configure-ecc

設定 Everything Claude Code (ECC)

Everything Claude Code 專案的互動式逐步安裝精靈。使用 AskUserQuestion 引導使用者選擇性安裝技能與規則，然後驗證正確性並提供最佳化選項。

何時啟用

• 使用者說「設定 ecc」、「安裝 ecc」、「設定 everything claude code」或類似內容
• 使用者想要從此專案選擇性安裝技能或規則
• 使用者想要驗證或修復現有的 ECC 安裝
• 使用者想要針對其專案最佳化已安裝的技能或規則

前置需求

此技能必須在啟用前可被 Claude Code 存取。有兩種引導方式：

1. 透過外掛：/plugin install ecc@ecc — 外掛會自動載入此技能
2. 手動：僅將此技能複製到 ~/.claude/skills/configure-ecc/SKILL.md，然後說「設定 ecc」來啟用

---

步驟 0：複製 ECC 儲存庫

在安裝之前，先將最新的 ECC 原始碼複製到 /tmp：

rm -rf /tmp/everything-claude-code
git clone https://github.com/affaan-m/everything-claude-code.git /tmp/everything-claude-code

將 ECC_ROOT=/tmp/everything-claude-code 設為後續所有複製操作的來源目錄。

如果複製失敗（網路問題等），使用 AskUserQuestion 詢問使用者提供現有 ECC 複本的本地路徑。

---

步驟 1：選擇安裝層級

使用 AskUserQuestion 詢問使用者要安裝在哪裡：

問題：「ECC 元件應安裝在哪裡？」
選項：
  - 「使用者層級 (~/.claude/)」—「適用於你所有的 Claude Code 專案」
  - 「專案層級 (.claude/)」—「僅適用於當前專案」
  - 「兩者」—「共用/共享項目在使用者層級，專案特定項目在專案層級」

將選擇儲存為 INSTALL_LEVEL。設定目標目錄：

• 使用者層級：TARGET=~/.claude
• 專案層級：TARGET=.claude（相對於當前專案根目錄）
• 兩者：TARGET_USER=~/.claude，TARGET_PROJECT=.claude

如果目標目錄不存在，則建立它們：

mkdir -p $TARGET/skills $TARGET/rules

---

步驟 2：選擇並安裝技能

2a：選擇範圍（核心 vs 特定領域）

預設為核心（推薦給新使用者） — 複製 .agents/skills/* 加上 skills/search-first/ 以支援研究優先的工作流程。此套件涵蓋工程、評估、驗證、安全性、策略壓縮、前端設計以及 Anthropic 跨功能技能（文章寫作、內容引擎、市場研究、前端簡報）。

使用 AskUserQuestion（單選）：

問題：「只安裝核心技能，還是包含特定領域/框架套件？」
選項：
  - 「僅核心（推薦）」—「tdd、e2e、評估、驗證、研究優先、安全性、前端模式、壓縮、跨功能 Anthropic 技能」
  - 「核心 + 選定特定領域」—「在核心之後加入框架/領域特定技能」
  - 「僅特定領域」—「跳過核心，安裝特定框架/領域技能」
預設：僅核心

如果使用者選擇特定領域或核心 + 特定領域，繼續進行下方的類別選擇，並僅包含他們挑選的特定領域技能。

2b：選擇技能類別

以下有 7 個可選擇的類別群組。後續的詳細確認清單涵蓋 8 個類別共 45 個技能，加上 1 個獨立範本。使用 AskUserQuestion 搭配 multiSelect: true：

問題：「你想安裝哪些技能類別？」
選項：
  -「框架與語言」—「Django、Laravel、Spring Boot、Quarkus、Go、Python、Java、前端、後端模式」
  -「資料庫」—「PostgreSQL、ClickHouse、JPA/Hibernate 模式」
  -「工作流程與品質」—「TDD、驗證、學習、安全審查、壓縮」
  -「研究與 API」—「深度研究、Exa 搜尋、Claude API 模式」
  -「社交與內容發布」—「X/Twitter API、跨平台發布搭配內容引擎」
  -「媒體生成」—「fal.ai 圖片/影片/音訊搭配 VideoDB」
  -「編排」—「dmux 多代理工作流程」
  -「所有技能」—「安裝所有可用的技能」

2c：確認個別技能

對於每個選定的類別，列出下方所有技能，並要求使用者確認或取消選擇特定項目。如果清單超過 4 個項目，以文字形式列印清單，並使用 AskUserQuestion 提供「安裝所有列出項目」選項，以及「其他」讓使用者貼上特定名稱。

類別：框架與語言（25 個技能）

技能	說明
backend-patterns	後端架構、API 設計、Node.js/Express/Next.js 的伺服器端最佳實務
coding-standards	TypeScript、JavaScript、React、Node.js 的通用編碼標準
django-patterns	Django 架構、使用 DRF 的 REST API、ORM、快取、訊號、中介軟體
django-security	Django 安全性：驗證、CSRF、SQL 注入、XSS 防護
django-tdd	使用 pytest-django、factory_boy、模擬、涵蓋率的 Django 測試
django-verification	Django 驗證循環：遷移、linting、測試、安全掃描
laravel-patterns	Laravel 架構模式：路由、控制器、Eloquent、佇列、快取
laravel-security	Laravel 安全性：驗證、政策、CSRF、大量指派、速率限制
laravel-tdd	使用 PHPUnit 和 Pest、工廠、假物件、涵蓋率的 Laravel 測試
laravel-verification	Laravel 驗證：linting、靜態分析、測試、安全掃描
frontend-patterns	React、Next.js、狀態管理、效能、UI 模式
frontend-slides	零依賴的 HTML 簡報、樣式預覽，以及 PPTX 轉網頁
golang-patterns	慣用的 Go 模式，打造穩健 Go 應用程式的慣例
golang-testing	Go 測試：表格驅動測試、子測試、基準測試、模糊測試
java-coding-standards	Spring Boot 和 Quarkus 的 Java 編碼標準：命名、不可變性、Optional、串流、CDI
python-patterns	Python 慣用寫法、PEP 8、型別提示、最佳實務
python-testing	使用 pytest、TDD、fixtures、模擬、參數化的 Python 測試
quarkus-patterns	Quarkus 架構、Camel 訊息傳遞、CDI 服務、Panache 資料存取
quarkus-security	Quarkus 安全性：JWT/OIDC、RBAC、輸入驗證、機密管理
quarkus-tdd	使用 JUnit 5、Mockito、REST Assured、Camel 測試的 Quarkus TDD
quarkus-verification	Quarkus 驗證：建置、靜態分析、測試、原生編譯
springboot-patterns	Spring Boot 架構、REST API、分層服務、快取、非同步
springboot-security	Spring Security：驗證/授權、驗證、CSRF、機密、速率限制
springboot-tdd	使用 JUnit 5、Mockito、MockMvc、Testcontainers 的 Spring Boot TDD
springboot-verification	Spring Boot 驗證：建置、靜態分析、測試、安全掃描

類別：資料庫（3 個技能）

技能	說明
clickhouse-io	ClickHouse 模式、查詢最佳化、分析、資料工程
jpa-patterns	JPA/Hibernate 實體設計、關聯、查詢最佳化、交易
postgres-patterns	PostgreSQL 查詢最佳化、綱要設計、索引、安全性

類別：工作流程與品質（8 個技能）

技能	說明
continuous-learning	舊版 v1 停止鉤子階段模式提取；新安裝建議使用 continuous-learning-v2
continuous-learning-v2	基於直覺的學習，搭配信心評分，演化為技能、代理，以及可選的舊版指令橋接
eval-harness	評估驅動開發 (EDD) 的正式評估框架
iterative-retrieval	針對子代理上下文問題的漸進式上下文精煉
security-review	安全檢查清單：驗證、輸入、機密、API、付款功能
strategic-compact	建議在邏輯間隔進行手動上下文壓縮
tdd-workflow	強制 TDD 達到 80% 以上涵蓋率：單元、整合、端對端
verification-loop	驗證與品質循環模式

類別：商業與內容（5 個技能）

技能	說明
article-writing	使用提供的語氣，根據筆記、範例或來源文件進行長篇寫作
content-engine	多平台社交內容、腳本與重新利用工作流程
market-research	附來源的市場、競爭者、基金與技術研究
investor-materials	募資簡報、一頁摘要、投資者備忘錄與財務模型
investor-outreach	個人化的投資者冷郵件、暖介紹與後續追蹤

類別：研究與 API（2 個技能）

技能	說明
deep-research	使用 firecrawl 和 exa MCP 的多來源深度研究，附引用報告
exa-search	透過 Exa MCP 的神經搜尋，用於網路、程式碼、公司與人物研究

claude-api 是 Anthropic 的標準技能。當你想要官方的 Claude API 工作流程而非 ECC 捆綁版本時，從 anthropics/skills 安裝它。

類別：社交與內容發布（2 個技能）

技能	說明
x-api	X/Twitter API 整合，用於發文、討論串、搜尋與分析
crosspost	多平台內容發布，搭配平台原生改編

類別：媒體生成（2 個技能）

技能	說明
fal-ai-media	透過 fal.ai MCP 的統一 AI 媒體生成（圖片、影片、音訊）
video-editing	AI 輔助影片編輯，用於剪輯、結構化與增強真實素材

類別：編排（1 個技能）

技能	說明
dmux-workflows	使用 dmux 進行多代理編排，實現平行代理會話

獨立項目

技能	說明
docs/examples/project-guidelines-template.md	用於建立專案特定技能的範本

2d：執行安裝

對於每個選定的技能，從正確的來源根目錄複製整個技能目錄：

# 核心技能位於 .agents/skills/ 下
cp -R "$ECC_ROOT/.agents/skills/<skill-name>" "$TARGET/skills/"

# 特定領域技能位於 skills/ 下
cp -R "$ECC_ROOT/skills/<skill-name>" "$TARGET/skills/"

在遍歷萬用字元來源目錄時，切勿將結尾斜線的來源直接傳遞給 cp。請明確使用目錄路徑作為目標名稱：

cp -R "${src%/}" "$TARGET/skills/$(basename "${src%/}")"

注意：continuous-learning 和 continuous-learning-v2 有額外檔案（config.json、鉤子、腳本）— 確保複製整個目錄，而不只是 SKILL.md。

---

步驟 3：選擇並安裝規則

使用 AskUserQuestion 搭配 multiSelect: true：

問題：「你想安裝哪些規則集？」
選項：
  -「通用規則（推薦）」—「與語言無關的原則：編碼風格、Git 工作流程、測試、安全性等（8 個檔案）」
  -「TypeScript/JavaScript」—「TS/JS 模式、鉤子、使用 Playwright 的測試（5 個檔案）」
  -「Python」—「Python 模式、pytest、black/ruff 格式化（5 個檔案）」
  -「Go」—「Go 模式、表格驅動測試、gofmt/staticcheck（5 個檔案）」

執行安裝：

# 通用規則
cp -r $ECC_ROOT/rules/common $TARGET/rules/common

# 語言特定規則（保留各語言目錄）
cp -r $ECC_ROOT/rules/typescript $TARGET/rules/typescript   # 如果選取
cp -r $ECC_ROOT/rules/python $TARGET/rules/python            # 如果選取
cp -r $ECC_ROOT/rules/golang $TARGET/rules/golang            # 如果選取

重要：如果使用者選取了任何語言特定規則但未選取通用規則，請警告他們：

「語言特定規則擴充了通用規則。不安裝通用規則可能導致涵蓋不完整。是否也安裝通用規則？」

---

步驟 4：安裝後驗證

安裝後，執行以下自動檢查：

4a：驗證檔案存在

列出所有已安裝的檔案，並確認它們存在於目標位置：

ls -la $TARGET/skills/
ls -la $TARGET/rules/

4b：檢查路徑引用

掃描所有已安裝的 .md 檔案中的路徑引用：

grep -rn "~/.claude/" $TARGET/skills/ $TARGET/rules/
grep -rn "../common/" $TARGET/rules/
grep -rn "skills/" $TARGET/skills/

對於專案層級安裝，標記任何對 ~/.claude/ 路徑的引用：

• 如果技能引用了 ~/.claude/settings.json — 這通常沒問題（設定總是在使用者層級）
• 如果技能引用了 ~/.claude/skills/ 或 ~/.claude/rules/ — 如果僅安裝在專案層級，這可能會出問題
• 如果技能按名稱引用了另一個技能 — 檢查被引用的技能是否也已安裝

4c：檢查技能間的交叉引用

某些技能會引用其他技能。驗證這些依賴關係：

• django-tdd 可能引用 django-patterns
• laravel-tdd 可能引用 laravel-patterns
• quarkus-tdd 可能引用 quarkus-patterns
• springboot-tdd 可能引用 springboot-patterns
• continuous-learning-v2 引用 ~/.claude/homunculus/ 目錄
• python-testing 可能引用 python-patterns
• golang-testing 可能引用 golang-patterns
• crosspost 引用 content-engine 和 x-api
• deep-research 引用 exa-search（互補的 MCP 工具）
• fal-ai-media 引用 videodb（互補的媒體技能）
• x-api 引用 content-engine 和 crosspost
• 語言特定規則引用 common/ 對應項目

4d：回報問題

對於發現的每個問題，回報：

1. 檔案：包含問題引用的檔案
2. 行號：行號
3. 問題：哪裡出錯（例如「引用了 ~/.claude/skills/python-patterns 但 python-patterns 未安裝」）
4. 建議修復：該怎麼做（例如「安裝 python-patterns 技能」或「將路徑更新為 .claude/skills/」）

---

步驟 5：最佳化已安裝的檔案（可選）

使用 AskUserQuestion：

問題：「你是否想要針對你的專案最佳化已安裝的檔案？」
選項：
  -「最佳化技能」—「移除不相關的章節、調整路徑、針對你的技術棧量身打造」
  -「最佳化規則」—「調整涵蓋目標、加入專案特定模式、自訂工具設定」
  -「兩者都最佳化」—「完整最佳化所有已安裝的檔案」
  -「跳過」—「保持所有檔案原樣」

如果最佳化技能：

1. 讀取每個已安裝的 SKILL.md
2. 詢問使用者他們的專案技術棧是什麼（如果還不知道）
3. 對於每個技能，建議移除不相關的章節
4. 在安裝目標（而非來源儲存庫）就地編輯 SKILL.md 檔案
5. 修復步驟 4 中發現的任何路徑問題

如果最佳化規則：

1. 讀取每個已安裝的規則 .md 檔案
2. 詢問使用者他們的偏好：
   • 測試涵蓋率目標（預設 80%）
   • 偏好的格式化工具
   • Git 工作流程慣例
   • 安全性需求
3. 在安裝目標就地編輯規則檔案

關鍵：僅修改安裝目標（$TARGET/）中的檔案，絕對不要修改來源 ECC 儲存庫（$ECC_ROOT/）中的檔案。

---

步驟 6：安裝摘要

從 /tmp 清理已複製的儲存庫：

rm -rf /tmp/everything-claude-code

然後列印摘要報告：

## ECC 安裝完成

### 安裝目標
- 層級：[使用者層級 / 專案層級 / 兩者]
- 路徑：[目標路徑]

### 已安裝的技能（[數量]）
- skill-1, skill-2, skill-3, ...

### 已安裝的規則（[數量]）
- common（8 個檔案）
- typescript（5 個檔案）
- ...

### 驗證結果
- 發現 [數量] 個問題，已修復 [數量] 個
- [列出任何剩餘問題]

### 已套用的最佳化
- [列出所做的變更，或「無」]

---

疑難排解

###「技能未被 Claude Code 辨識」

• 確認技能目錄包含 SKILL.md 檔案（而不只是鬆散的 .md 檔案）
• 對於使用者層級：檢查 ~/.claude/skills/<skill-name>/SKILL.md 是否存在
• 對於專案層級：檢查 .claude/skills/<skill-name>/SKILL.md 是否存在

###「規則無法運作」

• 規則是平面檔案，不在子目錄中：$TARGET/rules/coding-style.md（正確）vs $TARGET/rules/common/coding-style.md（平面安裝時不正確）
• 安裝規則後重新啟動 Claude Code

###「專案層級安裝後的路徑引用錯誤」

• 某些技能假設 ~/.claude/ 路徑。執行步驟 4 驗證來找出並修復這些問題。
• 對於 continuous-learning-v2，~/.claude/homunculus/ 目錄總是在使用者層級 — 這是預期行為，不是錯誤。