SuperAPI AI 工具集

skill-review

智能体与模型

查看项目

更新于 10-16 00:29

技能介绍

用途:在发布或合并前,系统审查 Claude Code 技能是否符合官方最佳实践,关注质量、可发现性与可维护性。

主要能力与审查流程:

  1. 结构校验:检查目录名是否与技能名一致、是否使用动名词形式与连字符小写、Skill.md 是否存在(大写 S)、REFERENCE.md 等辅助文件是否全大写、是否避免深层嵌套与错误命名。
  2. frontmatter 审查:用 head -n 10 Skill.md 查看 YAML,检查 name、description、version 等字段;description 需第三人称、含具体能力与使用触发条件,避免含糊表达。
  3. 内容质量:主文件建议 500 行以内,含 Purpose、When to Use、工作流或快速开始、至少 2-3 个示例、验证步骤与故障排查;使用渐进式披露,把细节放进 references/ 且只嵌套一层。
  4. 指令清晰度:步骤编号明确、代码块给出确切命令与预期输出、术语前后一致。
  5. 测试验证:检查是否有评测或测试用例、覆盖常见与边界场景、是否用全新 Claude 实例及多模型测试。

输出与用法:审查后生成报告模板,按 BLOCKER、CRITICAL、MAJOR、MINOR 分级列出问题、亮点、建议与后续步骤,并给出 PASS、NEEDS WORK 或 FAIL 结论。也可识别选项过多、包含通用知识、指令含糊、嵌套引用、主文件臃肿等反模式。

限制:资料未提供安装命令、收费信息或具体平台支持范围,暂未提供。