---
title: "既有项目常见问题"
description: 关于在既有项目上使用 BMad 方法的常见问题
sidebar:
  order: 8
---
关于使用 BMad 方法（BMM）在既有项目上工作的常见问题的快速解答。

## 问题

- [我必须先运行 document-project 吗？](#我必须先运行-document-project-吗)
- [如果我忘记运行 document-project 怎么办？](#如果我忘记运行-document-project-怎么办)
- [我可以在既有项目上使用快速流程吗？](#我可以在既有项目上使用快速流程吗)
- [如果我的现有代码不遵循最佳实践怎么办？](#如果我的现有代码不遵循最佳实践怎么办)

### 我必须先运行 document-project 吗？

强烈推荐，特别是如果：

- 没有现有文档
- 文档已过时
- AI 智能体需要关于现有代码的上下文

如果你拥有全面且最新的文档，包括 `docs/index.md`，或者将使用其他工具或技术来帮助智能体发现现有系统，则可以跳过此步骤。

### 如果我忘记运行 document-project 怎么办？

不用担心——你可以随时执行。你甚至可以在项目期间或项目之后执行，以帮助保持文档最新。

### 我可以在既有项目上使用快速流程吗？

可以！快速流程在既有项目上效果很好。它将：

- 自动检测你的现有技术栈
- 分析现有代码模式
- 检测约定并请求确认
- 生成尊重现有代码的上下文丰富的技术规范

非常适合现有代码库中的错误修复和小功能。

### 如果我的现有代码不遵循最佳实践怎么办？

快速流程会检测你的约定并询问："我应该遵循这些现有约定吗？"你决定：

- **是** → 与当前代码库保持一致
- **否** → 建立新标准（在技术规范中记录原因）

BMM 尊重你的选择——它不会强制现代化，但会提供现代化选项。

**有未在此处回答的问题吗？** 请[提出问题](https://github.com/bmad-code-org/BMAD-METHOD/issues)或在 [Discord](https://discord.gg/gk8jAdXWmj) 中提问，以便我们添加它！

---
## 术语说明

- **agent**：智能体。在人工智能与编程文档中，指具备自主决策或执行能力的单元。
- **Quick Flow**：快速流程。BMad 方法中的一种工作流程，用于快速处理既有项目。
- **tech-spec**：技术规范。描述技术实现细节和标准的文档。
- **stack**：技术栈。项目所使用的技术组合，包括框架、库、工具等。
- **conventions**：约定。代码库中遵循的编码风格、命名规则等规范。
- **modernization**：现代化。将旧代码或系统更新为更现代的技术和最佳实践的过程。
