RepoTrending
Về bảng xếp hạng
GitHubAI AgentJavaScript

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.

243k sao37k fork

README

ECC - the agent harness operating system

GitHub Trending Repository of the Day Star History Global Rank

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

Discord Website GitHub App MIT license

Stars Forks Contributors GitHub App installs

ecc-universal npm downloads ecc-agentshield npm downloads

Shell TypeScript Python Go Java Perl Markdown

[!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-universalecc-agentshield, cái Ứng dụng GitHub, sên plugin ecc@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-universal 2.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.

ECC Tools
Ứ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ở
Discord
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ợ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ợ

CodeRabbit    Greptile    Atlas Cloud    Moonshot AI - Kimi    Itô Markets

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ợ

Chuyển đến cài đặt ↓

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

ECC star history: first 40,000 stars, January 18 to February 7, 2026

Cài đặt ECC

[!QUAN TRỌNG] Sắp có gói hướng dẫn thiết lập ecc-universal 2.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 doctornode 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, projectlocal 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-fix/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 LLMtà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):

Itô Markets
1. Nhận dung lượng GPU

Sử dụng Itô hoặc bất kỳ nhà cung cấp GPU nào.
Moonshot AI - Kimi
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.
ECC Tools
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_findito_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 cinpm 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--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-frontend/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:

  1. Gỡ cài đặt plugin Claude Code.
  2. 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.
  3. 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.
  4. 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-universal 2.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, hermesopenclaw. 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/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.

Plan Canvas demo: reviewing an ECC plan in the browser, scrolling diagrams, attaching an anchored annotation, chatting with the agent, and approving the plan

Đó 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 find Cầ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.py hoặc npm 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-opsworkspace-surface-audit vò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-baskets kỹ 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-plannerito-data-atlas-agent kỹ năng), cộng thêm prediction-market-oracle-researchprediction-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-systemsrecursive-decision-ledger biế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, resumedaemon lệnh.
  • Ảnh chụp nhanh trạng thái người vận hành: ecc status --markdown --write status.md biế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.jsinstall-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-resolver mở 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|strictECC_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-slides kỹ 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-setup lệnh tạo ra codex.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-scan chạ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-ecc kỹ 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: /sessions lệ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_readmemory_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ứ.

The Shorthand Guide to ECC
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ủ đề)
The Longform Guide to ECC
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ủ đề)
The Security Guide to ECC
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.

GitHub | npm

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, experimentalinstruction-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:

  1. Biến môi trường: CLAUDE_PACKAGE_MANAGER
  2. Cấu hình dự án: .claude/package-manager.json
  3. gói.JSON: packageManager lĩnh vực
  4. Khóa tập tin: Phát hiện từ gói-lock.JSON, sợi.lock, pnpm-lock.YAML hoặc Bun.lockb
  5. Cấu hình chung: ~/.claude/package-manager.json
  6. 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.md thay 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ọn model_instructions_file ghi đè 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:

  1. Cursor sessionStart cái móc (được cài đặt vào .cursor/hooks.json trên --target cursor) tiêm ECC_AGENT_DATA_HOME cho toàn bộ phiên soạn nhạc.
  2. Mặc định thời gian chạy hook: khi nào CURSOR_VERSION hoặc CURSOR_PROJECT_DIR hiện diện, móc mặc định là ~/.cursor/ecc nếu var env không được đặt.
  3. Cấu hình dự án: .cursor/ecc-agent-data.json tài liệu và ghi đè đường dẫn (agentDataHome).
  4. Quy tắc luôn bật: .cursor/rules/ecc-agent-data-home.mdc nhắ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, globsalwaysApply:

---
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.toml.codex/agents/*.toml hoạt động tốt nhất khi giữ dự án cục bộ.
  • Tài liệu tham khảo .codex/config.toml cố tình không ghim model hoặc model_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-designskill-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 = true trong .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 /agent trong 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ây instructions, agentcommand mục trong opencode.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:

  1. Mở bảng Trò chuyện Copilot trong VS Code.
  2. 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.
  3. 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_MCPS chỉ để 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-budget và 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:

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ẫn git checkout, và có tính chất phá hoại find -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 đó.

  1. Gỡ cài đặt plugin Claude Code.
  2. Chạy node scripts/ecc.js uninstall --dry-run từ quầy thanh toán ECC.
  3. 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.
  4. 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.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.md và 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.json.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ữ.

ECC chuyên nghiệp
Ứng dụng GitHub được lưu trữ cho các kho lưu trữ riêng tư
Nhà tài trợ ECC
Tài trợ cho công việc OSS
cộng đồng
Hỏi đáp, ý tưởng và Hiển thị và kể
Ứng dụng GitHub
Kiểm tra PR và quy trình công việc đượ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:

  1. Ngã ba repo
  2. 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)
  3. Hoặc tạo một đại lý trong agents/your-agent.md
  4. 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

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

openclaw/openclaw

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. 🦞

387k81k23 phút trước
GitHubAI AgentTypeScript

NousResearch/hermes-agent

Đại lý phát triển cùng bạn

236k48k1 giờ trước
GitHubAI AgentPython

mattpocock/skills

Kỹ năng dành cho kỹ sư thực sự. Trực tiếp từ thư mục .agents của tôi.

235k20k9 giờ trước
GitHubAI AgentShell

anomalyco/opencode

Tác nhân mã hóa nguồn mở.

201k26k26 phút trước
GitHubAI AgentTypeScript

ultraworkers/claw-code

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.

195k109k8 ngày trước
GitHubAI AgentRust

deepseek-ai/deepseek-harness

DeepSeek Khai thác: Mọi thứ đều là Plugin.

192k22k3 ngày trước
GitHubAI AgentTypeScript