SuperAPI AI 工具集

skill-improver

智能体与模型

查看项目

更新于 10-15 21:08

技能介绍

用途:改进已有的 Claude Code 技能或 SKILL.md。目标是给出具体、按优先级排序、可直接应用的修改建议,而非打分。输入为技能目录(含 SKILL.md)或 SKILL.md 文件路径,可选提供技能预期用途,以判断名称与范围是否匹配。

主要能力:审阅五个维度。名称与范围应动词开头、主动、聚焦单一明确用途;描述要说明何时调用(触发条件/症状/情境),用第三人称并以“Use when”开头,而非仅说做什么;结构建议包含概述、输入、步骤、准则、输出格式;SKILL.md 应精简,正文放工作流与判断,重细节放入 references/;机械动作交给脚本,可复用上下文放入引用,模板放入 assets,并标记孤立文件与非确定性脚本。重点寻找两类机会:抽取(把内联内容移到 references/)与确定性(把易不一致的文字步骤写成脚本)。所有观察都附带具体修复建议。

使用方式:先运行机械检查脚本获取事实:bash "${CLAUDE_SKILL_DIR}/scripts/skill-lint.sh" <skill-dir-or-SKILL.md>,它会报告 frontmatter 有效性、名称格式、描述形态、SKILL.md 大小、推荐章节、被引用与孤立文件,其中 [FLAG] 仅作线索而非结论。随后自行阅读 SKILL.md 与附带文件,判断清晰度、范围与正确性;再按高到低影响排序输出报告,并主动提出可代为应用修改。若脚本无法运行,可用环境现有工具直接复现相同的普通 git/文本命令步骤。

输出格式:标题为“Skill review: <name>”,先写优点,再列按影响排序的改进建议(每条标注维度、观察与具体修复),接着是抽取与确定性机会,最后是一两句具体鼓励性的总结,无评分。

限制:不评分;每条意见必须可操作;不照搬 linter 结果;涉及抽取时必须指明目标文件及移入内容。其他细节暂未提供。