SuperAPI AI 工具集

docs-drift-review

测试与质量

查看项目

更新于 10-15 21:41

技能介绍

用途:该技能用于审查单个拉取请求是否引入了具体的 harness 文档漂移,即代码行为与最近的权威文档之间的不一致;仅审查 PR 新引入的问题,不审计无关的既有内容。

主要能力:先解析 PR、仓库与基础引用,在基础分支语境下查看 diff;阅读仓库的 AGENTS.md 及其关联的贡献者与 harness 文档,以与改动工作流最近的文档为准。优先检查 harness 敏感面:构建清单与任务文件;脚本、钩子、CI 工作流、命令面与自测;与改动行为相邻的路由文档。核对命令是否存在及契约、脚本清单、可变性标签、路由链接、计划与现状措辞。仅当 PR 修改了代理加载或 happy-path 操作员文档时,才检查操作员文档膨胀,并将新主预览/脚手架/非默认路径、新重复的注意事项或命令文本标为建议性。

使用方式:报告仅包含有改动文件、受影响文档和精确建议修改的发现,区分必须修复的漂移与建议性膨胀;若无实质漂移,发布简短的无漂移评论,或当 PR 未触及 harness 面时省略。评论仅发在触发 PR 上,使用固定格式:Summary、Must-fix drift、Advisory、Verification。不得推送提交、开设其他 PR 或对建议性发现要求更改。

适用场景:审查涉及构建、脚本、CI、命令与路由文档的 PR。

限制:仅审查 PR 所属仓库;独立 dev/plans/ 文档不视为现状行为,除非 PR 本身仅涉及计划;忽略不改变命令、契约或路由的装饰性 Markdown 改动;忽略不改变 harness 工作流行为的产品或功能文档;不确定、理论性、纯风格或纯膨胀的观察不得作为更改要求。具体安装与调用命令暂未提供。