4.6 KiB
4.6 KiB
| title | description | sidebar | ||
|---|---|---|---|---|
| 管理项目上下文 | 创建并维护 project-context.md 以指导 AI 智能体 |
|
使用 project-context.md 文件确保 AI 智能体在所有工作流程中遵循项目的技术偏好和实现规则。
:::note[前置条件]
- 已安装 BMad Method
- 了解项目的技术栈和约定 :::
何时使用
- 在开始架构设计之前有明确的技术偏好
- 已完成架构设计并希望为实施捕获决策
- 正在处理具有既定模式的现有代码库
- 注意到智能体在不同用户故事中做出不一致的决策
步骤 1：选择方法
手动创建 — 当您确切知道要记录哪些规则时最佳
架构后生成 — 最适合捕获解决方案制定过程中所做的决策
为现有项目生成 — 最适合在现有代码库中发现模式
步骤 2：创建文件
选项 A：手动创建
在 _bmad-output/project-context.md 创建文件：
mkdir -p _bmad-output
touch _bmad-output/project-context.md
添加技术栈和实现规则：
---
project_name: 'MyProject'
user_name: 'YourName'
date: '2026-02-15'
sections_completed: ['technology_stack', 'critical_rules']
---
# AI 智能体的项目上下文
## 技术栈与版本
- Node.js 20.x, TypeScript 5.3, React 18.2
- 状态管理：Zustand
- 测试：Vitest, Playwright
- 样式：Tailwind CSS
## 关键实现规则
**TypeScript：**
- 启用严格模式，不使用 `any` 类型
- 公共 API 使用 `interface`，联合类型使用 `type`
**代码组织：**
- 组件位于 `/src/components/` 并附带同位置测试
- API 调用使用 `apiClient` 单例 — 绝不直接使用 fetch
**测试：**
- 单元测试专注于业务逻辑
- 集成测试使用 MSW 进行 API 模拟
选项 B：架构后生成
在新的聊天中运行工作流程：
/bmad-bmm-generate-project-context
工作流程扫描架构文档和项目文件，生成捕获所做决策的上下文文件。
选项 C：为现有项目生成
对于现有项目，运行：
/bmad-bmm-generate-project-context
工作流程分析代码库以识别约定，然后生成上下文文件供您审查和完善。
步骤 3：验证内容
审查生成的文件并确保它捕获了：
- 正确的技术版本
- 实际约定（而非通用最佳实践）
- 防止常见错误的规则
- 框架特定的模式
手动编辑以添加任何缺失内容或删除不准确之处。
您将获得
一个 project-context.md 文件，它：
- 确保所有智能体遵循相同的约定
- 防止在不同用户故事中做出不一致的决策
- 为实施捕获架构决策
- 作为项目模式和规则的参考
提示
:::tip[关注非显而易见的内容] 记录智能体可能遗漏的模式，例如"在每个公共类、函数和变量上使用 JSDoc 风格注释"，而不是像"使用有意义的变量名"这样的通用实践，因为 LLM 目前已经知道这些。 :::
:::tip[保持精简] 此文件由每个实施工作流程加载。长文件会浪费上下文。不要包含仅适用于狭窄范围或特定用户故事或功能的内容。 :::
:::tip[根据需要更新] 当模式发生变化时手动编辑，或在重大架构更改后重新生成。 :::
:::tip[适用于所有项目类型] 对于快速流程和完整的 BMad Method 项目同样有用。 :::
后续步骤
术语说明
- agent：智能体。在人工智能与编程文档中，指具备自主决策或执行能力的单元。
- workflow：工作流程。指完成特定任务的一系列步骤或过程。
- codebase：代码库。指项目的所有源代码和资源的集合。
- implementation：实施。指将设计或架构转化为实际代码的过程。
- architecture：架构。指系统的整体结构和设计。
- stack：技术栈。指项目使用的技术组合，如编程语言、框架、工具等。
- convention：约定。指团队或项目中遵循的编码规范和最佳实践。
- singleton：单例。一种设计模式，确保类只有一个实例。
- co-located：同位置。指相关文件（如测试文件）与主文件放在同一目录中。
- mocking：模拟。在测试中用模拟对象替代真实对象的行为。
- context：上下文。指程序运行时的环境信息或背景信息。
- LLM：大语言模型。Large Language Model 的缩写，指大型语言模型。