# 验证下一个故事任务 ## 目的 在实施开始前,全面验证故事草稿,确保其完整、准确,并为成功开发提供足够的上下文。此任务旨在识别需要解决的问题和差距,防止产生幻觉,并确保实施准备就绪。 ## 顺序任务执行(在当前任务完成前不要继续) ### 0. 加载核心配置和输入 - 加载 `.bmad-core/core-config.yaml` - 如果文件不存在,则停止并通知用户:“未找到 core-config.yaml。此文件是故事验证所必需的。” - 提取关键配置:`devStoryLocation`、`prd.*`、`architecture.*` - 识别并加载以下输入: - **故事文件**:要验证的草稿故事(由用户提供或在`devStoryLocation`中发现) - **父史诗**:包含此故事需求的史诗 - **架构文档**:根据配置(分片或单片) - **故事模板**:`bmad-core/templates/story-tmpl.md` 用于完整性验证 ### 1. 模板完整性验证 - 加载 `bmad-core/templates/story-tmpl.md` 并从模板中提取所有章节标题 - **缺失章节检查**:将故事章节与模板章节进行比较,以验证所有必需的章节都存在 - **占位符验证**:确保没有模板占位符未被填充(例如,`{{EpicNum}}`、`{{role}}`、`_TBD_`) - **代理章节验证**:确认模板中的所有章节都存在,以供将来的代理使用 - **结构合规性**:验证故事遵循模板结构和格式 ### 2. 文件结构和源代码树验证 - **文件路径清晰度**:是否清楚地指定了要创建/修改的新/现有文件? - **源代码树相关性**:开发说明中是否包含相关的项目结构? - **目录结构**:新目录/组件是否根据项目结构正确定位? - **文件创建顺序**:任务是否按逻辑顺序列出了应在何处创建文件? - **路径准确性**:文件路径是否与架构文档中的项目结构一致? ### 3. UI/前端完整性验证(如果适用) - **组件规范**:UI组件的详细程度是否足以进行实施? - **样式/设计指导**:视觉实施指导是否清晰? - **用户交互流程**:是否指定了UX模式和行为? - **响应式/可访问性**:如果需要,是否解决了这些考虑因素? - **集成点**:前后端集成点是否清晰? ### 4. 验收标准满意度评估 - **AC覆盖率**:列出的任务是否能满足所有验收标准? - **AC可测试性**:验收标准是否可衡量和可验证? - **缺失场景**:是否覆盖了边缘情况或错误条件? - **成功定义**:是否为每个AC明确定义了“完成”? - **任务-AC映射**:任务是否正确链接到特定的验收标准? ### 5. 验证和测试说明审查 - **测试方法清晰度**:是否清楚地指定了测试方法? - **测试场景**:是否确定了关键测试用例? - **验证步骤**:验收标准验证步骤是否清晰? - **测试工具/框架**:是否指定了所需的测试工具? - **测试数据要求**:是否确定了测试数据需求? ### 6. 安全考虑评估(如果适用) - **安全要求**:是否确定并解决了安全需求? - **认证/授权**:是否指定了访问控制? - **数据保护**:敏感数据处理要求是否清晰? - **漏洞预防**:是否解决了常见的安全问题? - **合规要求**:是否解决了法规/合规需求? ### 7. 任务/子任务顺序验证 - **逻辑顺序**:任务是否遵循正确的实施顺序? - **依赖关系**:任务依赖关系是否清晰正确? - **粒度**:任务的大小是否适当且可操作? - **完整性**:任务是否涵盖了所有需求和验收标准? - **阻塞问题**:是否有任何任务会阻塞其他任务? ### 8. 反幻觉验证 - **来源验证**:每个技术声明都必须可以追溯到源文档 - **架构对齐**:开发说明内容与架构规范匹配 - **无杜撰细节**:标记任何不受源文档支持的技术决策 - **引用准确性**:验证所有源引用是否正确且可访问 - **事实核查**:将声明与史诗和架构文档进行交叉引用 ### 9. 开发代理实施准备情况 - **自包含上下文**:无需阅读外部文档即可实施故事吗? - **清晰的说明**:实施步骤是否明确? - **完整的技术上下文**:开发说明中是否包含所有必需的技术细节? - **信息缺失**:识别任何关键信息差距 - **可操作性**:所有任务是否都可由开发代理操作? ### 10. 生成验证报告 提供结构化的验证报告,包括: #### 模板合规性问题 - 故事模板中缺失的章节 - 未填充的占位符或模板变量 - 结构格式问题 #### 关键问题(必须修复 - 故事受阻) - 实施所需的基本信息缺失 - 不准确或无法验证的技术声明 - 验收标准覆盖不完整 - 缺少必需的章节 #### 应修复问题(重要的质量改进) - 不清晰的实施指导 - 缺少安全考虑 - 任务排序问题 - 不完整的测试说明 #### 可有可无的改进(可选增强) - 有助于实施的额外上下文 - 可以提高效率的澄清说明 - 文档改进 #### 反幻觉发现 - 无法验证的技术声明 - 缺少来源引用 - 与架构文档不一致 - 杜撰的库、模式或标准 #### 最终评估 - **GO**:故事已准备好实施 - **NO-GO**:故事在实施前需要修复 - **实施准备就绪分数**:1-10分 - **成功实施的置信度**:高/中/低