SuperAPI AI 工具集

agents-md-sync

智能体与模型

查看项目

更新于 10-16 06:16

技能介绍

用途:在创建 PR 前、PR 合并到 main 后或用户显式要求时,检查当前分支代码改动是否让 AGENTS.md 中的长期指导过时。AGENTS.md 被视为面向未来智能体的操作手册,而非变更日志。

主要能力:先确定与基线的差异(如 git diff main...HEAD 或 gh pr diff <number>);按目录归属把改动映射到对应的 AGENTS.md;检查是否存在缺失的 AGENTS.md;逐文件比对准确性、信息密度、缺失不变量、结构漂移、命令漂移、约定漂移、描述漂移与层级漂移等问题。输出按文件分组的报告,列出过时位置、原因和具体修改建议;若无需更新则明确说明,不制造问题。报告后可选择直接应用修改、创建后续 PR 或跳过。

使用方式:作为技能在开发流程中调用,先提供 diff,再阅读相关 AGENTS.md 与源码进行核实。缺少上下文时可提出反应式补充建议。

限制:只推荐高置信度、持久的指导;不记录一次性实现细节、明显事实、文件清单或当前 PR 专用建议。新增文件建议需同时满足真实所有权边界与隐藏约定等条件,目标长度约 20-80 行。缺少资料之处暂未提供。