BMAD-METHOD/common/tasks/execute-checklist.md

清单验证任务

本任务提供根据清单验证文档的说明。代理人必须遵循这些说明，以确保对文档进行彻底和系统的验证。

可用清单

如果用户询问或未指定具体清单，请列出可供代理人角色使用的清单。如果任务不是由特定代理人运行，请告知用户检查 {root}/checklists 文件夹以选择要运行的适当清单。

说明

1. 初步评估

   • 如果用户或正在运行的任务提供了清单名称：
     • 尝试模糊匹配（例如“architecture checklist” -> “architect-checklist”）
     • 如果找到多个匹配项，请用户澄清
     • 从 {root}/checklists/ 加载相应的清单
   • 如果未指定清单：
     • 询问用户要使用哪个清单
     • 从 checklists 文件夹中的文件呈现可用选项
   • 确认他们是否要逐一处理清单：
     • 逐节进行（交互模式 - 非常耗时）
     • 一次性完成（YOLO 模式 - 推荐用于清单，最后会有各部分的摘要供讨论）

2. 文档和工件收集

   • 每个清单都会在开头指定其所需的文档/工件
   • 遵循清单的具体说明来收集所需内容，通常文件可以在 docs 文件夹中找到，如果不确定或找不到，请暂停并询问或与用户确认。

3. 清单处理

   如果在交互模式下：

   • 一次一个地处理清单的每个部分
   • 对于每个部分：
     • 根据清单中嵌入的该部分的说明，审查该部分中的所有项目
     • 根据相关文档或工件检查每个项目
     • 呈现该部分的调查结果摘要，突出显示警告、错误和不适用的项目（并说明不适用的理由）。
     • 在进入下一部分之前获得用户确认，或者如果有任何重大问题，是否需要暂停并采取纠正措施

   如果在 YOLO 模式下：

   • 一次性处理所有部分
   • 创建一份所有调查结果的综合报告
   • 向用户呈现完整的分析

4. 验证方法

   对于每个清单项目：

   • 阅读并理解要求
   • 在文档中寻找满足要求的证据
   • 考虑明确提及和隐含覆盖
   • 除此之外，遵循所有清单的 llm 指令
   • 将项目标记为：
     • ✅ 通过：要求明确满足
     • ❌ 失败：要求未满足或覆盖不充分
     • ⚠️ 部分通过：某些方面已覆盖但需要改进
     • N/A：不适用于本案例

5. 部分分析

   对于每个部分：

   • 逐步思考以计算通过率
   • 识别失败项目中的共同主题
   • 提供具体的改进建议
   • 在交互模式下，与用户讨论调查结果
   • 记录任何用户决定或解释

6. 最终报告

   准备一份摘要，包括：

   • 总体清单完成状态
   • 各部分的通过率
   • 包含上下文的失败项目列表
   • 具体的改进建议
   • 任何标记为 N/A 的部分或项目及其理由

清单执行方法论

每个清单现在都包含嵌入的 LLM 提示和说明，这些提示和说明将：

1. 指导深入思考 - 提示确保对每个部分进行深入分析
2. 请求特定工件 - 关于需要哪些文档/访问权限的明确说明
3. 提供上下文指导 - 针对特定部分的提示以实现更好的验证
4. 生成综合报告 - 包含详细调查结果的最终摘要

LLM 将：

• 执行完整的清单验证
• 呈现一份包含通过/失败率和关键调查结果的最终报告
• 主动提出对任何部分进行详细分析，特别是那些有警告或失败的部分