
关于
使用 skill-reviewer 代理迭代改进 Claude Code 技能直到满足质量标准。适用于改进有多个质量问题的技能、迭代新技能直到达标或自动化修复-审查循环。
name: skill-improver description: "使用 skill-reviewer 代理迭代改进 Claude Code 技能,直到达到质量标准。适用于改进存在多个质量问题的技能、迭代新技能直到达标、或用自动化修复-审查循环替代手动编辑。" risk: unknown source: community
技能改进方法论
使用 skill-reviewer 代理迭代改进 Claude Code 技能,直到达到质量标准。
前置条件
需要 plugin-dev 插件,该插件提供 skill-reviewer 代理。
验证方法:运行 /plugins — plugin-dev 应出现在列表中。如果缺失,请从 Trail of Bits 插件仓库安装。
核心循环
- 审查 - 对目标技能调用 skill-reviewer
- 分类 - 按严重程度解析问题
- 修复 - 解决关键和重大问题
- 评估 - 在修复之前检查次要问题的有效性
- 重复 - 持续循环直到达到质量标准
适用场景
- 改进存在多个质量问题的技能
- 迭代新技能直到达到标准
- 用自动化修复-审查循环替代手动编辑
- 跨技能实施一致的质量标准
不适用场景
- 一次性审查:直接使用
/skill-reviewer - 快速单项修复:直接编辑文件
- 非技能文件:仅适用于 SKILL.md 文件
- 实验性技能:探索阶段手动迭代更有控制力
问题分类
关键问题(必须立即修复)
这些问题会阻止技能加载或导致运行时故障:
- 缺少必需的 frontmatter 字段(name、description)— Claude 无法索引或触发该技能
- 无效的 YAML frontmatter 语法 — 解析失败,技能无法加载
- 引用了不存在的文件 — Claude 跟随链接时产生运行时错误
- 损坏的文件路径 — 同上,导致工具调用失败
重大问题(必须修复)
这些问题会显著降低技能效果:
- 触发描述薄弱或模糊 — Claude 可能无法识别何时使用该技能
- 错误的写作语态(使用第二人称"你"而非祈使句)— 与 Claude 的执行模型不一致
- SKILL.md 超过 500 行且未使用 references/ — 上下文过载,降低理解能力
- 缺少"适用场景"或"不适用场景"部分 — 项目质量标准要求
- 描述未指定触发时机 — 技能可能永远不会被选中
次要问题(修复前需评估)
这些是润色项目,可能改善也可能不改善技能:
- 主观风格偏好 — 审查者可能与作者品味不同
- 可选增强 — 可能增加复杂性但价值不成比例
- "锦上添花"的改进 — 实施前考虑成本效益
- 格式建议 — 通常有效但影响较低
次要问题评估
在实施任何次要问题修复之前,评估:
- 这是真正的改进吗? - 是否增加了实际价值,还是仅满足偏好?
- 这可能是误报吗? - 审查者是否误解了上下文?
- 这是否真的帮助 Claude 使用该技能? - 专注于功能性改进
仅实施明确有益的次要修复。skill-reviewer 可能产生误报。
调用 skill-reviewer
使用 plugin-dev 插件中的 skill-reviewer 代理。通过以下方式请求审查:
使用 plugin-dev:skill-reviewer 代理审查位于 [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>
何时输出标记:
- skill-reviewer 报告"通过" 或 未发现问题 → 立即输出标记
- 所有关键和重大问题已修复 且已验证修复 → 输出标记
- 剩余问题仅为次要问题 且已评估为非必要修复 → 输出标记