ECC
Mã nguồn mở bởi affaan-m
ECC là bộ plugin mã nguồn mở biến trợ lý lập trình AI thành một quy trình làm việc có kỷ luật: lập kế hoạch, viết test, code, tự review, kiểm tra và ghi nhớ. Theo README, bộ này hiện hỗ trợ đầy đủ cho Claude Code, có bản cho Codex, Qoder và bản chuyển đổi cho Cursor, OpenCode, Gemini, Copilot cùng nhiều công cụ khác.
ECC dùng để làm gì?
- Cài một lần bộ agent, skill, lệnh, hook và rule cho Claude Code, Codex hoặc Kimi Code bằng trình cài đặt có hướng dẫn
- Lập kế hoạch tính năng bằng /ecc:plan rồi viết code theo kiểu test trước với skill tdd-workflow
- Review code vừa viết trong bối cảnh mới bằng /code-review, sửa build lỗi bằng /build-fix
- Lưu và nối lại phiên làm việc dài bằng /save-session và /resume-session
- Quét cấu hình agent, hook, MCP, quyền và secret của dự án bằng AgentShield
Giao diện
Ảnh và video lấy từ README của dự án trên GitHub, bản quyền thuộc nhóm phát triển.
Cần biết trước khi dùng
- Lưu ýKhông tìm thấy docker-compose hay Dockerfile ở thư mục gốc: chưa thể gắn nút Deploy tự động.
- Lưu ýTino chưa kiểm thử dự án này.
Kiểm tra tự động ngày 04/11/2026 từ dữ liệu GitHub, OSV.dev và docker-compose. Đây không phải chứng nhận bảo mật; Tino không phát triển hay bảo trì repo này.
ECC là gì?
Trợ lý AI viết được code, nhưng mỗi lần lại phải dặn lại quy trình: lập kế hoạch trước, viết test, tự kiểm tra. ECC đóng gói quy trình đó thành plugin cài một lần. Theo README, bản hiện tại có 71 agent chuyên biệt (lập kế hoạch, review, sửa build, bảo mật, kiến trúc…), 314 skill, 98 lệnh tương thích cũ, cùng hook, rule, bộ nhớ và cơ chế tự học từ các phiên trước.
Cách cài khuyên dùng là trình cài đặt có hướng dẫn qua npx: trình này kiểm tra các bản cài sẵn có, cho chọn phạm vi (toàn máy, dự án, cục bộ) và mức hook. Với Claude Code có thể cài bằng lệnh /plugin; với Codex có plugin riêng; các công cụ khác như Cursor, OpenCode, Gemini, Zed, Copilot dùng script install.sh từ bản clone. README nhấn mạnh mỗi công cụ chỉ chọn một cách cài, cài chồng sẽ làm skill, hook bị lặp.
Rule không đi kèm plugin Claude Code, bạn tự chép những gói rule cần dùng (phần chung và ngôn ngữ của dự án). Hook có thể chạy lệnh shell, MCP có thể giữ thông tin đăng nhập; README khuyên coi cả hai là cấu hình có khả năng thực thi. ECC có GateGuard chặn các lệnh huỷ dữ liệu như rm trước khi chạy.
Mã nguồn theo giấy phép MIT và miễn phí. Riêng ECC Pro là GitHub App do nhóm phát triển host, phân tích repo riêng tư và audit PR, có trả phí; theo README giá từ 19 USD mỗi người mỗi tháng.
Nên dùng khi
- Bạn dùng Claude Code hằng ngày và muốn trợ lý làm theo quy trình cố định: kế hoạch, test, review, kiểm tra
- Bạn dùng nhiều công cụ AI (Claude Code, Codex, Cursor…) và muốn chung một bộ skill và rule
- Đội của bạn cần chuẩn hoá cách review và kiểm tra bảo mật code do AI viết
Không nên dùng khi
- Bạn chưa đọc hook sẽ cài làm gì: hook của ECC chạy lệnh shell tự động trong phiên của trợ lý, với quyền của tài khoản trên máy bạn. Có thể cài bản minimal không hook
- Bạn cài từ bản sao chép hoặc mirror không chính thức: README cảnh báo các bản tải lại có thể chứa mã độc, chỉ cài từ affaan-m/ECC, npm ecc-universal, plugin ecc@ecc
- Bạn chạy lệnh npx ecc-universal mà chưa rà mã: README ghi việc ghim phiên bản không phải là kiểm tra bảo mật, nên xem mã nguồn bản phát hành trước khi chạy
- Bạn cần phân tích repo riêng tư bằng GitHub App: phần này là ECC Pro trả phí
- Ngữ cảnh model đã chật hoặc bạn dùng model chạy máy nhỏ: bộ đầy đủ có hàng trăm skill và nạp thêm bối cảnh mỗi phiên
- Bạn chỉ cần trợ lý trả lời nhanh vài câu, không cần quy trình nhiều bước
Tính năng chính
- 71 agent, 314 skill, 98 lệnh tương thích (số liệu theo README)
- Trình cài đặt có hướng dẫn cho Claude Code, Codex, Kimi Code, có chạy thử --dry-run
- Hook theo mức (profile), tóm tắt phiên, bộ nhớ và cơ chế tự học thành instinct
- Gói rule theo ngôn ngữ, chọn cài phần cần dùng
- AgentShield quét prompt, hook, cấu hình MCP, quyền và secret
- GateGuard chặn lệnh huỷ dữ liệu (rm, git checkout cưỡng bức…) trước khi chạy
- Lệnh doctor, repair, uninstall chỉ đụng tới file ECC đã ghi nhận
- Dùng được với gateway hoặc model tự host qua cấu hình của từng công cụ
Cách cài đặt ECC
-
Kiểm tra yêu cầu
Cần Node.js 18 trở lên. Cài cho Claude Code cần thêm Git và Claude Code 2.1 trở lên có trong PATH.
node --version git --version claude --version -
Cài cho Claude Code bằng trình hướng dẫn
Trình cài đặt hỏi phạm vi cài (cá nhân thường chọn Global user) và mức hook (thường chọn Standard). Chạy lại lệnh này khi muốn cập nhật hoặc đổi cấu hình. Sau đó mở phiên Claude Code mới, gõ /plugin list để xem ecc@ecc đã bật.
npx ecc-universal@2.2.3 setup -
Hoặc cài bằng lệnh plugin trong Claude Code
Gõ trong ô chat của Claude Code. Chọn một trong hai cách trên, không cài chồng.
/plugin marketplace add https://github.com/affaan-m/ECC /plugin install ecc@ecc -
Chép gói rule muốn dùng
Plugin không mang theo rule. Thay typescript bằng ngôn ngữ của dự án. Đã cài plugin thì không chạy thêm ./install.sh --profile full.
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 -
Cài cho Codex
Hook của Codex cần bạn duyệt và tin cậy rõ ràng trong Codex.
codex plugin marketplace add affaan-m/ECC codex plugin add ecc@ecc -
Bản nhẹ không hook (tuỳ chọn)
Cài rule, agent, lệnh và quy trình chính nhưng không cài phần hook chạy tự động.
npx ecc-universal@2.2.3 install --profile minimal --target claude
Lệnh chép từ README của dự án. Đọc kỹ trước khi chạy và đối chiếu với README mới nhất, vì lệnh có thể đổi theo phiên bản.
Cấu hình quan trọng
| Mục | Ý nghĩa |
|---|---|
ECC_CONTEXT_MONITOR_COST_WARNINGS | Đặt off để tắt cảnh báo ước tính chi phí API (hữu ích khi dùng gói thuê bao); vẫn giữ cảnh báo ngữ cảnh, phạm vi, vòng lặp |
ECC_DISABLED_MCPS | Bộ lọc khi cài hoặc đồng bộ để bỏ các máy chủ MCP không dùng; không phải công tắc bật tắt lúc đang chạy Claude Code |
ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN | Biến của Claude Code (không phải của ECC) để dùng gateway hoặc model tự host; ECC chạy theo cấu hình này |
Cách tích hợp và sử dụng
- Làm tính năng mớiGõ /ecc:plan "mô tả tính năng" để agent planner lập kế hoạch, sau đó dùng skill tdd-workflow để viết test trước rồi mới code.
- Sửa lỗiViết một test tái hiện lỗi, dùng tdd-workflow để sửa tới khi test qua, rồi chạy /code-review để kiểm tra lại.
- Review và sửa build/code-review review code trong bối cảnh mới, /build-fix sửa build lỗi, /refactor-clean dọn mã thừa.
- Phiên làm việc dàiDùng /context-budget khi ngữ cảnh nặng, /save-session trước khi dừng và /resume-session để làm tiếp.
- Kiểm tra cấu hình agentChạy /security-scan, hoặc agentshield scan --path . nếu đã cài AgentShield, để rà hook, MCP, quyền và secret trong dự án.
Cập nhật và sao lưu
Cập nhật bằng cách chạy lại npx ecc-universal@2.2.3 setup (đổi số phiên bản theo bản phát hành mới). Với Codex: codex plugin marketplace upgrade ecc rồi codex plugin add ecc@ecc.
Khi cài bị lỗi hoặc trùng lặp, dùng các lệnh list-installed, doctor, repair và uninstall --dry-run của ecc-universal, chạy từ đúng thư mục đã cài. Gói rule chép tay nằm trong ~/.claude/rules/ecc, tự sao lưu nếu đã sửa.
Câu hỏi thường gặp
ECC có miễn phí không?
Bộ mã nguồn mở theo giấy phép MIT và miễn phí. ECC Pro là GitHub App do nhóm phát triển host, dùng cho repo riêng tư, audit PR, có trả phí; theo README giá từ 19 USD mỗi người mỗi tháng.
Có nên vừa cài plugin vừa chạy install.sh không?
Không. README dặn mỗi công cụ chỉ chọn một cách cài. Cài chồng làm skill, lệnh và hook bị lặp, hook có thể chạy hai lần. Nếu đã lỡ, gỡ plugin rồi chạy lệnh uninstall và cài lại một lần.
Tại sao lệnh là ecc@ecc mà gói npm là ecc-universal?
README giải thích đây là ba tên khác nhau có chủ ý: repo GitHub affaan-m/ECC, plugin ecc@ecc và gói npm ecc-universal. Không có gói npm tên ecc-install riêng.
ECC có tải dữ liệu chẩn đoán lên máy chủ không?
README ghi ECC không tự gửi dữ liệu chẩn đoán. Form góp ý khi gỡ cài đặt là issue công khai trên GitHub và không bắt buộc.
Dùng ECC với model tự host được không?
Được, qua cấu hình của từng công cụ. Với Claude Code, đặt ANTHROPIC_BASE_URL và ANTHROPIC_AUTH_TOKEN trỏ tới gateway; ECC không cố định nhà cung cấp model.
Ứng dụng liên quan
Miễn trừ trách nhiệm
Tino không phát triển, không sở hữu và không liên kết với ECC hay nhóm phát triển affaan-m. Tên, logo và nhãn hiệu thuộc về chủ sở hữu tương ứng; việc nhắc tới chỉ để mô tả, không có nghĩa là dự án xác nhận hay hợp tác với Tino.
ECC được phân phối theo giấy phép MIT của nhóm phát triển. Tino không bảo đảm về tính năng, bảo mật hay mức độ phù hợp của phần mềm; bạn tự chịu trách nhiệm khi cài đặt, cấu hình và sử dụng.
Lệnh cài và thông tin trên trang lấy từ tài liệu công khai của dự án tại thời điểm cập nhật và có thể đã thay đổi. Đọc tài liệu chính thức và sao lưu dữ liệu trước khi chạy trên máy chủ thật.
