ECC（Everything Claude Code）是什麼、怎麼安裝和使用：300 個 Skills 加子智能體、Hooks 的全家桶

本文根據 affaan-m/ECC 倉庫 README 和 Claude Code 官方文檔整理，資料核對於 2026-10-10。ECC 版本迭代很快，安裝命令裏的版本號以 README 為準。

是什麼

ECC 是 Affaan Mustafa 維護的開源項目，中文社區裏更常聽到的名字是 Everything Claude Code（搜尋時兩個叫法都在用，倉庫現名 affaan-m/ECC）。它的定位不是一組技能，而是一整套「智能體工程系統」：讓編程智能體先計劃再動手、用測試驗證改動、換一個乾淨的上下文評審自己的成果、記住重要的東西，並把反覆成功的做法沉澱成可複用的技能。README 用一行流程概括：

text
plan -> test -> implement -> review -> verify -> remember -> improve

作者在 README 裏介紹，這套配置來自他長期使用 Claude Code 的積累，並在 2025 年 9 月的一場 Anthropic 相關黑客松中獲獎。截至 2026-10-10，GitHub 顯示該倉庫約 27.6 萬 Star、4.1 萬 Fork，最近一次推送在 2026-10-10。

包含哪些 Skill

README 給出的規模（不同段落的數字略有出入，約 300 個技能）：

• Skills（約 300 個）：覆蓋 TDD、調研、安全、文檔、前端、數據、機器學習、運維等。最核心的是 tdd-workflow，以及計劃、代碼評審、構建修復、重構清理、會話儲存與恢復等流程技能。
• 子智能體（71 個）：如 planner（規劃）、architect（架構）、tdd-guide、code-reviewer、security-reviewer、build-error-resolver、e2e-runner 等，供主會話委派任務。
• 命令（90 多個）：斜槓命令入口。README 說明項目正在轉向「以技能為主」，命令作為便捷入口和兼容層保留。
• Hooks 與記憶：會話摘要、持續學習（把會話裏積累的經驗沉澱成「instincts」）、上下文預算控制、在執行危險 shell 命令前攔截的 GateGuard。
• Rules：按語言或項目選擇加載的編碼規範。
• AgentShield：掃描你自己的智能體配置（提示詞、Hooks、MCP 配置、權限、密鑰）的安全工具。

怎麼安裝

需要 Node.js 18 以上；裝 Claude 插件還需要 Git 和 Claude Code 2.1 以上。命令均來自 README。

推薦：引導式安裝（會檢查已有安裝並讓你選擇範圍和 Hook 檔位）：

bash
npx [email protected] setup

Claude Code 原生插件命令（在會話裏輸入，裝到這一步就夠了）：

text
/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@ecc

Codex（終端裏運行）：

bash
codex plugin marketplace add affaan-m/ECC
codex plugin add ecc@ecc

README 反覆強調：每種工具只選一種安裝方式，不要疊加。同一個工具裏裝兩遍會讓技能、命令、Hooks 重複；已經裝亂了就按 README 的 Reset / Uninstall 一節清理。Claude Code 的插件不能分發 rules，需要的規範包要另外按 README 添加。Cursor、Gemini CLI、Zed 等通過倉庫裏的 install.sh --profile minimal --target … 安裝項目級適配，功能不完整。README 沒有提供 claude.ai 網頁版的安裝方式。

怎麼用

README 的建議是「從你要做的事開始，而不是從整個目錄開始」：

• 做新功能：輸入 /ecc:plan "Add authentication"（插件安裝時命令帶 ecc: 前綴），它會調用 planner 子智能體出計劃；確認後用 tdd-workflow 先寫失敗的測試再實現。
• 評審與修復：/code-review 用全新的上下文評審剛寫的代碼；構建掛了用 /build-fix；清理代碼用 /refactor-clean。
• 長會話管理：/context-budget 查看上下文壓力；結束前 /save-session，下次 /resume-session 接着做。
• 調整配置：裝好後用 /ecc:configure-ecc 重新選擇組件和 Hook 檔位。

適合誰 / 不適合誰

適合：

• 重度使用 Claude Code、想要一份拿來就能用的完整工程配置的開發者；
• 想研究「技能 + 子智能體 + Hooks + 記憶」怎麼協同的人——它是很好的參考實現；
• 需要跨多個工具共享流程和上下文的團隊。

不適合：

• 剛上手的新手——組件太多，出問題時很難判斷是哪一層造成的；
• 在意上下文佔用的場景：README 自己也提醒，插件會把已裝的技能目錄告訴模型，在意佔用時應改用選擇性安裝；
• 已經裝了 Superpowers、gstack 等同類流程框架的項目——Hooks 和流程容易衝突。

注意事項

• 許可證：MIT。
• 維護狀態：非常活躍（最近推送 2026-10-10），版本更新頻繁，文檔裏的技能數量和命令會變。
• 只從官方渠道安裝：README 頂部有醒目警告——只認 GitHub 倉庫 affaan-m/ECC、npm 包 ecc-universal 與 ecc-agentshield、插件標識 ecc@ecc 和官網 ecc.tools；第三方轉載和非官方鏡像可能含惡意代碼。
• 它會運行 Hooks 和 MCP：README 明確說 Hooks 能執行 shell 命令、MCP 伺服器可能持有憑據，要把它們當作「可執行的配置」對待。安裝前在 /plugin 詳情裏看清它會裝什麼，敏感項目先選較保守的 Hook 檔位。
• 平台差異：核心功能支持 Windows、macOS、Linux，但 README 列出了原生 Windows 下持續學習等功能的已知缺陷；Codex 之外的其他工具屬於 beta 或實驗性適配，不要預設功能齊全。
• 上下文成本：技能多不等於效果好，按需啟用，不用的規則和 MCP 及時關掉。