SuperAPI AI 工具集

skill-sync

编程与开发

查看项目

更新于 10-15 22:40

技能介绍

用途:核对一个技能(SKILL.md)内容所覆盖的上游库,检查其中 API 描述、版本引用与 SOURCE: 引用是否与上游保持一致,并在需要时生成变更计划。

输入与解析:传入单个 SKILL.md 路径或含 SKILL.md 的技能目录时,为该技能生成一条流水线;传入含 skills/ 的插件目录时,匹配 skills/*/SKILL.md,为每个技能生成一条流水线;输入为空或无法识别时停止并报告歧义,要求提供技能路径。

主要阶段:Stage 1 用 uvx skilllint@latest check <skill-path>/SKILL.md 做令牌配置检查(需指向文件而非目录),并用 wc -w 查看 references/ 体积;若 SKILL.md 已超过 SK007,需先执行 /refactor-skill 再重启流水线。Stage 2 在一轮中并行发起 3 个读取代理(skill-auditor、skill-content-updater 读角色、通用结构校验),报告写入 .tmp/scratch/reports/。Stage 3 综合报告,写入变更计划 .tmp/scratch/plans/;若全部为 VERIFIED 且无结构问题则判定无需变更并跳过后续阶段。Stage 4 执行 git status --porcelain,工作区不干净则停止并列出未提交文件。Stage 4.5 由 skill-sync-source-validator 校验并预取所有 SOURCE URL,将无法验证的 URL 降级为 UNVERIFIABLE,并写出 .tmp/scratch/fetched/source-material-YYYYMMDD.md。Stage 5 由 skill-content-updater 写角色依据变更计划与素材文件改写内容,之后再次运行 skilllint,若非零则把超预算段落抽到 references/ 并重新派发。Stage 6 对所有被修改文件运行 skilllint,全部退出码为 0 才算完成,否则回到 Stage 5 做定向修复。

限制:依赖 uvx skilllint 与 git;要求干净工作区;URL 抓取失败标记为 UNVERIFIABLE 并跳过;写作代理不直接抓取 URL。