用途:审计该技能仓库中所有 SKILL.md,检查 frontmatter 正确性、结构完整性、API/版本漂移与跨文件引用完整性,输出优先级排序的 Markdown 报告。只读,不自动修复。
主要能力:共 11 项检查,按严重程度分级。Critical(C-01 缺少 frontmatter);High(H-01 缺少 allowed-tools、H-02 支撑文件引用失效、H-03 H1 标题与 name 不匹配);Medium(M-01 缺少激活条件章节、M-02 版本引用过时、M-03 未标注的旧 @Observable 写法、M-04 单文件超 400 行且无同级 .md);Low(L-01 无 ✅/❌ 示例、L-02 description 长度不在 20–300 字符、L-03 版本提及上下文不明)。报告按严重程度分组,含汇总计数与逐项修复建议。
使用方式:在对话中要求审计技能触发,可传参限定范围。无参数扫描全部 skills/**/SKILL.md;传分类路径(如 generators/)只扫该分类;传单文件路径只审一个文件。流程为枚举、解析 frontmatter 并缓存、并行批量 Grep 检查、区分 aggregator 与 leaf、排序输出。检查包含 M-02 的两阶段版本漂移判定,已知当前常量为 iOS 27、macOS 27、Swift 6.x(标注 2026-07-11)。
适用场景:整个技能仓库的一致性巡检、批量清理前的盘点、frontmatter 校验、发现失效引用。
限制:不自动修复,不发起网络请求,不验证 URL 可用性,不编译 Swift 代码,不做 WWDC 会话交叉引用。属只读,Bash 仅用于 wc、ls 等只读操作。版本常量与部分阈值需在 Apple 平台新版本发布后人工更新;预期计数为参考区间,实际以仓库状态为准。