Skilltune Skill 技能

Skilltune 是一款专门优化 Claude Code 技能描述的 CLI 工具，通过自动化循环提升技能的触发准确率。Claude Code 的技能调用完全依赖 description 字段作为触发信号，描述质量直接影响 AI 能否在正确场景下调用对应技能——Skilltune 正是为解决这一痛点而设计。

其工作原理是一个「生成查询 → 测量触发率 → 提出新描述 → 循环迭代」的自动化优化流程。首次运行时，Skilltune 会利用 Claude Agent SDK 自动生成 20 组评测查询（其中一半为应触发场景，一半为不触发场景），保存在本地 queries.json 文件中。之后每次迭代会实际运行 Claude Code 测量每个查询的真实触发情况，计算正向触发率和误触发率，基于评测结果提出改进后的描述文案，再进入下一轮优化。整个过程在 .skilltune/eval-XXXXX/ 隔离目录下执行，确保项目 CLAUDE.md 不会干扰评测环境。

生成 queries、运行 eval、完整 optimize 三步均可独立使用，支持 --runs（每查询运行次数）、--max-iterations（最大迭代轮次）、--patience（早停轮数）等参数调优。默认以 0.6 比例划分训练集和验证集，防止过拟合到训练数据。

Skilltune 采用 Feature-Sliced Design（FSD）架构组织代码，主目录包含 evaluate（触发率评测）、generate-queries（自动查询生成）、optimize（描述优化循环）、entities（查询与结果类型定义）和 shared/lib（通用工具与 Claude SDK 封装）等模块，结构清晰易维护。Node.js 18 及以上版本即可运行。