SuperAPI AI 工具集

skill-tester

编程与开发

查看项目

更新于 10-15 17:28

技能介绍

用途:Skill Tester 用于验证 Claude Code 技能包的结构合规性、测试其中的 Python 脚本,并对质量进行评分,适合在创建新技能后发布前校验、审计已有技能,或作为 CI/CD 质量门禁。

主要能力:结构验证检查必需文件、目录布局、YAML frontmatter 和 SKILL.md 必需章节是否符合档位阈值;脚本测试执行 AST 语法检查、仅标准库导入分析、argparse 与 main 守卫检测,以及运行时 --help 和样例数据执行;质量评分按文档、代码质量、完整性、可用性四个等权维度给出总分、字母等级(A+ 至 F)和优先级改进路线图;档位分类定义 BASIC/STANDARD/POWERFUL 对 SKILL.md 深度、脚本数量与行数、argparse、输出格式和错误处理的要求;支持人类可读报告与 --json 双输出,便于 CI/CD 门禁和退出码判断。

使用方式:先确认目标技能路径、目标档位(--tier)和通过标准(--minimum-score 及退出码)。常用命令:python skill_validator.py engineering/my-skill --tier POWERFUL --json;python script_tester.py engineering/my-skill --timeout 30;python quality_scorer.py engineering/my-skill --detailed --minimum-score 75。详细参数、输出格式和退出码见 references/tool-reference.md,工作流与 CI/CD 集成见 references/workflows-and-cicd.md。

适用场景:新技能发布前校验、已有技能审计、CI/CD 质量门禁、质量分数趋势跟踪。

限制:不验证脚本逻辑或算法正确性,不做性能基准或内存分析,不做安全漏洞扫描,也不做跨技能依赖解析或集成测试;技能为孤立验证。