SuperAPI AI 工具集

skill-updater

通用与其它

查看项目

更新于 11-05 16:17

技能介绍

Skill Updater 用于执行技能改进计划:对技能文件进行具体编辑、验证修改,并提示用户同步。

用途

当 skill-improvement-plan 生成计划且用户表示“go”之后使用;也可在已有一份明确的跨技能编辑清单时使用;还可用于直接落实评审报告中的修复(简单修复可跳过规划步骤)。

输入

  • 改进计划:来自 skill-improvement-plan 的结构化计划,或一份具体变更清单。
  • 范围(可选):要执行的优先级层级,例如“仅 P0”“P0 和 P1”“全部”。

使用方式

  1. 解析计划:读取改进计划,提取有序变更列表,包括目标技能与文件路径、要改什么、具体编辑(旧文本 → 新文本、新内容、要创建或删除的文件)。若用户提供的是临时变更而非正式计划,则将其整理为相同结构。
  2. 编辑前校验:对每项变更,先读取目标文件,确认存在且内容符合预期;检查冲突,若多个变更指向同一文件,规划编辑顺序以避免冲突;验证归属,若修改 owns 字段,检查与其他技能是否重叠。若与预期不符(评审后文件内容已变、文件不存在),标记并询问用户后再继续。
  3. 应用变更:按优先级顺序执行(先 P0,再 P1 等)。frontmatter 编辑使用 Edit 工具修改特定字段,保留 YAML 格式与字段顺序;description 重写则整体替换为新文本,并确认符合动作动词与触发上下文的模式;内容重构时,若迁移内容到新引用文件,先创建引用文件,再在正文中添加指针并移除被迁移内容,若合并章节,则读取两个来源、合并并写入合并版本;新建文件按指定创建引用文件、检查清单或模板,并确保从父 SKILL.md 链接;删除则移除孤儿文件或重复内容,并更新指向已删内容的链接。每项变更后简要确认,例如“Updated [skill-name]: [what changed]”。
  4. 编辑后校验:重新读取所有修改过的 SKILL.md,校验 frontmatter 字段仍有效;验证修改文件中所有引用链接仍可解析;确认没有 SKILL.md 正文超过 500 行;若 owns 字段有变更,重新验证无重叠。随后报告校验结果,包括修改文件数、frontmatter 有效数、链接解析数、正文行数限制数、归属是否干净,以及发现的问题。
  5. 提示同步:校验成功后询问用户是否将技能同步到全局位置,可使用 sync-skills 工作流推送到 Cursor 和/或 Claude Code。用户同意则调用该工作流,或直接运行同步脚本:
skills/workflows/sync-skills/scripts/sync-skills.sh --to-all

若用户拒绝,提醒其在准备好时同步,因为仓库版本已更新但全局技能位置仍是旧版本。

准则与错误处理

一次只做一个逻辑变更,不把无关编辑合并到一次 Edit 调用;编辑前必须读取文件,绝不编辑本会话中未读过的文件;定向编辑时保留现有格式,不重新格式化整个文件;若计划中的变更已不再合理(上下文变化、文件已修复),跳过并说明原因;大批量(10+ 变更)可用子代理并行处理不同技能的独立编辑;编辑后始终校验。若某次编辑失败,报告失败原因,跳到下一项变更而不阻塞整批,最后汇总所有失败并建议重试、手动修复或跳过;若编辑后校验失败,报告具体失败项、建议修复,并询问用户立即修复还是留待后续。