個人技能建構器

個人技能建構器 是做什麼的？

建立小型、可被發現的技能，以改善代理在特定重複性工作流程中的決策。

範圍

使用此技能來建立新技能或對現有技能進行重點修改。請保留使用者要求的位置、調用策略及授權邊界。請勿僅為了存放代理已知的通用建議而建立技能。

工作流程

1. 在撰寫檔案前先定義任務邊界：

   • 該技能提供什麼重複性產出？
   • 哪些請求應觸發它，而哪些類似請求不應觸發？
   • 有哪些輸入、工具、副作用及完成檢查？

2. 在變更現有技能前先檢查它。保留有用的資源與策略；請勿重新初始化現有目錄。

3. 選擇最小的結構：

   • SKILL.md 是必需的。
   • 僅在包含大量、條件性且會改變決策的資料時才加入 references/。
   • 僅在包含重複性或確定性工作（且執行能提升可靠性）時才加入 scripts/。
   • 僅在包含用於生成輸出檔案時才加入 assets/。

4. 撰寫 SKILL.md：

   • 前端資料 name 必須為小寫連字號、與目錄名稱一致，且長度不超過 64 個字元。
   • description 必須同時說明技能的作用及適用時機；包含邊界說明以防止誤路由。
   • 保持主體專注於產出、非顯而易見的規則、執行順序、確認點及完成檢查。
   • 將條件性細節放在連結資源中，並明確說明何時應閱讀。

5. 當環境提供可用的技能驗證器時（請在已安裝的 skill-creator 技能下尋找 quick_validate.py），使用驗證器驗證結果：

   python3 <skill-creator>/scripts/quick_validate.py /path/to/skill
   

   若無可用的驗證器，請手動執行等效的前端資料、命名、資源連結、佔位符及腳本檢查。在可行時執行已加入的腳本。

設計規則

• 將描述視為路由條件，而非功能目錄。
• 保持共用指令簡短，以便常規載入；請勿將完整的外部規格複製到入口點。
• 優先使用明確的範圍與可觀察的完成標準，而不是廣泛的禁止或模糊的品質形容詞。
• 請勿在沒有具體工作流程使用它們的情況下加入 README 檔案、範例、範本或資源目錄。
• 更新技能時，保留現有的支援前端資料與 agents/openai.yaml 欄位。
• 除非使用者明確要求僅限明確調用，否則保持自動發現啟用。

參考資料

在對可移植性、前端資料欄位、命名限制或載入行為不確定時，請閱讀 Agent Skills 規範。將使用者提供或機器本地的設計指南視為可選偏好來源：僅在使用者明確要求這些慣例或任務依賴它們時才閱讀，且請勿複製其完整內容到技能中。請諮詢已安裝的 skill-creator 技能以取得初始化器、UI 中繼資料或驗證細節，而不要依賴於機器特定的絕對路徑。