SuperAPI AI 工具集

doc-chg-audit

通用与其它

查看项目

更新于 10-16 05:46

技能介绍

用途:对已存在的变更管理(CHG)记录做统一审计,在交给 gate-check 做 C3/紧急审批前,或在 autopilot 的审计↔修复循环中使用。不用于编写 CHG,也不执行正式门禁。

主要能力:一次运行完成声明式 schema 与必填字段检查、变更级别检查、来源路由检查、影响/级联检查,以及内容质量评审;产出单一报告 .aidoc/audit/09_CHG-audit.md(每次原地覆盖),并在存在可自动修复项时移交给 doc-chg-fixer。CHG 没有 0–100 就绪分,审计以通过/失败加修复清单报告门禁就绪度,门禁批准由人工经 gate-check 授予。

使用方式:输入 CHG 路径(docs/governance/chg/CHG-NN_* 或 CHG-EMG-YYYYMMDD-HHMM)。执行顺序为结构检查→记录发现→内容评审→合并归一化→写报告→必要时移交修复。评审模式由 .aidoc/profile.yaml 的 review_mode 决定,未设置时按框架默认:门禁处(pre_promotion/pre_merge)用 team,写入时(on_author)用 single_pass。team 模式按 REVIEW_CREWS.yaml 的 CHG 团队(integration_lead 30、architect 20、chaos_engineer 15、operator 15、auditor 10、security_engineer 10)扇出 Task 子代理,黑板上写入 .aidoc/review/09_CHG/<CHG-id>/,再由 synthesizer 生成 verdict.json 与 report.md;single_pass 在本技能上下文内顺序执行全部透镜,不适用法定人数。结构门禁底线始终由本技能确定性执行,不委托。

限制:始终从头审计,不复用旧结果;透镜不得读取或加权作者自评字段(_ready_score、_score、readiness_score、audit_score、gate_ready);空 findings 必须附 no_findings_rationale,否则视为失败透镜;法定人数未达时标记低置信度并交人工,绝不静默通过。独立调用且无 saga.json 时不初始化 saga 日志。具体命令与路径以原文为准。