調校技能
調校是對已存在技能進行一系列微小、有證據支持的編輯，而非重寫。目標是讓技能在正確的請求上觸發，不干擾同級技能，並以定義好的格式傳遞工作。
基本規則
- 先讀取真正的 SKILL.md。 README、倉庫描述和列表經常與代理實際載入的檔案內容有出入。任何關於技能的斷言都必須來自其
SKILL.md或其參考資料。如果你無法開啟檔案，請明確說出檔名，並說明你正在進行推論。 - 檢查自己的主張。 如果你後來讀取的檔案與你先前說的話矛盾，請坦白說明並修正。不要默默地繞過這個矛盾。
- 最小編輯，保留作者的語氣。 僅修改稽核發現的問題，不要動其他內容。保留你不認識的前置資料鍵（例如
version、argument-hint、user-invocable）。絕不削弱誠實、安全或隱私規則。 - 沒有實際運行的東西就不要聲稱。 說明哪些檢查已經執行、哪些測試案例只是撰寫而未執行、以及哪些檔案你從未見過。
工作流程
1. 收集
獲取目標技能及其所有相關同級技能的 SKILL.md，以及你能夠取得的任何參考資料。如果使用者提供了一個你無法開啟的連結，請要求提供檔案內容或連結。如果技能是磁碟上的一個資料夾，請立即執行檢查腳本（步驟 6）以進行初步讀取。
2. 繪製地圖
為每個技能撰寫一個簡短的清單：其描述承諾的功能、模式或指令、所引用的參考檔案，以及它會將工作交接給誰。將同級技能的描述和指令列表並列比較。只有當你能同時看到兩者時，重疊之處才會顯現出來。
3. 稽核
依照 references/audit-checklist.md 進行檢查。每個發現都需記錄證據（引用該行內容）、嚴重程度（破壞觸發、造成混淆或僅為外觀問題），以及最小的修正方式。優先報告最嚴重的問題。
4. 界定歸屬
當兩個技能宣稱處理同一個請求時，將擁有權交給其中一個。使用使用者自己的設計中已經採用的拆分方式（例如，判決 vs. 成品：一個技能負責判斷，另一個負責撰寫）。僅在使用者的設計無法解決問題時才詢問使用者，且只問一次。
5. 編輯
執行能修正每個發現的最小修改。當使用者會直接將結果放入倉庫時，請提供完整的替換檔案，並精確地複製未修改的內容。當某個修正需要一個新的共享元件（例如交接格式）時，請新增一個新的參考檔案，而不是編輯你未曾見過的檔案。列出任何可能需要同步更新的參考檔案。
6. 驗證
在每個技能資料夾上執行檢查腳本：
python scripts/check_skill.py <path-to-skill-folder>
該腳本會檢查名稱是否與資料夾相符、描述是否不超過 1024 個字元且包含觸發和邊界條件的關鍵字、一級標題是否與名稱相符、引用的檔案是否存在、以及主體長度是否合理。修正所有 FAIL 項目，並判斷每個 WARN 項目。如果你只有貼上的文字，請將 SKILL.md 儲存到以技能名稱命名的資料夾中，然後在那裡執行腳本；在這種情況下，缺少參考檔案的警告是預期中的。
7. 撰寫測試案例
依照 references/test-cases.md 的指引。你修改的每個邊界條件都需在兩側各撰寫一個測試案例。手動對照描述來執行這些案例。有些代理在其創作工具中內建了自動化的觸發循環；如果你沒有執行這樣的循環，就不要暗示你執行過。說明你實際執行了哪些步驟。
8. 報告
報告應簡潔扼要：
- 每個技能做了哪些修改，以及原因（每個一行）。
- 對你先前說過的話進行修正。
- 你無法看到的內容或未執行的步驟。
- 一個下一步行動。
報告的開頭應是修改內容，而非過程。