mcpField
S
skill-improver

skill-improver

github.com/heyvhuangAgent 工作流33853 次安装30 周前更新
代码仓库

关于 skill-improver

skill-improver 分析运行产物,为 Skills 和 Workflows 提出改进建议。它识别失败、耗时瓶颈、确认环节问题和产物约定缺口,并提供优先级建议及可选的最小补丁。

主要功能

  1. 01分析运行日志与状态
  2. 02发现失败和耗时瓶颈
  3. 03检查产物命名与持久化
  4. 04按优先级整理改进建议
  5. 05可生成最小技能补丁

适用场景

  1. 01根据一次运行改进工作流
  2. 02识别反复失败或低效步骤
  3. 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 的最小补丁(仅修改必要内容)

流程

  1. 读取 logs/state.json 和 logs/events.jsonl,提取:
    • 失败点(错误类型、频率、缺失的上下文)
    • 时间瓶颈(重复步骤、无效搜索、上下文过多)
    • 手动确认节点(确认是否过早、过晚或缺失)
  2. 检查产物契约:
    • 每个步骤是否都持久化了输出
    • 是否仅传递路径而非内容
    • 命名/路径是否不一致
  3. 输出改进建议(按收益排序):
    • 提示词/触发词优化
    • 完善输入/输出契约(添加必需字段、修正产物文件名)
    • 错误处理和拒绝策略
    • 建议新增确定性脚本(仅在必要时)

输出模板(推荐)

  • 概述:本次运行中的核心问题
  • 主要问题(从高到低):每项包括“症状/根本原因/修复建议/相关技能/建议变更点”
  • 建议的最小变更清单:按文件列出

评论

支持 Markdown