SuperAPI AI 工具集

skill-check

智能体与模型

查看项目

更新于 10-16 05:58

技能介绍

用途

Skill Check 用于审计智能体技能(agent skills),检查其是否符合 agentskills.io 规范、是否遵循最佳实践,以及整体质量水平。当用户需要“审计技能”“校验技能”时可以使用该工具。

主要能力

  • 结构校验:通过 scripts/validate-structure.sh path/to/target-skill 快速校验技能结构。
  • 规范核对:读取 references/spec-requirements.md,逐条对照规范规则检查 frontmatter。
  • 最佳实践评估:读取 references/best-practices.md,逐条评估正文内容是否符合最佳实践指南。
  • 评估门禁检查:检查 <skill-path>/evals/evals.json 是否存在,记录 YES/NO。
  • 结构对比:运行 scripts/compare-structure.sh <skill-path>,输出与 skills-ref 模式的结构差异。
  • 报告生成:读取 assets/skill-check-report-template.html,填充模板变量生成 HTML 审计报告,并写入 <skill-path>/<skill-name>-skill-check-report.html。

使用方式

工作流程如下:

  1. 读取目标 SKILL.md,提取 frontmatter YAML 和正文内容。
  2. 运行 scripts/validate-structure.sh <skill-path>,捕获通过/失败输出。
  3. 读取 references/spec-requirements.md,对照每条规范规则检查 frontmatter。
  4. 读取 references/best-practices.md,对照每条最佳实践指南评估正文。
  5. 检查评估门禁:<skill-path>/evals/evals.json 是否存在,记录 YES/NO。
  6. 运行 scripts/compare-structure.sh <skill-path>,输出与 skills-ref 模式的结构差异。
  7. 读取 assets/skill-check-report-template.html,用审计数据填充模板变量,包括技能名称、目标路径、审计日期、各项得分与百分比、分类、副标题、表格行、警告与修复项、等级、结论文本,以及 JSON 摘要。
  8. 将填充后的报告写入 <skill-path>/<skill-name>-skill-check-report.html。

JSON 摘要为紧凑 JSON 对象,包含所有得分、每项检查的通过/失败状态以及机器可解析结构,嵌入报告顶部的 <pre> 块中,便于下游技能仅读取前约 30 行即可获取机器数据。其 schema 包含:skill、target_path、audit_date、grade、spec(score、total、checks 数组)、best_practices(score、total、warnings 数组)、has_evals、structure(score、found、warnings)、fixes(priority、description)。

参考文件

  • spec-requirements.md:所有规范条款。
  • best-practices.md:质量指南。
  • skills-ref-patterns.md:结构模式。
  • skill-check-report-template.html:模板化 HTML 报告(用于第 7 步)。

适用场景

适用于需要对智能体技能进行规范合规性审计、最佳实践遵循度评估和质量检查的场景,尤其适合在技能开发、发布前校验或持续质量保障流程中使用。

限制

资料中未提供关于收费、价格、平台支持范围、具体效果指标或额外使用步骤的说明,这些信息暂未提供。