SuperAPI AI 工具集

dependency-update-fix

编程与开发

查看项目

更新于 11-02 15:20

技能介绍

用途

这个技能用于修复单个依赖关系更新的 pull request。它由 dependency-update skill 的指挥角色委派调用,只处理评审结论为“需要修正”的那一个 PR,并且只在该 PR 所在仓库的文档所规定的范围内进行修改,改完后推送到该 PR 自己的分支。整个过程没有人在中途参与。

主要能力与执行前提

执行环境方面的条件与 dependency-update skill 中“执行环境确认”所述的条件相同。开始工作前需要自行确认,如果不满足,则不改变任何内容,报告不满足的条件后结束。

执行时不能向用户提问。遇到无法判断的事情时,不做任何改动,直接报告。

pull request 的位置、clone 的位置、工作目录以及标签名称,都遵从指挥角色的指示。同一仓库的其他 pull request 可能由并行的子代理同时处理,因此不得改动指定工作目录之外的内容。技能本身不执行合并,合并由指挥角色完成。

使用方式

开始修改前要先确认两个条件是否同时满足,只有同时满足才进行修复:

  1. 仓库的规则文档(如 CLAUDE.md、AGENTS.md 等)引用了列出依赖更新时需要同步修改位置的文档;
  2. 最新评审评论要求在合并前进行的修正点,全部包含在该文档所列出的位置之中。

如果任一条件不满足,则不改代码,向该 pull request 发表评论说明不在处理范围内及其理由,然后报告结束。评论的第一行为 # Dependency update fix skipped。指挥角色在重新评审之前,不会把带有这条评论的 pull request 作为修正对象。评论中需要写明自己的 Agent 名称与 model 名称。

符合条件时,先 checkout 该 PR 的 head 分支,按照评审评论和文档进行修改,不新建分支,而是在该分支上追加一个 commit。如果修改过程中发现文档所列位置之外也需要修改,则既不 commit 也不 push,立即停止,并发表与上述相同的“不在处理范围”评论后报告。

修改完成后,向该 pull request 发表评论,说明修改了哪些位置、commit 的 SHA 以及所遵循文档的位置,评论第一行为 # Dependency update fix。指挥角色通过这一行识别评论并组装重新评审的指示。评论中同样写明 Agent 名称与 model 名称。发布到 GitHub 上的文字写法遵循 kuden:github skill。

如果指挥角色提供了标签名称,则移除请求评审的标签。最后执行 push。评论先于 push 发布,是因为如果 push 之后作业中断,下一次执行的指挥角色将无法判断该 pull request 已被修正。CI 结束后的重新评审由指挥角色交给其他子代理处理。

汇报内容

向指挥角色简短汇报:commit 的 SHA、修改的文件、所遵循文档的位置;所发评论的 URL;以“不在处理范围”停止时,说明理由并附上所发评论的 URL;以及流程中不明确的地方。

适用场景与限制

适用于依赖更新 PR 在评审中被判定需要修正、且修正点落在仓库文档规定范围内的情形。限制包括:不能由用户直接调用;不能向用户提问;不得修改指定工作目录之外的内容;不执行合并;发现需要超出文档范围的修改时必须停止;执行环境条件不满足时必须不做任何改动并报告。