# 清单验证任务 本任务提供根据清单验证文档的说明。代理人必须遵循这些说明,以确保对文档进行彻底和系统的验证。 ## 可用清单 如果用户询问或未指定具体清单,请列出可供代理人角色使用的清单。如果任务不是由特定代理人运行,请告知用户检查 {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 将: * 执行完整的清单验证 * 呈现一份包含通过/失败率和关键调查结果的最终报告 * 主动提出对任何部分进行详细分析,特别是那些有警告或失败的部分