技能安全审计器

要解决什么问题

在把 Agent 技能发布到生产或引入第三方技能之前，你往往只能人工翻 SKILL.md 和脚本目录，很难系统性地排查硬编码密钥、命令注入、不安全文件权限或已知 CVE 依赖。漏掉一项就可能把 token 或执行面暴露给运行环境。

skill-safety-auditor 针对「技能目录」做静态安全审计，在开发期、发版审批或定期复查时，用统一规则把发现项按严重级别列出来，并支持生成可归档的 JSON 报告。

如何工作

审计粒度分三档，可按耗时与深度选择：

| 类型 | 说明 | 大致耗时 |
|------|------|----------|
| quick-scan | 表层快速检查 | ~1s |
| audit | 全面分析 | ~5–10s |
| report | 完整审计并输出 JSON | ~10s |

检查维度与典型严重级别包括：

• secrets（Critical）：API key、密码、token、私钥、环境变量模式
• injection（High）：命令注入、路径遍历
• permissions（Medium）：全局可写、数据文件可执行等
• dependencies（High）：已知漏洞依赖、过时或高风险包
• network（Low）：明文 HTTP、不安全端点等

严重级别从 Critical（必须修复）到 Info（可选处理）。输入一般为技能目录路径、审计类型、输出格式及漏洞类型过滤；输出包含控制台发现列表、汇总统计与 pass/fail 状态。

推荐流程：发版前跑全量检查 → 生成正式报告 → 优先处理 Critical/High → 对接受的低风险项留档 → 修复后重新审计验证。也可对第三方技能做引入前审查。

适用边界

• 仅静态分析，无法发现运行时行为或外部服务真实安全配置问题。
• 可能对合法模式产生误报，需结合业务判断。
• 检查范围限于文档中列出的已知漏洞模式，不替代渗透测试或运行时沙箱验证。