SuperAPI AI 工具集

skill-reviewer

编程与开发

查看项目

更新于 10-16 05:05

技能介绍

用途:Skill Reviewer 用于审查技能(Skill)的质量,先确认技能声明的工作、领域方法与证据,再建议改动。它区分静态质量与实测任务收益,并强调审查本身不授权编辑、fork、发布或执行目标。

主要能力:提供单技能自动审查脚本 scripts/review_skill.py,以及面向集合或整体质量判断的 scripts/quality_review.py(流程为 inventory → prepare → 原生语义决策 → aggregate)。审查覆盖 frontmatter 元数据、目录结构、SKILL.md 大小、硬编码路径与疑似密钥、脚本卫生、subagent_type 有效性及指令风格启发式;这些启发式仅作审查线索,行数、代码存在与英文触发词不能确立语义质量。

使用方式:通过同套件 skill-creator 的锁定 uv 项目运行,例如 uv run --project <skill-creator-path> --frozen python <this-skill-path>/scripts/review_skill.py <target-skill-path>,加 --json 输出 JSON。退出码含义:0 干净,1 仅警告,2 审查错误,3 调用或运行时失败。显式交付审查需加 --delivery-contract <private-contract.json>,并检查 delivery_review.source_audit;无交付契约时报告 delivery 为 not_requested。

适用场景:发布前自审、外部技能仓库评估、经授权的自动 PR(仅做增量改进,不删除文件、不移除功能、不改主语言、不重命名组件)。

限制:该检查器面向 Claude Code,不应把其宿主 schema 套用到其他运行时;静态检查无法证明契约与原始请求一致,也无法确立当前宿主加载;未读证据或评估器故障不应记为低分;部分覆盖须如实报告为部分。批量评分前需阅读 references/quality_rubric.json,声称方法来源或任务收益时需阅读 references/quality_method_sources.md。