skill-improver

技能改进方法

使用 skill-reviewer Agent 迭代改进 Claude Code 技能，直到达到质量标准。

前置条件

需要提供 skill-reviewer Agent 的 plugin-dev 插件。

验证该插件是否已启用：运行 /plugins，确认列表中显示 plugin-dev。如果缺少，请报告此项前置条件，并在获准安装前核实插件来源和安装说明；仅凭插件名称无法确定其来源。

核心循环

1. 审查 - 调用 skill-reviewer 审查目标技能
2. 分类 - 按严重程度解析问题
3. 修复 - 解决严重和主要问题
4. 评估 - 检查次要问题是否确实成立，再决定是否修复
5. 重复 - 设定迭代次数／时间预算（例如，三个周期）；预算耗尽后停止并报告尚未解决的阻塞问题。审查者的意见仅供参考，不得凌驾于仓库政策或用户要求的范围之上。

适用场景

• 改进存在多个质量问题的技能
• 持续迭代新技能，直到达到标准
• 使用自动化修复—审查循环，而非手动编辑
• 对多个技能执行一致的质量检查

不适用场景

• 一次性审查：改用 /skill-reviewer
• 快速修复单个问题：直接编辑文件
• 非技能文件：仅适用于 SKILL.md 文件
• 实验性技能：探索阶段手动迭代更灵活

问题分类

严重问题（必须立即修复）

这些问题会阻止技能加载或导致运行时故障：

• 缺少必需的 frontmatter 字段（name、description）——Claude 无法索引或触发该技能
• YAML frontmatter 语法无效——解析失败，技能无法加载
• 引用了不存在的文件——Claude 按链接操作时会出现运行时错误
• 文件路径无效——同上，会导致工具故障

主要问题（必须修复）

这些问题会显著降低技能的有效性：

• 触发描述薄弱或含糊——Claude 可能无法识别何时应使用该技能
• 写作语气严重妨碍执行——应根据目标项目的风格评估，而不是一概禁止使用第二人称
• 上下文占用过多——检查实际加载行为并考虑使用引用文件；500 行只是参考值，除非宿主或项目另有要求
• 缺少目标项目实际要求的触发条件／范围界限
• 描述未说明何时触发——技能可能永远不会被选中

次要问题（评估后再修复）

这些润色项未必能改善技能：

• 主观风格偏好——审查者的品味可能与作者不同
• 可选增强项——增加复杂度，却未必带来相称的价值
• “锦上添花”的改进——实施前应权衡成本与收益
• 格式建议——通常有效，但影响较小

次要问题评估

实施任何次要问题修复前，先评估：

1. 这确实是改进吗？ - 它是否带来实际价值，还是仅仅符合某种偏好？
2. 这可能是误报吗？ - 审查者是否误解了上下文？
3. 这真的有助于 Claude 使用该技能吗？ - 聚焦于功能上的改进

只实施明确有益的次要问题修复。skill-reviewer 可能会产生误报。

调用 skill-reviewer

使用 plugin-dev 插件中的 skill-reviewer Agent。请 Claude：

使用 plugin-dev:skill-reviewer Agent 审查 [SKILL_PATH] 处的技能，并按严重程度对问题分类，提供详细的质量评估。

将 [SKILL_PATH] 替换为技能目录的绝对路径（例如，/path/to/plugins/my-plugin/skills/my-skill）。

示例修复周期

第 1 轮 — skill-reviewer 输出：

Critical: SKILL.md:1 - Missing required 'name' field in frontmatter
Major: SKILL.md:3 - Description uses second person ("you should use")
Major: Missing "When NOT to Use" section
Minor: Line 45 is verbose

已应用的修复：

• 在 frontmatter 中添加了 name 字段
• 将描述改写为第三人称
• 添加了“何时不应使用”部分

第 2 轮 — 再次运行 skill-reviewer 以验证修复：

Minor: Line 45 is verbose

次要问题评估： 第 45 行目前表达清晰。详细内容提供了有用的上下文。跳过。

所有严重/主要问题均已解决。输出完成标记：

<skill-improvement-complete>

注意：标记必须出现在输出中。“质量标准已达成”或“看起来不错”之类的陈述不会停止循环。

完成标准

如果此工作流配置了已安装并经过检查的停止钩子，请确认其约定。本技能不会提供或安装停止钩子。在这种集成中，停止钩子可能会检查下面的显式标记。没有其他信号可以终止循环。

完成后输出此标记：

<skill-improvement-complete>

何时输出标记：

1. skill-reviewer 报告“Pass”或未发现问题 → 立即输出标记
2. 所有严重和主要问题均已修复且已验证修复 → 输出标记
3. 剩余问题仅为次要问题且已评估为误报或不值得修复 → 输出标记

何时不应输出标记：

• 仍有未修复的严重问题
• 仍有未修复的主要问题
• 尚未运行 skill-reviewer 来验证修复是否有效

标记仅表示此循环已完成；它不代表安全认证、测试、来源证明或仓库合并门禁已通过。如果用户取消、工具不可用或预算耗尽，请停止并报告阻碍因素，即使此时不适合输出成功标记。

应拒绝的借口

• “我先标记为已完成，之后再回来处理”——现在就修复问题
• “这个次要问题似乎不对，我会把它们全都跳过”——逐一评估每个问题
• “评审者太严格了”——质量标准有其存在的理由
• “这样已经够好了”——如果存在主要问题，就还不够好

限制

• 仅当任务明确符合上述范围时，才使用此技能。
• 不要将输出视为针对特定环境的验证、测试或专家评审的替代品。
• 如果缺少必要的输入、权限、安全边界或成功标准，请停止并要求澄清。