将第三方技能与上游同步
前提条件:已认证 gh CLI。所有命令从代码库根目录执行。
工作流程
-
运行
node scripts/skills-sync.mjs status。状态及对应操作:up-to-date— 无需操作。local— 自有技能,无上游;无需同步。upstream-updated— 安全快进:执行node scripts/skills-sync.mjs pull <plugin>/<skill>。locally-modified— 自上次基线后有过编辑。如果编辑是有意的, 执行node scripts/skills-sync.mjs accept <plugin>/<skill>。diverged— 两侧均有变更:手动合并(见下方章节)。fetch-error (...)— 上游不可达或已移动;检查插件skills-lock.json中的source/skillPath与上游仓库。
-
所有更改完成后:执行
node scripts/skills-sync.mjs verify,然后提交并附带一条信息, 列出哪些技能被拉取或合并,以及来自哪些上游提交。
分歧技能的手动合并
切勿盲目覆盖分歧的技能 —— pull --force 会丢弃我们的自定义修改。
node scripts/skills-sync.mjs diff <plugin>/<skill>— 显示完整的差异(第三方版本 → 上游版本)。- 识别哪些差异是我们的有意自定义修改
(
git log -p -- <plugin>/skills/<skill>显示第三方副本的演变过程) 以及哪些是真正的上游改进。 - 编辑第三方文件,在保留每个本地自定义修改的同时整合上游改进。编辑前务必完整阅读两个版本。
- 重新设定两侧基线:
node scripts/skills-sync.mjs seed <plugin>/<skill>(accept仅重新设定第三方哈希的基线,会导致技能永久标记为上游已更新)。