skill-template

skill-template 作為開發者與 AI 代理設計、記錄與部署上下文工程框架內新功能的基礎架構。它強制執行一種模組化結構，旨在通過漸進式揭露（progressive disclosure）最小化 token 開銷並最大化代理的理解力。透過使用此模板，開發者能確保其自定義的代理技能在 Claude Code 與其他整合開發環境中均具有可發現性、可解釋性與可維護性。它促進了從隨意提示（ad-hoc prompting）轉向穩健、可重用技能庫的過程。

• 標準化技能文檔結構，包含觸發條件、核心概念與實施指南。

• 強制執行嚴格的 token 高效格式，優化上下文窗口使用並防止效能下降。

• 整合相關技能的相依性文檔，以維護連貫的代理生態系統。

• 提供將詳細參考資料置於外部文件的機制，確保主 SKILL.md 文件保持在 500 行以內。

• 鼓勵使用第三人稱、無歧義的語言，以優化代理系統提示詞的注入效果。

• 當擴展上下文工程技能集合並新增工具或專業推理功能時，請使用此模板。

• 確保填寫作者、版本與建立日期等所有元數據欄位，以支援版本控制與可審計性。

• 優先填寫 'Gotchas' 部分以記錄經驗所得的失敗模式，這能為其他代理提供最高訊號的上下文。

• 務必驗證技能描述是否簡潔，以便於代理發現服務，同時不犧牲必要的運作指令。

• 將詳細的技術參考資料保持在 references/ 目錄中，避免在技能初步發現階段淹沒代理的注意力。

• 跨不同的代理執行時環境測試技能，以確保嚴格遵守平台無關的設計原則。