SuperAPI AI 工具集

skill-reviewer

智能体与模型

查看项目

更新于 10-15 23:43

技能介绍

用途:对仓库内 SKILL.md 执行必填 frontmatter 硬性校验与最佳实践评审,用于创建或修改 skill 时获得一致的质量检查,提前发现命名、描述等问题。

主要能力:输出清单式报告,每项含 status(pass | can improve | fail)和 severity(high | medium | low);对 can improve 或 fail 给出简短可执行建议。硬性校验(高严重级)包括:frontmatter 存在且可解析为 YAML;含 name 与 description 字符串;name 与父目录名一致、在 **/SKILL.md 中唯一、长度≤64、匹配 ^[a-z0-9-]+$、不含 XML 标签与保留词(anthropic、claude);description 非空、长度≤1024、不含 XML 标签;引用的文件存在且位于仓库内(node_modules 除外)。最佳实践检查(中/低严重级,从不判 fail)涵盖描述是否说明用途与使用时机、是否具体含关键词、标题层级、渐进披露、脚本分离、验证步骤、术语一致性、路径风格、魔法常量等。评分规则:仅高严重级项可标 fail;任一高严重级 fail 则总体为 ❌ NEEDS_CHANGES,否则 ✅ PASS。报告仅列出非 pass 项并附证据,按 severity(high→medium→low)、再按类型(fail 先于 can improve)排序。

使用方式:让 agent 运行本 skill 并提供目标路径,例如“Use skill-reviewer to review skills/<skill-name>/SKILL.md.”或“Review skills/<skill-name>/SKILL.md and display the checklist report.”。输入为必填 targetSkillMdPath,即仓库相对路径。

限制:仅审查本仓库内的 SKILL.md;除非用户明确要求,不创建或修改文件;引用证据时应简短,避免大段摘录。其他如收费、价格、平台等暂无提供。