关于 skill-improver
skill-improver 分析运行产物,为 Skills 和 Workflows 提出改进建议。它识别失败、耗时瓶颈、确认环节问题和产物约定缺口,并提供优先级建议及可选的最小补丁。
主要功能
- 01分析运行日志与状态
- 02发现失败和耗时瓶颈
- 03检查产物命名与持久化
- 04按优先级整理改进建议
- 05可生成最小技能补丁
适用场景
- 01根据一次运行改进工作流
- 02识别反复失败或低效步骤
- 03检查工作流产物是否一致
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ heyvhuang/ ship-faster --skill skill-improver安装后在 Claude Code 中输入/skill-improver确认已加载。
详细介绍
技能改进器
基于实际执行产物回顾并改进技能/工作流,让技能链在使用过程中更加稳定。
输入(仅传入路径)
run_dir:runs/<workflow>/active/<run_id>/(或openspec/changes/<change-id>/)
输出
improvements.md:改进建议(可直接转换为变更任务)- 可选:对相关
SKILL.md的最小补丁(仅修改必要内容)
流程
- 读取
logs/state.json和logs/events.jsonl,提取:- 失败点(错误类型、频率、缺失的上下文)
- 时间瓶颈(重复步骤、无效搜索、上下文过多)
- 手动确认节点(确认是否过早、过晚或缺失)
- 检查产物契约:
- 每个步骤是否都持久化了输出
- 是否仅传递路径而非内容
- 命名/路径是否不一致
- 输出改进建议(按收益排序):
- 提示词/触发词优化
- 完善输入/输出契约(添加必需字段、修正产物文件名)
- 错误处理和拒绝策略
- 建议新增确定性脚本(仅在必要时)
输出模板(推荐)
- 概述:本次运行中的核心问题
- 主要问题(从高到低):每项包括“症状/根本原因/修复建议/相关技能/建议变更点”
- 建议的最小变更清单:按文件列出
评论
支持 Markdown