簡介
本 Harness 驗證 Matt Pocock’s engineering skills 的完整工作流程是否能正確執行。工作流程包括標準開發流程、協作規劃流程和深度分析流程，每個流程都涵蓋多個 skills 的組合使用。
前置條件
- 已完成 Skill Integration Verification
- 已準備一個測試專案或任務
- 熟悉工作流程的每個階段
驗證步驟
第一步：標準開發流程驗證
測試情境：新增使用者搜尋功能
流程步驟：
1. /brainstorming 探索搜尋功能的實作方式
2. /writing-plans 制定詳細計畫
3. /implement 根據計畫實作
4. /verification-before-completion 驗證實作結果預期結果：
Brainstorming 階段：
- 探索多種搜尋方案
- 比較向量搜尋、全文搜尋、混合搜尋
- 建議最佳方案
Writing Plans 階段：
- 制定詳細的實作計畫
- 列出具體步驟和時間估算
- 定義驗收標準
Implement 階段：
- 根據計畫執行實作
- 遵循最佳實踐
- 記錄實作決策
Verification 階段：
- 驗證功能正確性
- 檢查程式碼品質
- 確認使用者體驗
第二步：協作規劃流程驗證
測試情境：團隊協作的大型功能開發
流程步驟：
1. /grill-with-docs 透過追問建立規格文件
2. /to-tickets 將規格拆成 tickets
3. /wayfinder 規劃大型工作並拆成共享決策 tickets
4. /implement 分配並執行 tickets預期結果：
Grill-With-Docs 階段：
- 透過密集追問建立規格
- 產生 ADR 和詞彙表
- 澄清模糊需求
To-Tickets 階段：
- 將規格拆成可管理的 tickets
- 定義每個 ticket 的阻塞邊
- 建立清晰的依賴關係
Wayfinder 階段：
- 規劃大型工作的整體方向
- 建立共享決策機制
- 確保團隊對齊
Implement 階段：
- 分配 tickets 給團隊成員
- 執行並追蹤進度
- 處理阻礙和問題
第三步：深度分析流程驗證
測試情境：API 延遲問題的深度分析
流程步驟：
1. /systematic-debugging 系統化除錯
2. /improve-codebase-architecture 分析架構問題
3. /to-spec 將分析結果整理成規格
4. /implement 實作修正方案預期結果：
Systematic Debugging 階段：
- 系統化收集資訊
- 形成並驗證假設
- 找到根本原因
Improve Codebase Architecture 階段：
- 掃描程式碼庫尋找深化機會
- 產生視覺化分析報告
- 建議架構改進方向
To-Spec 階段：
- 將分析結果整理成規格
- 定義修正計畫
- 建立驗收標準
Implement 階段：
- 實作修正方案
- 驗證問題解決
- 建立防止回歸機制
第四步：Skill 過渡驗證
測試情境：測試不同 skills 之間的平滑過渡
測試案例：
案例 1：Brainstorming → Writing Plans
brainstorming 完成後，自動建議使用 writing-plans
案例 2：Writing Plans → Implement
writing-plans 完成後，自動建議使用 implement
案例 3：Systematic Debugging → Implement
systematic-debugging 完成後，自動建議使用 implement預期結果：
- 每個 skill 完成後有適當的下一步建議
- Skills 之間的過渡自然流暢
- 不需要手動重複背景說明
第五步：錯誤恢復驗證
測試情境：測試錯誤情況下的恢復能力
測試案例：
案例 1：實作失敗的恢復
implement 過程中遇到錯誤，能回到 writing-plans 修正
案例 2：驗證失敗的恢復
verification-before-completion 失敗，能回到 implement 修正
案例 3：除錯失敗的恢復
systematic-debugging 無法找到根因，能回到 brainstorming 重新探索預期結果：
- 錯誤情況有適當的恢復路徑
- 不會因為一個錯誤而失去所有進度
- 能靈活調整流程
驗證清單
| 步驟 | 測試項目 | 狀態 | 預期結果 |
|---|---|---|---|
| 1 | 標準開發流程完整 | 🔲 | 4 個階段都正常執行 |
| 2 | 協作規劃流程完整 | 🔲 | 4 個階段都正常執行 |
| 3 | 深度分析流程完整 | 🔲 | 4 個階段都正常執行 |
| 4 | Skill 過渡平滑 | 🔲 | Skills 之間過渡自然 |
| 5 | 錯誤恢復正常 | 🔲 | 錯誤情況能妥善處理 |
常見問題
問題 1：流程中斷
症狀：在流程中斷後無法恢復
解決方案：
- 檢查上下文管理機制
- 確認記憶系統正常
- 重新開始流程並記錄中斷點
問題 2：Skill 過渡失敗
症狀：從一個 skill 到下一個 skill 時出錯
解決方案：
- 檢查 skill 的輸出格式
- 確認下一個 skill 的輸入要求
- 調整 skill 的配置
問題 3：流程時間過長
症狀：完整流程執行時間超過預期
解決方案：
- 分析每個階段的耗時
- 優化耗時最長的階段
- 考慮並行化某些階段
結論
若步驟 1-5 通過 🟢，Matt Pocock’s 工作流程運作正常，可以投入實際使用。
若有任何步驟失敗，根據錯誤訊息調整設定，或參考相關文檔尋求解決方案。