SuperAPI AI 工具集

skill-review

设计与创作

查看项目

更新于 10-16 09:56

技能介绍

Skill Review 是面向 Claude Code 技能的质量审查与审计工具,核心原则是具体且可执行:不允许只说“可以改进”,必须说明改什么、为什么影响模型输出质量。

用途:审查一个技能目录,评估其结构合规性、描述质量、工作流设计、token 效率与反模式,并给出可落地的改进建议。

主要能力:按五维度分析。结构合规检查目录布局(SKILL.md、scripts/、references/、assets/)、SKILL.md 是否少于 500 行、frontmatter 是否只含 name 与 description(可选 allowed-tools、license、metadata)、是否存在多余文件、引用是否按领域组织。描述质量检查是否含具体触发关键词、是否关键词堆砌、是否自包含、是否把“何时使用”错放正文、自然语言查询能否匹配。工作流设计检查是否有可跟踪清单、关键步骤是否标记 ⚠️ REQUIRED 或 ⛔ BLOCKING、破坏性操作前是否有确认门、流程是否线性递进。token 效率检查顶部是否有 Iron Law、是否只写 Claude 不知道的内容、引用是否按需加载、指令是否用祈使句、脚本是否执行而非载入上下文、是否存在冗余。反模式检测覆盖模糊指令、占位符残留(TODO、FIXME、xxx、TBD)、过度规定已知内容、缺少反模式章节、缺少交付前检查清单、巨型单体 SKILL.md、只描述 WHAT 而不约束 HOW。

使用方式:接受显式路径(如 /skill-review path/to/skill)、当前目录上下文或技能名称(在工作区内搜索匹配目录)。随后读取完整 SKILL.md、列出目录全部文件并统计行数,加载 references/review-criteria.md 作为详细标准,最后按“优点”与“建议”输出报告;建议按影响从高到低排序,每条包含 What、Where、Fix。

适用场景:技能作者自查、团队评审、发布前质量把关。

限制:资料未提供安装方式、收费、平台支持与效果数据;审查依赖 references/review-criteria.md 的详细标准,该文件内容未在资料中给出。