代理排序 是做什麼的?
當一個倉庫需要一個專案專用的 ECC 表面,而非預設的完整安裝時,使用此技能。
目標不是猜測「什麼感覺有用」。目標是根據實際程式碼庫的證據來分類 ECC 元件。
使用時機
- 一個專案只需要 ECC 的子集,完整安裝太過吵雜
- 倉庫的技術棧很明確,但沒有人想逐一手動挑選技能
- 團隊希望有一個可重複的安裝決策,該決策基於 grep 證據而非個人意見
- 你需要區分總是載入的每日工作流程表面,以及可搜尋的函式庫/參考表面
- 一個倉庫的語言、規則或鉤子設定已經偏離,需要清理
不可妥協的規則
- 使用當前的倉庫作為真相來源,而非通用偏好
- 每個「DAILY」的決策都必須引用具體的倉庫證據
- 「LIBRARY」不代表「刪除」;它代表「保持可存取,但預設不載入」
- 不要安裝目前倉庫無法使用的鉤子、規則或腳本
- 優先使用 ECC 原生表面;不要引入第二個安裝系統
產出物
按順序產出以下成品:
- DAILY 盤點清單
- LIBRARY 盤點清單
- 安裝計畫
- 驗證報告
- 可選的
skill-library路由器,如果專案需要的話
分類模型
僅使用兩個類別:
DAILY- 每個會話都應為此倉庫載入
- 與倉庫的語言、框架、工作流程或操作表面強烈匹配
LIBRARY- 保留有用,但不值得預設載入
- 應可透過搜尋、路由器技能或有選擇性的手動使用來存取
證據來源
在進行任何分類之前,使用倉庫本地的證據:
- 檔案副檔名
- 套件管理器和鎖定檔
- 框架配置
- CI 和鉤子配置
- 建置/測試腳本
- 引入和依賴清單
- 明確描述技術棧的倉庫文件
有用的指令包括:
rg --files
rg -n "typescript|react|next|supabase|django|spring|flutter|swift"
cat package.json
cat pyproject.toml
cat Cargo.toml
cat pubspec.yaml
cat go.mod
並行審查流程
如果並行子代理可用,將審查拆分為以下流程:
- 代理
- 分類
agents/*
- 分類
- 技能
- 分類
skills/*
- 分類
- 指令
- 分類
commands/*
- 分類
- 規則
- 分類
rules/*
- 分類
- 鉤子和腳本
- 分類鉤子表面、MCP 健康檢查、輔助腳本和作業系統相容性
- 附加項目
- 分類上下文、範例、MCP 配置、模板和指導文件
如果子代理不可用,則依序執行相同的流程。
核心工作流程
1. 讀取倉庫
在分類任何項目之前,先確立實際的技術棧:
- 使用的語言
- 使用的框架
- 主要的套件管理器
- 測試棧
- 程式碼檢查/格式化棧
- 部署/執行時期表面
- 已存在的操作者整合
2. 建立證據表
對於每個候選表面,記錄:
- 元件路徑
- 元件類型
- 提議的類別
- 倉庫證據
- 簡短的理由
使用此格式:
skills/frontend-patterns | skill | DAILY | 84 個 .tsx 檔案,next.config.ts 存在 | 核心前端棧
skills/django-patterns | skill | LIBRARY | 無 .py 檔案,無 pyproject.toml | 此倉庫未啟用
rules/typescript/* | rules | DAILY | package.json + tsconfig.json | 活躍的 TS 倉庫
rules/python/* | rules | LIBRARY | 零個 Python 原始碼檔案 | 僅保持可存取
3. 決定 DAILY 與 LIBRARY
提升為 DAILY 當:
- 倉庫明確使用匹配的技術棧
- 元件足夠通用,能幫助每個會話
- 倉庫已依賴對應的執行時期或工作流程
降級為 LIBRARY 當:
- 元件與技術棧不符
- 倉庫未來可能需要它,但不是每天
- 它增加了上下文負擔,但沒有立即的相關性
4. 建立安裝計畫
將分類轉化為行動:
- DAILY 技能 -> 安裝或保留在
.claude/skills/ - DAILY 指令 -> 僅在仍然有用時保留為明確的 Shims
- DAILY 規則 -> 僅安裝匹配的語言集合
- DAILY 鉤子/腳本 -> 僅保留相容的
- LIBRARY 表面 -> 保持可透過搜尋或
skill-library存取
如果倉庫已經使用選擇性安裝,則更新該計畫,而不是創造另一個系統。
5. 建立可選的函式庫路由器
如果專案想要一個可搜尋的函式庫表面,則建立:
.claude/skills/skill-library/SKILL.md
該路由器應包含:
- DAILY 與 LIBRARY 的簡短說明
- 分組的觸發關鍵字
- 函式庫參考的位置
不要將每個技能主體複製到路由器中。
6. 驗證結果
套用計畫後,驗證:
- 每個 DAILY 檔案都存在於預期位置
- 過時的語言規則沒有被保留啟用
- 不相容的鉤子沒有被安裝
- 最終的安裝確實與倉庫技術棧匹配
回傳一份簡潔的報告,包含:
- DAILY 數量
- LIBRARY 數量
- 已移除的過時表面
- 未解決的問題
交接
如果下一步是互動式安裝或修復,請交接給:
configure-ecc
如果下一步是重疊清理或目錄審查,請交接給:
skill-stocktake
如果下一步是更廣泛的上下文修剪,請交接給:
strategic-compact
輸出格式
按此順序回傳結果:
STACK
- 語言/框架/執行時期摘要
DAILY
- 總是載入的項目及其證據
LIBRARY
- 可搜尋/參考的項目及其證據
INSTALL PLAN
- 應該安裝、移除或重新路由的項目
VERIFICATION
- 已執行的檢查和剩餘的差距