SuperAPI AI 工具集

skills-audit

安全与审计

查看项目

更新于 10-16 06:40

技能介绍

Skills Audit 是一个基于 SkillLens CLI 的本地 Agent 技能安全审计工具,主要用于扫描本地已安装的 Agent 技能(Agent Skills),检查其中是否存在安全或策略层面的问题。

用途

Skills Audit 用于对本地安装的 Agent 技能进行安全与策略审计。当需要扫描某个技能目录、检查技能是否存在不安全或可疑行为时,可以使用该工具。

主要能力

SkillLens CLI 提供以下命令:

  • skilllens config:查看已配置的扫描根目录(scan roots)以及审计器 CLI(auditor CLI)是否可用。
  • skilllens scan:扫描已配置的根目录;也可以使用 skilllens scan <path> 扫描指定目录。
  • 支持 --verbose 参数查看审计器的原始输出。
  • 支持 --force 参数忽略缓存结果,强制重新审计。
  • 支持 --auditor claude|codex 指定审计器。

审计工作流包括以下环节:

  1. 定义范围:优先使用具体的目标路径(例如 ~/.codex/skills),除非用户明确要求扫描所有已配置根目录。如果要审计包含技能的仓库检出(repo checkout),应扫描包含技能目录的父文件夹(例如 skilllens scan ./skills)。
  2. 盘点技能:使用 SkillLens 运行 skilllens scan [path] [--auditor claude|codex]。对于缺少审计器 CLI 或状态为跳过的技能,应视为“需要人工审查”,而不是“安全”。
  3. 确定审查优先级:先审查任何判定为不安全(unsafe)或可疑(suspicious)的技能;其次审查请求广泛权限(文件系统/网络)、运行 Shell 命令或引用外部下载的技能。
  4. 人工审查技能内容:阅读技能的 SKILL.md 以及引用的 scripts/、references/ 和 assets/。默认不要执行随附脚本,应先检查。
  5. 评估风险(关注现实中的滥用可能):
    • 数据外泄:将文件内容、环境变量、令牌、SSH 密钥、浏览器数据或配置发送到远程端点。
    • 执行:指示运行任意 Shell 命令、curl | bash、eval,或获取并执行代码。
    • 持久化:修改 Shell 配置文件、启动代理、cron、编辑器配置或技能安装位置。
    • 权限/审批绕过:指示忽略系统策略、禁用安全检查,或不必要地请求提权。
    • 提示注入:尝试覆盖更高优先级的指令(“ignore previous”、“always comply”、“never mention…”)。
    • 触发器过宽:描述模糊,导致技能在无关任务上被触发。
  6. 生成报告:对每个技能,包含名称、路径、判定结果(safe/suspicious/unsafe)、风险评分(0–100),以及带有具体证据(引用或文件名)的问题列表。建议修复措施以缩小影响范围:缩小作用域、移除危险默认值、增加明确的确认门控、记录所需权限。

使用方式

安装 SkillLens:

  • 一次性运行:npx skilllens scan(或 pnpm dlx skilllens scan)
  • 全局安装:pnpm add -g skilllens

快速开始:

  • 运行 skilllens config 查看已配置的扫描根目录和审计器 CLI 可用性。
  • 运行 skilllens scan 扫描已配置根目录,或 skilllens scan <path> 扫描特定目录。
  • 使用 --verbose 查看原始审计器输出,使用 --force 忽略缓存结果。

命令片段:

  • 扫描已配置根目录:skilllens scan
  • 扫描特定文件夹:skilllens scan ~/.codex/skills
  • 强制重新审计并显示原始输出:skilllens scan ~/.codex/skills --force --verbose

适用场景

  • 审计本地已安装的 Agent 技能,检查是否存在安全或策略问题。
  • 审查请求广泛权限、运行 Shell 命令或引用外部下载的技能。
  • 对仓库检出中的技能目录进行安全检查。

限制

  • 缺少审计器 CLI 或状态为跳过的技能,不能判定为安全,只能标记为需要人工审查。
  • 默认不应执行随附脚本,需要先进行检查。
  • 关于收费、价格、支持平台、具体效果等信息,资料中暂未提供。