TTechSpecs

基本工作流程

在 Superpowers 中,**工作流程(Workflows)**是多個 Skills 的組合,用於完成特定的開發任務。

標準工作流程

Quick Flow(快速流程)

適用情境

  • 小型功能開發
  • 快速 Bug 修復
  • 簡單的重構任務

流程步驟

1. Brainstorming(可選)

2. Writing Plans(可選)

3. Executing Plans

4. Verification Before Completion

時間成本:10-30 分鐘

特點

  • 快速迭代
  • 適合低風險任務
  • 可以靈活調整步驟

Full Flow(完整流程)

適用情境

  • 重要功能開發
  • 核心系統重構
  • 需要高品質保證的任務

流程步驟

1. Brainstorming

2. Writing Plans

3. Test-Driven Development

4. Systematic Debugging(如需要)

5. Verification Before Completion

6. Requesting Code Review

時間成本:1-3 小時

特點

  • 嚴謹的開發流程
  • 完整的品質保證
  • 適合高風險任務

實際應用範例

範例 1:新功能開發(Quick Flow)

任務:新增使用者資料匯出功能

第 1 步:使用 brainstorming skill
使用者:「使用 brainstorming skill 探索資料匯出的多種格式」
AI:提出 CSV、JSON、Excel 等多種格式選擇

第 2 步:使用 writing-plans skill
使用者:「使用 writing-plans skill 制定實作計畫」
AI:生成詳細的實作步驟

第 3 步:使用 executing-plans skill
使用者:「使用 executing-plans skill 實作功能」
AI:按照計畫撰寫程式碼

第 4 步:使用 verification-before-completion skill
使用者:「使用 verification-before-completion skill 驗證」
AI:測試功能並確認符合需求

範例 2:Bug 修復(Quick Flow)

任務:修復登入頁面的錯誤

第 1 步:使用 systematic-debugging skill
使用者:「使用 systematic-debugging skill 診斷登入錯誤」
AI:系統化地分析問題根因

第 2 步:使用 executing-plans skill
使用者:「使用 executing-plans skill 修復問題」
AI:實作修復方案

第 3 步:使用 verification-before-completion skill
使用者:「使用 verification-before-completion skill 確認修復」
AI:測試修復結果

範例 3:重構(Full Flow)

任務:重構使用者服務層

第 1 步:使用 brainstorming skill
使用者:「使用 brainstorming skill 探索重構方案」
AI:提出多種重構策略

第 2 步:使用 writing-plans skill
使用者:「使用 writing-plans skill 制定重構計畫」
AI:生成詳細的重構步驟和測試計畫

第 3 步:使用 test-driven-development skill
使用者:「使用 test-driven-development skill 進行重構」
AI:使用 TDD 方式逐步重構

第 4 步:使用 verification-before-completion skill
使用者:「使用 verification-before-completion skill 驗證重構」
AI:確認重構後功能正常

第 5 步:使用 requesting-code-review skill
使用者:「使用 requesting-code-review skill 請求審查」
AI:準備程式碼審查請求

工作流程的選擇

決策樹

任務重要嗎?
├─ 是 → 任務複雜嗎?
│   ├─ 是 → 使用 Full Flow
│   └─ 否 → 使用 Quick Flow
└─ 否 → 任務複雜嗎?
    ├─ 是 → 使用 Quick Flow
    └─ 否 → 直接執行(無需 workflow)

風險評估

低風險任務

  • UI 調整
  • 文案更新
  • 簡單功能增強 → 使用 Quick Flow 或直接執行

中風險任務

  • 新功能開發
  • 一般 Bug 修復
  • 小型重構 → 使用 Quick Flow 或 Full Flow

高風險任務

  • 核心功能修改
  • 架構調整
  • 安全性修補 → 必須使用 Full Flow

工作流程的最佳實踐

1. 靈活調整

不要拘泥於標準流程,根據實際情況調整:

標準流程:A → B → C → D
調整後:A → C → D(跳過不必要的步驟)

2. 持續驗證

在每個步驟後都進行驗證:

  • 完成 brainstorming 後:確認方案可行性
  • 完成實作後:立即進行 verification
  • 發現問題時:使用 systematic-debugging

3. 記錄學習

記錄每次使用工作流程的經驗:

  • 哪些組合特別有效?
  • 哪些步驟可以省略?
  • 如何優化流程效率?

4. 團隊協作

在團隊環境中使用工作流程:

  • 統一流程命名和術語
  • 分享最佳實踐
  • 建立團隊模板

進階技巧

並行處理

某些情況下可以並行處理多個任務:

任務 A:quick flow
任務 B:quick flow
任務 C:quick flow

使用 dispatching-parallel-agents skill 實現並行處理。

迭代優化

使用相同的工作流程進行多輪優化:

第一輪:brainstorming → writing-plans → executing-plans
第二輪:systematic-debugging → verification
第三輪:verification → requesting-code-review

混合工作流程

結合多種工作流程應對複雜專案:

階段一:quick flow(快速原型)
階段二:full flow(完整實作)
階段三:quick flow(優化調整)

常見錯誤

錯誤 1:過度使用工作流程

問題:簡單任務也使用完整流程 解決:評估任務複雜度,選擇適當的流程

錯誤 2:跳過驗證步驟

問題:完成後不進行 verification 解決:每次完成後都使用 verification-before-completion skill

錯誤 3:不靈活調整

問題:機械式執行標準流程 解決:根據實際情況調整流程步驟

下一步

理解基本工作流程後,您可以:

  1. 深入學習各種 Skills
  2. 探索進階工作流程
  3. 查看實戰範例

開始使用工作流程來提升您的開發效率!