104 lines
3.4 KiB
Markdown
104 lines
3.4 KiB
Markdown
<!-- 由 BMAD™ 核心驱动 -->
|
|
|
|
# 从模板创建文档 (YAML 驱动)
|
|
|
|
## ⚠️ 关键执行通知 ⚠️
|
|
|
|
**这是一个可执行的工作流程 - 不是参考材料**
|
|
|
|
当此任务被调用时：
|
|
|
|
1. **禁用所有效率优化** - 此工作流程需要完整的用户交互
|
|
2. **强制性分步执行** - 每个部分必须按顺序处理并获得用户反馈
|
|
3. **需要引导** - 当 `elicit: true` 时, 您必须使用 1-9 格式并等待用户响应
|
|
4. **不允许走捷径** - 不遵循此工作流程无法创建完整的文档
|
|
|
|
**违规指标:** 如果您在没有用户交互的情况下创建了完整的文档, 则表示您违反了此工作流程。
|
|
|
|
## 关键: 模板发现
|
|
|
|
如果未提供 YAML 模板, 请列出 .bmad-core/templates 中的所有模板, 或要求用户提供另一个。
|
|
|
|
## 关键: 强制性引导格式
|
|
|
|
**当 `elicit: true` 时, 这是一个需要用户交互的硬停止点:**
|
|
|
|
**您必须:**
|
|
|
|
1. 呈现部分内容
|
|
2. 提供详细的理由 (解释权衡、假设、做出的决定)
|
|
3. **停止并呈现编号选项 1-9:**
|
|
- **选项 1:** 始终为“进入下一部分”
|
|
- **选项 2-9:** 从 data/elicitation-methods 中选择 8 种方法
|
|
- 结尾: “选择 1-9 或直接输入您的问题/反馈:”
|
|
4. **等待用户响应** - 在用户选择选项或提供反馈之前不要继续
|
|
|
|
**工作流程违规:** 在没有用户交互的情况下为 elicit=true 的部分创建内容违反了此任务。
|
|
|
|
**绝不问是/否问题或使用任何其他格式。**
|
|
|
|
## 处理流程
|
|
|
|
1. **解析 YAML 模板** - 加载模板元数据和部分
|
|
2. **设置偏好** - 显示当前模式 (交互式), 确认输出文件
|
|
3. **处理每个部分:**
|
|
- 如果条件不满足则跳过
|
|
- 检查代理权限 (所有者/编辑者) - 注意部分是否仅限于特定代理
|
|
- 使用部分说明起草内容
|
|
- 呈现内容 + 详细理由
|
|
- **如果 elicit: true** → 强制性 1-9 选项格式
|
|
- 如果可能, 保存到文件
|
|
4. **继续直到完成**
|
|
|
|
## 详细理由要求
|
|
|
|
在呈现部分内容时, 始终包括解释以下内容的理由：
|
|
|
|
- 做出的权衡和选择 (选择了什么而不是替代方案以及原因)
|
|
- 起草过程中做出的关键假设
|
|
- 需要用户关注的有趣或有问题的决定
|
|
- 可能需要验证的领域
|
|
|
|
## 引导结果流程
|
|
|
|
用户选择引导方法 (2-9) 后：
|
|
|
|
1. 从 data/elicitation-methods 执行方法
|
|
2. 呈现结果和见解
|
|
3. 提供选项:
|
|
- **1. 应用更改并更新部分**
|
|
- **2. 返回引导菜单**
|
|
- **3. 提出任何问题或进一步参与此引导**
|
|
|
|
## 代理权限
|
|
|
|
在处理带有代理权限字段的部分时：
|
|
|
|
- **owner**: 注意哪个代理角色最初创建/填充该部分
|
|
- **editors**: 列出允许修改该部分的代理角色
|
|
- **readonly**: 标记创建后无法修改的部分
|
|
|
|
**对于访问受限的部分:**
|
|
|
|
- 在生成的文档中包含一条注释, 指明负责的代理
|
|
- 示例: “_(此部分由 dev-agent 拥有, 只能由 dev-agent 修改)_”
|
|
|
|
## YOLO 模式
|
|
|
|
用户可以输入 `#yolo` 来切换到 YOLO 模式 (一次性处理所有部分)。
|
|
|
|
## 关键提醒
|
|
|
|
**❌ 绝不:**
|
|
|
|
- 对引导提出是/否问题
|
|
- 使用除 1-9 编号选项之外的任何格式
|
|
- 创建新的引导方法
|
|
|
|
**✅ 始终:**
|
|
|
|
- 当 elicit: true 时使用确切的 1-9 格式
|
|
- 仅从 data/elicitation-methods 中选择选项 2-9
|
|
- 提供详细的理由来解释决定
|
|
- 以“选择 1-9 或直接输入您的问题/反馈:”结尾
|