SuperAPI AI 工具集

skill-audit

编程与开发

查看项目

更新于 10-15 20:05

技能介绍

用途:审计指定路径下的 Claude Code 技能,评估其是否符合规范、token 使用是否高效、是否存在反模式,以及与其他技能是否存在范围重叠。

主要能力:静态分析技能目录;对照检查清单与模式参考交叉核对分析结果;检测同级技能之间的重叠;可选进行动态评估,生成评测集并迭代运行;按严重程度(Critical、Recommended、Optional)列出问题,并给出修复前后对比;输出优化后的 SKILL.md。

使用方式:调用时传入技能路径作为 $ARGUMENTS。若参数为空或未找到 SKILL.md,则报错。随后运行静态分析:python "$SKILL_DIR/scripts/analyze_skill.py" "$ARGUMENTS",并阅读 $SKILL_DIR/references/CHECKLIST.md 与 $SKILL_DIR/references/PATTERNS.md。若存在同级技能,运行:python "$SKILL_DIR/scripts/detect_overlap.py" "<parent>" --target "<name>"。动态评估为可选,需用户同意后生成 evals.json(schema 见 $SKILL_DIR/assets/schemas.md)并运行:python "$SKILL_DIR/scripts/run_loop.py" --eval-set <path> --skill-path "$ARGUMENTS" --model <current_model> --max-iterations 3 --report auto。

输出内容:按严重程度分类的问题、质量评分(格式/完整性/写作,满分 24)、token 预算表(Before/After/Δ)、重叠报告(如有)以及优化后的 SKILL.md。

限制与规则:仅使用官方 frontmatter 字段;正文需少于 300 token,使用祈使语气,不包含教学性内容;保留原意图,将参考内容移至 references/ 目录。