BMAD-METHOD/common/tasks/create-doc.md

从模板创建文档 (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 或直接输入您的问题/反馈:”结尾