SuperAPI AI 工具集

skill-improver

通用与其它

查看项目

更新于 10-16 01:08

技能介绍

用途:迭代改进 Claude Code 技能,使其达到质量标准。核心循环:调用 skill-reviewer 审查目标技能,按严重程度对问题分类,修复关键与主要问题,评估次要问题是否真的有效,然后重复直到达标。

使用前提:需要 plugin-dev 插件提供的 skill-reviewer 代理。可通过运行 /plugins 验证是否启用,若缺失则从 Trail of Bits 插件仓库安装。

适用场景:技能存在多个质量问题、新技能需反复迭代至标准、用自动化的修复-审查循环替代手工编辑、统一技能质量。不适用:只需一次性审查(直接用 /skill-reviewer)、只需快速单点修复(直接编辑文件)、非技能文件(仅适用于 SKILL.md)、实验性技能(人工迭代更可控)。

问题分级:关键问题须立即修复,包括缺少必需的 frontmatter 字段(name、description)、YAML 语法无效、引用的文件不存在或路径失效。主要问题须修复,包括触发描述模糊、写作口吻错误(应为祈使句而非第二人称)、SKILL.md 超过 500 行且未使用 references/、缺少“何时使用”或“何时不使用”章节、描述未说明触发时机。次要问题需先评估价值再决定是否修复,可能包含误报。

调用方式:请求 Claude 使用 plugin-dev:skill-reviewer 代理审查指定路径下的技能,并把 [SKILL_PATH] 替换为技能目录的绝对路径。

完成标准:仅当 skill-reviewer 报告通过或无问题,或关键与主要问题已修复并验证,或只剩已评估为误报/不值得修的次要问题时,才输出完成标记 <skill-improvement-complete>,该标记是终止循环的唯一方式,自然语言无法结束循环。

限制:仅在任务符合上述范围时使用;输出不能替代针对具体环境的验证、测试或专家审查;若缺少必要输入、权限、安全边界或成功标准,应停下并请求澄清。