SuperAPI AI 工具集

doc-bdd-audit

通用与其它

查看项目

更新于 10-16 03:04

技能介绍

用途:对已存在的 BDD 套件做统一审计,把声明式结构检查与内容质量评审合并为一份报告,供 ../doc-bdd-fixer/SKILL.md 消费;框架本身不含运行时代码,由 Claude 依据规范直接执行各项检查。位于第 4 层(BDD 质量门禁),上游是 BDD 文件,下游是 .aidoc/audit/04_BDD-audit.md 及可选的修复循环。不要在需要创建 BDD 时使用(改用 doc-bdd 或 doc-bdd-autopilot)。每次审计必须从零开始,不得复用先前分数或缓存结果。

主要能力:结构检查包括元素 ID 格式(BDD.NN.SS.xxxx 四字节哈希)、必需章节完整且非空、场景原子性与合法 Given/When/Then 阶段列表、每场景的 element-level ears 列表、场景字段(id、type、priority、given/when/then、spec_trace)、阈值使用 @threshold: 键、ADR-Ready 分数不低于阈值(默认 90)。二级为建议项:frontmatter 元数据、内部链接与模板/治理引用可解析、未引用尚不存在的下游数字、五类场景齐全、时间使用 HH:MM:SS 与 IANA 时区、含流程图时带序列图标签。还做写作风格检查(禁用短语、表格/要点偏好、体量目标)。

使用方式:输入为 BDD 路径(docs/04_BDD/BDD-NN_*/...),可选分数阈值(默认 90)。流程为执行结构检查、记录发现、内容评审、合并归一化、写出 .aidoc/audit/04_BDD-audit.md,若存在可自动修复项则交给 doc-bdd-fixer。评审模式从 .aidoc/profile.yaml 读取 review_mode,未设置时按优先级回退到框架默认:门禁处为 team,写入时为 single_pass。team 模式下创建 .aidoc/review/04_BDD/<BDD-id>/ 黑板,按 REVIEW_CREWS.yaml 中 qa_lead 35、tech_lead 25、chaos_engineer 14、security_engineer 6、operator 10、auditor 10 分配权重,为每个透镜分发 Task 子代理并读取对应 playbook;随后合成器写出 verdict.json 与 report.md。single_pass 模式在自身上下文顺序应用全部透镜,不产生 saga。

限制:透镜不得读取、引用或加权作者自评字段(如 _ready_score、_score、readiness_score、audit_score)以免锚定;未满足法定人数时标记为低置信并需人工复核,绝不静默通过。独立调用不初始化 saga.json;断路上限 SOFT_DEADLINE 为 1500 秒,达到则干净退出并标记 PARTIAL_TIMEOUT。审计将 PARTIAL_TIMEOUT 视为 FAIL 且不重试,重试由 saga 驱动负责,最大迭代次数为 3。其他细节暂未提供。