gistfile1.txt

# 2026 SDD 工作流規範

## 核心原則
- **先規劃，後動手**：未經確認，絕不修改任何產品程式碼。
- **小步快跑**：一次只做一件事，每步完成即時回報，不一次做完。
- **嚴守邊界**：不自行增加未要求的功能，不猜測，沒把握就發問。

## 流程三階段

### 【階段一：提案】
當我說「提案」時，請執行以下步驟：

1. **命名與分類**：
   - 取英文短名稱（小寫、連字號，如 `fix-login`）。
   - 分類為：`新功能` / `修 bug` / `重構`（三選一）。
2. **建立 `sdd/<短名稱>/proposal.md`**，內容包含：
   - `## 為什麼做`：解決什麼問題。
   - `## 要改什麼`：行為變更（條列）。
   - `## 影響範圍`：預計新增或修改的檔案。
3. **建立 `sdd/<短名稱>/tasks.md`**，內容包含：
   - **任務清單**：使用 `- [ ]` 格式，每項限 1 小時內完成，總數不超過 10 條（若超標，提醒我拆分）。
   - `## 驗收條件`：用白話「情境」描述（格式：`情境：當...就...`）。
4. **停下等待**：貼出提案重點，**除非我說「開始實作」，否則不寫任何程式碼**。

---

### 【階段二：實作】
當我說「實作」時，請執行以下步驟：

1. **閱讀規格**：先讀 `proposal.md` 與 `tasks.md`，確認上下文。
2. **單一執行**：由上至下，一次只做一條 `- [ ]`。優先重複使用現有程式碼。
3. **驗證勾選**：完成後對照「驗收條件」，確認無誤後將 `- [ ]` 改為 `- [x]`。
4. **即時回報**：每完成一條即簡短回報，再進行下一條。
5. **異常中斷**：若發現規格有誤或方向不對，立即停下討論，不硬幹。
6. **完成驗收**：全部打勾後，回報「全部完成」並請我驗收。

---

### 【階段三：歸檔】
當我說「歸檔」時，請執行以下步驟：

1. **檢查狀態**：確認 `tasks.md` 所有項目皆為 `- [x]`（若有未完成項，停止歸檔並回報）。
2. **移動目錄**：將 `sdd/<短名稱>/` 移動至 `sdd/archive/YYYY-MM-DD-<短名稱>/`。
3. **總結回報**：回報歸檔完成，並附上一句話總結。