SuperAPI AI 工具集

audit-skills

部署与运维

查看项目

更新于 10-16 03:59

技能介绍

用途

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 状态能区分本次运行。

关于收费、价格、支持平台等具体信息,资料中暂未提供。