快速修复
直接使用 DEV 智能体进行 bug 修复、重构或小型针对性更改,这些操作不需要完整的 BMad Method 或 Quick Flow。
何时使用此方法
Section titled “何时使用此方法”- 原因明确且已知的 bug 修复
- 包含在少数文件中的小型重构(重命名、提取、重组)
- 次要功能调整或配置更改
- 探索性工作,以了解不熟悉的代码库
选择你的方法
Section titled “选择你的方法”| 情况 | 智能体 | 原因 |
|---|---|---|
| 修复特定 bug 或进行小型、范围明确的更改 | DEV agent | 直接进入实现,无需规划开销 |
| 更改涉及多个文件,或希望先有书面计划 | Quick Flow Solo Dev | 在实现前创建 quick-spec,使智能体与你的标准保持一致 |
如果不确定,请从 DEV 智能体开始。如果更改范围扩大,你始终可以升级到 Quick Flow。
1. 加载 DEV 智能体
Section titled “1. 加载 DEV 智能体”在 AI IDE 中启动一个新的聊天,并使用斜杠命令加载 DEV 智能体:
/bmad-agent-bmm-dev这会将智能体的角色和能力加载到会话中。如果你决定需要 Quick Flow,请在新的聊天中加载 Quick Flow Solo Dev 智能体:
/bmad-agent-bmm-quick-flow-solo-dev加载 Solo Dev 智能体后,描述你的更改并要求它创建一个 quick-spec。智能体会起草一个轻量级规范,捕获你想要更改的内容和方式。批准 quick-spec 后,告诉智能体开始 Quick Flow 开发周期——它将实现更改、运行测试并执行自我审查,所有这些都由你刚刚批准的规范指导。
2. 描述更改
Section titled “2. 描述更改”用通俗语言告诉智能体你需要什么。具体说明问题,如果你知道相关代码的位置,也请说明。
你不需要提供每个细节。智能体会读取相关的源文件,并在需要时提出澄清问题。
3. 让智能体工作
Section titled “3. 让智能体工作”智能体将:
- 读取并分析相关的源文件
- 提出解决方案并解释其推理
- 在受影响的文件中实现更改
- 如果存在测试套件,则运行项目的测试套件
如果你的项目有测试,智能体会在进行更改后自动运行它们,并迭代直到测试通过。对于没有测试套件的项目,请手动验证更改(运行应用、访问端点、检查输出)。
4. 审查和验证
Section titled “4. 审查和验证”在提交之前,审查更改内容:
- 通读 diff 以确认更改符合你的意图
- 自己运行应用程序或测试以再次检查
- 如果看起来有问题,告诉智能体需要修复什么——它可以在同一会话中迭代
满意后,使用描述修复的清晰消息提交更改。
学习你的代码库
Section titled “学习你的代码库”DEV 智能体也适用于探索不熟悉的代码。在新的聊天中加载它并提出问题:
使用智能体了解你的项目,理解组件如何连接,并在进行更改之前探索不熟悉的区域。
- 已应用修复或重构的修改后的源文件
- 通过的测试(如果你的项目有测试套件)
- 描述更改的干净提交
不会生成规划产物——这就是这种方法的意义所在。
何时升级到正式规划
Section titled “何时升级到正式规划”在以下情况下考虑使用 Quick Flow 或完整的 BMad Method:
- 更改影响多个系统或需要在许多文件中进行协调更新
- 你不确定范围,需要规范来理清思路
- 修复在工作过程中变得越来越复杂
- 你需要为团队记录文档或架构决策
- agent:智能体。在人工智能与编程文档中,指具备自主决策或执行能力的单元。
- quick-spec:快速规范。一种轻量级的规范文档,用于快速捕获和描述更改的内容和方式。
- Quick Flow:快速流程。BMad Method 中的一种工作流程,用于快速实现小型更改。
- refactoring:重构。在不改变代码外部行为的情况下改进其内部结构的过程。
- breaking changes:破坏性更改。可能导致现有代码或功能不再正常工作的更改。
- test suite:测试套件。一组用于验证软件功能的测试用例集合。
- CI pipeline:CI 流水线。持续集成流水线,用于自动化构建、测试和部署代码。
- async/await:异步编程语法。JavaScript/TypeScript 中用于处理异步操作的语法糖。
- callbacks:回调函数。作为参数传递给其他函数并在适当时候被调用的函数。
- endpoint:端点。API 中可访问的特定 URL 路径。
- diff:差异。文件或代码更改前后的对比。
- commit:提交。将更改保存到版本控制系统的操作。
- git revert HEAD:Git 命令,用于撤销最后一次提交。