SuperAPI AI 工具集

skill-refine

编程与开发

查看项目

更新于 10-16 06:39

技能介绍

Skill Refine 是一个面向技能(skill)开发工作流的工具,用于把反馈报告转换为计划层面的补丁操作。它的定位是:当 .skill-plan.yaml 已存在,且 skill-check 或 skill-eval 给出了反馈时,先在本工具中把这些反馈整理成对计划的修改建议,再重新运行 /skill-forge。它明确不直接编辑技能包(skill bundle)文件。

主要能力

  1. 加载计划与报告:要求提供已存在的 .skill-plan.yaml 路径,若缺失则停止并询问用户路径。读取基础计划 YAML,确认可解析且包含必需的规划字段。定位用户提供的 *-skill-check-report.html 和/或 *-eval-report.html,对每份报告运行 Bash scripts/parse-report.sh <report-path>,并用 assets/report-schema.json 校验解析出的 JSON,格式错误时展示解析错误。随后呈现反馈摘要:发现总数、主要失败项、受影响的计划区域。

  2. 问题排序:读取 references/priority-rules.md,把发现项分为 P0-P3 等级,先按等级、再按同级内影响度排序,向用户展示排序后的队列,并给出各优先级层级的数量。

  3. 提出计划补丁操作:针对排名最高的问题,按 references/change-proposal-format.md 生成一个计划补丁提案。补丁范围仅限计划字段,例如 intent、scope、mechanism、context_assets、workflow_notes、example_placed、target_path。向用户提供 [apply / skip / edit / stop] 选项:apply 时把操作追加到补丁队列;edit 时接受用户修改后的补丁操作并再次呈现确认一次;skip 时进入下一个问题;stop 时持久化队列并退出循环。

  4. 构建产物:把排队的操作按 assets/plan-patch-template.yaml 的结构写入 <plan-dir>/.skill-plan.patch.yaml;在内存中把操作应用到基础计划,生成 <plan-dir>/.skill-plan.patched.yaml;运行 Bash scripts/validate-plan.sh <plan-dir>/.skill-plan.patched.yaml 校验 forge 导入契约。若校验失败,标记失败的操作并询问用户是编辑还是丢弃;校验通过后展示简洁的计划差异摘要(仅变更字段)。

  5. 交接:请用户批准补丁后的计划作为 forge 输入。批准后指示运行 /skill-forge <plan-dir>/.skill-plan.patched.yaml;拒绝时保留补丁产物并返回上一步。

使用方式

典型调用形式为:Agent: "refine plan skills/my-skill/.skill-plan.yaml"。整体流程为:加载计划与报告 → 排序问题 → 逐条提出补丁操作 → 构建补丁与补丁后计划并校验 → 交接给 /skill-forge。

适用场景

适用于已经用 skill-forge 生成技能计划、并通过 skill-check 或 skill-eval 获得反馈后,希望以结构化、可审查的方式把反馈回灌到计划中的开发者。

限制与约束

始终需要人在回路,未经用户明确批准绝不自动应用补丁;本技能不直接编辑目标技能包文件;补丁操作保持细粒度(一个操作只处理一个关注点);保留原始 .skill-plan.yaml,补丁输出写入 .skill-plan.patched.yaml。

参考文件

priority-rules.md 提供发现项严重等级与排序逻辑;change-proposal-format.md 提供补丁提案模板;Example.md 提供端到端示例;report-schema.json 提供解析后报告的 JSON 模式;plan-patch-template.yaml 提供补丁产物结构;changelog-template.md 提供补丁日志条目格式。