SuperAPI AI 工具集

skill-check

测试与质量

查看项目

更新于 10-16 09:58

技能介绍

用途:skill-check 用于技能(Skill)部署前的质量校验,与 skill-creator 互补——skill-creator 负责流程(理解→规划→初始化→编辑→打包→迭代),本技能负责校验具体质量要求。核心原则是技能应教会 Claude“如何做”,而非只说明“做什么”。

适用时机:编写任何 SKILL.md 之前(强制门禁)、skill-creator 生成模板后、部署前评审技能、把重复工作流沉淀为技能时。不适用于一次性指令、Claude 已掌握的简单工具用法、不会跨会话重复的任务。

主要校验内容:命名要求小写字母、数字、连字符,最长 64 字符,必须与目录名完全一致,使用动名词或能力形式(如 systematic-debugging);描述需包含触发时机、触发词与方法预览,推荐 BEFORE/FIRST/MANDATORY 等门禁式措辞;另含结构、内容、工作流、可发现性四类质量清单,以及发现、结构、内容三类反模式与修复建议。

分享前扫描:若计划公开分享技能或仓库,可运行扫描脚本: ~/.claude/skills/skill-check/scripts/scan.py /path/to/skill ~/.claude/skills/skill-check/scripts/scan.py --risk high /path/to/skill ~/.claude/skills/skill-check/scripts/scan.py --format json /path/to/skill 流程为扫描、按风险等级分诊、修复或接受、复扫确认干净后分享。

限制:资料未提供收费、价格、平台支持范围及具体扫描规则细节,相关事实暂未提供;脚本具体行为与依赖未在资料中完整说明,使用前需自行确认。