快速修复
对于 bug 修复、重构或小范围改动,使用 Quick Dev 即可,不必走完整的 BMad Method。
何时使用本指南
Section titled “何时使用本指南”- 原因明确且已知的 bug 修复
- 包含在少数文件中的小型重构(重命名、提取、重组)
- 次要功能调整或配置更改
- 依赖更新
1. 开启新会话
Section titled “1. 开启新会话”在 AI IDE 中开启一个全新的聊天会话。复用之前工作流留下的会话,容易引发上下文冲突。
2. 提供你的意图
Section titled “2. 提供你的意图”Quick Dev 支持自由表达意图,你可以在调用前、调用时或调用后补充说明。示例:
run quick-dev — 修复允许空密码的登录验证 bug。run quick-dev — fix https://github.com/org/repo/issues/42run quick-dev — 实现 _bmad-output/implementation-artifacts/my-intent.md 中的意图我觉得问题在 auth 中间件,它没有检查 token 过期。让我看看... 是的,src/auth/middleware.ts 第 47 行完全跳过了exp 检查。run quick-devrun quick-dev> 你想做什么?重构 UserService 以使用 async/await 而不是回调。纯文本、文件路径、GitHub issue 链接、缺陷跟踪地址都可以,只要 LLM 能解析成明确意图。
3. 回答问题并批准
Section titled “3. 回答问题并批准”Quick Dev 可能会先问澄清问题,或在实现前给出一份简短方案供你确认。回答问题后,在你认可方案时再批准继续。
4. 审查和推送
Section titled “4. 审查和推送”Quick Dev 会实现改动、执行自检并修补问题,然后在本地提交。完成后,它会在编辑器中打开受影响文件。
- 快速浏览 diff,确认改动符合你的意图
- 如果有偏差,直接告诉智能体要改什么,它可以在同一会话里继续迭代
确认无误后推送提交。Quick Dev 会提供推送和创建 PR 的选项。
- 已应用修复或重构的修改后的源文件
- 通过的测试(如果你的项目有测试套件)
- 带有约定式提交消息的准备推送的提交
Quick Dev 每次只聚焦一个目标。如果你的请求包含多个独立目标,或审查过程中发现与你本次改动无关的存量问题,Quick Dev 会把它们记录到 deferred-work.md(位于实现产物目录),而不是一次性全都处理。
每次运行后都建议看一下这个文件,它就是你的后续待办清单。你可以把其中任何一项在后续新的 Quick Dev 会话里单独处理。
何时升级到正式规划
Section titled “何时升级到正式规划”在以下情况下考虑使用完整的 BMad Method:
- 更改影响多个系统或需要在许多文件中进行协调更新
- 你不确定范围,需要先进行需求发现
- 你需要为团队记录文档或架构决策
参见 Quick Dev 了解 Quick Dev 在 BMad Method 中的位置与边界。