簡介
本 Harness 驗證 mattpocock/skills 1.2.3（目前 main）的 25 個 skills 是否正確載入。清單分為 Engineering 18 個與 Productivity 7 個，再依 user-invoked 與 model-invoked 分類；實際 slash command 顯示方式仍由安裝的 agent 決定。
前置條件
- 已完成目標 agent 的設定
- 已安裝 Matt Pocock’s skills 套件
- 熟悉目標 agent 的 skill 系統
驗證步驟
第一步：驗證 Skill 列表
在目標 agent 中檢查已安裝的 skills：
/skill list預期結果：
✓ ask-matt - 詢問哪個 skill 或流程適合目前情境
✓ code-review - 對照 Standards 與 Spec 審查 diff
✓ codebase-design - 使用深模組與乾淨 seam 的設計詞彙
✓ diagnosing-bugs - 以假設與證據進行紀律化除錯
✓ domain-modeling - 建立並磨利專案領域模型
✓ grill-with-docs - 透過逐步追問建立文件
✓ grill-me - 透過密集訪談磨利計畫或設計
✓ prototype - 建立拋棄式原型回答設計問題
✓ research - 以高信任度一手來源進行調查
✓ resolving-merge-conflicts - 依意圖處理 merge 或 rebase 衝突
✓ setup-matt-pocock-skills - 設定 repo 的 tracker、labels 與文件位置
✓ tdd - 以 red-green-refactor 進行測試驅動開發
✓ wizard - 產生引導人類完成手動操作的 bash wizard
✓ triage - 讓 issues 與外部 PR 依狀態機流轉
✓ improve-codebase-architecture - 掃描程式碼庫尋找深化機會
✓ to-spec - 將對話整理成規格並發佈至專案 issue tracker
✓ to-tickets - 將計畫拆成一組 tickets
✓ implement - 根據規格或 tickets 實作工作項目
✓ wayfinder - 規劃大型工作並拆成共享決策 tickets
✓ handoff - 將目前對話整理成交接文件
✓ teach - 跨 session 教學
✓ to-questionnaire - 產生決策問卷
✓ wait-what - 重新表述沒有被理解的訊息
✓ writing-for-agents - 撰寫給代理使用的文件
✓ grilling - 針對計畫、決策或想法進行密集追問第二步：測試觸發詞
測試每個 skill 的觸發詞是否正常工作：
Grill-with-Docs Skill：
使用 grill-with-docs skill 探索新功能的實作方式預期結果：
- AI 回應探索多種解決方案
- 比較不同方案的優缺點
- 提供建議和下一步行動
Ask-Matt Skill：
使用 ask-matt skill 詢問適合的流程預期結果：
- AI 詢問目前的情境和目標
- 分析可用的 skills
- 建議最適合的 skill 組合
第三步：測試 Skill 組合
測試 skills 的組合使用：
組合 1：探索 + 規劃：
/grill-with-docs 探索使用者搜尋功能的實作方式
/to-spec 制定詳細規格預期結果：
- grill-with-docs 探索多種解決方案並建立共享語言
- to-spec 制定可執行的規格
- 兩個 skill 無縫連接
組合 2：規劃 + 實作：
/to-spec 將想法整理成規格
/implement 根據規格實作預期結果：
- to-spec 產生清晰的規格文件
- implement 根據規格執行實作
- 確保實作符合規格
第四步：測試錯誤處理
測試 skills 的錯誤處理：
情境 1：觸發詞無法辨識
使用 skill xyz預期結果：
- AI 回應「無法找到對應的 skill」
- 提供建議的替代方案
情境 2：使用不當的 skill
在已明確的任務上使用 grill-with-docs預期結果：
- AI 建議直接進入適合的下一個 skill，而不是重複訪談
- 建議直接使用其他 skills
第五步：驗證上下文保持
測試 skills 的上下文保持能力：
測試流程：
1. /grill-with-docs 探索新功能
2. 記錄探索結果
3. /to-spec 制定計畫
4. 確認計畫參考 grill-with-docs 的結果
5. /implement 實作功能
6. 確認實作參考計畫預期結果：
- 每個 skill 都能記住前面的結果
- 上下文正確傳遞
- 不需要重複說明背景
驗證清單
| 步驟 | 測試項目 | 狀態 | 預期結果 |
|---|---|---|---|
| 1 | Skill 列表完整 | 🔲 | 25 個官方 skills 都列出 |
| 2 | 觸發詞正常工作 | 🔲 | 每個 skill 的觸發詞都能觸發 |
| 3 | Skill 組合無縫 | 🔲 | 多個 skills 連續使用正常 |
| 4 | 錯誤處理正確 | 🔲 | 錯誤情況有適當反饋 |
| 5 | 上下文保持正確 | 🔲 | 跨 skill 上下文正確傳遞 |
常見問題
問題 1：Skill 無法觸發
症狀：輸入觸發詞但 skill 沒有啟動
解決方案：
- 檢查 skill 是否正確安裝
- 確認觸發詞拼寫正確
- 檢查 skill 配置檔案
問題 2：Skill 組合失敗
症狀：連續使用多個 skills 時出現錯誤
解決方案：
- 檢查 skill 的輸入輸出格式
- 確認 skills 之間的相容性
- 查看錯誤訊息並調整
問題 3：上下文丟失
症狀：跨 skill 時上下文丟失
解決方案：
- 檢查 skill 的上下文管理
- 確認記憶系統正常運作
- 依 agent 文件重新載入 skills 或重啟 agent
結論
若步驟 1-5 通過 🟢，Matt Pocock’s skills 的整合運作正常，可以開始使用。
若有任何步驟失敗，根據錯誤訊息調整設定，或聯繫技術支援。