SuperAPI AI 工具集

skill-review

编程与开发

查看项目

更新于 10-15 14:36

技能介绍

Skill Review 是一个面向 claude-skills 的审查技能,用于系统化地审计技能质量。其核心流程为 9 阶段审查,可通过 /review-skill <skill-name> 命令调用,也可在检测到过时模式时使用。

用途 该技能用于对 claude-skills 进行系统性审查,覆盖标准合规性、官方文档验证、代码准确性、跨文件一致性和版本漂移等方面,帮助发现并修复技能中的问题。

主要能力 9 阶段审查流程包括:预审查(安装技能、检查版本/日期、测试发现)、标准检查(验证 YAML、关键词、第三人称风格、目录结构)、官方文档验证(通过 WebFetch/Context7 验证 API 模式、GitHub 更新、npm 版本、生产仓库)、代码示例验证(检查导入是否存在、API 签名是否匹配、模式一致性、模板是否可用)、跨文件一致性(比较 SKILL.md 与 README.md、捆绑资源与文件是否匹配)、依赖检查(运行 ./scripts/check-versions.sh、检查破坏性变更、验证“Last Verified”)、分类(按严重程度分级并附证据)、修复(自动修复明确问题,架构性问题询问用户,更新所有文件并提升版本)、验证(测试发现、模板可用、无矛盾、提交并附变更日志)。

严重程度分类 🔴 关键:不存在的 API/导入、无效配置、缺失依赖;🟡 高:矛盾的示例、不一致的模式、过时的主要版本;🟠 中:过时的次要版本(超过 90 天)、缺失文档章节、不完整的错误;🟢 低:拼写错误、格式问题、缺失可选元数据。

修复决策 自动修复适用于无歧义(根据文档修正导入)、有明确证据、无架构影响的情况;询问用户适用于存在多种有效方法、破坏性变更、架构选择的情况。

版本提升规则 主要版本(v1→v2):API 模式变更;次要版本(v1.0→v1.1):新功能且向后兼容;补丁版本(v1.0.0→v1.0.1):仅错误修复。

使用方式 通过 /review-skill <skill-name> 命令调用,或使用该技能检测过时模式。自动化部分通过 ./scripts/review-skill.sh 执行,包括 YAML 语法、包版本、断链、TODO、文件组织、过时检查;手动部分由 AI 执行,包括 API 方法与文档对比、GitHub 问题、生产环境比较、代码正确性、模式一致性。

适用场景 适用于审计 claude-skills 的质量,发现并修复过时模式、不存在的 API、不一致的示例等问题。

限制 资料中未提供关于收费、价格、平台限制等具体信息。

捆绑资源 规划文档:~/.claude/skills/../planning/SKILL_REVIEW_PROCESS.md 或仓库 planning/SKILL_REVIEW_PROCESS.md(完整的 9 阶段指南);脚本:仓库根目录 scripts/review-skill.sh(自动化验证);命令:仓库根目录 commands/review-skill.md(斜杠命令,符号链接到 ~/.claude/commands/);参考:references/audit-report-template.md(输出模板)。

最后验证:2026-01-09 | 版本:1.0.1