Help us improve
Share bugs, ideas, or general feedback.
From ddd-workflow
Systematically diagnose and fix bugs using structured phases: root cause analysis, pattern analysis, hypothesis testing with failing tests, and minimal changes. Produces works.md documentation.
npx claudepluginhub applepig/ddd-workflowHow this skill is triggered — by the user, by Claude, or both
Slash command
/ddd-workflow:ddd.fixbugThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
系統性診斷與修復 bug。參考 Superpowers systematic-debugging 方法論,強制四階段流程,禁止跳過根因分析直接猜修。
Root cause based one-shot bug fix. Runs a full investigation pipeline: debugger diagnosis, gap analysis, requirements generation, execution, and verification. Includes QA suggestions after successful fix.
Step-by-step workflow for diagnosing root causes, implementing minimal fixes, and writing regression tests. Use when fixing bugs or working on bug report issues.
Share bugs, ideas, or general feedback.
系統性診斷與修復 bug。參考 Superpowers systematic-debugging 方法論,強制四階段流程,禁止跳過根因分析直接猜修。
Main agent 直接修——bug fix 通常小且急,派工開銷不值得。這是唯一 main agent 直接寫 code 的 skill。
| 入口 | 情境 | 差異 |
|---|---|---|
| Post-xreview | xreview 產出 findings,使用者確認要修 | 跳過 Phase 1(問題已定位),從 Phase 2 開始 |
| 獨立觸發 | 使用者回報 bug 或自行發現 | 完整四階段 |
Post-xreview 入口跳過此階段。
釐清問題
重現
定位根因
git log、git blame)寫預期行為測試
最小改動修復
驗證
失敗處理
更新文件
docs/ 下建 <序號>-hotfix-<簡述>/works.md(序號接續既有 docs 編號)回報使用者
獨立 hotfix 不走 spec/tasks 流程,改用一份三合一的 works.md 記錄完整脈絡:
# Hotfix: <簡述>
## 問題描述
- **症狀**:<使用者觀察到的現象>
- **預期行為**:<應該怎樣>
- **影響範圍**:<哪些功能/使用者受影響>
## 根因分析
- **根因**:<一句話根因>
- **定位過程**:<怎麼找到的,排除了哪些假設>
- **受影響的檔案**:<列出修改的檔案>
## 修復內容
- **修了什麼**:<具體改動>
- **測試**:<新增或修改了哪些測試>
- **驗證結果**:<測試執行結果>
Post-xreview 的修復直接記在當前 sprint 的 works.md,不需要獨立開檔。格式簡化為一筆日誌紀錄:
### xreview 修正
- **[finding 摘要]**:<修了什麼> → <測試結果>
- **[finding 摘要]**:<修了什麼> → <測試結果>
修復完成、測試通過、使用者確認 commit 後結束。