SuperAPI AI 工具集

doc-bdd-reviewer

通用与其它

查看项目

更新于 10-16 03:38

技能介绍

用途:对行为驱动开发(BDD)文档做深度内容审查与质量保证,属于第 4 层 BDD 质量保证,上游来自 doc-bdd-autopilot 或 doc-bdd,下游无(是生成 ADR 前的最终 QA 关卡)。适用于 BDD 生成后、手工修改 BDD 后、运行 doc-adr-autopilot 前、定期质量检查及 CI/CD 审查门禁;BDD 尚不存在时应先用 doc-bdd 或 doc-bdd-autopilot,仅需结构校验时用 doc-bdd-validator。

主要能力:审查流程先做结构合规检查(强制嵌套文件夹规则,不通过则阻断),再依次检查 Gherkin 语法、场景完整性、EARS 对齐、步骤定义复用性、数据表校验、占位符检测、命名合规,以及上游漂移检测。漂移检测使用强制缓存 docs/04_BDD/.drift_cache.json,采用加载缓存、检测漂移、更新缓存三阶段算法,并用 sha256sum <file_path> | cut -d' ' -f1 计算哈希。

评分与阈值:按 Gherkin 语法 19%、场景完整性 23%、EARS 对齐 19%、步骤复用 10%、数据表 9%、占位符 5%、命名 10%、上游漂移 5% 加权,满分 100;≥90 通过,80-89 警告,<80 失败。

用法:/doc-bdd-reviewer BDD-01、/doc-bdd-reviewer docs/04_BDD/BDD-01_f1_iam.feature 或 /doc-bdd-reviewer all。报告写入 BDD 嵌套文件夹,命名 BDD-NN.R_review_report_vNNN.md,版本自动递增;doc-bdd-audit 会合并审查与校验结果,输出 BDD-NN.A_audit_report_vNNN.md。

限制:结构不合规会阻断后续检查;漂移缓存不可禁用;哈希必须为 64 位十六进制,禁止占位值;具体平台、收费与价格资料暂未提供。