用途:对 BRD 文档做结构/schema 校验,是质量门禁的结构性关卡,不负责深层语义审阅(战略对齐、内容质量、未解占位符、业务一致性由 doc-brd-reviewer 负责)。可在用户要求校验 BRD、创建或修改 BRD 后、生成下游 PRD 前、以及质量门禁检查时调用。
主要能力:校验 YAML frontmatter 元数据合规;18 个必需章节及部分子章节结构;Document Control 字段完整性;追溯标签格式与存在;PRD-Ready 评分;文件命名规范;架构决策需求(ADR)完整性(7 个强制类别:基础设施、数据架构、集成、安全、可观测性、AI/ML、技术选型,状态 Selected/Pending/N/A 及各自必填字段);图表契约结构合规(c4-l1、dfd-l0、sequence 标签、intent header 字段);上游来源配置与哈希格式;元素 ID 与章节上下文映射(不匹配报 BRD-E022)。
使用方式:使用 schema 为 ai_dev_ssd_flow/01_BRD/BRD_MVP_SCHEMA.yaml,模板与规则文件同目录。校验命令示例:bash ai_dev_ssd_flow/01_BRD/scripts/validate_brd_wrapper.sh docs/01_BRD --skip-advisory;完整含 advisory 校验去掉 --skip-advisory;组件级诊断 python ai_dev_ssd_flow/01_BRD/scripts/validate_brd.py docs/01_BRD/BRD-01_example.md --verbose;跨文档校验 python ai_dev_ssd_flow/scripts/validate_cross_document.py --document docs/01_BRD/BRD-01.md --auto-fix。
限制:仅做结构与 schema 校验,链接完整性与内容质量不在范围内;PRD-Ready 分数最低阈值 90%;图表检查在 BRD 阶段为非阻断建议,正式阻断在 PRD 校验器(PRD-E023..PRD-E026)。支持部分自动修复(ID 格式、缺失追溯章节、Document Control 字段、废弃 ID 模式、缺失 PRD-Ready 分数)。输出为 BRD 校验报告,包含 PASS/FAIL、分数、错误、警告与提示。