Ngôn ngữ: English | Português (Brasil) | 简体中文 | 繁體中文 | 日本語 | 한국어 | Türkçe | Русский | Tiếng Việt | ไทย | Deutsch | Українська | Polski | বাংলা | العربية

140K+ sao | 21K+ fork | 170+ contributor | 12+ hệ sinh thái ngôn ngữ | Anthropic Hackathon Winner

ECC là hệ thống tối ưu hiệu năng cho AI agent harness.

ECC không chỉ là một bộ cấu hình. Repo này đóng gói agents, skills, hooks, rules, MCP config, selective install, kiểm tra bảo mật, và workflow vận hành cho Claude Code, Codex, Cursor, OpenCode, Gemini và các harness agent khác.

Trang tiếng Việt này là bản onboarding gọn, được phục hồi từ đóng góp cộng đồng trong PR #1322 và cập nhật để khớp mặt cài đặt hiện tại. README tiếng Anh vẫn là nguồn chuẩn đầy đủ nhất.

Với Claude Code, phần lớn người dùng nên chọn đúng một trong hai đường:

• Khuyến nghị: cài plugin Claude Code, sau đó copy thủ công chỉ những thư mục rules/ bạn thật sự cần.
• Dùng installer thủ công nếu bạn muốn kiểm soát chi tiết hơn, muốn tránh plugin, hoặc bản Claude Code của bạn không resolve được marketplace tự host.
• Không chồng nhiều cách cài lên nhau. Cấu hình dễ hỏng nhất là /plugin install trước, rồi chạy tiếp install.sh --profile full hoặc npx ecc-universal install --profile full.

Nếu bạn đã cài chồng nhiều lần và thấy skill/hook bị trùng, xem Reset / Gỡ ECC.

# Thêm marketplace
/plugin marketplace add https://github.com/affaan-m/ECC

# Cài plugin
/plugin install ecc@ecc

ECC có ba định danh công khai khác nhau:

• Repo GitHub: affaan-m/ECC
• Plugin Claude marketplace: ecc@ecc
• Gói npm: ecc-universal

Các tên này cố ý khác nhau. Plugin Claude Code dùng ecc@ecc; npm vẫn dùng ecc-universal.

Plugin Claude Code không tự phân phối rules/. Nếu bạn đã cài bằng plugin, đừng chạy thêm full installer. Hãy copy riêng rule pack bạn 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/

git clone https://github.com/affaan-m/ECC.git
cd ECC

New-Item -ItemType Directory -Force -Path "$HOME/.claude/rules/ecc" | Out-Null
Copy-Item -Recurse rules/common "$HOME/.claude/rules/ecc/"
Copy-Item -Recurse rules/typescript "$HOME/.claude/rules/ecc/"

Copy cả thư mục ngôn ngữ, ví dụ rules/common hoặc rules/golang, thay vì copy từng file riêng lẻ.

Chỉ dùng đường này nếu bạn cố ý bỏ qua plugin:

npm install
./install.sh --profile full

npm install
.\install.ps1 --profile full
# hoặc
npx ecc-universal install --profile full

Nếu chọn đường thủ công, dừng ở đó. Đừng chạy thêm /plugin install.

Nếu bạn chỉ muốn rules, agents, commands và core workflow skills, dùng profile tối thiểu:

./install.sh --profile minimal --target claude

.\install.ps1 --profile minimal --target claude
# hoặc
npx ecc-universal install --profile minimal --target claude

Profile này cố ý không cài hooks-runtime.

Nếu ECC bị trùng, quá xâm lấn, hoặc hoạt động sai, đừng tiếp tục cài đè lên chính nó.

• Đường plugin: gỡ plugin trong Claude Code, rồi xoá các rule folder bạn đã copy thủ công dưới ~/.claude/rules/ecc/.
• Đường installer/CLI: từ root repo, preview trước:

node scripts/uninstall.js --dry-run

Sau đó gỡ các file do ECC quản lý:

node scripts/uninstall.js

Bạn cũng có thể dùng lifecycle wrapper:

node scripts/ecc.js list-installed
node scripts/ecc.js doctor
node scripts/ecc.js repair
node scripts/ecc.js uninstall --dry-run

ECC chỉ xoá file có trong install-state của nó. Nó không xoá file không liên quan.

• README tiếng Anh - nguồn chuẩn đầy đủ nhất
• Hướng dẫn Hermes
• Release notes v2.0.0-rc.1
• Kiến trúc cross-harness
• Troubleshooting
• Hook bug workarounds

# Plugin install dùng namespace đầy đủ
/ecc:plan "Thêm xác thực người dùng"

# Manual install giữ dạng slash ngắn
# /plan "Thêm xác thực người dùng"

# Xem plugin đang cài
/plugin list ecc@ecc

ECC hiện cung cấp hàng chục agent, hơn 200 skill và legacy command shim cho các workflow agent khác nhau. Kiểm tra README tiếng Anh để xem danh sách và hướng dẫn chi tiết nhất.