SuperAPI AI 工具集

skill-forge-review

智能体与模型

查看项目

更新于 10-15 16:43

技能介绍

用途:审计和验证已有 Claude Code 技能,评估质量、触发准确性、结构合规性与最佳实践,并生成 0-100 分的健康评分。

主要能力: 定位技能文件,支持技能目录路径、技能名称(在 ~/.claude/skills/ 中搜索)或 GitHub 仓库 URL 三种输入,读取其中的 .md 文件、脚本与资源文件。结构校验可运行 python scripts/validate_skill.py <path> 做程序化检查,并人工核对 SKILL.md 是否存在(大小写精确)、技能文件夹内是否无 README.md、文件夹名是否与 name 字段一致、命名是否为 1-64 字符的 kebab-case、名称中不含 claude 或 anthropic。前端元数据审计涵盖名称格式、描述非空且 1-1024 字符、描述含 WHAT 与 WHEN、含领域关键词、无 XML 标签、可选字段有效。触发分析评估描述激活质量,识别欠触发与过触发风险,并生成测试查询:5 条应触发、5 条不应触发、3 条边界查询。指令质量按具体性、完整性、错误处理、示例、渐进式披露、长度(500 行或 5000 token 以内)、交叉引用评分。多技能架构审查涵盖路由表、子技能职责、交叉引用有效性、命名约定、共享引用与代理角色。脚本质量检查文档字符串、CLI 接口、结构化输出、错误处理、硬编码路径或密钥、依赖。最终按前端元数据 25%、触发准确性 20%、指令质量 25%、结构合规 15%、脚本质量 10%、渐进式披露 5% 生成健康评分与报告。

使用方式:按步骤执行;可运行 python scripts/generate_eval_set.py <path> 自动生成起始评测集,保存到 evals/evals.json,再运行 python scripts/optimize_description.py <path> --eval-set evals/evals.json 评分并获取改进建议;也可运行 /skill-forge eval <path> 做完整功能评测。

输出报告含健康分、分项得分与问题、关键问题、高优先级问题、建议与建议测试查询。

限制:适用于 Claude Code 技能审查,具体平台兼容性、收费与价格信息暂未提供。