Skills
Skills 是可重用的提示模組。透過載入SKILL.md,可為 Session 加入特定領域的指令。
概觀
- 可將領域知識封裝為 Skill 重複使用
- 可在專案之間共用相同的行為
- 可依 Session 切換啟用/停用
SessionConfig 的 skillDirectories 與 disabledSkills 進行設定。
基本用法
在skillDirectories 中指定父目錄後,會載入其底下每個子目錄中的 SKILL.md。
停用 Skill
使用disabledSkills 可只停用已載入 Skill 的一部分。
目錄結構
skillDirectories 需指定 skills/ 這類父目錄。
SKILL.md 格式
SKILL.md 為 Markdown,可選擇性附上 YAML frontmatter。
name: Skill 識別碼(用於disabledSkills中指定)description: Skill 的簡短說明
name,會使用目錄名稱。
與 Custom Agents 搭配
若在customAgents[].skills 指定 Skill 名稱,啟用該 Agent 時會預先載入該 Skill 內容。
若省略 skills,Skill 內容不會注入該 Agent。
透過 RPC 檢查與操作
Skill 的探索與啟用/停用也可以透過 RPC 進行。最佳實踐
- 依領域切分 Skill(例如
skills/security、skills/testing) - 於 frontmatter 加上
name與description - 若指令有衝突,透過
disabledSkills明確排除 - 建議先單獨測試,再組合多個 Skill