用途
audit-skills 用于审计已安装的技能(skills),关注四个方面:实际观测到的使用情况、仅显式调用(explicit-only)控制、重复发现(duplicate discovery),以及全局与项目作用域(global-versus-project scope)的划分。
该工具仅在用户显式执行 $audit-skills 时才会运行。默认行为是审计;修复(fix)模式仅在账本(ledger)存在之后,才应用高置信度的修正。
主要能力
- 从参数或当前仓库解析项目根目录(project-root)。
- 保留无关的未提交改动(dirty changes)。
- 报告每个已清点技能,附带扫描覆盖范围,并归入以下证据类别之一:
- OBSERVED_USER
- OBSERVED_MODEL
- UNOBSERVED
- EXPLICIT_ONLY
- INVOCATION_MISMATCH
- LOCALITY_CANDIDATE
- NAME_COLLISION
- 说明 Cursor ACP 存储是不透明的(opaque)。
- 在未指明扫描范围时,不将 UNOBSERVED 标记为“从未使用”。
使用方式
通过以下命令运行审计:
bun ~/.agents/skills/audit-skills/scripts/audit-skills.mjs --project "$PWD" --format markdown
安全自动修复
修复模式仅应用以下高置信度修正:
- 在 Claude/Codex 之间镜像已有的仅显式调用决定。
- 当技能文本已经要求直接调用时,补充缺失的仅显式调用控制。
- 修复过期的移动/重命名元数据。
跨作用域移动技能仅在以下情况下进行:用户明确指示,或存在项目特定的运行时依赖。移动流程为:复制完整目录、重写自身路径、验证、将源目录移入回收站,然后确认该名称只被发现一次。
适用场景与限制
- 对未观测到的技能只做建议,不做改动。
- 保护事件(incident)、安全(security)、恢复(recovery)和迁移(migration)类技能,避免仅基于使用情况进行裁剪。
- 完成标准:每个技能都有一行记录,每条建议都引用证据;在修复模式下,被触及的技能通过验证,且 Git 状态能区分本次运行。
关于收费、价格、支持平台等具体信息,资料中暂未提供。