簡介
本 Harness 驗證 Matt Pocock’s engineering skills 的整合是否正常運作。這些 skills 包括 12 個核心 skills（ask-matt、brainstorming、grill-with-docs、grill-me、triage、improve-codebase-architecture、to-spec、to-tickets、implement、wayfinder、loop-me、grilling），每個 skill 都有特定的觸發詞和使用情境。
前置條件
- 已完成 OpenCode 環境設定
- 已安裝 Matt Pocock’s skills 套件
- 熟悉 OpenCode 的 skill 系統
驗證步驟
第一步：驗證 Skill 列表
在 OpenCode 中檢查已安裝的 skills：
/skill list預期結果：
✓ ask-matt - 詢問哪個 skill 或流程適合目前情境
✓ brainstorming - 在創意發散前探索多種解決方案
✓ grill-with-docs - 透過逐步追問建立文件
✓ grill-me - 透過密集訪談磨利計畫或設計
✓ triage - 讓 issues 與外部 PR 依狀態機流轉
✓ improve-codebase-architecture - 掃描程式碼庫尋找深化機會
✓ to-spec - 將對話整理成規格並發佈至專案 issue tracker
✓ to-tickets - 將計畫拆成一組 tickets
✓ implement - 根據規格或 tickets 實作工作項目
✓ wayfinder - 規劃大型工作並拆成共享決策 tickets
✓ loop-me - 針對工作流程規格對使用者進行密集追問
✓ grilling - 針對計畫、決策或想法進行密集追問第二步：測試觸發詞
測試每個 skill 的觸發詞是否正常工作：
Brainstorming Skill：
使用 brainstorming skill 探索新功能的實作方式預期結果：
- AI 回應探索多種解決方案
- 比較不同方案的優缺點
- 提供建議和下一步行動
Ask-Matt Skill：
使用 ask-matt skill 詢問適合的流程預期結果：
- AI 詢問目前的情境和目標
- 分析可用的 skills
- 建議最適合的 skill 組合
第三步：測試 Skill 組合
測試 skills 的組合使用：
組合 1：探索 + 規劃：
/brainstorming 探索使用者搜尋功能的實作方式
/writing-plans 制定詳細計畫預期結果：
- brainstorming 探索多種解決方案
- writing-plans 制定可執行的計畫
- 兩個 skill 無縫連接
組合 2：規劃 + 實作：
/to-spec 將想法整理成規格
/implement 根據規格實作預期結果：
- to-spec 產生清晰的規格文件
- implement 根據規格執行實作
- 確保實作符合規格
第四步：測試錯誤處理
測試 skills 的錯誤處理：
情境 1：觸發詞無法辨識
使用 skill xyz預期結果：
- AI 回應「無法找到對應的 skill」
- 提供建議的替代方案
情境 2：使用不當的 skill
在已明確的任務上使用 brainstorming預期結果：
- AI 警告「需求已經很明確，不需要 brainstorming」
- 建議直接使用其他 skills
第五步：驗證上下文保持
測試 skills 的上下文保持能力：
測試流程：
1. /brainstorming 探索新功能
2. 記錄探索結果
3. /writing-plans 制定計畫
4. 確認計畫參考 brainstorming 的結果
5. /implement 實作功能
6. 確認實作參考計畫預期結果：
- 每個 skill 都能記住前面的結果
- 上下文正確傳遞
- 不需要重複說明背景
驗證清單
| 步驟 | 測試項目 | 狀態 | 預期結果 |
|---|---|---|---|
| 1 | Skill 列表完整 | 🔲 | 12 個 skills 都列出 |
| 2 | 觸發詞正常工作 | 🔲 | 每個 skill 的觸發詞都能觸發 |
| 3 | Skill 組合無縫 | 🔲 | 多個 skills 連續使用正常 |
| 4 | 錯誤處理正確 | 🔲 | 錯誤情況有適當反饋 |
| 5 | 上下文保持正確 | 🔲 | 跨 skill 上下文正確傳遞 |
常見問題
問題 1：Skill 無法觸發
症狀：輸入觸發詞但 skill 沒有啟動
解決方案：
- 檢查 skill 是否正確安裝
- 確認觸發詞拼寫正確
- 檢查 skill 配置檔案
問題 2：Skill 組合失敗
症狀：連續使用多個 skills 時出現錯誤
解決方案：
- 檢查 skill 的輸入輸出格式
- 確認 skills 之間的相容性
- 查看錯誤訊息並調整
問題 3：上下文丟失
症狀：跨 skill 時上下文丟失
解決方案：
- 檢查 skill 的上下文管理
- 確認記憶系統正常運作
- 重啟 OpenCode 環境
結論
若步驟 1-5 通過 🟢，Matt Pocock’s skills 的整合運作正常，可以開始使用。
若有任何步驟失敗，根據錯誤訊息調整設定，或聯繫技術支援。