--- 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**:现代化。将旧代码或系统更新为更现代的技术和最佳实践的过程。