用途：doc-bdd-validator 用于按 Layer 4（BDD）模式标准校验行为驱动开发文档，可在用户要求校验 BDD 文档时调用，或在创建、修改 BDD 产物后调用。
主要能力：校验分为几部分。第0部分为阻塞性文件夹结构校验：所有 BDD 文档必须放在嵌套文件夹中，Markdown 与 feature 文件须位于 docs/04_BDD/BDD-NN_{slug}/ 下，文件夹名、文件名须与 BDD ID 匹配，对应错误码 BDD-E020、BDD-E021、BDD-E022，以及 VAL-H001、VAL-H002。元数据校验要求 custom_fields（document_type、artifact_type、layer、architecture_approaches、priority、development_status）与 tags（bdd 或 bdd-template、layer-4-artifact），并禁止特定标签模式。结构校验要求标题及第1至第9节，Document Control 含 BDD ID、Document Name、Version、Date Created、Last Updated、Author、Status、Source EARS。内容校验检查 Gherkin 语法、Given-When-Then、Scenario Outline 与 Examples、ADR-Ready Score（最低90%）。追溯校验要求 @brd、@prd、@ears 等 Layer 4 累积标签及同类引用。
用法：使用 validate_bdd.py 命令，例如 python ai_dev_ssd_flow/04_BDD/scripts/validate_bdd.py docs/04_BDD/BDD-001_example.md，或校验目录、feature 文件，加 --verbose 输出详情。执行流程为解析 YAML frontmatter、检查元数据、标签、章节、Document Control、Gherkin 语法与 Given-When-Then、Scenario Outline Examples、上游引用，计算 ADR-Ready Score，校验文件命名，生成报告。输出为 BDD 校验报告，含 PASS/FAIL、场景统计与按严重级别列出的错误、警告、信息。
集成：由 doc-flow、doc-bdd 在创建后调用，供 trace-check 使用，并报告给 quality-advisor。
限制：资料未提供安装方式、收费模式、支持平台、运行环境要求及性能说明。校验结果依赖指定 schema、目录规则与错误码定义。