/implement — 紀律實作

/implement — 紀律實作

按 diagnosis 的策略寫 code，不多做也不少做。

核心原則

每一行改動都必須能追溯到 #NNN。追溯不到的改動 → 開新 issue。

Execution

Step 1: 讀取 Issue + Diagnosis

gh issue view $NUMBER --repo $GITHUB_REPO --json title,body,labels

回顧對話中的 diagnosis report，確認 strategy。

Step 2: 列出變更清單並 comment 到 issue

根據 diagnosis 的 strategy，列出具體要改的檔案：

## Implementation Plan

- [ ] 修改 src/foo.ts — {改什麼}
- [ ] 修改 src/bar.ts — {改什麼}
- [ ] 新增 tests/foo.test.ts — {測什麼}

Scope check: 清單裡的每一項都能對應到 issue 的某個要求？

• 對應不上 → 移除，或開新 issue
• Issue 的要求沒被覆蓋 → 補上

Comment 到 issue（留下實作計畫的紀錄）：

gh issue comment $NUMBER --repo $GITHUB_REPO --body "$IMPLEMENTATION_PLAN"

Step 3: TDD 執行

每個變更項依序執行：

1. 寫測試（RED）

   • 測試描述用 issue 的語言
   • 測 behavior，不測 implementation

2. 跑測試確認失敗

   • 失敗原因必須是「功能還沒實作」，不是「測試寫錯」

3. 寫最小實作（GREEN）

   • 只寫讓測試通過的 code
   • 不「順便」優化、重構、加功能

4. 跑測試確認通過

   • 全部測試，不只新的

5. Commit

   git add {changed files}
   git commit -m "fix: {description} (#NNN)"
   

Step 4: Scope 守衛

實作過程中發現的問題：

發現	處理
不相關的 bug	開新 issue，繼續 #NNN
不相關的 code smell	開新 issue，繼續 #NNN
#NNN 的前置依賴	確認是否 blocker。是 → 先處理依賴；不是 → 記錄在 issue comment
比預期更大的改動	停下來，回到 diagnosis 重新評估

鐵律：不在 #NNN 的 branch 上修不相關的東西。

Step 5: 完成確認並 comment 到 issue

所有變更清單項目完成後：

git status --short
git diff --stat HEAD~{N}

回顧：

• 每個 commit 都引用了 #NNN？
• 變更範圍跟 diagnosis 的 strategy 一致？
• 沒有超出 scope 的改動？

如果有產出圖表，上傳到 attachments release：

# 讀取 .claude/issue-driven-dev.local.md 的 attachments_release 設定
gh release upload $ATTACHMENTS_RELEASE {figure_files}.png \
  --repo $GITHUB_REPO --clobber

圖片 URL 格式：https://github.com/$GITHUB_REPO/releases/download/$ATTACHMENTS_RELEASE/{filename}.png

Comment 實作摘要到 issue（含圖片）：

gh issue comment $NUMBER --repo $GITHUB_REPO --body "$(cat <<'EOF'
## Implementation Complete

### Changes
- {commit 1 hash}: {description}
- {commit 2 hash}: {description}

### Files Changed
{git diff --stat output}

### Figures (if any)
![{description}](https://github.com/$GITHUB_REPO/releases/download/$ATTACHMENTS_RELEASE/{filename}.png)

### Scope Compliance
{是否有超出範圍的改動，如有則說明}

### Next: verification pending
EOF
)"

提示下一步：/issue-driven-dev:idd-verify #NNN

Commit 規範

<type>: <description> (#NNN)

• type: fix / feat / refactor / docs / test
• description: 用 issue 的語言描述改了什麼
• 必須包含 (#NNN) 或 #NNN

Auto-Update

Implementation comment 完成後，自動執行 idd-update 更新 issue body 的 Current Status（phase → implemented）。

Next Step

實作完成後，進入 verify：

/issue-driven-dev:idd-verify #NNN