SuperAPI AI 工具集

backport-skill

通用与其它

查看项目

更新于 10-16 06:20

技能介绍

用途:当某个项目安装了技能后又在本地做了改进,backport-skill 负责把这项改进带回本机的来源仓库并提交,而不是把整个文件复制过去。因为已安装副本可能比上游旧,直接覆盖会撤销上游已完成的工作。

主要能力与流程:

  1. 定位两份副本。项目 skills-lock.json 中该技能键下的 source 指明仓库,skillPath 指明仓库内文件路径;已安装副本通常位于项目的 .agents/skills/<name>/。两侧的参考文件与 SKILL.md 同目录,需读取整个文件夹。
  2. 从项目历史中读出改动。以安装提交为基线,其后内容即需回迁部分,可用 git log -p -- .agents/skills/<name>/ 与 git diff -- .agents/skills/<name>/ 查看。动手前需用一句话说明该改动做什么。
  3. 应用到上游。用 diff -ru <upstream-folder> <installed-folder> 查看差异,区分用户改动与项目未拉取的上游提交,只落地前者。若两侧改了同一行,应停下并向用户展示两个版本。
  4. 在来源仓库提交,提交信息限定到该技能,例如 feat(create-ticket): ...;推送需另行确认。
  5. 告知下一步:项目仍运行旧副本,来源仓库推送后需运行 /manage-project-skills update <name>。

适用场景:维护本地技能仓库、将项目内技能改进回流上游。限制:需能定位来源仓库检出位置;无法描述清楚的改动不应回迁;推送与更新需用户另行操作。