用途
skill-audit 用于对技能生态做一次广覆盖的批量扫描,以发现单个技能评审容易遗漏的生态系统级问题,包括一致性、质量缺口、归属冲突以及覆盖缺口。它面向“整体健康度”而非单技能深挖。
主要能力
- 技能发现与清单:递归查找
skills/**/SKILL.md,解析各文件 frontmatter,生成包含技能名、分类、版本、描述长度、正文行数、引用数量的清单表。 - 前置元数据一致性检查:检查必填字段(name、version、description)是否存在、版本是否为合法 semver、名称是否与目录名一致、描述是否以动作动词开头、描述长度是否接近 200 字符目标,并输出违规表。
- 归属冲突检测:针对 agent 角色技能,收集
owns.directories与owns.patterns声明,检查两个 agent 是否声明同目录等重叠情况,并对照frontmatter-spec.md中的 v1.1 已解决冲突表标记新冲突,输出冲突地图。 - 描述质量评分:检查是否有动作动词、是否含 ≥3 个触发场景、是否有关键词变体、歧义时是否说明排除项,并估计“推送力”(低/中/高),按从弱到强排序。
- 渐进式披露检查:统计 SKILL.md 正文行数与参考文件数量、引用是否从正文链接、正文是否超过 500 行、参考文件超过 300 行是否缺目录,并标记问题。
- 跨技能一致性检查:发现
composes_with或spawned_by指向不存在技能、循环组合链(A→B→A)、声明requires_agent_teams: true但不能优雅降级的技能,以及未被任何 SKILL.md 链接的孤儿参考文件。 - 覆盖缺口分析:将技能清单与项目权威文档(
docs/architecture.md、CLAUDE.md及编排器的 File Ownership Map)对照,检查架构文档中的角色是否都有对应技能、项目依赖的工作流是否被覆盖、编排器 playbook 引用但无技能存在的能力。 - 审计报告生成:产出结构化 Markdown 报告,含执行摘要(技能总数、通过数、问题数及分级、归属冲突数)、技能清单、归属地图与冲突、描述质量排名、各类批量问题、覆盖缺口、优先级建议以及每个技能的快速评分。
- 优先级梳理:报告生成后突出 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(所有批量检查的快速核对清单)。 - 关于收费、价格、平台支持等信息,资料中暂未提供。