---
title: "快速修复"
description: 如何进行快速修复和临时更改
sidebar:
  order: 5
---

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

## 何时使用此方法

- 原因明确且已知的 bug 修复
- 包含在少数文件中的小型重构（重命名、提取、重组）
- 次要功能调整或配置更改
- 探索性工作，以了解不熟悉的代码库

:::note[前置条件]
- 已安装 BMad Method（`npx bmad-method install`）
- AI 驱动的 IDE（Claude Code、Cursor 或类似工具）
:::

## 选择你的方法

| 情况 | 智能体 | 原因 |
| --- | --- | --- |
| 修复特定 bug 或进行小型、范围明确的更改 | **DEV agent** | 直接进入实现，无需规划开销 |
| 更改涉及多个文件，或希望先有书面计划 | **Quick Flow Solo Dev** | 在实现前创建 quick-spec，使智能体与你的标准保持一致 |

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

## 步骤

### 1. 加载 DEV 智能体

在 AI IDE 中启动一个**新的聊天**，并使用斜杠命令加载 DEV 智能体：

```text
/bmad-agent-bmm-dev
```

这会将智能体的角色和能力加载到会话中。如果你决定需要 Quick Flow，请在新的聊天中加载 **Quick Flow Solo Dev** 智能体：

```text
/bmad-agent-bmm-quick-flow-solo-dev
```

加载 Solo Dev 智能体后，描述你的更改并要求它创建一个 **quick-spec**。智能体会起草一个轻量级规范，捕获你想要更改的内容和方式。批准 quick-spec 后，告诉智能体开始 **Quick Flow 开发周期**——它将实现更改、运行测试并执行自我审查，所有这些都由你刚刚批准的规范指导。

:::tip[新聊天]
加载智能体时始终启动新的聊天会话。重用之前工作流的会话可能导致上下文冲突。
:::

### 2. 描述更改

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

:::note[示例提示词]
**Bug 修复** -- "修复允许空密码的登录验证 bug。验证逻辑位于 `src/auth/validate.ts`。"

**重构** -- "重构 UserService 以使用 async/await 而不是回调。"

**配置更改** -- "更新 CI 流水线以在运行之间缓存 node_modules。"

**依赖更新** -- "将 express 依赖升级到最新的 v5 版本并修复任何破坏性更改。"
:::

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

### 3. 让智能体工作

智能体将：

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

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

### 4. 审查和验证

在提交之前，审查更改内容：

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

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

:::caution[如果出现问题]
如果提交的更改导致意外问题，请使用 `git revert HEAD` 干净地撤销最后一次提交。然后启动与 DEV 智能体的新聊天以尝试不同的方法。
:::

## 学习你的代码库

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

:::note[示例提示词]
"解释此代码库中的身份验证系统是如何工作的。"

"向我展示 API 层中的错误处理发生在哪里。"

"`ProcessOrder` 函数的作用是什么，什么调用了它？"
:::

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

## 你将获得

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

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

## 何时升级到正式规划

在以下情况下考虑使用 [Quick Flow](../explanation/quick-flow.md) 或完整的 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 命令，用于撤销最后一次提交。
