SuperAPI AI 工具集

evolve-skill

通用与其它

查看项目

更新于 10-16 03:42

技能介绍

evolve-skill 用于维护由 create-skill 创建的技能,属于技能生命周期的维护环节,目标是评估缺口、实施定向改进、提升版本,并保持注册表与交叉引用同步。

用途与适用时机:当技能的步骤因工具变更而过时或不完整、用户反馈暴露缺失的陷阱或验证薄弱、技能需从基础升级到中级或高级、需要与原技能并存的进阶变体,或相关技能增删导致交叉引用失效时使用。

主要能力与流程:读取并评估现有 SKILL.md 各章节是否满足质量清单;收集演进触发因素并分类为精修或变体;依据决策矩阵选择原地精修(技能 ID 不变、版本升 MINOR)或创建进阶变体(新 ID 如 <skill>-advanced、版本重置为 1.0);对精修直接编辑原文件并保留所有章节,新增步骤须同时具备 Expected 与 On failure;对变体则复制原文件到新目录后修改名称、描述、复杂度等。此外还包括同步翻译变体、更新版本与元数据、更新注册表 _registry.yml 与交叉引用、创建符号链接,以及运行完整校验清单。

必要用法示例:读取技能用 cat skills/<skill-name>/SKILL.md,创建变体目录用 mkdir -p skills/<skill-name>-advanced/,校验翻译用 npm run validate:translations 与 npm run translation:status,检查围栏传播用 npm run check:fence-propagation -- --id <skill-name>,字段更新用 node tools/provenance-field.mjs。版本为 MAJOR.MINOR 两段式:当旧用法仍能得到正确结果时升 MINOR,只有当步骤重编号或移除、必需输入变更等破坏既有用法时才升 MAJOR。

限制:资料未提供收费、价格、平台等信息;SKILL.md 不存在或无 frontmatter 时本技能不适用,应改用 create-skill;翻译处理应保持断代真实,不得用 sed 批量修改来源字段;新变体的翻译应待其稳定后再添加。