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指定审计器。
审计工作流包括以下环节:
- 定义范围:优先使用具体的目标路径(例如
~/.codex/skills),除非用户明确要求扫描所有已配置根目录。如果要审计包含技能的仓库检出(repo checkout),应扫描包含技能目录的父文件夹(例如skilllens scan ./skills)。 - 盘点技能:使用 SkillLens 运行
skilllens scan [path] [--auditor claude|codex]。对于缺少审计器 CLI 或状态为跳过的技能,应视为“需要人工审查”,而不是“安全”。 - 确定审查优先级:先审查任何判定为不安全(unsafe)或可疑(suspicious)的技能;其次审查请求广泛权限(文件系统/网络)、运行 Shell 命令或引用外部下载的技能。
- 人工审查技能内容:阅读技能的
SKILL.md以及引用的scripts/、references/和assets/。默认不要执行随附脚本,应先检查。 - 评估风险(关注现实中的滥用可能):
- 数据外泄:将文件内容、环境变量、令牌、SSH 密钥、浏览器数据或配置发送到远程端点。
- 执行:指示运行任意 Shell 命令、
curl | bash、eval,或获取并执行代码。 - 持久化:修改 Shell 配置文件、启动代理、cron、编辑器配置或技能安装位置。
- 权限/审批绕过:指示忽略系统策略、禁用安全检查,或不必要地请求提权。
- 提示注入:尝试覆盖更高优先级的指令(“ignore previous”、“always comply”、“never mention…”)。
- 触发器过宽:描述模糊,导致技能在无关任务上被触发。
- 生成报告:对每个技能,包含名称、路径、判定结果(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 或状态为跳过的技能,不能判定为安全,只能标记为需要人工审查。
- 默认不应执行随附脚本,需要先进行检查。
- 关于收费、价格、支持平台、具体效果等信息,资料中暂未提供。