agent-sort

agent-sort 技能概覽

agent-sort 是一個具備 repo 感知能力的規劃技能，專門用來把範圍很大的 ECC 設定，收斂成較小、以證據為基礎的安裝範圍。它可以協助你判斷哪些內容應該每日載入，哪些應該保留在可搜尋的知識庫中，避免為專案裝入太多實際上不會用到的 skills、rules、hooks 或 scripts。

這個技能最適合維護者、agent workflow 負責人，以及任何在既有 repo 上執行 agent-sort install 的人。它真正要解決的不是「整理檔案」，而是根據實際 codebase 做出站得住腳的安裝決策，減少猜測，也降低 ECC 雜訊。

agent-sort 的用途

當你需要把 repo 內特定的 ECC 元件分類到實務上可用的區塊時，就適合使用 agent-sort skill，尤其是在流程混合、或 ECC 採用程度不一的專案裡。它很適合在保留日常載入內容精簡的同時，也把參考資料留給之後查找。

agent-sort 的不同之處

agent-sort skill 是以證據為本：安裝計畫由 repository 內容決定，而不是由個人偏好決定。它最強的價值在於減少誤裝，並把專案真正有在用的東西浮現出來，因此比一般的 prompt 更偏向決策工具，而不是純描述工具。

最適合與不適合的情境

如果 repo 已經有 ECC，但範圍過大、重複太多，或逐漸偏離專案真實工作流程，這個技能就很適合。若你只是想快速用一次性 prompt 摘要 repo，或者專案根本沒有使用 ECC 原生介面，那它就不是很理想的選擇。

如何使用 agent-sort skill

安裝與情境設定

先在目標 repository 中執行 agent-sort install 流程，然後把 skills/agent-sort/SKILL.md 當成你的操作指南。這個技能是設計成根據 repository 證據來工作，因此要在你實際評估的 repo 旁邊安裝，而不是把它當成獨立工具單獨使用。

能提升輸出品質的輸入

給 skill 明確的目標 repo、清楚的範圍，以及你在意的決策邊界。好的輸入像是：「把這個 repo 的 ECC surfaces 分成目前 app 的 DAILY 與 LIBRARY，只保留日常 agent run 需要的內容。」差的輸入則很模糊，例如「整理這個專案」或「讓它更乾淨」。

建議工作流程

先檢查 repo 自己的 README、AGENTS 風格說明，以及任何與 ECC 相關的資料夾或 manifest 檔。接著用 agent-sort usage 把具體證據對應到 daily-load 候選項、僅供 library 參考的內容，以及完全不該安裝的項目。目標是產出精簡的安裝計畫並附上驗證步驟，而不是推測性的重構提案。

先讀哪些檔案

先從 SKILL.md 開始，再查看 repo tree 裡的 README.md、AGENTS.md、metadata.json，以及任何 rules/、resources/、references/ 或 scripts/ 資料夾。在這個 repo 裡，SKILL.md 是主要來源，因為沒有可交叉比對的支援檔。

agent-sort skill 常見問題

agent-sort 只適用於 ECC 專案嗎？

是，agent-sort 是圍繞 ECC-native surfaces 與安裝決策設計的。如果你的 repository 不採用這種模式，用一般 prompt 通常更簡單，也更合適，不一定需要 agent-sort skill。

這和一般 prompt 有什麼不同？

一般 prompt 可以快速給出建議，但 agent-sort 會要求以證據為基礎的分類與安裝計畫。當你需要在整個 repo 中重複使用 agent-sort usage，而不是只得到一次性的意見時，這個差異就很重要。

agent-sort 對初學者友善嗎？

如果你能指出要評估的 repo，並且願意先閱讀 source tree，那它對初學者是友善的。主要門檻不是深厚的 ECC 專業知識，而是要清楚分辨哪些內容應該每日安裝，哪些應該保留為 library material。

什麼情況下不該用 agent-sort？

如果你只需要一般的 repo 摘要、專案根本沒有可分類的 ECC surfaces，或你要的是大範圍 refactor 而不是安裝決策，就不要用它。在這些情況下，agent-sort for Skill Authoring 的額外成本是不必要的。

如何改善 agent-sort skill

提供更精準的 repo 證據

最好的 agent-sort 結果來自具體的 repository 訊號：file paths、目前的 workflow 名稱，以及 agent 實際會碰到的範例。如果你能指出特定命令、資料夾或 rule files，daily/library 的切分就會更準確。

把安裝邊界說清楚

要明確說明你是在替整個 repo、某個 subpackage，還是某條狹窄 workflow 做分類。邊界越精準，技能就越不會把參考資料過度歸類為 daily load，這也是 agent-sort install 工作裡常見的失誤模式。

檢查第一輪是否載入過重

如果輸出看起來太重，就追問哪些項目真的是每次執行都需要，哪些只是查閱用資料。最有價值的迭代方式，是把 daily installs 持續縮減，直到計畫反映的是日常使用，而不是理論上的有用性。

保留有價值的 library material

一個好的 agent-sort guide 不會把所有非 daily 的內容都刪掉。只要邊界內容能支援後續決策，就把它留在 library 裡，因為這個技能的目的是降低預設載入量，而不是抹掉專案知識。