Agent Harness 的工程作業層
ECC 將工程流程放進 skills、agents、rules 與 hooks。Skills 在任務需要時載入；agents 隔離規劃、實作與審查上下文；rules 保存長期標準；hooks 在模型上下文之外執行確定性檢查。
官方 catalog 目前包含 68 個 agents、286 個 skills 與 94 個維護中的 command shims。主要流程涵蓋計畫、TDD、build repair、code review、security scan、session memory 與 orchestration。
Claude Code 是穩定的主要平台，Codex 提供原生 marketplace plugin 路徑。其他 harness 使用 beta 或 experimental adapters；各平台不保證功能一致。
Plan
Test
Implement
Review
Verify
Remember
Improve
Optimize the context window. Persist everything else.
單一路徑的 Guided Setup
使用 universal package 執行互動式安裝。Claude Code 的 plugin setup、更新、scope 與 hook profile 變更使用第一個命令；同時設定 Claude Code、Codex 或 Kimi Code 使用第二個命令。
# Claude Code plugin setup
npx ecc-universal setup
# Multi-harness guided install
npx ecc-universal install --guidedCodex 原生 Plugin
Codex App 與 CLI 可以透過 repository marketplace 安裝。安裝後列出 plugin 狀態，並檢查 cache 中的 manifest 與相依資源。
codex plugin marketplace add affaan-m/ECC
codex plugin add ecc@ecc
codex plugin list --json
node scripts/codex/check-plugin-cache.js規劃、品質、記憶與安全控制
從目前任務選擇工作流，不需要載入完整 catalog。以下六組能力對應 README 的主要入口。
Plan · 01
/ecc:plan
實作前計畫
產生可確認或修改的 implementation blueprint，並可交由 Plan Canvas 審閱。
Build · 02
tdd-workflow
RED → GREEN → REFACTOR
先保存 failing-test 證據，再做最小實作、重構並驗證測試。
Review · 03
/code-review
新上下文審查
由獨立 reviewer 檢查回歸、盲點、品質與安全問題。
Repair · 04
/build-fix
Build 修復
定位編譯或建置錯誤，交由 build-error-resolver 處理。
Memory · 05
ecc memory
跨 Harness 記憶
以本地、可檢查的 Markdown 儲存摘要與 handoff，支援 search、read 與 doctor。
Security · 06
/security-scan
Agent 攻擊面
掃描 prompts、hooks、MCP 設定、權限、secrets 與 agent files。
任務入口對照
| 任務 | 入口 | 驗證重點 |
|---|---|---|
| 建立功能 | /ecc:plan + tdd-workflow | 計畫與 RED/GREEN 證據 |
| 修復錯誤 | tdd-workflow | 先建立可重現的 failing test |
| 審查新程式碼 | /code-review | 獨立上下文 findings |
| 修復建置 | /build-fix | 建置命令恢復成功 |
| 結束與恢復 session | /save-session、/resume-session | 摘要與 handoff 可讀 |
| 稽核 Agent 設定 | /security-scan | 權限、hooks、MCP 與 secrets |
依工作負載選擇元件範圍
manifests/install-profiles.json 定義六個 profile。先從符合任務的最小集合開始，再以 modules 或 skills 增補。
PROFILE 01 · minimal
安裝 rules、agents、commands、platform config 與 quality workflow，不安裝 hook runtime。
來源 · manifests/install-profiles.json
PROFILE 02 · core
在基線元件上加入 hook runtime，適合需要事件驅動品質檢查的環境。
來源 · manifests/install-profiles.json
PROFILE 03 · developer
加入 framework、language、database 與 orchestration modules；這是多數應用程式專案的預設工程 profile。
來源 · manifests/install-profiles.json
PROFILE 04 · security
在核心 runtime 與品質工作流之外加入 security module。
來源 · manifests/install-profiles.json
PROFILE 05 · research
組合 research APIs、business content 與 social distribution 元件。
來源 · manifests/install-profiles.json
PROFILE 06 · full
安裝目前已分類的全部 modules，包含 memory、security、operator、media、DevOps 與 orchestration。
來源 · manifests/install-profiles.json
從計畫到最終驗證
以下流程依 README 的 feature workflow 組合。每個階段留下可檢查的 artifact 或測試結果。
$ You › /ecc:plan "Add usage-based billing alerts"
$ You › Use tdd-workflow
$ You › /code-review
ok: 最終驗證：build · lint · types · tests
A result is not just code. It's a trail of evidence.
完成條件
計畫已獲確認、failing test 證明問題可重現、實作後測試轉綠、review findings 已處理，且 build、lint、types 與 tests 全部通過。
Harness 差異與執行邊界
從預設安裝到專案化配置
先確認 managed install 的狀態，再調整 profile 或 modules。ECC 的 installer 會記錄其管理的檔案，repair 與 uninstall 依此範圍處理。
進階工作地圖
**1. 檢查安裝狀態。**依序執行 npx ecc-universal list-installed、doctor 與必要時的 repair。
**2. 先查詢再增補元件。**執行 node scripts/ecc.js consult "security reviews" --target claude，查看 matching components、profiles 與 preview command。
**3. 建立跨 harness 記憶。**另行安裝 CLI runtime，使用 ecc memory init --scope project 建立本地 vault，再以 search、read 與 doctor 檢查內容。
**4. 調整 hook profile。**依專案風險選擇 minimal、standard 或 strict，並審查任何會執行 shell command 的 hook。
**5. 定期執行 AgentShield。**使用 npx -y ecc-agentshield scan --path . 檢查 agent、hook、MCP、權限與 secrets。
延伸閱讀
① README.md：安裝路徑、平台矩陣、工作流與限制。 ② Codex Navigation Guide：Codex 中的 repository 導航與 PR diff packet。 ③ Token Optimization Guide：context、compaction 與 MCP 數量管理。
Skills keep the context focused.