ECC 指南 是做什麼的?
當使用者需要協助來理解、導航、安裝或選擇 Everything Claude Code 的各個部分時,使用此技能。
使用時機
當使用者遇到以下情況時,使用此技能:
- 詢問 ECC 包含哪些內容
- 需要協助尋找技能、命令、代理、鉤子、規則或安裝設定檔
- 是倉儲的新手,需要引導路徑
- 詢問「如何使用 ECC 做 X?」
- 詢問哪些 ECC 元件適合其專案
- 需要一個輕量化的解釋來說明命令、技能、代理、鉤子和規則之間的關係
- 對於安裝路徑、重複安裝、重設/解除安裝或選擇性安裝選項感到困惑
核心原則
從當前檔案中回答,而非依賴記憶。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/:維護的斜線命令相容性墊片skills/*/SKILL.md:可重複使用的工作流程與領域手冊agents/*.md:委派的子代理角色提示rules/:語言與框架規則hooks/README.md,hooks/hooks.json,scripts/hooks/:鉤子行為與安全閘門manifests/install-*.json:選擇性安裝模組、元件、設定檔與目標支援docs/:框架指南、架構說明、翻譯文件、發行說明
回覆風格
直接以答案開頭,然後給出下一步行動。大多數使用者不需要完整的目錄轉儲。
良好的第一回覆架構:
- 使用什麼
- 為什麼適合
- 要檢查的具體檔案或命令
- 一個下一步命令或問題
避免:
- 預設列出每個技能或命令
- 重複大段的 README 內容
- 當技能優先的路徑存在時,推薦已淘汰的命令墊片
- 未經檢查檔案系統就聲稱某個元件存在
- 當受管理的安裝程式支援該目標時,用複製命令來取代安裝指導
常見任務
新手上路
提供一個簡短選單:
- 安裝或重設 ECC
- 為專案挑選技能
- 理解命令 vs 技能
- 檢查鉤子與安全行為
- 執行框架稽核
- 尋找特定工作流程
指向 README.md 以取得安裝/重設資訊,指向 /project-init 以取得專案特定上手指南。
功能探索
對於「我該用什麼來做 X?」:
- 搜尋
skills/、commands/和agents/。 - 偏好以技能作為主要的工作流程介面。
- 僅在命令是維護中的相容性墊片或使用者明確想要斜線命令行為時,才使用命令。
- 當委派有用時,提及代理。
有用的搜尋:
rg -n "<查詢>" 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
針對特定技能的安裝:
node scripts/install-plan.js --skills <skill-id> --target claude --json
node scripts/install-apply.js --skills <skill-id> --target claude --dry-run
警告使用者,除非他們有意想要重複的介面,否則不要疊加外掛安裝與完整的手動/設定檔安裝。
專案初始化
當使用者想要為目標倉儲配置 ECC 時,使用 /project-init。預期流程是:
- 從專案檔案偵測技術棧
- 解析出一個試運行安裝計畫
- 檢查現有的
CLAUDE.md與設定檔 - 應用變更前先詢問
- 保持生成的指導精簡且針對特定倉儲
疑難排解
首先詢問目標框架與安裝路徑,然後檢查:
- 外掛安裝中繼資料
.claude/,.cursor/,.codex/,.gemini/,.opencode/,.codebuddy/,.joycode/或.qwen/hooks/hooks.json- 安裝狀態檔案
- 相關的命令/技能檔案
對於倉儲健康狀況,建議執行:
npm run harness:audit -- --format text
npm run observability:ready
npm test
輸出範本
簡短建議
使用 <技能或命令>。它適合是因為 <原因>。
標準檔案:<路徑>
驗證方式:<命令>
下一步:<一個具體行動>
搜尋結果
最佳匹配:
- <路徑>:<為何重要>
- <路徑>:<為何重要>
建議:<先使用哪一個及其原因>
安裝計畫摘要
偵測到:<技術棧證據>
目標:<框架>
計畫:<設定檔/模組/技能>
試運行:<命令>
將變更:<路徑>
應用前需批准:<是/否>
相關介面
/project-init:基於技術棧的目標倉儲上手指南/harness-audit:確定性就緒狀態卡/skill-health:技能品質審查/skill-create:從本地 git 歷史生成新技能/security-scan:檢查 Claude/OpenCode 設定安全性