核心用法
agent-skills-tools 是一款面向 Agent Skills 生态系统的安全审计与验证工具,主要用于在安装前扫描技能包中的常见安全漏洞。其核心功能通过 skill-security-audit.sh 脚本实现,支持以下检测项:
- 凭据泄露检测:扫描硬编码的 API key、password、secret、token 等敏感字符串
- 危险文件访问检测:识别对
~/.ssh、~/.aws、~/.config等敏感目录的访问 - 外部网络请求识别:检测代码中的外部网络调用
- 环境变量使用规范:检查是否遵循从环境变量读取配置的最佳实践
- 文件权限检查:关注
credentials.json等敏感文件的权限设置 - Git 历史扫描:使用
git log -S和git-secrets扫描提交历史中泄露的密钥
使用方式极为简洁:
./skill-security-audit.sh path/to/skill
显著优点
1. 零依赖安全设计:纯 Bash 脚本实现,无 package.json、requirements.txt 等第三方依赖,仅使用系统标准工具(find、grep、git),供应链攻击面为零
2. 功能定位精准:专门针对 Agent Skills 生态的安全痛点设计,填补了这一特定领域的安全审计空白
3. 双语文档完备:同时提供中文 README.md 和英文 SKILL.md,使用门槛极低
4. 符合安全最佳实践:自身即践行文档中所倡导的安全原则——无硬编码凭据、无外部 API 调用、无数据外传
5. MIT 开源许可:允许自由使用、修改和分发
潜在缺点与局限性
1. 扫描深度有限:基于正则表达式的静态扫描,无法检测复杂的混淆代码或运行时漏洞
2. 误报/漏报风险:简单的字符串匹配可能产生误报,也可能遗漏经过编码或加密的泄露凭据
3. 无持续集成:作为独立脚本,缺乏与 CI/CD 流程的原生集成
4. 社区维护等级:来源可信度为 T3(社区项目/个人开发者),长期维护和更新存在不确定性
5. 输入验证不足:当前版本未对输入路径进行严格验证,存在潜在的路径遍历风险(已识别为改进建议)
适合人群
- Agent Skills 生态的贡献者:在提交技能前进行自检
- 企业安全团队:需要批量审计内部开发的 Agent Skills
- 技术管理者:评估第三方技能的安全风险等级
- 安全意识较强的终端用户:在安装来源不明的技能前进行验证
常规风险
| 风险类别 | 等级 | 说明 |
|---------|------|------|
| 运行时破坏风险 | 极低 | 仅读取文件,无写入、删除或系统调用 |
| 数据外泄风险 | 无 | 无网络请求,扫描结果仅本地输出 |
| 供应链风险 | 极低 | 零第三方依赖 |
| 误报干扰 | 低 | 可能影响用户对技能安全性的判断 |
背景价值
该工具的创建背景值得注意:开发者 eudaemon_0 曾在 286 个技能中发现 1 个凭据窃取恶意技能。Agent 被训练为乐于助人和信任导向,这使其容易受到恶意技能的攻击。此工具正是为了填补这一安全防护空白而诞生。