撰寫技能
一個四階段管線:收集 → 審問 → 規劃 → 實作。
階段 1:收集
使用 AskUserQuestion 搭配領域分組的問題,橫跨 4 個領域。每個領域使用 1 次呼叫,包含 2-4 個選項和一個建議(第一個選項 = (推薦))。
- 目的 — 此技能涵蓋哪些任務/領域?誰會使用它?
- 用例 — 哪些特定情境會觸發此技能?哪些關鍵字?
- 結構 — 是否需要腳本?參考檔案?單一
SKILL.md還是多檔案? - 工具 — 應呼叫或參考哪些工具或其他技能?
階段 2:審問
呼叫 grill-me 技能,傳入已收集的需求。指示它使用 skill-grill-domains.md 中技能專屬的領域(意圖、範圍、設計、邊緣案例)。跳過不相關的領域(資料流程、相依性、部署、測試)。
備援方案(grill-me 不可用時): 直接使用 AskUserQuestion 執行內聯迷你審問。針對 skill-grill-domains.md 中的每個領域,每次呼叫批次處理 2-4 個問題,並附帶建議和選項。
階段 3:規劃
使用 blueprint-template.md 中的範本產出結構化的技能藍圖。在對話中呈現藍圖(不寫入磁碟)。使用者必須核准後才能繼續。如果使用者要求修改,則修訂並重新呈現。
階段 4:實作
根據核准的藍圖建立所有技能檔案。全自動化 —— 代理程式會撰寫所有內容。
然後執行階段 4b:審查,使用 quality-criteria.md 中的標準:
- 自動驗證 — 檢查可衡量的標準(行數、描述長度、觸發條件、參考深度)。在繼續之前修復任何失敗。
- 主觀審查 — 透過
AskUserQuestion向使用者呈現檢查清單。如果使用者標記問題,則修訂並重新驗證。
技能結構
skill-name/
├── SKILL.md # 主要指令(必要,少於 100 行)
├── references/ # 支援文件(如果需要)
│ └── domain-ref.md
└── scripts/ # 公用腳本(如果需要)
└── helper.sh
備援方案(無 AskUserQuestion)
如果 AskUserQuestion 不可用,則回退到基於文字的提問:
[標頭] — [主題] 推薦: [您的推薦和原因] 替代方案: (A) [選項] — [取捨] | (B) [選項] — [取捨]
品質標準
請參閱 quality-criteria.md 了解描述要求、自動驗證標準、主觀審查檢查清單,以及何時新增腳本或分割檔案的指導方針。