SuperAPI AI 工具集

skill-audit

编程与开发

查看项目

更新于 11-05 18:17

技能介绍

用途

skill-audit 用于对技能生态做一次广覆盖的批量扫描,以发现单个技能评审容易遗漏的生态系统级问题,包括一致性、质量缺口、归属冲突以及覆盖缺口。它面向“整体健康度”而非单技能深挖。

主要能力

  1. 技能发现与清单:递归查找 skills/**/SKILL.md,解析各文件 frontmatter,生成包含技能名、分类、版本、描述长度、正文行数、引用数量的清单表。
  2. 前置元数据一致性检查:检查必填字段(name、version、description)是否存在、版本是否为合法 semver、名称是否与目录名一致、描述是否以动作动词开头、描述长度是否接近 200 字符目标,并输出违规表。
  3. 归属冲突检测:针对 agent 角色技能,收集 owns.directories 与 owns.patterns 声明,检查两个 agent 是否声明同目录等重叠情况,并对照 frontmatter-spec.md 中的 v1.1 已解决冲突表标记新冲突,输出冲突地图。
  4. 描述质量评分:检查是否有动作动词、是否含 ≥3 个触发场景、是否有关键词变体、歧义时是否说明排除项,并估计“推送力”(低/中/高),按从弱到强排序。
  5. 渐进式披露检查:统计 SKILL.md 正文行数与参考文件数量、引用是否从正文链接、正文是否超过 500 行、参考文件超过 300 行是否缺目录,并标记问题。
  6. 跨技能一致性检查:发现 composes_with 或 spawned_by 指向不存在技能、循环组合链(A→B→A)、声明 requires_agent_teams: true 但不能优雅降级的技能,以及未被任何 SKILL.md 链接的孤儿参考文件。
  7. 覆盖缺口分析:将技能清单与项目权威文档(docs/architecture.md、CLAUDE.md 及编排器的 File Ownership Map)对照,检查架构文档中的角色是否都有对应技能、项目依赖的工作流是否被覆盖、编排器 playbook 引用但无技能存在的能力。
  8. 审计报告生成:产出结构化 Markdown 报告,含执行摘要(技能总数、通过数、问题数及分级、归属冲突数)、技能清单、归属地图与冲突、描述质量排名、各类批量问题、覆盖缺口、优先级建议以及每个技能的快速评分。
  9. 优先级梳理:报告生成后突出 3–5 个影响最大的问题,建议哪些技能适合用 skill-deep-review 深入调查,哪些问题可由 skill-improvement-plan 直接处理。

使用方式

在技能生态需要批量审计时调用本技能,并提供:

  • 范围(Scope):默认为全部技能;也可按分类(roles、meta、contracts、workflows、orchestrator)筛选,或提供指定技能名列表。
  • 焦点(Focus,可选):将审计收窄到特定检查,例如“只看归属”“只看描述”。

流程分四个阶段:先发现并建立技能清单,再按类别并行执行批量检查(可用子代理并行),随后生成结构化审计报告,最后进行优先级梳理并向用户给出后续处理建议。审计完成后会提示可将报告交给 /skill-improvement-plan 生成修复计划,或对特定技能使用 /skill-deep-review 深入排查。

适用场景

  • 对技能生态做定期健康检查。
  • 批量编辑后或新增一批技能后进行验证。
  • 发布前校验生态完整性。
  • 排查系统性问题,例如“为什么我的技能都不触发”。

限制与说明

  • 该技能优化的是速度,属于广覆盖扫描而非深度分析;快速评分、标记问题、继续推进。
  • 除非检查孤儿文件或断链等特定问题,否则不读取参考文件内容;多数检查只需 frontmatter 与正文行数。
  • 若范围被筛选,跨技能引用仍会对照完整技能清单进行检查。
  • 参考资料:references/audit-checklist.md(所有批量检查的快速核对清单)。
  • 关于收费、价格、平台支持等信息,资料中暂未提供。