SuperAPI AI 工具集

docs-corpus-audit

写作与研究

查看项目

更新于 10-16 00:31

技能介绍

用途:对 microsoft/apm 文档全库做整体重校准(regrounding),逐页核对当前源码,修复单次 PR 审查漏掉的累积漂移,如过期 flag 名、IA 调整遗留的死链、超出目标版本的弃用横幅、源侧事实已变动的内容。与 docs-sync 分工:docs-sync 由 PR 事件触发、基于 diff;本技能由维护者要求“审计全库/reground/发布前清扫”触发,无需 PR 或 diff。

主要能力:将语料切分为 6-8 个互不重叠的页面范围,每个范围由一个验证子代理负责,提取事实性声明并用确定性来源核验(如 uv run apm <verb> --help、grep -n src/apm_cli/、python -c "import ..."、文件存在性检查),就地做 1-3 行外科式修改;随后编排器运行跨语料扫描与对齐循环,复查修改是否真正成立。

使用方式:流程为 PROBE(检查 docs/src/content/docs/、packages/apm-guide/.apm/skills/apm-usage/、.apm/docs-index.yml,并确认在非 main 工作分支)、风险分级、波次规划、并行波次执行、跨语料后处理(scripts/scan-cross-corpus-drift.sh)、对齐循环、提交推送、开 PR 并附摘要评论。子代理绝不执行 git commit/push/gh pr,编排器是唯一 git 写入者,每波提交一次、每会话推送一次。

适用场景:发布前全库清扫、文档整体感觉陈旧时。限制:不做单 PR 文档影响审查(用 docs-sync)、不做单页错字编辑、不为新功能写文档、不自动合并或未经维护者审查推送、不审查代码质量/安全/测试覆盖。若缺少 packages/apm-guide/.apm/skills/apm-usage/,审计无法完成 Rule 4,需先询问维护者。成本随波次而非语料规模增长,S7 验证占主要墙钟时间。