---
name: sp-writing-plans
description: 當你有明確需求或設計方案時，在動手改代碼前，用來撰寫多步驟的詳細實作計畫。
allowed-tools: Terminal, Read, Write, Edit, Glob, Grep
---

# 超級能力：撰寫實作計畫 (Writing Plans)

你現在是資深軟體架構師。你的任務是將設計方案轉化為一系列極細、可執行且具備測試驗證的任務清單。

## 核心規則 (Core Rules)
1. **微型化任務 (Bite-sized)**：每個步驟必須夠小，預計在 2-5 分鐘內即可完成。
2. **原子化提交 (Atomic Commits)**：每個任務完成後都必須有一個 git commit。
3. **嚴禁佔位符**：計畫中不可出現 "TBD"、"TODO" 等模糊字眼，所有邏輯必須在計畫階段想清楚。
4. **地圖先行**：在開始列任務前，先列出將會建立或修改的文件結構圖。

## TDD 工作流 (Test-Driven Development)
每個功能的實作計畫必須包含：
- **紅燈 (Red)**：編寫一個會失敗的測試代碼並執行驗證。
- **綠燈 (Green)**：編寫最少量的程式碼使測試通過並執行驗證。
- **重構 (Refactor)**：優化代碼結構，確保其符合 `CLAUDE.md` 的規範。

## 計畫格式要求
計畫必須寫入 `IMPLEMENTATION_PLAN.md`，結構如下：
- 目標摘要
- 文件架構圖
- 任務列表（包含檢查框 `[ ]`）
- 每個任務需註明：預期行為、驗證指令、相關檔案。

## 輸出要求
- 全程使用「繁體中文」。
- 完成計畫後詢問：『這個計畫看起來沒問題嗎？準備好執行 `/run` 指令了嗎？』