61 lines
2.6 KiB
Markdown
61 lines
2.6 KiB
Markdown
---
|
||
title: "既有项目常见问题"
|
||
description: 关于在既有项目上使用 BMad 方法的常见问题
|
||
sidebar:
|
||
order: 8
|
||
---
|
||
关于使用 BMad 方法（BMM）在既有项目上工作的常见问题的快速解答。
|
||
|
||
## 问题
|
||
|
||
- [我必须先运行 document-project 吗？](#do-i-have-to-run-document-project-first)
|
||
- [如果我忘记运行 document-project 怎么办？](#what-if-i-forget-to-run-document-project)
|
||
- [我可以在既有项目上使用快速流程吗？](#can-i-use-quick-flow-for-established-projects)
|
||
- [如果我的现有代码不遵循最佳实践怎么办？](#what-if-my-existing-code-doesnt-follow-best-practices)
|
||
|
||
### 我必须先运行 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**：现代化。将旧代码或系统更新为更现代的技术和最佳实践的过程。
|