affaan-m/ECC
Hệ thống tối ưu hóa hiệu suất khai thác tác nhân. Kỹ năng, bản năng, trí nhớ, bảo mật và sự phát triển ưu tiên nghiên cứu cho Claude Code, Codex, Opencode, Cursor và hơn thế nữa.
README
Ngôn ngữ: Tiếng Anh | Người Bồ Đào Nha (Brasil) | 简体中文 | 繁體中文 | 日本語 | 한국어 | Türkçe | Русский | Tiếng Việt | ไทย | tiếng Đức | tiếng Tây Ban Nha
[!CẢNH BÁO] Chỉ có nguồn chính thức. Chỉ cài đặt ECC từ các kênh đã được xác minh: kho lưu trữ GitHub GitHub.com/affaan-m/ECC, các gói npm
ecc-universalvàecc-agentshield, cái Ứng dụng GitHub, sên pluginecc@ecc, và trang web của dự án ecc.tools. Các bản tải lên lại của bên thứ ba và các bản sao không chính thức không được dự án duy trì hoặc xem xét và có thể chứa phần mềm độc hại.
Cài đặt bằng Claude Code
Chạy các lệnh này bên trong Claude Code:
/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@ecc
Việc này cài đặt các kỹ năng, tác nhân, lệnh và hook do plugin quản lý của ECC. Nếu bạn chọn con đường này, hãy dừng lại ở đó. Cũng không chạy cài đặt thủ công đầy đủ vào Claude Code.
Sắp có gói thiết lập có hướng dẫn
ecc-universal2.2.0. Sử dụng các lệnh plugin Claude gốc ở trên trong khi npm vẫn ở phiên bản 2.1.0.
|
Ứng dụng ECC Pro + GitHub Cài đặt miễn phí · Kho riêng tư từ $19/chỗ/tháng |
Nhà tài trợ ECC Tài trợ cho dự án nguồn mở |
cộng đồng Bất hòa · Hỏi đáp · Hiển thị và kể |
OSS vẫn miễn phí. Kho lưu trữ này được MIT cấp phép vĩnh viễn. ECC Pro là Ứng dụng GitHub được lưu trữ dành cho các kho lưu trữ riêng tư. Nhà tài trợ và Người đăng ký chuyên nghiệp tài trợ cho công việc. Đó là lý do tại sao một nhà bảo trì vận chuyển 7 dây nịt hàng tuần.
Đối tác & nhà tài trợ
Các nhà tài trợ cộng đồng: Mike Morgan · @jasonwu513 · @1anter · @massimotodaro · @meadmccabe
Trở thành nhà tài trợ · Cấp độ nhà tài trợ · Chương trình tài trợ
ECC
Nhân viên hỗ trợ của bạn có thể viết mã, nhưng ECC cung cấp cho nó một hệ thống kỹ thuật và hộp công cụ phối hợp: nó lập kế hoạch trước khi xây dựng, xác minh các thay đổi bằng các thử nghiệm, đánh giá công việc của chính mình từ một bối cảnh mới, ghi nhớ những gì quan trọng và biến những chiến thắng lặp đi lặp lại thành các kỹ năng và quy trình làm việc có thể tái sử dụng.
plan -> test -> implement -> review -> verify -> remember -> improve
Thay vì xây dựng lại quy trình đó trong mọi lời nhắc, bạn cài đặt nó một lần và biến nó thành một phần trong cách hoạt động của nhân viên.
Tối ưu hóa cửa sổ ngữ cảnh. Kiên trì mọi thứ khác.
ECC là nguồn mở được MIT cấp phép. Hiện nay, nó hoạt động tốt nhất với Claude Code, có đường dẫn đồng bộ hóa Codex được hỗ trợ và cung cấp các bộ điều hợp có giới hạn khả năng cho Cursor, OpenCode, Gemini, Zed, GitHub Copilot, AntiGravity, Qwen và các bộ khai thác khác. Xem ma trận trạng thái hỗ trợ trước khi giả định tính năng tương đương.
Truy cập vào 68 tác nhân, 285 kỹ năng và 94 miếng chêm lệnh kế thừa, cùng với các móc nối, quy tắc, bộ nhớ, học tập liên tục và quét bảo mật AgentShield. Các đại lý này chuyên lập kế hoạch, xem xét, sửa chữa xây dựng, bảo mật, kiến trúc và công việc miền.
| Bao gồm | Đếm | Những gì nó mang lại cho bạn |
|---|---|---|
| Đại lý | 68 đại lý | Lập kế hoạch, đánh giá, xây dựng sửa chữa, bảo mật, kiến trúc và công việc miền |
| Kỹ năng | 285 kỹ năng | TDD, nghiên cứu, bảo mật, tài liệu, giao diện người dùng, dữ liệu, ML, hoạt động, v.v. |
| Lệnh | 94 lệnh | Điểm vào thuận tiện trong khi ECC chuyển sang bề mặt kỹ năng đầu tiên |
| Móc và bộ nhớ | Thời gian chạy | Thực thi, tóm tắt phiên, học hỏi liên tục, bản năng và kiểm soát bối cảnh |
| Quy tắc | chọn lọc | Các tiêu chuẩn luôn được tải bạn chọn theo ngôn ngữ hoặc dự án |
| Đặc vụShield | Bao gồm | Quét các lời nhắc, hook, cấu hình MCP, quyền, bí mật và tệp tác nhân |
Cài đặt ECC
[!QUAN TRỌNG] Sắp có gói hướng dẫn thiết lập
ecc-universal2.2.0. Bản phát hành npm hiện tại, 2.1.0, không bao gồm các lệnh thiết lập được hướng dẫn. Sử dụng các lệnh plugin Claude gốc ở đầu README này cho đến khi phiên bản 2.2.0 được xuất bản.
Chỉ chọn một đường dẫn (mỗi dây)
Bạn có thể sử dụng ECC với Claude Code, Codex và các bộ dây khác cùng lúc. Chọn một phương pháp cài đặt cho mỗi dây nịt:
- Được đề xuất hôm nay cho Claude Code: sử dụng lệnh plugin gốc ở trên
- Sắp có phiên bản 2.2: thiết lập gói có hướng dẫn cho Claude Code, Codex và Kimi Code; xem bản xem trước ở cuối khu vực cài đặt này
- Công trình: Plugin Claude Code + plugin gốc Codex
- Công trình: Plugin Claude Code + luồng đồng bộ hóa Codex cũ
- Tránh: Plugin Claude Code + cài đặt thủ công đầy đủ Claude
- Tránh: Đồng bộ hóa Codex + plugin thị trường Codex
Không xếp chồng các phương pháp cài đặt. Việc cài đặt ECC hai lần vào cùng một bộ dây có thể trùng lặp các kỹ năng, lệnh, móc hoặc cấu hình; cài đặt nó một lần vào nhiều dây nịt thì không.
Nếu bạn đã xếp nhiều lớp cài đặt và mọi thứ có vẻ trùng lặp, hãy chuyển thẳng đến Đặt lại/Gỡ cài đặt ECC.
Cài đặt có vấn đề? Mở đoạn ngắn biểu mẫu vấn đề cài đặt hoặc thời gian chạy, hoặc chạy ecc feedback. ECC không bao giờ tự động tải lên chẩn đoán.
chi tiết Claude Code
Claude Code sở hữu các lệnh tích hợp này, bao gồm cả lỗi khi thị trường, plugin hoặc phạm vi xung đột đã tồn tại. ECC không thể chặn trình phân tích cú pháp đó. Nếu lệnh gốc báo cáo xung đột cài đặt hoặc phạm vi hiện có, hãy đợi thiết lập theo hướng dẫn 2.2.0 hoặc giải quyết phạm vi plugin Claude xung đột trước khi thử lại; không xếp lớp cài đặt thủ công lên trên.
Sau khi cài đặt ECC, /ecc:configure-ecc là kỹ năng cấu hình lại được đặt tên trong Claude. Nó ủy quyền cho cùng một luồng thiết lập an toàn, nhưng nó chỉ khả dụng sau khi cài đặt plugin và không thể thay thế tính năng tích hợp sẵn của Claude Code /plugin lệnh trong lần cài đặt đầu tiên.
Các plugin Claude Code không thể phân phối rules, vì vậy chỉ thêm các gói quy tắc bạn thực sự muốn:
git clone https://github.com/affaan-m/ECC.git
cd ECC
mkdir -p ~/.claude/rules/ecc
cp -R rules/common ~/.claude/rules/ecc/
cp -R rules/typescript ~/.claude/rules/ecc/ # replace with your stack
Bắt đầu với rules/common cộng thêm một gói ngôn ngữ hoặc khung công tác mà bạn thực sự sử dụng. Nếu bạn cài đặt plugin, đừng chạy ./install.sh --profile full sau đó.
Ưu tiên cài đặt.JSON? Thêm thị trường khai báo
Thêm trực tiếp vào ~/.claude/settings.json:
{
"extraKnownMarketplaces": {
"ecc": {
"source": {
"source": "github",
"repo": "affaan-m/ECC"
}
}
},
"enabledPlugins": {
"ecc@ecc": true
}
}
Điều này mang lại cho bạn kết quả tương tự như hai /plugin các lệnh trên.
Đặt tên + ghi chú di chuyển (ecc@ecc, affaan-m/ECC, ecc-universal)
ECC có ba mã định danh công khai và chúng không thể thay thế cho nhau:
- Kho lưu trữ nguồn GitHub:
affaan-m/ECC - Claude mã định danh thị trường/plugin:
ecc@ecc - gói npm:
ecc-universal
Đây là cố ý. Lượt cài đặt plugin/thị trường Anthropic được khóa bằng mã định danh plugin chuẩn, vì vậy ECC sử dụng ecc@ecc để giữ tên công cụ và không gian tên lệnh gạch chéo đủ ngắn cho trình xác thực Desktop/API nghiêm ngặt. Các bài đăng cũ hơn vẫn có thể hiển thị mã nhận dạng thị trường dài trước đây; chỉ coi đó là bí danh cũ. Riêng biệt, gói npm vẫn được duy trì ecc-universal, vì vậy lượt cài đặt npm và lượt cài đặt trên thị trường có chủ ý sử dụng các tên khác nhau.
bản phát hành npm được cắt theo thẻ phiên bản, không phải theo cam kết, vì vậy ecc-universal theo dõi các bản phát hành (2.1, 2.2, ...) thay vì mỗi lần đẩy tới main. Cài đặt từ git nếu bạn muốn có lợi thế.
Nếu thiết lập Claude cục bộ của bạn bị xóa hoặc đặt lại, điều đó không có nghĩa là bạn cần mua lại bất kỳ thứ gì. Bắt đầu với node scripts/ecc.js list-installed, sau đó chạy node scripts/ecc.js doctor và node scripts/ecc.js repair trước khi cài đặt lại. Điều đó thường khôi phục các tệp do ECC quản lý mà không cần xây dựng lại thiết lập của bạn.
Ứng dụng Codex và CLI
Các bản phát hành Codex hiện tại có thể cài đặt ECC làm plugin thị trường kho lưu trữ gốc. Mục nhập thị trường sử dụng thư mục gốc của kho lưu trữ để bộ đệm của Codex nhận được tệp kê khai cùng với tất cả các kỹ năng được tham chiếu, cấu hình MCP, thời gian chạy hook, tập lệnh và nội dung:
codex plugin marketplace add affaan-m/ECC
codex plugin add ecc@ecc
codex plugin list --json
node scripts/codex/check-plugin-cache.js
Cả hai lệnh thêm đều bình thường. Để làm mới sau, hãy chạy codex plugin marketplace upgrade ecc theo sau là codex plugin add ecc@ecc. Codex lưu trữ một trạng thái plugin được kích hoạt trong trạng thái hoạt động CODEX_HOME; nó không cung cấp Claude user, projectvà local phạm vi. Các hook gốc của nó yêu cầu một quyết định tin cậy rõ ràng và không sử dụng bốn cấu hình hook ECC của Claude. Bên trong Codex, gọi $configure-ecc cho luồng nhận thức của nhà cung cấp được hướng dẫn.
Càng lớn tuổi scripts/sync-ecc-to-codex.sh đường dẫn là một tùy chọn tương thích không được dùng nữa đối với những người dùng cố tình cần cấu hình được sao chép và hợp nhất trong ~/.codex; nó không bắt buộc đối với plugin gốc. Các lần chạy đồng bộ hóa mới ghi một bảng kê khai quyền sở hữu để quá trình dọn dẹp có thể bảo toàn các tệp người dùng đã sửa đổi. Chạy Codex một lần trước tiên ~/.codex/config.toml tồn tại thì:
git clone https://github.com/affaan-m/ECC.git
cd ECC
npm install
bash scripts/sync-ecc-to-codex.sh
Để kiểm tra hoặc xóa lớp kế thừa đó mà không cần chạm vào các cuộc hội thoại Codex hoặc bộ đệm plugin gốc:
node scripts/ecc.js uninstall --legacy-codex-sync --dry-run
node scripts/ecc.js uninstall --legacy-codex-sync
Việc cài đặt trước tệp kê khai được xử lý thận trọng: ECC xóa các cài đặt được đánh dấu của nó AGENTS.md chặn nhưng giữ lại các tập tin đã sao chép mà nó không thể chứng minh được mình sở hữu và báo cáo chúng để xem xét.
Bạn cũng có thể mở kho lưu trữ ECC trực tiếp trong Codex để thiết lập dự án cục bộ. Codex đọc thư mục gốc AGENTS.md và cấu hình dự án đáng tin cậy trong .codex/ không có sự đồng bộ toàn cầu. Không thêm plugin thị trường gốc vào đầu luồng đồng bộ hóa.
Để biết điều hướng kho lưu trữ, quyền sở hữu bề mặt và hướng dẫn gói PR khác biệt, hãy đọc Bản đồ điều hướng Codex ECC. Xem ghi chú bổ trợ .codex để biết chi tiết về vòng đời của bản địa.
Các đại lý và biên tập viên khác
Cursor, OpenCode, Gemini, Zed, Anti Gravity, Qwen, Hermes, OpenClaw, Kimi, CodeBuddy, JoyCode, Copilot
Sao chép ECC một lần, sau đó chọn mục tiêu phù hợp với dây nịt của bạn:
git clone https://github.com/affaan-m/ECC.git
cd ECC
| Khai thác | Cài đặt hoặc thiết lập | Ghi chú |
|---|---|---|
| Cursor | ./install.sh --profile minimal --target cursor |
Dự án-địa phương .cursor/ bộ chuyển đổi |
| Mã mở | npm install && npm run build:opencode && ./install.sh --profile full --target opencode |
Xây dựng tải trọng plugin trước khi cài đặt đầy đủ |
| Gemini CLI | ./install.sh --profile minimal --target gemini |
Dự án-địa phương .gemini/ cấu hình |
| Zed | ./install.sh --profile minimal --target zed |
Dự án-địa phương .zed/ bộ chuyển đổi |
| phản trọng lực | ./install.sh --profile minimal --target antigravity |
Xem Hướng dẫn phản trọng lực |
| Qwen CLI | ./install.sh --profile minimal --target qwen |
Xem hướng dẫn Qwen |
| Hermes | ./install.sh --profile minimal --target hermes |
Xem Hướng dẫn cài đặt Hermes |
| OpenClaw | ./install.sh --profile minimal --target openclaw |
Cài đặt thư mục chính được quản lý |
| Mã Kimi CLI | ./install.sh --profile minimal --target kimi |
Dự án-địa phương .kimi-code/ cài đặt |
| CodeBuddy | ./install.sh --profile minimal --target codebuddy |
Dự án-địa phương .codebuddy/ cài đặt |
| Mã niềm vui | ./install.sh --profile minimal --target joycode |
Dự án-địa phương .joycode/ cài đặt |
Hỗ trợ GitHub Copilot đã được bao gồm trong kho lưu trữ này. .github/copilot-instructions.md cung cấp lớp hướng dẫn, .github/prompts/ chứa có thể tái sử dụng /plan, /tdd, /security-review, /build-fixvà /refactor lời nhắc và .vscode/settings.json cho phép chat.promptFiles.
Đối với dây nịt không có mục tiêu ECC gốc, hãy sử dụng hướng dẫn thích ứng thủ công. Nó giải thích cách đưa một tập hợp nhỏ các kỹ năng ECC và hướng dẫn quy trình làm việc vào các công cụ kiểu trò chuyện mà không có sẵn các móc câu hoặc khám phá kỹ năng gốc.
Cursor cài đặt các định nghĩa tác nhân trong .cursor/agents/ecc-*.md. Cursor-hành vi tải gốc có thể thay đổi tùy theo bản dựng Cursor. ECC không cài root AGENTS.md vào .cursor/. Bộ điều hợp giữ cho bối cảnh của Cursor nằm trong phạm vi các quy tắc gốc và bề mặt tác nhân của nó.
Ghi chú sâu cho mỗi dây nịt (tính năng tương đương, bộ điều hợp móc, giới hạn) có trong Hỗ trợ nền tảng bên dưới.
Mô hình tự lưu trữ và điểm cuối tùy chỉnh
ECC hoạt động thông qua cấu hình thông thường của từng dây nịt, vì vậy bạn có thể sử dụng nhà cung cấp chính thức, cổng mô hình hoặc điểm cuối API tùy chỉnh tương thích hoặc mô hình tự lưu trữ mà không thay đổi quy trình công việc của ECC.
Đối với Claude Code, ECC không mã hóa cứng các cài đặt truyền tải được lưu trữ trên máy chủ Anthropic. Ví dụ về cổng tối thiểu:
export ANTHROPIC_BASE_URL=https://your-gateway.example.com
export ANTHROPIC_AUTH_TOKEN=your-token
claude
Nếu cổng của bạn ánh xạ lại tên mẫu, hãy định cấu hình tên đó trong Claude Code thay vì trong ECC. Những điểm hấp dẫn, kỹ năng, mệnh lệnh và quy tắc của ECC là điều bất khả tri của nhà cung cấp mô hình một khi claude CLI đã hoạt động. Xem của Anthropic Tài liệu về cổng LLM và tài liệu cấu hình mô hình.
Chạy hoặc tự lưu trữ bất kỳ mô hình nguồn mở nào đằng sau cổng đó bằng cách sử dụng thiết lập điện toán và phân phối riêng biệt. Nếu bạn cần dung lượng GPU, Itô là nhà tài trợ điện toán ưa thích của ECC; mọi nhà cung cấp GPU đều hoạt động. Liên kết tài trợ mang tính thụ động: nó không gọi RFQ, công suất dự trữ, tính toán cung cấp hoặc định cấu hình phân phát. Riêng biệt, ecc ito find gọi Itô CLI chuẩn được định cấu hình rõ ràng và gửi RFQ được xác thực trực tiếp; nó không dự trữ năng lực. Suy luận được quản lý thông qua Itô vẫn chưa hoạt động.
Kimi tự lưu trữ với tính toán ECC + Itô
Bộ khai thác Mã Kimi và lớp phục vụ mô hình là riêng biệt. ECC cấu hình khai thác tác nhân; bạn mang theo điểm cuối API hoặc tự lưu trữ mô hình Kimi có trọng lượng mở trên dung lượng GPU của riêng bạn. Bộ điều hợp này được xác minh dựa trên Mã Kimi 0.31.x (@moonshot-ai/kimi-code):
![]() 1. Nhận dung lượng GPU Sử dụng Itô hoặc bất kỳ nhà cung cấp GPU nào. |
![]() 2. Phục vụ Kimi Hiển thị điểm kiểm tra đã chọn thông qua điểm cuối tương thích. |
3. Chạy Kimi Code bằng ECC Cài đặt hướng dẫn và kỹ năng của dự án, sau đó khởi động Kimi Code. |
Định cấu hình điểm cuối bằng Kimi Code hướng dẫn nhà cung cấp chính thức, sau đó cài đặt ECC:
bash ./install.sh --target kimi --profile minimal
node scripts/ecc.js doctor --target kimi
kimi
Kimi Code phát hiện đã cài đặt .kimi-code/AGENTS.md hướng dẫn và .kimi-code/skills/ quy trình làm việc nguyên bản; cấp dự án .agents/skills/ cũng là một địa điểm khám phá chính thức. ECC hợp nhất các mục dự án MCP một cách an toàn vào .kimi-code/mcp.json và không thay đổi cấp độ người dùng ~/.kimi-code/config.toml. Mã Kimi hỗ trợ các hook gốc, nhưng bộ điều hợp dự án được quản lý hiện tại của ECC không định cấu hình chúng, vì vậy trình cài đặt này không cung cấp cấu hình hook Kimi. Bộ chạy thử và hồi quy của trình cài đặt xác minh rằng mọi ghi Kimi được quản lý đều nằm trong dự án cục bộ .kimi-code/ gốc.
Itô tính toán cầu CLI
ecc ito đại biểu cho máy khách Itô chuẩn được cài đặt riêng; ECC không duy trì ứng dụng khách API thứ hai. ecc ito login [--no-browser] thực hiện ủy quyền thiết bị, mở trang xác minh Itô theo mặc định và duy trì mã thông báo thiết bị trong chuỗi khóa macOS; --no-browser chặn việc chuyển giao trang. Bản thân ECC không tự động hóa trình duyệt. ecc ito auth chỉ dành cho xác thực và từ chối --no-browser. Các hoạt động có sẵn là ecc ito login, ecc ito auth, ecc ito find, ecc ito status, và có cổng riêng ecc ito evals. Các công cụ MCP phù hợp vẫn còn ito_auth, ito_findvà ito_status; ito_auth xác thực thông tin xác thực hiện có và trình độ chuyên môn của nút chỉ là CLI.
các ito-compute-cli gói hiện chưa được xuất bản. Xây dựng nó cục bộ từ kho thời gian chạy Itô (riêng tư trong khi bàn cứng lại; đối tác thiết kế có quyền truy cập) trong cli/ito-compute-cli, chạy npm ci và npm run check, sau đó đặt ECC_ITO_CLI_EXECUTABLE với bản dựng đó là tuyệt đối dist/bin/ito.js con đường. Đăng nhập không bao giờ kế thừa ITO_API_KEY; xác thực, tìm và chuyển tiếp trạng thái ITO_API_KEY trực tiếp khi được cấu hình và ITO_AUTH_MODE=legacy không cần thiết. ecc ito logout thu hồi thông tin xác thực của thiết bị hiện tại và giữ lại bản sao cục bộ của nó nếu không thể xác nhận việc thu hồi từ xa. Mã thông báo thiết bị sử dụng Chuỗi khóa macOS theo mặc định; dự phòng tệp rõ ràng phải giữ lại quyền truy cập thư mục/tệp chỉ dành cho chủ sở hữu. ECC không phát hiện ra khách hàng có thông tin xác thực này thông qua PATH. Xem ito-compute kỹ năng để có toàn quyền RFQ và hợp đồng thiết lập MCP.
find gửi RFQ được xác thực trực tiếp. Nó không dự trữ năng lực. evals đòi hỏi cả hai ITO_ENABLE_SIXTYTWO_LIVE=1 và --live-sixtytwo, được cài đặt riêng sixtytwo-cli==0.3.33, danh sách nút rõ ràng và thư mục cấu hình tuyệt đối hiện có. Nó không thể thuê, khởi động, phục hồi, sửa chữa hoặc mua. ECC không cung cấp khóa báo giá, giao dịch mua, khối lượng công việc hoặc đường dẫn suy luận và không bao giờ thay thế một khách hàng bị thiếu hoặc cuộc gọi trực tiếp không thành công bằng kết quả cục bộ.
Tùy chọn cài đặt nâng cao
Các tùy chọn vẫn ở đây, ngay dưới đường dẫn cài đặt chính, do đó bạn không cần phải tìm kiếm trong README khi thiết lập mặc định không phù hợp.
Cài đặt bối cảnh thấp không có thời gian chạy hook
Đường dẫn có ngữ cảnh thấp/không có móc nối
Sử dụng điều này khi bạn muốn các quy tắc, tác nhân, lệnh, cấu hình nền tảng và quy trình công việc cốt lõi của ECC mà không có hook thời gian chạy:
./install.sh --profile minimal --target claude
Windows:
.\install.ps1 --profile minimal --target claude
Hồ sơ này cố tình loại trừ hooks-runtime.
Claude cài đặt thủ công đặt từng kỹ năng ngay bên dưới ~/.claude/skills/<skill-name>/ (hoặc .claude/skills/<skill-name>/ cho claude-project) để Claude Code có thể khám phá nó. Khi nâng cấp bản cài đặt thủ công ECC cũ hơn, trình cài đặt chỉ di chuyển các phần lồng nhau skills/ecc/ các tập tin được ghi ở trạng thái cài đặt ECC. Nếu thư mục kỹ năng phẳng thuộc sở hữu của người dùng, ECC sẽ bảo tồn nó, in cảnh báo xung đột và theo dõi mọi bản sao được quản lý cũ hơn để gỡ cài đặt an toàn thay vì ghi đè lên tệp người dùng.
Đối với cấu hình lõi thông thường có móc bị tắt:
./install.sh --profile core --without baseline:hooks --target claude
Chỉ thêm thời gian chạy hook sau nếu bạn muốn:
./install.sh --target claude --modules hooks-runtime
Chỉ chọn những thành phần bạn cần
Trước tiên hãy tìm các thành phần phù hợp
Hỏi cố vấn trọn gói xem thành phần nào phù hợp với công việc của bạn:
node scripts/ecc.js consult "security reviews" --target claude
Nó trả về các thành phần phù hợp, cấu hình liên quan và các lệnh xem trước/cài đặt. Sử dụng lệnh xem trước trước khi cài đặt nếu bạn muốn kiểm tra sơ đồ tệp chính xác.
Bạn cũng có thể cài đặt các kỹ năng hoặc khả năng rõ ràng:
./install.sh --target claude --skills tdd-workflow,security-review
node scripts/ecc.js install --profile minimal --target claude --with capability:machine-learning
Sao chép thủ công từng thành phần cũng hoạt động. Mỗi thành phần hoàn toàn độc lập:
# Just agents
cp agents/*.md ~/.claude/agents/
# Rules directories (common + language-specific)
mkdir -p ~/.claude/rules/ecc
cp -r rules/common ~/.claude/rules/ecc/
cp -r rules/typescript ~/.claude/rules/ecc/ # pick your stack
# Core/general skills only (Claude Code loads skills from direct children
# of ~/.claude/skills; do not nest manual installs under ~/.claude/skills/ecc/)
mkdir -p ~/.claude/skills
cp -r .agents/skills/* ~/.claude/skills/
cp -r skills/search-first ~/.claude/skills/
# Optional: maintained slash-command compatibility during migration
mkdir -p ~/.claude/commands
cp commands/*.md ~/.claude/commands/
Miếng chêm đã nghỉ hưu sống trong legacy-command-shims/. Chỉ sao chép các tệp riêng lẻ từ đó nếu bạn vẫn cần các tên cũ như /tdd.
Quy tắc cục bộ của dự án thay vì quy tắc chung
Sử dụng quy tắc dự án cục bộ khi tiêu chuẩn của ECC phải áp dụng cho một kho lưu trữ thay vì mọi phiên Claude Code:
cd your-project
mkdir -p .claude/rules/ecc
cp -R /path/to/ECC/rules/common .claude/rules/ecc/
cp -R /path/to/ECC/rules/typescript .claude/rules/ecc/
Quy tắc là bối cảnh luôn được tải, vì vậy hãy bắt đầu bằng common và một gói cho ngăn xếp mà bạn thực sự sử dụng. Khi sao chép quy tắc thủ công, hãy sao chép toàn bộ thư mục ngôn ngữ (ví dụ: rules/common hoặc rules/golang), chứ không phải các tệp bên trong nó, vì vậy các tham chiếu tương đối vẫn tiếp tục hoạt động và tên tệp không xung đột.
Cài đặt hoàn toàn thủ công Claude
Chỉ sử dụng điều này khi bạn cố tình bỏ qua đường dẫn plugin:
git clone https://github.com/affaan-m/ECC.git
cd ECC
./install.sh --profile full
Windows:
git clone https://github.com/affaan-m/ECC.git
cd ECC
.\install.ps1 --profile full
Nếu bạn chọn con đường này, hãy dừng lại ở đó. Cũng đừng chạy /plugin install.
Đối với các lượt cài đặt thủ công được chọn lọc kỹ lưỡng, Claude khám phá các kỹ năng với tư cách là con trực tiếp của ~/.claude/skills/; đừng lồng chúng dưới ~/.claude/skills/ecc/.
Cài đặt móc
Không sao chép repo thô hooks/hooks.json vào ~/.claude/settings.json hoặc ~/.claude/hooks/hooks.json. Tệp đó được định hướng theo plugin/repo; sử dụng trình cài đặt để đường dẫn lệnh hook được viết lại chính xác:
bash ./install.sh --target claude --modules hooks-runtime
Điều đó viết các móc đã được giải quyết vào ~/.claude/hooks/hooks.json và để lại mọi thứ hiện có ~/.claude/settings.json không bị ảnh hưởng.
Nếu bạn đã cài đặt ECC qua /plugin install, đừng sao chép những cái móc đó vào settings.json. Claude Code v2.1+ đã tự động tải plugin hooks/hooks.jsonvà sao chép chúng vào settings.json gây ra xung đột thực thi trùng lặp và xung đột hook đa nền tảng.
Trên Windows, cấu hình gốc của Claude là %USERPROFILE%\\.claude; cài đặt thời gian chạy hook với:
pwsh -File .\install.ps1 --target claude --modules hooks-runtime
Định cấu hình MCP
Việc cài đặt plugin Claude có chủ ý không tự động kích hoạt các định nghĩa máy chủ MCP đi kèm của ECC. Điều này tránh tên công cụ plugin MCP quá dài trên các cổng nghiêm ngặt của bên thứ ba trong khi vẫn duy trì cài đặt MCP thủ công.
Sử dụng Claude Code /mcp lệnh hoặc thiết lập MCP do CLI quản lý để thay đổi máy chủ Claude Code trực tiếp; Claude Code duy trì những lựa chọn đó trong ~/.claude.json. Để truy cập repo-local MCP, hãy sao chép định nghĩa máy chủ MCP mong muốn từ mcp-configs/mcp-servers.json vào phạm vi dự án .mcp.json.
ECC cung cấp chính xác một đầu nối mặc định (chrome-devtools); mọi thứ khác là một kỹ năng gói gọn một CLI/REST API hoặc một mục nhập danh mục chọn tham gia. Quy tắc và cuộc kiểm toán tháng 6 năm 2026 đã loại bỏ sáu vụ vỡ nợ trước đó vẫn còn hiệu lực. docs/MCP-CONNECTOR-POLICY.md.
Nếu bạn đã chạy các bản sao MCP đi kèm ECC của riêng mình, hãy đặt:
export ECC_DISABLED_MCPS="chrome-devtools"
Các luồng cài đặt và đồng bộ hóa Codex do ECC quản lý sẽ bỏ qua hoặc xóa các máy chủ đi kèm đó thay vì thêm lại các máy chủ trùng lặp. ECC_DISABLED_MCPS là bộ lọc cài đặt/đồng bộ hóa ECC, không phải là chuyển đổi Claude Code trực tiếp.
Quan trọng: Thay thế YOUR_*_HERE phần giữ chỗ bằng các phím API thực tế của bạn.
Lệnh đa mô hình yêu cầu thiết lập bổ sung
multi-* lệnh là không được bao phủ bởi cài đặt quy tắc/plugin cơ bản.
Để sử dụng /multi-plan, /multi-execute, /multi-backend, /multi-frontendvà /multi-workflow, bạn cũng phải cài đặt ccg-workflow thời gian chạy. Khởi tạo nó với npx ccg-workflow.
Thời gian chạy đó cung cấp các phần phụ thuộc bên ngoài mà các lệnh này mong đợi, bao gồm:
~/.claude/bin/codeagent-wrapper~/.claude/.ccg/prompts/*
không có ccg-workflow, những cái này multi-* các lệnh sẽ không chạy chính xác.
Đặt lại, sửa chữa hoặc gỡ cài đặt
Đặt lại/Gỡ cài đặt ECC
Nếu ECC cảm thấy bị trùng lặp, xâm phạm hoặc bị hỏng, hãy kiểm tra trạng thái được quản lý trước khi cài đặt lại:
node scripts/ecc.js list-installed
node scripts/ecc.js doctor
node scripts/ecc.js repair
node scripts/ecc.js uninstall --dry-run
Để gỡ cài đặt trực tiếp:
node scripts/uninstall.js --dry-run
node scripts/uninstall.js
Nếu bạn rời đi, lệnh gỡ cài đặt sẽ in một tùy chọn Mẫu phản hồi 20 giây. Đây là sự cố GitHub công khai, không bao giờ chặn việc gỡ cài đặt và ECC không tải lên chẩn đoán. Bạn cũng có thể chạy ecc feedback bất cứ lúc nào để xem vấn đề, phản hồi và lộ trình tính năng.
Người dùng plugin nên xóa plugin khỏi Claude Code, sau đó chỉ xóa các thư mục quy tắc mà họ đã sao chép thủ công và không còn muốn nữa. ECC chỉ xóa các tệp được ghi ở trạng thái cài đặt. Nó không yêu cầu các tập tin không liên quan trong thư mục khai thác của bạn.
Nếu bạn xếp chồng các phương thức, hãy dọn dẹp theo thứ tự sau:
- Gỡ cài đặt plugin Claude Code.
- Chạy lệnh gỡ cài đặt ECC từ gốc repo để xóa các tệp được quản lý trạng thái cài đặt.
- Xóa mọi thư mục quy tắc bổ sung mà bạn đã sao chép thủ công và không còn muốn nữa.
- Cài đặt lại một lần, sử dụng một đường dẫn duy nhất.
Sắp ra mắt: thiết lập có hướng dẫn trong phiên bản 2.2
[!CẢNH BÁO] Các lệnh chạy gói ECC này không có sẵn trong bản phát hành npm hiện tại, 2.1.0. Đừng chạy chúng cho đến khi
ecc-universal2.2.0 được xuất bản.
Mô tả README trước đó—Mặc định được đề xuất: chạy thiết lập plugin Claude được hướng dẫn—đã được xuất bản quá sớm. Khuyến nghị đó được rút lại cho đến khi phát hành 2.2.
Để thiết lập, cập nhật, thay đổi phạm vi và thay đổi cấu hình hook của plugin Claude Code:
npx ecc-universal setup
Phiên bản 2.2 sẽ hỗ trợ thiết lập có hướng dẫn tương tự thông qua các trình chạy gói hiện đại:
| Người chạy gói | Lệnh thiết lập có hướng dẫn |
|---|---|
| npm / npx | npx ecc-universal setup |
| pnpm | pnpm dlx ecc-universal setup |
| Sợi 2+ | yarn dlx ecc-universal setup |
| Bun | bunx ecc-universal setup |
Sợi Classic 1 không cung cấp yarn dlx; sử dụng npx, cài đặt gói trên toàn cầu hoặc nâng cấp Sợi để chạy một lần tạm thời sau khi 2.2 được xuất bản.
Trình hướng dẫn kiểm kê thị trường chính thức và mọi phạm vi cài đặt Claude gốc trước khi thực hiện thay đổi, sau đó cài đặt, cập nhật hoặc di chuyển một cách an toàn ecc@ecc vào phạm vi bạn chọn. Chạy lại lệnh tương tự bất cứ khi nào bạn muốn cập nhật ECC, thay đổi phạm vi hoặc thay đổi cấu hình hook của nó. Trình hướng dẫn thiết lập này hiện đang định cấu hình plugin Claude Code; sử dụng trình hướng dẫn đa khai thác bên dưới cho Codex hoặc Kimi Code.
Để định cấu hình nhiều tác nhân mã hóa trong một luồng được xem xét, hãy sử dụng trình hướng dẫn đa khai thác:
npx ecc-universal install --guided
Nó cho phép bạn chọn bất kỳ sự kết hợp nào của Claude Code, Codex và Kimi Code, hiển thị từng kênh cài đặt và đích đến, đánh giá trước mọi lựa chọn trước lần ghi đầu tiên và yêu cầu một xác nhận cuối cùng.
| Khai thác | Hành vi cài đặt có hướng dẫn |
|---|---|
| Claude Code | Bản địa ecc@ecc plugin với một user, projecthoặc local phạm vi và hồ sơ móc ECC |
| Codex | Vòng đời plugin/thị trường Codex gốc; đánh giá hook và sự tin cậy vẫn thuộc sở hữu của Codex |
| Mã Kimi | Các tệp dự án được quản lý theo ./.kimi-code; Móc ECC, cài đặt mô hình/nhà cung cấp và xác thực không được định cấu hình |
Để tự động hóa, hãy làm rõ mọi lựa chọn dành riêng cho nhà cung cấp:
npx ecc-universal install --guided \
--harness claude --harness codex --harness kimi \
--claude-scope local --claude-hooks standard \
--profile core --yes
Xác minh đường dẫn Codex được hướng dẫn gốc và đường dẫn Kimi được quản lý mà không cần ghi trước:
npx ecc-universal install --guided --harness codex --dry-run
npx ecc-universal install --profile core --target kimi --dry-run
Các lệnh tên gói bổ sung cũng sẽ có sẵn thông qua bí danh 2.2:
npx ecc-universal consult "security reviews" --target claude
npx ecc-universal install --profile minimal --target claude --with capability:machine-learning
npx ecc-universal doctor --target kimi
không sử dụng npx ecc-install --profile minimal --target claude: ecc-install là một tên nhị phân bên trong ecc-universal, không phải gói npm được xuất bản riêng.
ECC cũng cung cấp các bộ điều hợp được quản lý nâng cao cho cursor, antigravity, gemini, opencode, codebuddy, joycode, qwen, zed, hermesvà openclaw. Những mục tiêu đó vẫn sử dụng tài liệu của họ ecc install --target ... đường dẫn cho đến khi mỗi bộ chuyển đổi đã vượt qua ma trận vòng đời xung đột, cập nhật, sửa chữa và gỡ cài đặt được hướng dẫn. Cả thuật sĩ đều không âm thầm cài đặt vào mọi khai thác được phát hiện.
Bắt đầu sử dụng ECC
Bắt đầu với quy trình làm việc bạn cần chứ không phải danh mục đầy đủ.
| Bạn đang làm gì | Bắt đầu ở đây |
|---|---|
| Xây dựng một tính năng | /ecc:plan "describe the feature", sau đó tdd-workflow |
| Sửa một lỗi | Tái tạo nó bằng một bài kiểm tra thất bại, sau đó sử dụng tdd-workflow |
| Xem lại mã mới | /code-review để xem xét bối cảnh mới |
| Sửa chữa một công trình | /build-fix |
| Làm sạch cơ sở mã | /refactor-clean |
| Kiểm tra áp lực bối cảnh | /context-budget |
| Kết thúc một phiên dài | /save-session hoặc /learn-eval |
| Tiếp tục sau | /resume-session |
| Cấu hình đại lý kiểm toán | /security-scan hoặc npx -y ecc-agentshield scan --path . |
Lệnh plugin và lệnh thủ công
Các lệnh plugin Claude Code sử dụng dạng không gian tên:
/ecc:plan "Add authentication"
Cài đặt thủ công có thể hiển thị dạng tương thích ngắn hơn:
/plan "Add authentication"
Kỹ năng là bề mặt công việc chính. Các lệnh vẫn là điểm vào thuận tiện và miếng chêm tương thích. Kiểm tra những gì được cài đặt với:
/plugin list ecc@ecc
Tôi nên sử dụng đại lý nào?
Kỹ năng là bề mặt quy trình làm việc chuẩn mực; các mục nhập dấu gạch chéo được duy trì vẫn có sẵn cho quy trình làm việc bằng lệnh đầu tiên.
| Tôi muốn... | Sử dụng bề mặt này | Đại lý được sử dụng |
|---|---|---|
| Lên kế hoạch cho một tính năng mới | /ecc:plan "Add auth" |
người lập kế hoạch |
| Thiết kế kiến trúc hệ thống | /ecc:plan + đại lý kiến trúc |
kiến trúc sư |
| Viết mã với các bài kiểm tra đầu tiên | tdd-workflow kỹ năng |
hướng dẫn tdd |
| Xem lại mã tôi vừa viết | /code-review |
người đánh giá mã |
| Sửa bản dựng bị lỗi | /build-fix |
trình giải quyết lỗi xây dựng |
| Chạy thử nghiệm từ đầu đến cuối | e2e-testing kỹ năng |
Á hậu e2e |
| Tìm lỗ hổng bảo mật | /security-scan |
người đánh giá bảo mật |
| Loại bỏ mã chết | /refactor-clean |
trình dọn dẹp tái cấu trúc |
| Cập nhật tài liệu | /update-docs |
trình cập nhật tài liệu |
| Xem lại mã Go | /go-review |
người đánh giá |
| Xem lại mã Python | /python-review |
Python-người đánh giá |
| Xem lại mã F# | (gọi fsharp-reviewer trực tiếp) |
người đánh giá fsharp |
| Xem lại mã TypeScript/JavaScript | (gọi typescript-reviewer trực tiếp) |
TypeScript-người đánh giá |
| Phát triển ứng dụng HarmonyOS | (gọi harmonyos-app-resolver trực tiếp) |
Harmonos-app-Resolver |
| Kiểm tra truy vấn cơ sở dữ liệu | (tự động ủy quyền) | người đánh giá cơ sở dữ liệu |
| Xem xét các thay đổi ML sản xuất | mle-workflow kỹ năng + mle-reviewer đại lý |
người đánh giá mle |
Quy trình công việc chung
Các dạng dấu gạch chéo bên dưới được hiển thị ở vị trí chúng vẫn là một phần của bề mặt lệnh được duy trì. Các miếng chêm tên ngắn đã ngừng hoạt động như /tdd và /eval sống ở legacy-command-shims/ chỉ dành cho việc chọn tham gia rõ ràng.
Bắt đầu một tính năng mới:
/ecc:plan "Add user authentication with OAuth"
-> planner creates implementation blueprint
tdd-workflow skill -> tdd-guide enforces write-tests-first
/code-review -> code-reviewer checks your work
Sửa lỗi:
tdd-workflow skill -> tdd-guide: write a failing test that reproduces it
-> implement the fix, verify test passes
/code-review -> code-reviewer: catch regressions
Chuẩn bị sản xuất:
/security-scan -> security-reviewer: OWASP Top 10 audit
e2e-testing skill -> e2e-runner: critical user flow tests
/test-coverage -> verify 80%+ coverage
Có gì mới: ECC 2.1
[! QUAN TRỌNG] MỚI TRONG ECC 2.1: Plan Canvas · Khai thác Kimi · điện toán tự lưu trữ trên GPU Itô. Xem ghi chú phát hành đầy đủ →
Plan Canvas: xem lại kế hoạch bằng cách chỉ tay, không gõ lại
Nhân viên hỗ trợ của bạn viết một kế hoạch, sau đó mở nó trong khung trình duyệt chỉ dành cho vòng lặp. Nhấp vào phần bạn muốn nói, đính kèm chú thích được đánh số, trò chuyện từ thanh công cụ bên cạnh và nhấn Phê duyệt kế hoạch hoặc Yêu cầu thay đổi. Bản án ánh xạ thẳng vào /plancổng CONFIRM của. Sơ đồ Mermaid hiển thị trực tiếp và các chỉnh sửa đối với tệp kế hoạch sẽ tải lại trang.

Đó là khai thác và bất khả tri về mô hình: một CLI đơn giản (ecc-plan-canvas) nói JSON nên đại lý nào cũng có thể lái được. Hãy thử: yêu cầu đại lý của bạn /ecc:plan bất cứ điều gì, sau đó xem lại từ trang thay vì thiết bị đầu cuối.
Mở kế hoạch được sử dụng trong bản demo này →
Cũng trong 2.1
- Mục tiêu cài đặt Kimi Code (
--target kimi): ECC cài đặt tự nhiên vào AI ánh trăngMã Kimi của CLI - Tự lưu trữ trên GPU: một đường dẫn được xác minh với Itô, nhà tài trợ điện toán ưa thích của ECC, bao gồm cả việc chọn tham gia
ecc ito findCầu RFQ (chi tiết và tiết lộ ở trên trong Mô hình tự lưu trữ và điểm cuối tùy chỉnh) - Moonshot AI (Kimi), Itô và Atlas Cloud hiện là nhà tài trợ công
- Mục tiêu cài đặt Hermes + OpenClaw, hướng dẫn điều hướng Codex, các móc nối PostToolUse hợp nhất và tăng cường chuỗi cung ứng
Sự phát triển hiện tại: Kho bộ nhớ hợp nhất
ecc memory cung cấp cho Claude, Codex, Hermes, OpenClaw, Kimi và các khai thác khác một định dạng Markdown cục bộ, có thể kiểm tra được để có bối cảnh và chuyển giao lâu dài. tùy chọn ecc-memory-mcp máy chủ stdio hiển thị cùng một bề mặt lưu/tìm kiếm/đọc/bác sĩ được giới hạn mà không bật chính nó theo mặc định. Chi tiết đầy đủ trong Chia sẻ bối cảnh giữa các khai thác bên dưới.
Bản phát hành trước
| Phiên bản | Điểm nổi bật |
|---|---|
| v2.0.0 | Hệ điều hành khai thác tác nhân: chia độ khai thác chéo, nền khung điều khiển, orch-* người điều phối, bot Discord + ECC, chính sách kết nối đơn MCP |
| v1.10.0 | Làm mới bề mặt, quy trình vận hành, ECC 2.0 alpha |
| v1.9.0 | Cài đặt có chọn lọc, ECC Tools Pro, hệ sinh thái 12 ngôn ngữ |
| v1.8.0 | Khai thác hiệu suất và độ tin cậy đa nền tảng |
| v1.7.0 | Trình tạo bản trình bày và mở rộng đa nền tảng |
| v1.6.0 | Phiên bản Codex và Ứng dụng Công cụ ECC GitHub |
| v1.5.0 | Phiên bản phổ quát |
| v1.4.0 | Quy tắc đa ngôn ngữ, trình hướng dẫn cài đặt, phối hợp PM2 |
| v1.3.0 | Hỗ trợ plugin OpenCode hoàn chỉnh |
| v1.2.0 | Các lệnh và kỹ năng thống nhất |
| v1.1.0 | Hỗ trợ đa nền tảng và sửa lỗi cộng đồng |
| v1.0.0 | Bản phát hành plugin chính thức |
Lịch sử phát hành chi tiết
v2.0.0: Hệ điều hành khai thác tác nhân (Tháng 6 năm 2026)
Mức độ ổn định của dòng 2.0: nền của khung điều khiển (bộ điều hợp phiên + kho lưu trữ MCP), dịch vụ vòng đời của cây công việc, orch-* gia đình dàn nhạc, và sự ra mắt của Cộng đồng bất hòa ECC. Ghi chú đầy đủ: docs/releases/2.0.0/release-notes.md.
v2.0.0-rc.1: Làm mới bề mặt, Quy trình vận hành và ECC 2.0 Alpha (Tháng 4 năm 2026)
- GUI trang tổng quan: Ứng dụng máy tính để bàn dựa trên Tkinter mới (
ecc_dashboard.pyhoặcnpm run dashboard) với tính năng chuyển đổi chủ đề tối/sáng, tùy chỉnh phông chữ và biểu tượng dự án trong tiêu đề và thanh tác vụ. - Bề mặt công khai được đồng bộ hóa với kho lưu trữ trực tiếp: siêu dữ liệu, số lượng danh mục, bảng kê khai plugin và tài liệu hướng dẫn cài đặt hiện khớp với bề mặt OSS thực tế.
- Mở rộng quy trình làm việc của người vận hành và bên ngoài:
brand-voice,social-graph-ranker,connections-optimizer,customer-billing-ops,ecc-tools-cost-audit,google-workspace-ops,project-flow-opsvàworkspace-surface-auditvòng ra làn đường dành cho người điều khiển. - Công cụ truyền thông và khởi chạy:
manim-video,remotion-video-creationvà các bề mặt xuất bản xã hội được nâng cấp làm cho phần giải thích kỹ thuật và nội dung khởi chạy trở thành một phần của cùng một hệ thống. - Tăng trưởng khung và bề mặt sản phẩm:
nestjs-patterns, bề mặt cài đặt Codex/OpenCode phong phú hơn và bao bì dây chéo mở rộng giúp kho lưu trữ có thể sử dụng được ngoài một dây nịt duy nhất. - Gói kỹ năng dự đoán thị trường Itô: hợp nhất
ito-basketskỹ năng (chỉ số giỏ chỉ đọc, so sánh, tóm tắt thị trường và bảng tính lập kế hoạch không thể thực thi - thay thế bảng tính cũito-market-intelligence,ito-basket-compare,ito-trade-plannervàito-data-atlas-agentkỹ năng), cộng thêmprediction-market-oracle-researchvàprediction-market-risk-review, thêm quy trình làm việc thị trường/rổ công khai, không cần tư vấn trong khi vẫn duy trì quyền truy cập Itô API trực tiếp và tách biệt khỏi thanh toán Công cụ ECC. - Gói kỹ năng tối ưu hóa:
parallel-execution-optimizer,benchmark-optimization-loop,data-throughput-accelerator,latency-critical-systemsvàrecursive-decision-ledgerbiến các lời nhắc về tốc độ/đệ quy lặp đi lặp lại thành quy trình làm việc có giới hạn về điểm chuẩn, thông lượng và sổ cái quyết định. - ECC 2.0 alpha trong cây: nguyên mẫu mặt phẳng điều khiển Rust trong
ecc2/xây dựng cục bộ và hiển thịdashboard,start,sessions,status,stop,resumevàdaemonlệnh. - Ảnh chụp nhanh trạng thái người vận hành:
ecc status --markdown --write status.mdbiến kho lưu trữ trạng thái cục bộ thành một bản chuyển giao di động bao gồm tính sẵn sàng, các phiên hoạt động, tình trạng chạy kỹ năng, tình trạng cài đặt, các sự kiện quản trị đang chờ xử lý và các mục công việc được liên kết từ Tuyến tính/GitHub/chuyển giao. - Làm cứng hệ sinh thái: Kiểm soát chi phí AgentShield, Công cụ ECC, công việc cổng thanh toán và làm mới trang web tiếp tục được triển khai xung quanh plugin cốt lõi thay vì trôi dạt vào các silo riêng biệt.
v1.9.0: Cài đặt có chọn lọc và mở rộng ngôn ngữ (Tháng 3 năm 2026)
- Kiến trúc cài đặt chọn lọc: Quy trình cài đặt dựa trên tệp kê khai với
install-plan.jsvàinstall-apply.jsđể cài đặt thành phần được nhắm mục tiêu. Cửa hàng trạng thái theo dõi những gì đã được cài đặt và cho phép cập nhật gia tăng. - 6 đại lý mới:
typescript-reviewer,pytorch-build-resolver,java-build-resolver,java-reviewer,kotlin-reviewer,kotlin-build-resolvermở rộng phạm vi ngôn ngữ lên 10 ngôn ngữ. - Kỹ năng mới:
pytorch-patterns,documentation-lookup,bun-runtime,nextjs-turbopack, 8 kỹ năng lĩnh vực hoạt động, vàmcp-server-patterns. - Cơ sở hạ tầng phiên và trạng thái: Kho lưu trữ trạng thái SQLite với truy vấn CLI, bộ điều hợp phiên để ghi có cấu trúc, nền tảng phát triển kỹ năng để tự cải thiện kỹ năng.
- Đại tu dàn nhạc: Chấm điểm kiểm tra khai thác xác định, trạng thái điều phối được củng cố và khả năng tương thích của thiết bị phóng, ngăn ngừa vòng lặp quan sát với lớp bảo vệ 5 lớp.
- Độ tin cậy của người quan sát: Sửa lỗi nổ bộ nhớ với tính năng điều tiết và lấy mẫu đuôi, sửa lỗi truy cập hộp cát, logic khởi động lười và bảo vệ quyền truy cập lại.
- 12 hệ sinh thái ngôn ngữ: Các quy tắc mới cho Java, PHP, Perl, Kotlin/Android/KMP, C++ và Rust kết hợp với các quy tắc chung hiện có là TypeScript, Python, Go và các quy tắc chung.
- Đóng góp của cộng đồng: Bản dịch tiếng Hàn và tiếng Trung, tối ưu hóa móc quần xã, kỹ năng xử lý video, kỹ năng vận hành, trình cài đặt PowerShell, hỗ trợ AntiGravity IDE.
- CI cứng lại: 19 bản sửa lỗi kiểm thử, thực thi số lượng danh mục, xác thực bản kê khai cài đặt và bộ thử nghiệm đầy đủ màu xanh lá cây.
v1.8.0: Hệ thống hiệu suất khai thác (Tháng 3 năm 2026)
- Bản phát hành khai thác đầu tiên: ECC được định nghĩa rõ ràng là một hệ thống hiệu suất khai thác tác nhân chứ không chỉ là một gói cấu hình.
- Đại tu độ tin cậy của móc: Dự phòng gốc SessionStart, tóm tắt phiên ở pha dừng và các móc dựa trên tập lệnh thay thế các dòng một dòng dễ vỡ.
- Kiểm soát thời gian chạy móc:
ECC_HOOK_PROFILE=minimal|standard|strictvàECC_DISABLED_HOOKS=...để kiểm soát thời gian chạy mà không cần chỉnh sửa các tập tin hook. - Lệnh khai thác mới:
/harness-audit,/loop-start,/loop-status,/quality-gate,/model-route. - NanoClaw v2: định tuyến mô hình, tải nóng kỹ năng, nhánh phiên/tìm kiếm/xuất/nhỏ gọn/số liệu.
- Tính chẵn lẻ của khai thác chéo: hành vi được thắt chặt trên ứng dụng Claude Code, Cursor, OpenCode và Codex/CLI.
- 997 bài kiểm tra nội bộ đã vượt qua: bộ màu xanh lá cây đầy đủ sau khi tái cấu trúc hook/runtime và cập nhật khả năng tương thích.
v1.7.0: Trình tạo bản trình bày và mở rộng đa nền tảng (Tháng 2 năm 2026)
- Ứng dụng Codex + hỗ trợ CLI: Trực tiếp
AGENTS.mdhỗ trợ Codex dựa trên, nhắm mục tiêu trình cài đặt và tài liệu Codex frontend-slideskỹ năng: Trình tạo bản trình bày HTML không phụ thuộc với hướng dẫn chuyển đổi PPTX và các quy tắc nghiêm ngặt phù hợp với khung nhìn- 5 kỹ năng kinh doanh/nội dung chung mới:
article-writing,content-engine,market-research,investor-materials,investor-outreach - Phạm vi công cụ rộng hơn: Hỗ trợ Cursor, Codex và OpenCode được thắt chặt để cùng một kho lưu trữ được vận chuyển rõ ràng trên tất cả các khai thác chính
- 992 bài kiểm tra nội bộ: Phạm vi xác thực và hồi quy mở rộng trên plugin, hook, kỹ năng và gói
v1.6.0: Codex CLI, AgentShield và Marketplace (Tháng 2 năm 2026)
- Hỗ trợ Codex CLI: Mới
/codex-setuplệnh tạo racodex.mdđể tương thích với OpenAI Codex CLI - 7 kỹ năng mới:
search-first,swift-actor-persistence,swift-protocol-di-testing,regex-vs-llm-structured-text,content-hash-cache-pattern,cost-aware-llm-pipeline,skill-stocktake - Tích hợp AgentShield:
/security-scanchạy AgentShield trực tiếp từ Claude Code; 1282 bài kiểm tra, 102 quy tắc - Thị trường GitHub: Ứng dụng ECC Tools GitHub trực tiếp tại GitHub.com/marketplace/ecc-tools với các cấp độ miễn phí/chuyên nghiệp/doanh nghiệp
- Hơn 30 PR cộng đồng được hợp nhất: Đóng góp của 30 cộng tác viên trên 6 ngôn ngữ
- 978 bài kiểm tra nội bộ: Bộ xác thực mở rộng trên các tác nhân, kỹ năng, lệnh, hook và quy tắc
v1.4.1: Sửa lỗi (Tháng 2 năm 2026)
- Đã sửa lỗi mất nội dung nhập bản năng:
parse_instinct_file()đã âm thầm loại bỏ tất cả nội dung sau phần chính (các phần Hành động, Bằng chứng, Ví dụ) trong/instinct-import. (#148, #161)
v1.4.0: Quy tắc đa ngôn ngữ, Trình hướng dẫn cài đặt và PM2 (Tháng 2 năm 2026)
- Trình hướng dẫn cài đặt tương tác: Mới
configure-ecckỹ năng cung cấp thiết lập có hướng dẫn với tính năng phát hiện hợp nhất/ghi đè - PM2 và phối hợp đa tác nhân: 6 lệnh mới (
/pm2,/multi-plan,/multi-execute,/multi-backend,/multi-frontend,/multi-workflow) để quản lý quy trình làm việc đa dịch vụ phức tạp - Kiến trúc quy tắc đa ngôn ngữ: Các quy tắc được cơ cấu lại từ tệp phẳng thành
common/+typescript/+python/+golang/thư mục. Chỉ cài đặt những ngôn ngữ bạn cần - Bản dịch tiếng Trung (zh-CN): Bản dịch hoàn chỉnh của tất cả các tác nhân, lệnh, kỹ năng và quy tắc (hơn 80 tệp)
- GitHub Hỗ trợ của nhà tài trợ: Tài trợ dự án thông qua GitHub Nhà tài trợ
- ĐÓNG GÓP nâng cao.md: Mẫu PR chi tiết cho từng loại đóng góp
v1.3.0: Hỗ trợ plugin OpenCode (Tháng 2 năm 2026)
- Tích hợp OpenCode đầy đủ: 12 tác nhân, 24 lệnh, 16 kỹ năng có hỗ trợ hook thông qua hệ thống plugin của OpenCode (hơn 20 loại sự kiện)
- 3 công cụ tùy chỉnh gốc: chạy thử nghiệm, kiểm tra phạm vi bảo hiểm, kiểm toán bảo mật
- tài liệu LLM:
llms.txtđể có tài liệu OpenCode toàn diện
v1.2.0: Lệnh và Kỹ năng Thống nhất (Tháng 2 năm 2026)
- Hỗ trợ Python/Django: Django các kỹ năng về mẫu, bảo mật, TDD và xác minh
- Kỹ năng khởi động Java Spring: Mẫu, bảo mật, TDD và xác minh cho Spring Boot
- Quản lý phiên:
/sessionslệnh cho lịch sử phiên - Học liên tục v2: Học tập dựa trên bản năng với tính năng chấm điểm độ tin cậy, nhập/xuất, tiến hóa
Xem nhật ký thay đổi đầy đủ trong phát hành.
Tại sao chọn ECC?
| Không có hệ thống | Với ECC |
|---|---|
| Các kế hoạch biến mất trong lịch sử trò chuyện | Các kế hoạch trở thành các tạo phẩm có thể chỉnh sửa được trước khi bắt đầu triển khai |
| "Vui lòng sử dụng TDD" là hướng dẫn mà mô hình có thể quên | TDD trở thành quy trình làm việc có kiểm soát ĐỎ -> XANH -> REFACTOR có bằng chứng |
| Bối cảnh tương tự viết và đánh giá mã | Người đánh giá bối cảnh mới tìm kiếm sự hồi quy và điểm mù |
| Bộ nhớ có nghĩa là lưu một bản ghi khổng lồ | Các buổi học được chắt lọc thành các bản tóm tắt, bản năng và các kỹ năng có thể sử dụng lại |
| Kiểm tra chất lượng phụ thuộc vào lời nhắc | Móc có thể thực thi kiểm tra xác định bên ngoài lời nhắc |
| Cấu hình tác nhân được tin cậy theo mặc định | AgentShield tự quét dây nịt như một bề mặt tấn công |
TDD: Phát triển dựa trên thử nghiệm
/ecc:plan "Add usage-based billing alerts"
-> confirm or edit the plan
-> activate tdd-workflow
-> capture RED evidence before implementation
-> implement until GREEN
-> review from fresh context
-> fix findings with regression tests
-> verify build, lint, types, and tests
Kết quả không chỉ là mã. Đó là một dấu vết bằng chứng: kế hoạch, bài kiểm tra thất bại, bài kiểm tra đạt, kết quả đánh giá và xác minh cuối cùng.
Kỹ năng giữ bối cảnh tập trung
Các quy tắc, kỹ năng, tác nhân và cái móc giải quyết các vấn đề khác nhau. Tách biệt các công việc đó là cách ECC bổ sung khả năng mà không đưa toàn bộ kho lưu trữ vào mỗi phiên.
| Khái niệm | Nó làm gì | Hành vi bối cảnh |
|---|---|---|
| Kỹ năng | Các quy trình công việc có thể tái sử dụng như TDD, đánh giá bảo mật hoặc nghiên cứu sâu | Được tải khi tác vụ cần chúng |
| Đại lý | Nhân viên có phạm vi với quyền truy cập công cụ và ngữ cảnh của riêng họ | Tách biệt việc lập kế hoạch, thực hiện và đánh giá |
| Quy tắc | Dự án bền vững hoặc tiêu chuẩn ngôn ngữ | Luôn được tải nên hãy cài đặt chúng một cách có chọn lọc |
| móc | Các tập lệnh được kích hoạt bởi các sự kiện khai thác | Chạy bên ngoài bối cảnh mô hình |
| Bản năng | Các mẫu học được từ các phiên thực tế với điểm tin cậy | Nhớ lại khi có liên quan |
Chia sẻ bối cảnh giữa các khai thác
Memory Vault của ECC cung cấp cho Claude, Codex, Hermes, OpenClaw, Kimi và các khai thác khác một định dạng Markdown cục bộ, có thể kiểm tra để có được bối cảnh và chuyển giao lâu dài. Ký ức về dự án và nhóm vẫn tồn tại .ecc/memory/; ký ức người dùng sống dưới ~/.ecc/memory/.
npm install -g ecc-universal
ecc memory init --scope project
ecc memory search "authentication migration" --target-harness codex
ecc memory doctor
Bộ nhớ là bối cảnh chưa được xem xét, không phải chính sách thực thi. Xác minh các tuyên bố quan trọng dựa trên các nguồn có thẩm quyền và quảng bá kiến thức được chấp nhận vào tài liệu dự án được quản lý. tùy chọn ecc-memory-mcp máy chủ hiển thị cùng một bề mặt lưu, tìm kiếm, đọc và bác sĩ được giới hạn mà không tự kích hoạt theo mặc định.
Mở quy trình làm việc của Bộ nhớ hợp nhất →
Chiều sâu của Memory Vault: phạm vi, chuyển giao và ranh giới tin cậy
Memory Vault lưu trữ di động ecc.memory.v1 Đánh dấu tài liệu thay vì sao chép bản ghi của nhà cung cấp hoặc bối cảnh gửi email giữa các đại lý. Bộ nhớ dự án được bảo vệ bởi cơ chế đóng lỗi .gitignore; chỉ sử dụng phạm vi nhóm để chia sẻ do con người kiểm tra, kiểm soát phiên bản. Ký ức của nhóm vẫn là bối cảnh chưa được xem xét ngay cả sau khi chúng đã được cam kết.
Cài đặt plugin chỉ kỹ năng, tối thiểu, thủ công và Claude không bật thời gian chạy Memory Vault PATH. Cài đặt riêng thời gian chạy npm trước khi sử dụng máy chủ CLI hoặc MCP tùy chọn:
npm install -g ecc-universal
ecc memory --help
command -v ecc-memory-mcp
# Initialize the project vault.
ecc memory init --scope project
# Write a handoff body to a regular file, then target the next harness.
ecc memory handoff \
--from hermes \
--target codex \
--title "Continue authentication migration" \
--body-file ./handoff.md
# Recall it from another harness.
ecc memory search "authentication migration" --target-harness codex
ecc memory read <memory-id>
# Validate the vault before sharing team memories.
ecc memory doctor
Cơ thể ký ức chỉ được chấp nhận thông qua --stdin hoặc --body-file, không phải là giá trị dòng lệnh. Bản phát hành đầu tiên giữ cho mọi mục trong vault không được xem xét và chỉ ở chế độ tạo; Đánh giá của con người thúc đẩy kiến thức được chấp nhận vào tài liệu dự án được quản lý thay vì thay đổi độ tin cậy của bộ nhớ. Việc thu hồi tìm kiếm thông thường sẽ trả về những ký ức về dự án và nhóm đang hoạt động. Việc đọc ID trực tiếp có thể kiểm tra một mục nhập không hoạt động. Việc thu hồi phạm vi người dùng phải được yêu cầu một cách rõ ràng. Các đại lý phải xác minh các tuyên bố quan trọng dựa trên các nguồn có thẩm quyền và không bao giờ được coi các nội dung bị thu hồi là hướng dẫn hoặc chính sách có thể thực thi được.
Để chọn tham gia quyền truy cập MCP, hãy thêm ecc-memory-vault nhập từ mcp-configs/mcp-servers.json đến từng dây nịt cần nó, sau đó chạy ecc-memory-mcp. Máy chủ chỉ hiển thị memory_save, memory_search, memory_readvà memory_doctor. Mỗi máy chủ phải khởi chạy bằng chữ thường ECC_MEMORY_HARNESS danh tính; danh tính bị ràng buộc bởi máy chủ và người gọi công cụ không thể cung cấp. Phạm vi người dùng cũng yêu cầu người vận hành kiểm soát ECC_MEMORY_ALLOW_USER_SCOPE=1 chọn tham gia. Xem skills/unified-memory/SKILL.md cho các ranh giới quy trình công việc và tin cậy, và docs/design/ecc-memory-vault.md đối với hợp đồng năng lực.
Hướng dẫn
Repo này là mã thô. Các hướng dẫn giải thích mọi thứ.
![]() Hướng dẫn viết tắt Thiết lập, nền tảng và sử dụng hàng ngày. Đọc cái này trước. (chủ đề) |
![]() Hướng dẫn dạng dài Kinh tế bối cảnh, bộ nhớ, đánh giá và các tác nhân song song. (chủ đề) |
![]() Hướng dẫn bảo mật Nhắc nhở, móc, MCP và AgentShield. (chủ đề) |
| chủ đề | Bạn sẽ học được gì |
|---|---|
| Tối ưu hóa mã thông báo | Lựa chọn mô hình, giảm thiểu nhắc nhở hệ thống, xử lý nền |
| Sự kiên trì của bộ nhớ | Móc tự động lưu/tải ngữ cảnh qua các phiên |
| Học tập liên tục | Tự động trích xuất các mẫu từ các phiên thành các kỹ năng có thể sử dụng lại |
| Vòng xác minh | Điểm kiểm tra so với đánh giá liên tục, loại trình chấm điểm, số liệu pass@k |
| Song song hóa | Cây làm việc Git, phương thức xếp tầng, thời điểm mở rộng quy mô phiên bản |
| Phối hợp phụ | Vấn đề ngữ cảnh, mô hình truy xuất lặp |
Lệnh tham khảo nhanh | Hướng dẫn điều chỉnh thủ công
Có gì bên trong
ECC/
|-- agents/ # 68 specialized subagents for delegation
|-- skills/ # 284 reusable workflows loaded on demand
|-- commands/ # 94 maintained slash-command shims
|-- rules/ # opt-in common and language standards
|-- hooks/ # runtime automation and enforcement
|-- scripts/ # install, repair, sync, orchestration, and checks
|-- .claude-plugin/ # Claude Code marketplace manifest
|-- .codex/ # Codex reference configuration and agent roles
|-- .opencode/ # OpenCode plugin, commands, and instructions
|-- .cursor/ # Cursor rules and hook adapter
|-- docs/ # public setup, architecture, and operating guides
Gốc rễ là nguồn gốc của sự thật. Bộ điều hợp nền tảng đóng gói hoặc ánh xạ các quy trình công việc tương tự này thay vì duy trì các bản sao riêng biệt.
Danh mục thành phần có chú thích
ECC/
|-- .claude-plugin/ # Plugin and marketplace manifests
| |-- plugin.json # Plugin metadata and component paths
| |-- marketplace.json # Marketplace catalog for /plugin marketplace add
|
|-- agents/ # 67 specialized subagents for delegation
| |-- planner.md # Feature implementation planning
| |-- architect.md # System design decisions
| |-- tdd-guide.md # Test-driven development
| |-- code-reviewer.md # Quality and security review
| |-- security-reviewer.md # Vulnerability analysis
| |-- build-error-resolver.md
| |-- e2e-runner.md # Playwright E2E testing
| |-- refactor-cleaner.md # Dead code cleanup
| |-- doc-updater.md # Documentation sync
| |-- docs-lookup.md # Documentation/API lookup
| |-- chief-of-staff.md # Communication triage and drafts
| |-- loop-operator.md # Autonomous loop execution
| |-- harness-optimizer.md # Harness config tuning
| |-- cpp-reviewer.md # C++ code review
| |-- cpp-build-resolver.md # C++ build error resolution
| |-- fsharp-reviewer.md # F# functional code review
| |-- go-reviewer.md # Go code review
| |-- go-build-resolver.md # Go build error resolution
| |-- python-reviewer.md # Python code review
| |-- database-reviewer.md # Database/Supabase review
| |-- typescript-reviewer.md # TypeScript/JavaScript code review
| |-- java-reviewer.md # Java/Spring Boot code review
| |-- java-build-resolver.md # Java/Maven/Gradle build errors
| |-- kotlin-reviewer.md # Kotlin/Android/KMP code review
| |-- kotlin-build-resolver.md # Kotlin/Gradle build errors
| |-- harmonyos-app-resolver.md # HarmonyOS/ArkTS app development
| |-- rust-reviewer.md # Rust code review
| |-- rust-build-resolver.md # Rust build error resolution
| |-- pytorch-build-resolver.md # PyTorch/CUDA training errors
| |-- mle-reviewer.md # Production ML pipeline, eval, serving, and monitoring review
|
|-- skills/ # Workflow definitions and domain knowledge
| |-- coding-standards/ # Language best practices
| |-- clickhouse-io/ # ClickHouse analytics, queries, data engineering
| |-- backend-patterns/ # API, database, caching patterns
| |-- frontend-patterns/ # React, Next.js patterns
| |-- frontend-slides/ # HTML slide decks and PPTX-to-web presentation workflows
| |-- article-writing/ # Long-form writing in a supplied voice without generic AI tone
| |-- content-engine/ # Multi-platform social content and repurposing workflows
| |-- market-research/ # Source-attributed market, competitor, and investor research
| |-- investor-materials/ # Pitch decks, one-pagers, memos, and financial models
| |-- investor-outreach/ # Personalized fundraising outreach and follow-up
| |-- continuous-learning/ # Legacy v1 Stop-hook pattern extraction
| |-- continuous-learning-v2/ # Instinct-based learning with confidence scoring
| |-- iterative-retrieval/ # Progressive context refinement for subagents
| |-- strategic-compact/ # Manual compaction suggestions (Longform Guide)
| |-- tdd-workflow/ # TDD methodology
| |-- security-review/ # Security checklist
| |-- eval-harness/ # Verification loop evaluation (Longform Guide)
| |-- verification-loop/ # Continuous verification (Longform Guide)
| |-- videodb/ # Video and audio: ingest, search, edit, generate, stream
| |-- golang-patterns/ # Go idioms and best practices
| |-- golang-testing/ # Go testing patterns, TDD, benchmarks
| |-- cpp-coding-standards/ # C++ coding standards from C++ Core Guidelines
| |-- cpp-testing/ # C++ testing with GoogleTest, CMake/CTest
| |-- django-patterns/ # Django patterns, models, views
| |-- django-security/ # Django security best practices
| |-- django-tdd/ # Django TDD workflow
| |-- django-verification/ # Django verification loops
| |-- laravel-patterns/ # Laravel architecture patterns
| |-- laravel-security/ # Laravel security best practices
| |-- laravel-tdd/ # Laravel TDD workflow
| |-- laravel-verification/ # Laravel verification loops
| |-- python-patterns/ # Python idioms and best practices
| |-- python-testing/ # Python testing with pytest
| |-- quarkus-patterns/ # Java Quarkus patterns
| |-- quarkus-security/ # Quarkus security
| |-- quarkus-tdd/ # Quarkus TDD
| |-- quarkus-verification/ # Quarkus verification
| |-- springboot-patterns/ # Java Spring Boot patterns
| |-- springboot-security/ # Spring Boot security
| |-- springboot-tdd/ # Spring Boot TDD
| |-- springboot-verification/ # Spring Boot verification
| |-- configure-ecc/ # Interactive installation wizard
| |-- security-scan/ # AgentShield security auditor integration
| |-- java-coding-standards/ # Java coding standards
| |-- jpa-patterns/ # JPA/Hibernate patterns
| |-- postgres-patterns/ # PostgreSQL optimization patterns
| |-- nutrient-document-processing/ # Document processing with Nutrient API
| |-- database-migrations/ # Migration patterns (Prisma, Drizzle, Django, Go)
| |-- api-design/ # REST API design, pagination, error responses
| |-- deployment-patterns/ # CI/CD, Docker, health checks, rollbacks
| |-- docker-patterns/ # Docker Compose, networking, volumes, container security
| |-- e2e-testing/ # Playwright E2E patterns and Page Object Model
| |-- content-hash-cache-pattern/ # SHA-256 content hash caching for file processing
| |-- cost-aware-llm-pipeline/ # LLM cost optimization, model routing, budget tracking
| |-- regex-vs-llm-structured-text/ # Decision framework: regex vs LLM for text parsing
| |-- swift-actor-persistence/ # Thread-safe Swift data persistence with actors
| |-- swift-protocol-di-testing/ # Protocol-based DI for testable Swift code
| |-- search-first/ # Research-before-coding workflow
| |-- skill-stocktake/ # Audit skills and commands for quality
| |-- liquid-glass-design/ # iOS 26 Liquid Glass design system
| |-- foundation-models-on-device/ # Apple on-device LLM with FoundationModels
| |-- swift-concurrency-6-2/ # Swift 6.2 Approachable Concurrency
| |-- mle-workflow/ # Production ML data contracts, evals, deployment, monitoring
| |-- perl-patterns/ # Modern Perl 5.36+ idioms and best practices
| |-- perl-security/ # Perl security patterns, taint mode, safe I/O
| |-- perl-testing/ # Perl TDD with Test2::V0, prove, Devel::Cover
| |-- autonomous-loops/ # Autonomous loop patterns: sequential pipelines, PR loops, DAG orchestration
| |-- plankton-code-quality/ # Write-time code quality enforcement with Plankton hooks
| |-- codehealth-mcp/ # Optional CodeScene Code Health MCP skill (opt-in)
| |-- docs/examples/project-guidelines-template.md # Template for project-specific skills
|
|-- commands/ # Maintained slash-entry compatibility; prefer skills/
| |-- plan.md # /plan - Implementation planning
| |-- code-review.md # /code-review - Quality review
| |-- build-fix.md # /build-fix - Fix build errors
| |-- refactor-clean.md # /refactor-clean - Dead code removal
| |-- quality-gate.md # /quality-gate - Verification gate
| |-- learn.md # /learn - Extract patterns mid-session (Longform Guide)
| |-- learn-eval.md # /learn-eval - Extract, evaluate, and save patterns
| |-- checkpoint.md # /checkpoint - Save verification state (Longform Guide)
| |-- setup-pm.md # /setup-pm - Configure package manager
| |-- go-review.md # /go-review - Go code review
| |-- go-test.md # /go-test - Go TDD workflow
| |-- go-build.md # /go-build - Fix Go build errors
| |-- skill-create.md # /skill-create - Generate skills from git history
| |-- instinct-status.md # /instinct-status - View learned instincts
| |-- instinct-import.md # /instinct-import - Import instincts
| |-- instinct-export.md # /instinct-export - Export instincts
| |-- evolve.md # /evolve - Cluster instincts into skills
| |-- prune.md # /prune - Delete expired pending instincts
| |-- pm2.md # /pm2 - PM2 service lifecycle management
| |-- multi-plan.md # /multi-plan - Multi-agent task decomposition
| |-- multi-execute.md # /multi-execute - Orchestrated multi-agent workflows
| |-- multi-backend.md # /multi-backend - Backend multi-service orchestration
| |-- multi-frontend.md # /multi-frontend - Frontend multi-service orchestration
| |-- multi-workflow.md # /multi-workflow - General multi-service workflows
| |-- sessions.md # /sessions - Session history management
| |-- test-coverage.md # /test-coverage - Test coverage analysis
| |-- update-docs.md # /update-docs - Update documentation
| |-- update-codemaps.md # /update-codemaps - Update codemaps
| |-- python-review.md # /python-review - Python code review
|-- legacy-command-shims/ # Opt-in archive for retired shims such as /tdd and /eval
| |-- tdd.md # /tdd - Prefer the tdd-workflow skill
| |-- e2e.md # /e2e - Prefer the e2e-testing skill
| |-- eval.md # /eval - Prefer the eval-harness skill
| |-- verify.md # /verify - Prefer the verification-loop skill
| |-- orchestrate.md # /orchestrate - Prefer dmux-workflows or multi-workflow
|
|-- rules/ # Always-follow guidelines (copy to ~/.claude/rules/ecc/)
| |-- README.md # Structure overview and installation guide
| |-- common/ # Language-agnostic principles
| | |-- coding-style.md # Immutability, file organization
| | |-- git-workflow.md # Commit format, PR process
| | |-- testing.md # TDD, 80% coverage requirement
| | |-- performance.md # Model selection, context management
| | |-- patterns.md # Design patterns, skeleton projects
| | |-- hooks.md # Hook architecture, TodoWrite
| | |-- agents.md # When to delegate to subagents
| | |-- security.md # Mandatory security checks
| |-- typescript/ # TypeScript/JavaScript specific
| |-- python/ # Python specific
| |-- golang/ # Go specific
| |-- swift/ # Swift specific
| |-- php/ # PHP specific
| |-- arkts/ # HarmonyOS / ArkTS specific
|
|-- hooks/ # Trigger-based automations
| |-- README.md # Hook documentation, recipes, and customization guide
| |-- hooks.json # All hooks config (PreToolUse, PostToolUse, Stop, etc.)
| |-- memory-persistence/ # Session lifecycle hooks (Longform Guide)
| |-- strategic-compact/ # Compaction suggestions (Longform Guide)
|
|-- scripts/ # Cross-platform Node.js scripts
| |-- lib/ # Shared utilities
| | |-- utils.js # Cross-platform file/path/system utilities
| | |-- package-manager.js # Package manager detection and selection
| |-- hooks/ # Hook implementations
| | |-- session-start.js # Load context on session start
| | |-- session-end.js # Save state on session end
| | |-- pre-compact.js # Pre-compaction state saving
| | |-- suggest-compact.js # Strategic compaction suggestions
| | |-- evaluate-session.js # Extract patterns from sessions
| |-- setup-package-manager.js # Interactive PM setup
|
|-- tests/ # Test suite
| |-- lib/ # Library tests
| |-- hooks/ # Hook tests
| |-- run-all.js # Run all tests
|
|-- contexts/ # Dynamic system prompt injection contexts (Longform Guide)
| |-- dev.md # Development mode context
| |-- review.md # Code review mode context
| |-- research.md # Research/exploration mode context
|
|-- examples/ # Example configurations and sessions
| |-- CLAUDE.md # Example project-level config
| |-- user-CLAUDE.md # Example user-level config
| |-- saas-nextjs-CLAUDE.md # Real-world SaaS (Next.js + Supabase + Stripe)
| |-- go-microservice-CLAUDE.md # Real-world Go microservice (gRPC + PostgreSQL)
| |-- django-api-CLAUDE.md # Real-world Django REST API (DRF + Celery)
| |-- laravel-api-CLAUDE.md # Real-world Laravel API (PostgreSQL + Redis)
| |-- rust-api-CLAUDE.md # Real-world Rust API (Axum + SQLx + PostgreSQL)
|
|-- mcp-configs/ # MCP server configurations
| |-- mcp-servers.json # GitHub, Supabase, Vercel, Railway, etc.
|
|-- ecc_dashboard.py # Desktop GUI dashboard (Tkinter)
|
|-- marketplace.json # Self-hosted marketplace config (for /plugin marketplace add)
GUI trang tổng quan
Khởi chạy bảng thông tin trên máy tính để bàn để khám phá trực quan các thành phần ECC:
npm run dashboard
# or
python3 ./ecc_dashboard.py
Tính năng:
- Giao diện theo thẻ: Đại lý, Kỹ năng, Lệnh, Quy tắc, Cài đặt
- Chuyển đổi chủ đề tối/sáng
- Tùy chỉnh phông chữ (họ và kích thước)
- Logo dự án ở tiêu đề và thanh tác vụ
- Tìm kiếm và lọc trên tất cả các thành phần
Công cụ hệ sinh thái
Skill Creator: tạo kỹ năng từ lịch sử git của bạn
Hai cách để tạo kỹ năng từ kho lưu trữ của bạn:
Tùy chọn A: Phân tích cục bộ (Tích hợp sẵn)
Sử dụng /skill-create lệnh phân tích cục bộ mà không cần dịch vụ bên ngoài:
/skill-create # Analyze current repo
/skill-create --instincts # Also generate instincts for continuous-learning-v2
Điều này phân tích lịch sử git của bạn cục bộ và tạo các tệp SKILL.md.
Tùy chọn B: Ứng dụng GitHub (Nâng cao)
Đối với các tính năng nâng cao (10k+ cam kết, PR tự động, chia sẻ nhóm):
Cài đặt ứng dụng ECC Tools GitHub | ecc.tools
# Comment on any issue:
/ecc-tools analyze
Cả hai tùy chọn đều tạo:
- tập tin SKILL.md: Các kỹ năng sẵn sàng sử dụng cho dây đai chủ động
- Bộ sưu tập bản năng: Dành cho việc học liên tục-v2
- Trích xuất mẫu: Học hỏi từ lịch sử cam kết của bạn
AgentShield: kiểm tra bảo mật cho cấu hình tác nhân
Được xây dựng tại Claude Code Hackathon (Cerebral Valley x Anthropic, tháng 2 năm 2026). 1282 bài kiểm tra, độ bao phủ 98%, 102 quy tắc phân tích tĩnh.
Quét cấu hình tác nhân của bạn để tìm lỗ hổng, cấu hình sai và rủi ro tiêm nhiễm.
# Quick scan (no install needed)
npx ecc-agentshield scan
# Auto-fix safe issues
npx ecc-agentshield scan --fix
# Deep analysis with three Opus 4.6 agents
npx ecc-agentshield scan --opus --stream
# Generate secure config from scratch
npx ecc-agentshield init
Những gì nó quét: Claude.md, settings.JSON, MCP cấu hình, hook, định nghĩa tác nhân và kỹ năng trong 5 danh mục: phát hiện bí mật (14 mẫu), kiểm tra quyền, phân tích chèn hook, lập hồ sơ rủi ro máy chủ MCP và xem xét cấu hình tác nhân.
các --opus cờ điều hành ba tác nhân Claude Opus 4.6 trong quy trình nhóm đỏ/nhóm xanh/kiểm toán viên. Kẻ tấn công tìm thấy chuỗi khai thác, người bảo vệ đánh giá các biện pháp bảo vệ và kiểm toán viên tổng hợp cả hai thành đánh giá rủi ro ưu tiên. Lập luận đối nghịch, không chỉ khớp mẫu.
Các định dạng đầu ra: Thiết bị đầu cuối (được phân loại màu A-F), JSON (đường dẫn CI), Markdown, HTML. Mã thoát 2 đối với các phát hiện quan trọng đối với cổng xây dựng.
sử dụng /security-scan trong Claude Code để chạy nó hoặc thêm vào CI bằng GitHub Hành động.
Học tập liên tục v2: bản năng
Hệ thống học tập dựa trên bản năng sẽ tự động học các mẫu của bạn:
/instinct-status # Show learned instincts with confidence
/instinct-import <file> # Import instincts from others
/instinct-export # Export your instincts for sharing
/evolve # Cluster related instincts into skills
Xem skills/continuous-learning-v2/ để có tài liệu đầy đủ. Giữ continuous-learning/ chỉ khi bạn rõ ràng muốn luồng kỹ năng đã học theo kiểu Stop-hook v1 kế thừa.
Các khái niệm chính
Đại lý, kỹ năng, móc và quy tắc được giải thích
Đại lý
Các đại lý phụ xử lý các nhiệm vụ được ủy quyền với phạm vi hạn chế. Ví dụ:
---
name: code-reviewer
description: Reviews code for quality, security, and maintainability
tools: Read, Grep, Glob, Bash
model: opus
---
You are a senior code reviewer...
Kỹ năng
Kỹ năng là bề mặt công việc chính. Chúng có thể được gọi trực tiếp, được đề xuất tự động và được các tác nhân sử dụng lại. ECC vẫn duy trì tàu commands/ trong quá trình di chuyển, trong khi các miếng chêm tên viết tắt đã nghỉ hưu sống dưới legacy-command-shims/ chỉ dành cho việc chọn tham gia rõ ràng. Việc phát triển quy trình làm việc mới sẽ được triển khai skills/ đầu tiên.
# TDD Workflow
1. Define interfaces first
2. Write failing tests (RED)
3. Implement minimal code (GREEN)
4. Refactor (IMPROVE)
5. Verify 80%+ coverage
móc
Móc lửa vào các sự kiện công cụ. Ví dụ: cảnh báo về console.log:
{
"matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(ts|tsx|js|jsx)$\"",
"hooks": [{
"type": "command",
"command": "#!/bin/bash\ngrep -n 'console\\.log' \"$file_path\" && echo '[Hook] Remove console.log' >&2"
}]
}
Quy tắc
Các quy tắc là những hướng dẫn luôn được tuân theo, được tổ chức thành common/ (ngôn ngữ bất khả tri) + thư mục dành riêng cho ngôn ngữ:
rules/
common/ # Universal principles (always install)
typescript/ # TS/JS specific patterns and tools
python/ # Python specific patterns and tools
golang/ # Go specific patterns and tools
swift/ # Swift specific patterns and tools
php/ # PHP specific patterns and tools
arkts/ # HarmonyOS / ArkTS patterns and constraints
Xem rules/README.md để biết chi tiết lắp đặt và kết cấu.
Hỗ trợ đa nền tảng
Lõi của ECC Node.js CLI và trình cài đặt được quản lý chạy trên Windows, macOS và Linux, nhưng các khả năng tùy chọn không hoàn toàn ngang bằng. Một số lộ trình học tập liên tục, GAN và điều phối vẫn yêu cầu Bash hoặc Python; các bộ khai thác cũng hiển thị các API hook, tác nhân và kỹ năng khác nhau.
| Nền tảng | Trạng thái | Giới hạn hiện tại |
|---|---|---|
| Linux | Lõi được hỗ trợ | Các tính năng tùy chọn có thể yêu cầu Bash, Python hoặc các công cụ dành riêng cho nhà cung cấp. |
| macOS | Lõi được hỗ trợ | Đường dẫn shell GAN độc lập không tương thích với hệ thống Bash 3.2 và hiện có lỗi phân tích điểm (#2674). |
| Windows + WSL | Lõi được hỗ trợ | WSL đi theo con đường Linux; Việc tích hợp máy chủ Windows vẫn khác nhau tùy theo cách khai thác. |
| Windows gốc | Được hỗ trợ với những hạn chế | Trình nền quan sát và ghi kho bộ nhớ của v2 học liên tục có các lỗi mở của Windows gốc (#2489, #2626). Các tính năng tùy chọn được Shell hỗ trợ yêu cầu Git Bash/WSL hoặc không khả dụng. |
điều trị stable, beta, experimentalvà instruction-only bên dưới dưới dạng tuyên bố về năng lực, không phải cấp độ tiếp thị.
Phát hiện trình quản lý gói
Plugin tự động phát hiện trình quản lý gói ưa thích của bạn (npm, pnpm, sợi hoặc Bun) với mức độ ưu tiên sau:
- Biến môi trường:
CLAUDE_PACKAGE_MANAGER - Cấu hình dự án:
.claude/package-manager.json - gói.JSON:
packageManagerlĩnh vực - Khóa tập tin: Phát hiện từ gói-lock.JSON, sợi.lock, pnpm-lock.YAML hoặc Bun.lockb
- Cấu hình chung:
~/.claude/package-manager.json - Dự phòng: Trình quản lý gói có sẵn đầu tiên
Để đặt trình quản lý gói ưa thích của bạn:
# Via environment variable
export CLAUDE_PACKAGE_MANAGER=pnpm
# Via global config
node scripts/setup-package-manager.js --global pnpm
# Via project config
node scripts/setup-package-manager.js --project bun
# Detect current setting
node scripts/setup-package-manager.js --detect
Hoặc sử dụng /setup-pm lệnh.
Kiểm soát thời gian chạy hook (env vars)
Sử dụng cờ thời gian chạy để điều chỉnh mức độ nghiêm ngặt hoặc tạm thời vô hiệu hóa các móc cụ thể:
# Hook strictness profile (default: standard)
export ECC_HOOK_PROFILE=standard
# Comma-separated hook IDs to disable
export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"
# Cap SessionStart additional context (default: 8000 chars)
export ECC_SESSION_START_MAX_CHARS=4000
# Disable SessionStart additional context entirely for low-context/local-model setups
export ECC_SESSION_START_CONTEXT=off
# Session-tmp retention window in days (default: 30).
# Set to 0, off, false, disabled, never, or none to keep all sessions (disable pruning).
export ECC_SESSION_RETENTION_DAYS=14
# Cap how many learned instincts SessionStart injects into context (default: 6)
export ECC_MAX_INJECTED_INSTINCTS=6
# Minimum confidence an instinct needs to be injected, 0-1 (default: 0.7)
export ECC_INSTINCT_CONFIDENCE_THRESHOLD=0.7
# SessionStart ranks injected instincts by confidence + project/stack relevance
# (default: on). Project-scoped instincts, and instincts whose domain/trigger
# matches the detected stack (languages, frameworks, plus terraform/dbt markers),
# get a small ranking boost so they surface above unrelated higher-confidence
# ones. Set to off/false/0/no to rank by confidence alone.
export ECC_INSTINCT_RELEVANCE_RANKING=on
# Keep context/scope/loop warnings but suppress API-rate cost estimates
export ECC_CONTEXT_MONITOR_COST_WARNINGS=off
Windows PowerShell:
[Environment]::SetEnvironmentVariable('ECC_CONTEXT_MONITOR_COST_WARNINGS', 'off', 'User')
[Environment]::SetEnvironmentVariable('ECC_SESSION_RETENTION_DAYS', '14', 'User')
Nhà dữ liệu tác nhân (cách ly nhiều dây)
Các móc nối lưu trữ bộ nhớ (tóm tắt phiên, kỹ năng đã học, bí danh phiên, số liệu) lưu trữ dữ liệu dưới một gốc dữ liệu tác nhân duy nhất. Theo mặc định gốc đó là ~/.claude. Khi bạn sử dụng ECC trong cả Claude Code và Cursor trên cùng một máy, hãy đặt gốc riêng cho Cursor để hai môi trường không ghi đè lên tệp phiên của nhau:
# Cursor-only boundary (Claude Code keeps the default ~/.claude)
export ECC_AGENT_DATA_HOME="$HOME/.cursor/ecc"
Các đường dẫn được giải quyết dưới gốc đó bao gồm:
$ECC_AGENT_DATA_HOME/session-data/: tóm tắt phiên$ECC_AGENT_DATA_HOME/skills/learned/: các kỹ năng học được từ buổi đánh giá$ECC_AGENT_DATA_HOME/session-aliases.json: bí danh phiên$ECC_AGENT_DATA_HOME/metrics/: số liệu chi phí và hoạt động
Xem affaan-m/ECC#2065.
Hỗ trợ nền tảng
| Khai thác | Trạng thái | Phân phối được đề xuất | Hạn chế quan trọng |
|---|---|---|---|
| Claude Code | Sơ cấp ổn định | Plugin hoặc trình cài đặt chọn lọc | Plugin quảng cáo danh mục đã cài đặt cho mô hình; sử dụng hồ sơ chọn lọc/thủ công khi dấu chân bối cảnh có vấn đề. Các kỹ năng hỗ trợ shell tùy chọn không có sẵn cho mọi hệ điều hành. |
| Codex | Đồng bộ hóa được hỗ trợ; thị trường thử nghiệm | Cấu hình lại hoặc sync-ecc-to-codex.sh |
Không có thời gian chạy móc ECC. Gói thị trường có thể bỏ qua nội dung kho lưu trữ được chia sẻ khỏi bộ đệm của Codex; sử dụng đồng bộ hóa cho đường dẫn đáng tin cậy. |
| Cursor | Bộ điều hợp dự án Beta | Chọn lọc trình cài đặt vào .cursor/ |
Khám phá tác nhân thay đổi tùy theo bản dựng Cursor và đường dẫn trình cài đặt của ECC chưa hiển thị các bộ móc giống hệt nhau (#2419). |
| Mã mở | Plugin được xây dựng beta | Xây dựng plugin, sau đó chọn trình cài đặt | ECC gửi một tập hợp con của danh mục và các mô hình chân cấu hình tham chiếu Anthropic; chọn các mô hình có sẵn cho nhà cung cấp của bạn (#2617). |
| GitHub Copilot | Chỉ hướng dẫn | Hướng dẫn đăng ký và tệp nhắc nhở | Không có móc ECC, tác nhân thời gian chạy, ủy quyền hoặc khám phá kỹ năng gốc. |
| Gemini, Zed, Phản trọng lực, Qwen, Hermes, OpenClaw, Kimi, CodeBuddy, JoyCode | Bộ điều hợp thử nghiệm/tối thiểu | Mục tiêu chọn lọc dành riêng cho việc khai thác | Vị trí tập tin và khả năng di chuyển của lệnh được kiểm tra; tính chẵn lẻ đầy đủ của tính năng Claude không được yêu cầu. |
Bản đồ khả năng của nhiều công cụ
| Khả năng | Claude Code | Codex | Cursor | Mã mở | GitHub Copilot |
|---|---|---|---|---|---|
| Hướng dẫn | Bản địa | Bản địa AGENTS.md |
Quy tắc dự án | Hướng dẫn bổ trợ | Tệp hướng dẫn gốc |
| Kỹ năng | Bộ cài đặt gốc | Bộ được đồng bộ hóa gốc | Bộ dự án/phụ thuộc vào bản dựng | Tập hợp con được xây dựng | Chỉ tham khảo lời nhắc/hướng dẫn |
| Đại lý/ủy đoàn | Đại lý bản địa | Vai trò đa tác nhân của Codex | Đại lý dự án phụ thuộc vào xây dựng | Đại lý plugin | Không được hỗ trợ |
| móc ECC | Móc plugin gốc | Không được hỗ trợ | Bộ chuyển đổi móc Cursor; vẫn còn sự khác biệt về đường dẫn cài đặt | Sự kiện plugin | Không được hỗ trợ |
| Cấu hình MCP | Có sẵn, kích hoạt rõ ràng | Hợp nhất TOML thông qua đồng bộ hóa | Cấu hình dự án/người dùng rõ ràng | Cấu hình nhà cung cấp/plugin | Không được cung cấp bởi ECC |
| Ngang bằng với Claude Code | Tài liệu tham khảo chính | một phần | một phần | một phần | Không phải là mục tiêu ngang bằng |
Các quyết định kiến trúc quan trọng:
- ĐẠI LÝ.md tại thư mục gốc là tệp công cụ đa năng (được đọc bởi Claude Code, Cursor, Codex và OpenCode; GitHub Copilot sử dụng
.github/copilot-instructions.mdthay vào đó) - Mẫu bộ chuyển đổi DRY cho phép Cursor sử dụng lại tập lệnh hook của Claude Code mà không bị trùng lặp
- dạng kỹ năng (SKILL.md với frontmatter YAML) hoạt động trên Claude Code, Codex và OpenCode
- Việc thiếu hook của Codex được bù đắp bằng
AGENTS.md, tùy chọnmodel_instructions_fileghi đè và quyền hộp cát
Cursor Hỗ trợ IDE chuyên sâu
ECC cung cấp hỗ trợ IDE Cursor với các hook, quy tắc, tác nhân, kỹ năng, lệnh và cấu hình MCP được điều chỉnh cho phù hợp với bố cục dự án của Cursor.
# macOS/Linux
./install.sh --target cursor typescript
./install.sh --target cursor python golang swift php
# Windows PowerShell
.\install.ps1 --target cursor typescript
.\install.ps1 --target cursor python golang swift php
Bao gồm những gì cho Cursor
| thành phần | Đếm | Chi tiết |
|---|---|---|
| Sự kiện móc nối | 15 | sessionStart, beforeShellExecution, afterFileEdit, beforeMCPEexecution, beforeSubmitPrompt và 10 phiên bản khác |
| Tập lệnh móc | 16 | Các tập lệnh Node.js mỏng ủy quyền cho scripts/hooks/ thông qua bộ điều hợp chia sẻ |
| Quy tắc | 34 | 9 ngôn ngữ chung (luôn áp dụng) + 25 ngôn ngữ cụ thể (TypeScript, Python, Go, Swift, PHP) |
| Đại lý | 48 | .cursor/agents/ecc-*.md khi cài đặt; được đặt trước để tránh xung đột với người dùng hoặc đại lý thị trường |
| Kỹ năng | Chia sẻ + Đi kèm | .cursor/skills/ để bổ sung dịch |
| Lệnh | Đã chia sẻ | .cursor/commands/ nếu được cài đặt |
| Cấu hình MCP | Đã chia sẻ | .cursor/mcp.json nếu được cài đặt |
Cursor ghi chú đang tải
ECC không cài root AGENTS.md vào .cursor/. Cursor xử lý lồng nhau AGENTS.md các tệp dưới dạng ngữ cảnh thư mục, do đó việc sao chép danh tính repo của ECC vào dự án máy chủ sẽ gây ô nhiễm dự án đó.
Cursor-hành vi tải gốc có thể thay đổi tùy theo bản dựng Cursor. ECC cài đặt các đại lý như .cursor/agents/ecc-*.md; nếu bản dựng Cursor của bạn không hiển thị tác nhân dự án thì các tệp đó vẫn hoạt động dưới dạng định nghĩa tham chiếu rõ ràng thay vì ngữ cảnh nhắc chung ẩn.
Cách ly bộ nhớ và dữ liệu (Cursor + Claude Code)
Móc bộ nhớ ECC tái sử dụng giống nhau scripts/hooks/*.js là Claude Code. Đối với Cursor, ECC cố gắng giữ bộ nhớ ra khỏi ~/.claude tự động:
- Cursor
sessionStartcái móc (được cài đặt vào.cursor/hooks.jsontrên--target cursor) tiêmECC_AGENT_DATA_HOMEcho toàn bộ phiên soạn nhạc. - Mặc định thời gian chạy hook: khi nào
CURSOR_VERSIONhoặcCURSOR_PROJECT_DIRhiện diện, móc mặc định là~/.cursor/eccnếu var env không được đặt. - Cấu hình dự án:
.cursor/ecc-agent-data.jsontài liệu và ghi đè đường dẫn (agentDataHome). - Quy tắc luôn bật:
.cursor/rules/ecc-agent-data-home.mdcnhắc nhở tác nhân nơi bộ nhớ sống.
Bạn vẫn có thể ghi đè rõ ràng:
export ECC_AGENT_DATA_HOME="$HOME/.cursor/ecc"
Đến chia sẻ bộ nhớ có mục đích Claude Code, thiết lập ECC_AGENT_DATA_HOME=~/.claude trong vỏ hoặc trong .cursor/ecc-agent-data.json.
Bản năng học tập liên tục v2 vẫn tách biệt theo CLV2_HOMUNCULUS_DIR (mặc định ~/.local/share/ecc-homunculus).
Kiến trúc móc (mẫu bộ chuyển đổi DRY)
Cursor có nhiều sự kiện hấp dẫn hơn Claude Code (20 so với 8). các .cursor/hooks/adapter.js mô-đun chuyển đổi stdin JSON của Cursor sang định dạng của Claude Code, cho phép hiện có scripts/hooks/*.js để có thể tái sử dụng mà không bị trùng lặp.
Cursor stdin JSON -> adapter.js -> transforms -> scripts/hooks/*.js
(shared with Claude Code)
Móc chìa khóa:
- beforeShellExecution: Chặn máy chủ dev bên ngoài tmux (lối ra 2), đánh giá git push
- afterFileEdit: Tự động định dạng + kiểm tra TypeScript + cảnh báo console.log
- trướcGửiPrompt: Phát hiện bí mật (mẫu sk-, ghp_, AKIA) trong lời nhắc
- trướcTabFileĐọc: Chặn Tab đọc các file .env, .key, .pem (thoát 2)
- beforeMCPExecution / afterMCPExecution: ghi nhật ký kiểm tra MCP
Định dạng quy tắc
Quy tắc Cursor sử dụng tiền đề YAML với description, globsvà alwaysApply:
---
description: "TypeScript coding style extending common rules"
globs: ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx"]
alwaysApply: false
---
Ứng dụng Codex macOS + hỗ trợ CLI chuyên sâu
ECC cung cấp đường dẫn đồng bộ/repo Codex được hỗ trợ cho ứng dụng macOS và CLI, với cấu hình tham chiếu, phần bổ sung AGENTS.md dành riêng cho Codex và các kỹ năng được chia sẻ. Lộ trình thị trường ECC vẫn còn thử nghiệm. Để điều hướng repo, quyền sở hữu bề mặt và hướng dẫn gói PR khác biệt, hãy bắt đầu với docs/CODEX-NAVIGATION-GUIDE.md.
# Run Codex CLI in the repo: AGENTS.md and .codex/ are auto-detected
codex
# Automatic setup: sync ECC assets (AGENTS.md, skills, MCP servers) into ~/.codex
npm install && bash scripts/sync-ecc-to-codex.sh
# Or manually: copy the reference config to your home directory
cp .codex/config.toml ~/.codex/config.toml
Tập lệnh đồng bộ hóa sẽ hợp nhất các máy chủ ECC MCP một cách an toàn vào máy chủ hiện có của bạn ~/.codex/config.toml sử dụng một chỉ bổ sung chiến lược: nó không bao giờ loại bỏ hoặc sửa đổi các máy chủ hiện có của bạn. Chạy với --dry-run để xem trước các thay đổi, hoặc --update-mcp để buộc làm mới máy chủ ECC về cấu hình được đề xuất mới nhất.
Đối với Context7, ECC sử dụng tên phần Codex chuẩn [mcp_servers.context7] trong khi vẫn khởi chạy @upstash/context7-mcp gói. Nếu bạn đã có một di sản [mcp_servers.context7-mcp] nhập cảnh, --update-mcp di chuyển nó sang tên phần chuẩn.
Ứng dụng Codex macOS:
- Mở kho lưu trữ này làm không gian làm việc của bạn.
- Gốc
AGENTS.mdđược tự động phát hiện. .codex/config.tomlvà.codex/agents/*.tomlhoạt động tốt nhất khi giữ dự án cục bộ.- Tài liệu tham khảo
.codex/config.tomlcố tình không ghimmodelhoặcmodel_provider, vì vậy Codex sử dụng mặc định hiện tại của chính nó trừ khi bạn ghi đè lên nó. - Tùy chọn: sao chép
.codex/config.tomlđể~/.codex/config.tomlđối với các vụ vỡ nợ toàn cầu; giữ các tệp vai trò đa tác nhân dự án cục bộ trừ khi bạn cũng sao chép.codex/agents/.
Codex bao gồm những gì
| thành phần | Đếm | Chi tiết |
|---|---|---|
| Cấu hình | 1 | .codex/config.toml: phê duyệt cấp cao nhất/sandbox/web_search, máy chủ MCP, thông báo, hồ sơ |
| ĐẠI LÝ.md | 2 | Gốc (phổ quát) + .codex/AGENTS.md (Bổ sung dành riêng cho Codex) |
| Kỹ năng | 32 | .agents/skills/: SKILL.md + đại lý/OpenAI.YAML mỗi kỹ năng |
| Máy chủ MCP | 6 | GitHub, Ngữ cảnh7, Exa, Trí nhớ, Nhà viết kịch, Tư duy tuần tự (7 với Supabase qua --update-mcp đồng bộ) |
| Hồ sơ | 2 | strict (hộp cát chỉ đọc) và yolo (tự động phê duyệt hoàn toàn) |
| Vai trò đại lý | 3 | .codex/agents/: nhà thám hiểm, nhà phê bình, nhà nghiên cứu tài liệu |
Kỹ năng tại .agents/skills/ được Codex tự động tải. Các kỹ năng Canonical Anthropic như claude-api, frontend-designvà skill-creator được cố ý không được nhóm lại ở đây. Cài đặt chúng từ anthropics/skills khi bạn muốn có phiên bản chính thức.
Hạn chế về khóa
Codex làm chưa cung cấp tính chẵn lẻ thực thi hook kiểu Claude. Việc thực thi ECC dựa trên hướng dẫn thông qua AGENTS.md, tùy chọn model_instructions_file ghi đè và cài đặt hộp cát/phê duyệt.
Hỗ trợ đa tác nhân
Các bản dựng Codex hiện tại hỗ trợ quy trình làm việc đa tác nhân ổn định.
- Kích hoạt
features.multi_agent = truetrong.codex/config.toml - Xác định vai trò theo
[agents.<name>] - Trỏ từng vai trò vào một tệp bên dưới
.codex/agents/ - sử dụng
/agenttrong CLI để kiểm tra hoặc chỉ đạo các tác nhân con
ECC gửi ba cấu hình vai trò mẫu:
| Vai trò | Mục đích |
|---|---|
explorer |
Thu thập bằng chứng cơ sở mã chỉ đọc trước khi chỉnh sửa |
reviewer |
Đánh giá tính chính xác, bảo mật và kiểm tra thiếu |
docs_researcher |
Tài liệu và xác minh API trước khi thay đổi bản phát hành/tài liệu |
Hỗ trợ Zed
ECC cung cấp hỗ trợ dự án Zed thông qua một cơ chế bảo thủ .zed bộ điều hợp cho các cài đặt cục bộ của dự án, quy tắc phẳng, tác nhân, lệnh và kỹ năng.
./install.sh --profile minimal --target zed
.\install.ps1 --profile minimal --target zed
Bộ điều hợp ghi các tệp do ECC quản lý trong .zed/ và giữ thông tin đăng nhập BYOK/OpenRouter ra khỏi repo. Định cấu hình tài khoản Zed hoặc khóa API thông qua giao diện người dùng cài đặt của Zed hoặc cài đặt người dùng cục bộ của bạn.
Hỗ trợ OpenCode chuyên sâu
ECC cung cấp tích hợp plugin OpenCode beta với các hướng dẫn, tập hợp con danh mục, lệnh, công cụ tùy chỉnh và sự kiện hook. Nó không cung cấp tính năng tương đương với Claude Code và ID mô hình tham chiếu phải tồn tại trong nhà cung cấp được định cấu hình của người dùng.
# Install OpenCode
npm install -g opencode
# Run in the repository root
opencode
Cấu hình được tự động phát hiện từ .opencode/opencode.json.
Hỗ trợ hook thông qua plugin
Hệ thống plugin của OpenCode có hơn 20 loại sự kiện:
| Claude Code Móc | Sự kiện plugin OpenCode |
|---|---|
| PreToolSử dụng | tool.execute.before |
| PostToolSử dụng | tool.execute.after |
| Dừng lại | session.idle |
| Phiên bắt đầu | session.created |
| Phiên kết thúc | session.deleted |
Các sự kiện OpenCode bổ sung: file.edited, file.watcher.updated, message.updated, lsp.client.diagnostics, tui.toast.show, và hơn thế nữa
Cài đặt plugin
Cách 1: Sử dụng trực tiếp
cd ECC
opencode
Tùy chọn 2: Cài đặt dưới dạng gói npm
npm install ecc-universal
Sau đó thêm vào của bạn opencode.json:
{
"plugin": ["ecc-universal"]
}
Mục nhập plugin npm đó cho phép mô-đun plugin OpenCode được xuất bản của ECC (móc/sự kiện và công cụ plugin). Nó có không tự động thêm danh mục lệnh/tác nhân/lệnh đầy đủ của ECC vào cấu hình dự án của bạn.
Để thiết lập OpenCode ECC đầy đủ, hãy:
- chạy OpenCode bên trong kho lưu trữ này hoặc
- sao chép gói
.opencode/config vào dự án của bạn và nối dâyinstructions,agentvàcommandmục trongopencode.json
Tài liệu
- Hướng dẫn di chuyển:
.opencode/MIGRATION.md - Plugin OpenCode README:
.opencode/README.md - Quy tắc tổng hợp:
.opencode/instructions/INSTRUCTIONS.md - LLM Tài liệu:
llms.txt(hoàn thành tài liệu OpenCode cho LLM)
Hỗ trợ chuyên sâu về GitHub Copilot
ECC cung cấp Hỗ trợ GitHub Copilot cho VS Code thông qua hệ thống tệp nhắc nhở và hướng dẫn gốc của Trò chuyện. Không cần thêm dụng cụ.
Bao gồm những gì cho GitHub Copilot
| thành phần | tập tin | Mục đích |
|---|---|---|
| Hướng dẫn cốt lõi | .github/copilot-instructions.md |
Các quy tắc luôn được tải: kiểu mã hóa, bảo mật, thử nghiệm, quy trình làm việc git |
| cài đặt VS Code | .vscode/settings.json |
Các tệp hướng dẫn theo từng tác vụ cho gen mã, gen thử nghiệm và thông báo cam kết |
| Lời nhắc kế hoạch | .github/prompts/plan.prompt.md |
Lập kế hoạch thực hiện theo từng giai đoạn |
| Lời nhắc TDD | .github/prompts/tdd.prompt.md |
Chu kỳ Đỏ-Xanh-Cải thiện |
| Lời nhắc đánh giá bảo mật | .github/prompts/security-review.prompt.md |
Phân tích bảo mật liên kết OWASP sâu |
| Xây dựng lời nhắc sửa lỗi | .github/prompts/build-fix.prompt.md |
Xây dựng hệ thống và giải quyết lỗi CI |
| Lời nhắc tái cấu trúc | .github/prompts/refactor.prompt.md |
Dọn dẹp và đơn giản hóa mã chết |
Các tệp đã có sẵn: hãy mở bất kỳ kho lưu trữ nào có chứa dự án này và GitHub Copilot Trò chuyện sẽ tự động nhận .github/copilot-instructions.md. Đã cam kết .vscode/settings.json cho phép chat.promptFiles để VS Code có thể tải các lời nhắc có thể sử dụng lại từ .github/prompts/.
Để sử dụng lời nhắc quy trình làm việc trong Trò chuyện Copilot:
- Mở bảng Trò chuyện Copilot trong VS Code.
- Bấm vào kẹp giấy/đính kèm biểu tượng và chọn Nhắc..., hoặc gõ
/và chọn một lời nhắc. - Chọn lời nhắc (ví dụ:
plan,tdd,security-review).
Phạm vi tính năng
| Tính năng ECC | tương đương Copilot |
|---|---|
| Tiêu chuẩn mã hóa | Luôn bật qua copilot-instructions.md |
| Danh sách kiểm tra bảo mật | Luôn bật + security-review nhắc nhở |
| Kiểm tra/TDD | Luôn bật + tdd nhắc nhở |
| Lập kế hoạch thực hiện | plan nhắc nhở |
| Đánh giá mã | Đánh giá PR bên ngoài thông qua CodeRabbit + Greptile |
| Xây dựng giải pháp lỗi | build-fix nhắc nhở |
| Tái cấu trúc | refactor nhắc nhở |
| Cam kết định dạng tin nhắn | Hướng dẫn theo từng nhiệm vụ trong settings.json |
| Móc / tự động hóa | Không được hỗ trợ (Copilot không có hệ thống hook) |
| Đại lý/đoàn đại biểu | Không được hỗ trợ (Copilot không có tác nhân phụ API) |
Hạn chế
GitHub Copilot không có hệ thống hook hoặc tác nhân phụ API, do đó, tự động hóa hook của ECC (định dạng tự động, kiểm tra TypeScript, duy trì phiên, bảo vệ máy chủ nhà phát triển) và ủy quyền tác nhân không khả dụng. Lớp hướng dẫn và lời nhắc vẫn đưa triết lý mã hóa ECC đầy đủ (tiêu chuẩn, bảo mật, TDD và quy trình làm việc) vào mỗi phiên Trò chuyện Copilot.
Điều gì đã thay đổi trong v2.0.0
ECC v2.0.0 ổn định dòng 2.0 với câu chuyện về nhà điều hành Hermes công khai, 281 kỹ năng, 67 đặc vụ, 94 miếng chêm lệnh, bộ điều hợp phiên, kho lưu trữ MCP, dịch vụ vòng đời của cây công việc, quy trình làm việc của người điều phối và cộng đồng ECC Discord.
Tối ưu hóa mã thông báo
Việc sử dụng tác nhân có thể tốn kém nếu bạn không quản lý mức tiêu thụ mã thông báo. Những cài đặt này làm giảm đáng kể chi phí mà không làm giảm chất lượng. Hướng dẫn đầy đủ: docs/token-optimization.md.
Cài đặt được đề xuất
Thêm vào ~/.claude/settings.json:
{
"model": "sonnet",
"env": {
"MAX_THINKING_TOKENS": "10000",
"CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50",
"CLAUDE_CODE_SUBAGENT_MODEL": "haiku"
}
}
| Cài đặt | Mặc định | Được đề xuất | tác động |
|---|---|---|---|
model |
tác phẩm | bài sonnet | ~60% giảm chi phí; xử lý hơn 80% nhiệm vụ mã hóa |
MAX_THINKING_TOKENS |
31,999 | 10,000 | ~70% giảm chi phí tư duy tiềm ẩn cho mỗi yêu cầu |
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE |
95 | 50 | Thu gọn sớm hơn, chất lượng tốt hơn trong thời gian dài |
ECC_CONTEXT_MONITOR_COST_WARNINGS |
trên | tắt cho người dùng đăng ký | Ngăn chặn các cảnh báo ước tính tỷ lệ API đối mặt với tác nhân trong khi vẫn giữ các cảnh báo ngữ cảnh/phạm vi/vòng lặp |
Chỉ chuyển sang Opus khi bạn cần lý luận kiến trúc sâu sắc:
/model opus
Lệnh quy trình làm việc hàng ngày
| Lệnh | Khi nào nên sử dụng |
|---|---|
/model sonnet |
Mặc định cho hầu hết các tác vụ |
/model opus |
Kiến trúc phức tạp, gỡ lỗi, lý luận sâu sắc |
/clear |
Giữa các nhiệm vụ không liên quan (miễn phí, đặt lại ngay lập tức) |
/compact |
Tại các điểm dừng nhiệm vụ hợp lý (nghiên cứu xong, hoàn thành cột mốc) |
/cost |
Giám sát chi tiêu mã thông báo trong phiên |
Nếu bạn sử dụng đăng ký và ước tính tốc độ API của trình giám sát ngữ cảnh không hữu ích, hãy đặt ECC_CONTEXT_MONITOR_COST_WARNINGS=off. Điều này chỉ ngăn chặn các cảnh báo chi phí mà tác nhân phải đối mặt; nó không vô hiệu hóa cảnh báo cạn kiệt ngữ cảnh, phạm vi hoặc vòng lặp.
Thu gọn chiến lược
các strategic-compact kỹ năng gợi ý /compact tại các điểm dừng hợp lý thay vì dựa vào tính năng tự động nén ở ngữ cảnh 95%. Xem skills/strategic-compact/SKILL.md để có hướng dẫn quyết định đầy đủ.
Khi nào cần thu gọn:
- Sau khi nghiên cứu/thăm dò, trước khi thực hiện
- Sau khi hoàn thành một cột mốc, trước khi bắt đầu cột mốc tiếp theo
- Sau khi gỡ lỗi, trước khi tiếp tục công việc tính năng
- Sau một cách tiếp cận thất bại, trước khi thử một cách mới
Khi KHÔNG thu gọn:
- Đang triển khai giữa chừng (bạn sẽ mất tên biến, đường dẫn tệp, trạng thái một phần)
Quản lý cửa sổ ngữ cảnh
Quan trọng: Không kích hoạt tất cả MCP cùng một lúc. Mỗi mô tả công cụ MCP tiêu thụ mã thông báo từ khoảng thời gian 200k của bạn, có khả năng giảm xuống còn ~70k.
- Giữ dưới 10 MCP được kích hoạt cho mỗi dự án
- Giữ dưới 80 công cụ hoạt động
- sử dụng
/mcpđể vô hiệu hóa các máy chủ Claude Code MCP không sử dụng; những lựa chọn thời gian chạy đó vẫn tồn tại~/.claude.json - sử dụng
ECC_DISABLED_MCPSchỉ để lọc các cấu hình MCP do ECC tạo trong quá trình cài đặt/đồng bộ hóa - Nếu bối cảnh ngày càng nặng nề, hãy chạy
/context-budgetvà xóa các quy tắc bạn không cần
Cảnh báo chi phí đội đại lý: Nhóm đặc vụ sinh ra nhiều cửa sổ ngữ cảnh. Mỗi đồng đội tiêu thụ mã thông báo một cách độc lập. Chỉ sử dụng cho các nhiệm vụ mà tính song song mang lại giá trị rõ ràng (công việc có nhiều mô-đun, đánh giá song song). Đối với các tác vụ tuần tự đơn giản, các tác nhân phụ có hiệu quả sử dụng mã thông báo cao hơn.
Yêu cầu
Phiên bản Claude Code CLI + hành vi tự động tải hook
Phiên bản Claude Code CLI
Phiên bản tối thiểu: v2.1.0 trở lên. Plugin yêu cầu Claude Code CLI v2.1.0+ do những thay đổi trong cách hệ thống plugin xử lý các hook.
Kiểm tra phiên bản của bạn:
claude --version
Quan trọng: móc hành vi tự động tải
CẢNH BÁO: Dành cho người đóng góp: KHÔNG thêm một
"hooks"lĩnh vực để.claude-plugin/plugin.json. Điều này được thực thi bằng một thử nghiệm hồi quy.
Claude Code v2.1+ tự động tải hooks/hooks.json từ bất kỳ plugin nào được cài đặt theo quy ước. Khai báo rõ ràng nó trong plugin.json gây ra lỗi phát hiện trùng lặp:
Duplicate hooks file detected: ./hooks/hooks.json resolves to already-loaded file
lịch sử: Điều này đã gây ra các chu kỳ sửa chữa/hoàn nguyên lặp đi lặp lại trong kho lưu trữ này (#29, #52, #103). Hành vi đã thay đổi giữa các phiên bản Claude Code, dẫn đến nhầm lẫn. Hiện tại đã có thử nghiệm hồi quy để ngăn điều này được áp dụng lại.
Bảo mật
Chỉ cài đặt ECC từ các nguồn chính thức:
- Kho lưu trữ GitHub: https://GitHub.com/affaan-m/ECC
- Phần bổ trợ Claude Code:
ecc@ecc - gói npm:
ecc-universalvàecc-agentshield - Ứng dụng GitHub: https://GitHub.com/apps/ecc-tools
- Trang web: https://ecc.tools
Quét dự án bằng AgentShield:
npx -y ecc-agentshield scan --path .
- Báo cáo một lỗ hổng. Sử dụng quy trình riêng tư trong BẢO MẬT.md (GitHub báo cáo lỗ hổng bảo mật riêng tư). Vui lòng không mở các vấn đề công khai để báo cáo bảo mật.
- Tích hợp lan can. Các lệnh shell phá hủy cổng GateGuard (bao gồm
rm, lực/đường dẫngit checkout, và có tính chất phá hoạifind -exec) trước khi chúng chạy; máy quét IOC chuỗi cung ứng chạy trong CI; và AgentShield kiểm tra tác nhân, hook, MCP, quyền và các bề mặt bí mật của riêng bạn (/security-scan).
Móc, máy chủ MCP và điều khiển ngữ cảnh
Móc có thể chạy lệnh shell, máy chủ MCP có thể chứa thông tin xác thực và hướng dẫn dự án có thể nhập vào ngữ cảnh của tác nhân. Hãy coi cả ba là cấu hình thực thi.
Không sao chép thô hooks/hooks.json vào ~/.claude/settings.json sau khi cài đặt plugin. Các phiên bản Claude Code hiện đại tự động tải móc nối plugin và bản sao thứ hai có thể khiến chúng kích hoạt hai lần.
sử dụng /mcp đối với thời gian chạy Claude Code bị vô hiệu hóa; Claude Code duy trì những lựa chọn đó trong ~/.claude.json.
ECC_DISABLED_MCPS là bộ lọc cài đặt/đồng bộ hóa ECC, không phải là chuyển đổi Claude Code trực tiếp.
Nếu bối cảnh ngày càng nặng nề, hãy chạy /context-budget, xóa các quy tắc bạn không cần và tắt các máy chủ MCP không sử dụng. Xem hướng dẫn tối ưu hóa mã thông báo.
Tài liệu tham khảo bảo mật:
Khắc phục sự cố
ECC xuất hiện hai lần hoặc móc lửa hai lần
Nguyên nhân thông thường là cài plugin Claude rồi chạy ./install.sh --profile full trên đó.
- Gỡ cài đặt plugin Claude Code.
- Chạy
node scripts/ecc.js uninstall --dry-runtừ quầy thanh toán ECC. - Xóa các thư mục quy tắc bổ sung mà bạn đã sao chép thủ công và không còn muốn nữa.
- Cài đặt lại một lần, sử dụng một đường dẫn.
Để kiểm tra cụ thể về hook, hãy xem móc README.
Móc của tôi không hoạt động/lỗi "Tệp hook trùng lặp"
KHÔNG thêm một "hooks" lĩnh vực để .claude-plugin/plugin.json. Claude Code v2.1+ tự động tải hooks/hooks.json từ các plugin đã cài đặt. Khai báo rõ ràng nó gây ra lỗi phát hiện trùng lặp. Xem #29, #52, #103.
Thị trường Codex cài đặt nhưng kỹ năng không tải
Chạy kiểm tra bộ nhớ đệm từ quá trình kiểm tra ECC:
node scripts/codex/check-plugin-cache.js
Nếu nó báo cáo các tham chiếu gốc chưa được giải quyết, hãy sử dụng bash scripts/sync-ecc-to-codex.sh. Đăng ký tại codex plugin list xác nhận mục nhập thị trường, không phải mọi tệp được tham chiếu đều đạt đến bộ đệm của plugin. Tải kỹ năng trong thời gian chạy từ các thị trường địa phương/repo vẫn không đáng tin cậy ở thượng nguồn (OpenAI/codex#26037); xem #2128 cho cuộc điều tra đầy đủ.
Cửa sổ ngữ cảnh của tôi đang co lại
Quá nhiều máy chủ MCP ăn bối cảnh của bạn. Mỗi mô tả công cụ MCP tiêu thụ mã thông báo từ khoảng thời gian 200k của bạn, có khả năng giảm xuống còn ~70k. Ngữ cảnh SessionStart được giới hạn ở 8000 ký tự theo mặc định; hạ nó xuống với ECC_SESSION_START_MAX_CHARS=4000 hoặc vô hiệu hóa nó với ECC_SESSION_START_CONTEXT=off cho các thiết lập mô hình cục bộ hoặc bối cảnh thấp.
Sửa: Vô hiệu hóa các MCP không sử dụng khỏi Claude Code bằng /mcp. Claude Code ghi các lựa chọn thời gian chạy đó vào ~/.claude.json; .claude/settings.json và .claude/settings.local.json không phải là các nút chuyển đổi đáng tin cậy cho các máy chủ MCP đã được tải sẵn.
Giữ dưới 10 MCP được kích hoạt và dưới 80 công cụ hoạt động.
Tôi có thể chỉ sử dụng một số thành phần (ví dụ: chỉ đại lý) không?
Đúng. Sử dụng các bản sao thành phần thủ công trong Tùy chọn cài đặt nâng cao và chỉ sao chép những gì bạn cần:
# Just agents
cp agents/*.md ~/.claude/agents/
# Just rules
mkdir -p ~/.claude/rules/ecc/
cp -r rules/common ~/.claude/rules/ecc/
Mỗi thành phần hoàn toàn độc lập.
Tính năng này có hoạt động với Cursor / OpenCode / Codex / AntiGravity / GitHub Copilot không?
Đúng. ECC là nền tảng chéo:
- Cursor: Cấu hình được dịch trước trong
.cursor/. Xem Hỗ trợ nền tảng. - Gemini CLI: Hỗ trợ dự án thử nghiệm tại địa phương thông qua
.gemini/GEMINI.mdvà hệ thống ống nước cài đặt chung. - Mã mở: Tích hợp plugin Beta trong
.opencode/; Việc lựa chọn mô hình nhà cung cấp và tính chẵn lẻ của danh mục vẫn còn hạn chế. - Codex: Đường dẫn repo/đồng bộ hóa được hỗ trợ cho ứng dụng macOS và CLI; Gói thị trường của ECC vẫn còn thử nghiệm.
- GitHub Copilot (VS Code): Lớp hướng dẫn và nhắc nhở thông qua
.github/copilot-instructions.md,.vscode/settings.jsonvà.github/prompts/. - phản trọng lực: Thiết lập phản trọng lực 2.0 gốc cho quy trình làm việc, kỹ năng, tác nhân tùy chỉnh và các quy tắc được làm phẳng trong
.agents/. Xem Hướng dẫn phản trọng lực. - JoyCode / CodeBuddy: Bộ điều hợp cài đặt chọn lọc cục bộ theo dự án cho các lệnh, tác nhân, kỹ năng và quy tắc được làm phẳng. Xem Hướng dẫn sử dụng bộ chuyển đổi JoyCode.
- Qwen CLI: Bộ điều hợp cài đặt có chọn lọc trong thư mục chính cho các lệnh, tác nhân, kỹ năng, quy tắc và cấu hình Qwen. Xem Hướng dẫn sử dụng bộ chuyển đổi Qwen CLI.
- Zed: Bộ điều hợp cài đặt chọn lọc dự án cục bộ cho
.zed/settings.json, làm phẳng các quy tắc, mệnh lệnh, tác nhân và kỹ năng. - Khai thác không phải bản địa: Đường dẫn dự phòng thủ công cho giao diện kiểu trò chuyện. Xem Hướng dẫn điều chỉnh thủ công.
- Claude Code: Bản địa. Đây là mục tiêu hàng đầu.
Nền tảng của tôi không được liệt kê
Sử dụng hướng dẫn thích ứng thủ công, hoặc mở một thảo luận GitHub với tên khai thác và các định dạng tệp, kỹ năng, lệnh và móc mà nó hỗ trợ.
Chạy thử nghiệm
Plugin bao gồm một bộ thử nghiệm toàn diện:
# Run all tests
node tests/run-all.js
# Run individual test files
node tests/lib/utils.test.js
node tests/lib/package-manager.test.js
node tests/hooks/hooks.test.js
Nền
Tôi đã sử dụng Claude Code kể từ khi triển khai thử nghiệm. Giành chiến thắng trong cuộc thi hackathon Anthropic x Forum Ventures vào tháng 9 năm 2025 với @DRodriguezFX, được xây dựng thiên đỉnh.chat hoàn toàn với quy trình làm việc tác nhân.
Các cấu hình này đã được thử nghiệm trong nhiều ứng dụng sản xuất.
Cộng đồng và Dự án
Nhà tài trợ và ECC Pro
ECC vẫn miễn phí vì các nhà tài trợ và người dùng Pro tài trợ cho công việc. Logo nhà tài trợ nằm ở đầu README này; danh sách đầy đủ và các cấp độ có sẵn TÀI TRỢ.md.
ECC Pro bổ sung phân tích kho lưu trữ riêng tư, kiểm tra kích hoạt PR, quét được hỗ trợ bởi AgentShield, kiểm tra PR và đẩy tự động, sử dụng nhóm gộp và hỗ trợ ưu tiên thông qua Ứng dụng GitHub được lưu trữ.
Trở thành nhà tài trợ | Cấp độ nhà tài trợ | Chương trình tài trợ
Đóng góp
Chúng tôi hoan nghênh những đóng góp về kỹ năng, tác nhân, quy tắc, móc nối, tài liệu, bài kiểm tra, bộ điều hợp và cải tiến bảo mật.
Phiên bản ngắn:
- Ngã ba repo
- Tạo kỹ năng của bạn trong
skills/your-skill-name/SKILL.md(với vật chất phía trước YAML) - Hoặc tạo một đại lý trong
agents/your-agent.md - Gửi PR kèm theo mô tả rõ ràng về chức năng và thời điểm sử dụng nó
Ý tưởng đóng góp:
- Các kỹ năng dành riêng cho ngôn ngữ (Rust, C#, Kotlin, Java): Đã bao gồm Go, Python, Perl, Swift, TypeScript và HarmonyOS/ArkTS
- Đã bao gồm các cấu hình dành riêng cho khung (Rails, FastAPI): Django, NestJS, Spring Boot và Laravel
- Đại lý DevOps (Kubernetes, Terraform, AWS, Docker)
- Chiến lược thử nghiệm (các khung khác nhau, hồi quy trực quan)
- Kiến thức về miền cụ thể (ML, kỹ thuật dữ liệu, thiết bị di động)
Liên kết
- Hướng dẫn viết tắt (Bắt đầu tại đây): Hướng dẫn viết tắt về ECC
- Hướng dẫn dạng dài (Nâng cao): Hướng dẫn dạng dài về ECC
- Hướng dẫn bảo mật: Hướng dẫn bảo mật | chủ đề
- Theo dõi: @affaan
Giấy phép
MIT. Sử dụng nó một cách tự do, điều chỉnh nó cho phù hợp với quy trình làm việc của bạn và đóng góp lại khi bạn có thể.
Gắn dấu sao cho repo này nếu nó hữu ích. Đọc hướng dẫn. Xây dựng một cái gì đó tuyệt vời.
Dự án cùng danh mục
Trợ lý AI cá nhân của riêng bạn. Bất kỳ hệ điều hành nào. Bất kỳ nền tảng nào. Cách tôm hùm. 🦞
Đại lý phát triển cùng bạn
Kỹ năng dành cho kỹ sư thực sự. Trực tiếp từ thư mục .agents của tôi.
Triển lãm bảo tàng do đại lý quản lý, được xây dựng trong Rust với Gajae-Code / LazyCodex — được phát triển và duy trì mà không có sự can thiệp của con người.
DeepSeek Khai thác: Mọi thứ đều là Plugin.






