用途:在发布或合并前,系统审查 Claude Code 技能是否符合官方最佳实践,关注质量、可发现性与可维护性。
主要能力与审查流程:
- 结构校验:检查目录名是否与技能名一致、是否使用动名词形式与连字符小写、Skill.md 是否存在(大写 S)、REFERENCE.md 等辅助文件是否全大写、是否避免深层嵌套与错误命名。
- frontmatter 审查:用 head -n 10 Skill.md 查看 YAML,检查 name、description、version 等字段;description 需第三人称、含具体能力与使用触发条件,避免含糊表达。
- 内容质量:主文件建议 500 行以内,含 Purpose、When to Use、工作流或快速开始、至少 2-3 个示例、验证步骤与故障排查;使用渐进式披露,把细节放进 references/ 且只嵌套一层。
- 指令清晰度:步骤编号明确、代码块给出确切命令与预期输出、术语前后一致。
- 测试验证:检查是否有评测或测试用例、覆盖常见与边界场景、是否用全新 Claude 实例及多模型测试。
输出与用法:审查后生成报告模板,按 BLOCKER、CRITICAL、MAJOR、MINOR 分级列出问题、亮点、建议与后续步骤,并给出 PASS、NEEDS WORK 或 FAIL 结论。也可识别选项过多、包含通用知识、指令含糊、嵌套引用、主文件臃肿等反模式。
限制:资料未提供安装命令、收费信息或具体平台支持范围,暂未提供。