執行說明：/workflow 提供指示與檢查清單，不是確定性的執行器。
Claude 可能會要求釐清或選用可用的 agent；請自行核對實際測試、diff 與 commit。
另請參閱 Claude Code 的官方 agents 文件。
1
聚焦 2
防過度 3
測試 4
文檔 5
提交 1
聚焦問題
/focus-problem
在撰寫程式碼之前先理解問題。內附指令示範以一個 Explore agent 收集程式碼庫上下文； 額外 agents 僅在工作彼此獨立時才需要，並非固定平行啟動。
執行內容：
- → 分析專案結構和架構
- → 搜尋相關程式碼和模式
- → 檢視現有測試和文檔
- → 識別依賴和限制
2
防止過度開發
內建於 /workflow · 沒有獨立指令
YAGNI 原則檢查。只建構真正需要的功能，避免過早優化和不必要的抽象。
檢查清單：
- □ 這個功能真的需要嗎？
- □ 能用更簡單的方式解決嗎？
- □ 是否加入了不必要的抽象？
- □ 最小可行實作是什麼？
3
測試先行（TDD）
/test-first
在實作之前先寫測試。清單會引導 Red-Green-Refactor；請實際執行每個測試，確認預期的失敗與通過。
RED
撰寫失敗的測試
GREEN
撰寫最小程式碼通過測試
REFACTOR
改善但不破壞功能
4
撰寫文檔
/workflow 清單 · 可選擇委派 doc-writer
檢查變更是否需要更新 README、API 文檔、範例或程式碼註解。 doc-writer agent 可被明確指定或由模型選擇委派，但不保證會自動執行。
按需要檢查與更新：
- → 函式/方法的 JSDoc 註解
- → API 端點文檔
- → 新功能的 README 更新
- → 使用範例
5
智能提交
/smart-commit
檢查 diff、執行專案已有的品質檢查、分組相關變更，再建立 Conventional Commits。 提交前先審查內容；此步驟不會推送到遠端。
/smart-commit
feat(auth): 實作 JWT token 驗證
- 新增含過期檢查的 validateToken 函式
- 包含 refresh token 輪換
- 新增完整測試覆蓋率 (95%)
Co-Authored-By: Claude <noreply@anthropic.com>使用方式
# 執行完整工作流程
/workflow
# 或個別執行現有指令
/focus-problem "描述要建構的內容"
/test-first
/smart-commit