agent-sort

Agent Sort

當儲存庫需要專案專屬的 ECC 表面，而非預設完整安裝時，使用此技能。

目標不是猜測「什麼感覺有用」，而是根據實際程式碼庫的證據來分類 ECC 元件。

使用時機

• 專案只需要 ECC 的子集，完整安裝過於雜亂
• 儲存庫的技術棧很明確，但沒有人想逐一手動挑選技能
• 團隊希望基於 grep 證據而非意見，做出可重複的安裝決策
• 需要將始終載入的日常工作流程表面與可搜尋的函式庫/參考表面分開
• 儲存庫已偏離正確的語言、規則或鉤子設定，需要清理

不可妥協的規則

• 以當前儲存庫為事實依據，而非通用偏好
• 每個 DAILY 決策必須引用具體的儲存庫證據
• LIBRARY 不代表「刪除」，而是「保持可存取，但預設不載入」
• 不要安裝當前儲存庫無法使用的鉤子、規則或腳本
• 優先使用 ECC 原生表面，不要引入第二套安裝系統

產出

依序產出以下成品：

1. DAILY 清單
2. LIBRARY 清單
3. 安裝計畫
4. 驗證報告
5. 可選的 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

平行審查環節

若可使用平行子代理，將審查拆分為以下環節：

1. 代理
   • 分類 agents/*
2. 技能
   • 分類 skills/*
3. 指令
   • 分類 commands/*
4. 規則
   • 分類 rules/*
5. 鉤子與腳本
   • 分類鉤子表面、MCP 健康檢查、輔助腳本與作業系統相容性
6. 額外項目
   • 分類上下文、範例、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 指令 -> 僅在仍有幫助時保留為明確的 shim
• 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
- 執行的檢查與剩餘差距