SuperAPI AI 工具集

doc-ears-audit

通用与其它

查看项目

更新于 10-16 03:03

技能介绍

用途:在 EARS 文档已存在、生成 BDD 之前,或处于 autopilot 的审计↔修复循环中,对 EARS 执行统一审计。不用于创建 EARS。

主要能力:一次运行同时包含声明式结构检查与内容质量评审,产出单一合并报告 .aidoc/audit/03_EARS-audit.md。结构检查为 Tier 1 阻断项(元素 ID 格式 EARS.NN.SS.xxxx、必需章节齐全非空、EARS 语法含 WHEN/IF/WHILE 与 THE … SHALL 且原子、可量化约束用 p50/p95/p99 或具体值加单位、BDD-Ready 分数达阈值默认 90)与 Tier 2 建议项(frontmatter、@prd 标签、链接解析、图表标签、写作风格等)。内容评审由评审团队(requirements_specialist 35、tech_lead 25、qa_lead 20、chaos_engineer 12、security_engineer 8,权重合计 100)分镜头执行,再由 synthesizer 汇总出 verdict.json 与 report.md。

使用方式:输入 EARS 路径与可选分数阈值。序列为结构检查→记录发现→内容评审→合并归一→写报告→可自动修复则移交 doc-ears-fixer。执行前须从 .aidoc/profile.yaml 解析 review_mode;team 模式默认在关卡点使用,single_pass 为回退或写出时使用。结构检查在两种模式下均由本技能确定性执行,不委派。团队模式需准备 blackboard 目录并分派 Task 子代理。审计从零开始,不复用旧分数。独立调用且无 saga.json 时不初始化 saga。

限制:报告为单文件原地覆盖;soft deadline 1500s,超时以 PARTIAL_TIMEOUT 退出且不重试;迭代上限由 saga 驱动控制。资料未提供更具体的实现细节与兼容平台信息。