跳转到内容
🤖 Consolidated, AI-optimized BMAD docs: llms-full.txt. Fetch this plain text file for complete context.

快速修复

直接使用 DEV 智能体进行 bug 修复、重构或小型针对性更改,这些操作不需要完整的 BMad Method 或 Quick Flow。

  • 原因明确且已知的 bug 修复
  • 包含在少数文件中的小型重构(重命名、提取、重组)
  • 次要功能调整或配置更改
  • 探索性工作,以了解不熟悉的代码库
情况智能体原因
修复特定 bug 或进行小型、范围明确的更改DEV agent直接进入实现,无需规划开销
更改涉及多个文件,或希望先有书面计划Quick Flow Solo Dev在实现前创建 quick-spec,使智能体与你的标准保持一致

如果不确定,请从 DEV 智能体开始。如果更改范围扩大,你始终可以升级到 Quick Flow。

在 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 开发周期——它将实现更改、运行测试并执行自我审查,所有这些都由你刚刚批准的规范指导。

用通俗语言告诉智能体你需要什么。具体说明问题,如果你知道相关代码的位置,也请说明。

你不需要提供每个细节。智能体会读取相关的源文件,并在需要时提出澄清问题。

智能体将:

  • 读取并分析相关的源文件
  • 提出解决方案并解释其推理
  • 在受影响的文件中实现更改
  • 如果存在测试套件,则运行项目的测试套件

如果你的项目有测试,智能体会在进行更改后自动运行它们,并迭代直到测试通过。对于没有测试套件的项目,请手动验证更改(运行应用、访问端点、检查输出)。

在提交之前,审查更改内容:

  • 通读 diff 以确认更改符合你的意图
  • 自己运行应用程序或测试以再次检查
  • 如果看起来有问题,告诉智能体需要修复什么——它可以在同一会话中迭代

满意后,使用描述修复的清晰消息提交更改。

DEV 智能体也适用于探索不熟悉的代码。在新的聊天中加载它并提出问题:

使用智能体了解你的项目,理解组件如何连接,并在进行更改之前探索不熟悉的区域。

  • 已应用修复或重构的修改后的源文件
  • 通过的测试(如果你的项目有测试套件)
  • 描述更改的干净提交

不会生成规划产物——这就是这种方法的意义所在。

在以下情况下考虑使用 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 命令,用于撤销最后一次提交。