建立技能

建立有效技能的指南，透過專業知識、工作流程和工具整合來擴展代理程式能力。

關於技能

技能是模組化、自包含的套件，透過提供專業知識、工作流程和工具來擴展代理程式能力。把它們想像成特定領域或任務的「入門指南」。

技能提供的內容

專業工作流程 - 特定領域的多步驟程序
工具整合 - 使用特定檔案格式或 API 的說明
領域專業知識 - 公司特定知識、結構、商業邏輯
捆綁資源 - 用於複雜和重複性任務的腳本、參考資料和資產

漸進式揭露原則

200 行規則至關重要。 SKILL.md 必須少於 200 行。如果需要更多內容，請將內容拆分到 references/ 檔案中。

三層載入系統

中繼資料（名稱 + 描述） - 始終在上下文中（約 100 字）
SKILL.md 主體 - 當技能觸發時（<200 行，理想情況下 <500 行以獲得最佳效能）
捆綁資源 - 按代理程式需要載入（無限制）

為什麼漸進式揭露很重要

初始上下文載入減少 85%
啟動時間從 500 毫秒以上降至 100 毫秒以下
代理程式只載入需要的內容，在需要的時候載入
技能保持可維護性和專注性

技能結構

skill-name/
├── SKILL.md（必要，<200 行）
│   ├── YAML 前端中繼資料（必要）
│   │   ├── name:（必要）
│   │   └── description:（必要）
│   └── Markdown 說明（必要）
└── 捆綁資源（選用）
    ├── scripts/          - 可執行程式碼
    ├── references/       - 按需載入的文件
    └── assets/           - 輸出中使用的檔案

核心原則

簡潔是關鍵

上下文視窗是共享資源。你的技能與代理程式所需的其他所有內容共享它。保持簡潔，並挑戰每一項資訊：

代理程式真的需要這個解釋嗎？
我可以假設代理程式知道這個嗎？
這個段落值得它的 token 成本嗎？

設定適當的自由度

高自由度：針對多種有效方法的文字說明
中自由度：帶參數的虛擬碼或腳本
低自由度：針對脆弱操作使用少數或無參數的特定腳本

使用所有模型測試

技能作為模型的附加功能，因此效果取決於底層模型。使用你計劃使用的所有模型測試你的技能。

參考資料

如需詳細指南，請參閱：

references/progressive-disclosure.md - 200 行規則和參考模式
references/skill-structure.md - SKILL.md 格式和前端詳細資訊
references/examples.md - 良好的技能範例
references/best-practices.md - 全面的最佳實務指南

create-skill

相關技能