ecc-guide

ECC 指南

當使用者需要了解、瀏覽、安裝或選擇 Everything Claude Code (ECC) 的元件時，請使用此 skill。

適用時機

當使用者出現以下需求時使用此 skill：

• 詢問 ECC 包含哪些內容
• 需要協助尋找特定的 skill、指令、agent、hook、規則或安裝設定檔
• 剛接觸此儲存庫，需要引導導覽
• 詢問「如何用 ECC 做到 X？」
• 詢問哪些 ECC 元件適合某個專案
• 需要針對指令、skill、agent、hook 和規則之間的關係進行簡明說明
• 對安裝路徑、重複安裝、重置/解除安裝或選擇性安裝選項感到困惑

核心原則

依據最新的檔案回答，而不是憑記憶。ECC 更新迅速，寫死的目錄數量、功能列表與安裝說明很快就會過時。

當 ECC 儲存庫可用時，請在給出具體回答前先檢查相關檔案：

node scripts/ci/catalog.js --json
find skills -maxdepth 2 -name SKILL.md | sort
find commands -maxdepth 1 -name '*.md' | sort
find agents -maxdepth 1 -name '*.md' | sort
node scripts/install-plan.js --list-profiles
node scripts/install-plan.js --list-components --json

僅讀取回答使用者問題所需的最小檔案集合。

儲存庫地圖

• README.md：安裝路徑、解除安裝/重置指南、產品定位、常見問題
• AGENTS.md：貢獻者指南與專案結構
• agent.yaml：匯出的 gitagent 介面與指令列表
• commands/：維護中的斜線指令（slash-command）相容性轉接檔（shims）
• skills/*/SKILL.md：可重複使用的工作流程與領域操作劇本（playbooks）
• agents/*.md：委派的 subagent 角色提示詞
• rules/：語言與 harness 規則
• hooks/README.md、hooks/hooks.json、scripts/hooks/：hook 行為與安全檢查關卡
• manifests/install-*.json：選擇性安裝模組、元件、設定檔與目標支援
• docs/：harness 指南、架構筆記、翻譯文件、發布文件

回答風格

先直接給出答案，再提供下一步行動建議。大多數使用者不需要全量的目錄傾印。

良好的首次回答結構：

1. 建議使用什麼
2. 為何適合
3. 確切要檢查的檔案或指令
4. 一個下一步指令或問題

避免：

• 預設列出所有 skill 或指令
• 大篇幅重複 README 內容
• 在已有 skill 優先路徑時，仍推薦已停用的指令轉接檔
• 未先檢查檔案系統就聲稱某個元件存在
• 當受管理的安裝程式已支援該目標時，仍用手動複製指令取代安裝指南

常見任務

新手引導

提供簡短選單：

• 安裝或重置 ECC
• 為專案選擇 skill
• 理解指令與 skill 的差異
• 檢查 hook 與安全行為
• 執行 harness 審查
• 尋找特定的工作流程

指引使用者至 README.md 查看安裝/重置說明，並至 /project-init 進行專案專屬的導入流程。

功能探索

針對「針對 X 我應該用什麼？」類型的提問：

1. 搜尋 skills/、commands/ 和 agents/。
2. 優先將 skill 作為主要的工作流程介面。
3. 僅在指令屬於維護中的相容性轉接檔，或使用者明確要求斜線指令行為時才使用指令。
4. 在任務委派有所幫助時提及 agent。

實用的搜尋指令：

rg -n "<query>" skills commands agents docs
find skills -maxdepth 2 -name SKILL.md | sort

安裝指南

使用受管理的安裝路徑：

node scripts/install-plan.js --list-profiles
node scripts/install-plan.js --profile minimal --target claude --json
node scripts/install-apply.js --profile minimal --target claude --dry-run

針對特定 skill 的安裝：

node scripts/install-plan.js --skills <skill-id> --target claude --json
node scripts/install-apply.js --skills <skill-id> --target claude --dry-run

提醒使用者切勿同時疊加外掛（plugin）安裝與完整的手動/設定檔安裝，除非他們明確需要重複的介面。

專案導入

當使用者希望針對目標儲存庫設定 ECC 時，使用 /project-init。預期的執行順序為：

1. 從專案檔案中偵測技術棧
2. 解析出試執行（dry-run）安裝計畫
3. 檢查現有的 CLAUDE.md 與設定檔
4. 在套用變更前先詢問確認
5. 保持生成的引導簡潔且貼合該儲存庫需求

疑難排解

先詢問目標 harness 與安裝路徑，然後檢查：

• 外掛安裝元資料
• .claude/、.cursor/、.codex/、.gemini/、.opencode/、.codebuddy/、.joycode/ 或 .qwen/
• hooks/hooks.json
• 安裝狀態檔案
• 相關的指令/skill 檔案

若要檢查儲存庫健康度，建議執行：

npm run harness:audit -- --format text
npm run observability:ready
npm test

輸出範本

簡短推薦

請使用 <skill-或-指令>。適合的原因是 <原因>。

標準檔案：<路徑>
驗證方式：<指令>
下一步：<一個具體的行動>

搜尋結果

最佳匹配：
- <路徑>：<為何重要>
- <路徑>：<為何重要>

建議：<優先使用哪一個以及原因>

安裝計畫摘要

偵測到：<技術棧證據>
目標：<harness>
計畫：<設定檔/模組/skills>
試執行：<指令>
將會變更：<路徑>
套用前需要確認：<是/否>

相關介面

• /project-init：針對目標儲存庫感知技術棧的導入計畫
• /harness-audit：確定性的準備度評分表
• /skill-health：skill 品質審查
• /skill-create：從本機 git 歷史紀錄生成新 skill
• /security-scan：檢查 Claude/OpenCode 設定的安全性