agent-skills-tools

🔒 Agent Skills 生态安全审计卫士

专为 Agent Skills 设计的安全扫描工具,通过静态分析检测凭据泄露与危险操作,帮助开发者在安装前识别恶意技能,保障 AI Agent 运行安全。

收藏
5k
安装
1.1k
版本
v0.1.0
CLS 安全性认证2026-07-01
点击查看完整报告 >

使用说明

该 Skill 是一套专为 Agent Skills 生态系统设计的安全审计与验证工具集,旨在解决 AI Agent 环境中因"帮助性"设计导致的潜在恶意技能威胁。核心功能通过 skill-security-audit.sh 脚本实现,能够对技能包进行全面的静态安全扫描,包括检测硬编码 API 密钥、密码、令牌的凭据泄露风险,识别对 ~/.ssh、~/.aws 等敏感目录的危险文件访问行为,审查外部网络请求以及 Git 历史中的秘密残留。

工具采用纯 Bash 脚本实现,仅依赖系统标准工具(grep、find、git 等),无需额外安装 npm、pip 等包管理依赖,这种设计显著降低了供应链攻击面。执行过程完全只读,仅通过正则匹配和文件遍历进行安全检测,不会对目标文件系统产生任何修改操作,确保审计过程本身不会引入新的安全风险。同时,工具内置完善的安全使用指南和最佳实践文档,帮助开发者理解如何正确管理凭据、配置环境变量以及处理敏感文件。

显著优点包括零外部依赖带来的高可移植性、针对 Agent Skills 场景的专项检测规则(如 credentials.json 权限检查)、以及清晰的中文/英文输出报告。局限性在于作为静态扫描工具,无法检测运行时动态加载的恶意代码或混淆后的攻击载荷;对于大规模代码仓库的扫描性能受限于 grep 工具效率;且当前仅支持基于正则的粗粒度匹配,可能存在误报或漏报。

该工具最适合 Agent Skills 开发者进行发布前自检、平台运营方进行第三方技能准入审查,以及 DevSecOps 团队在 CI/CD 流程中集成自动化安全门禁。尽管作者为个人开发者(T3 来源),但代码完全开源可审计,且通过 BSS A 级安全认证,适合在隔离环境中作为第一道安全防线使用。

潜在使用风险主要包括:扫描超大仓库时可能产生性能瓶颈;依赖系统工具版本差异可能导致检测结果不一致;无法替代专业的商业安全扫描工具,建议作为补充手段而非唯一安全依赖。

安全解读

核心用法

agent-skills-tools 是一套面向 Agent Skills 生态的安全审计与验证工具集,核心功能由 skill-security-audit.sh 脚本驱动。用户只需指定技能包路径即可启动全自动扫描:

./skill-security-audit.sh path/to/skill

脚本执行六类安全检查:凭据硬编码检测(API key、password、secret、token 等关键词)、危险文件路径访问(~/.ssh、~/.aws、~/.config)、外部网络请求识别、环境变量使用规范、敏感文件权限审查,以及 Git 历史中的泄露秘密扫描。

显著优点

1. 零依赖纯净架构:仅 4 个文件、263 行代码,无第三方依赖,从根本上消除供应链攻击面。
2. 实战驱动设计:源于真实安全事件(eudaemon_0 发现 286 个技能中存在 1 个凭据窃取器),针对性解决"Agent 过度信任"的系统性风险。

3. 合规开箱即用:原生支持 GDPR/CCPA 隐私合规,不采集用户敏感数据,输出格式简洁适合 CI/CD 集成。

4. 顶级安全认证:CLS-Certify v2.1.0 六维扫描(静态分析、动态分析、依赖审计、网络分析、隐私合规、威胁情报)全部满分,获 S 级评级与 100 分安全评分。

潜在局限

  • 功能边界明确:专注安全审计而非功能测试,无法检测逻辑漏洞或性能问题。
  • 误报可能性:基于关键词的模式匹配可能将正常注释误判为敏感信息,需人工复核。
  • Shell 脚本限制:依赖本地 Unix 环境,Windows 用户需 WSL 或 Cygwin 支持。
  • 扩展性待验证:当前版本无输入参数过滤,未来功能扩展时需加强边界校验。

适合人群

  • 技能开发者:在发布前自检技能包安全性
  • 平台运营方:批量审计第三方技能,建立准入门槛
  • 安全运维团队:集成至 CI/CD 流水线实现自动化门禁
  • Agent 使用者:安装未知来源技能前的最后一道防线

常规风险

1. 审计盲区:仅能检测已知模式,新型混淆手段(如 base64 编码后拼接、动态代码生成)可能绕过检查。
2. 运行时逃逸:静态分析无法捕获运行期恶意行为(如首次执行后下载第二阶段载荷),建议结合沙箱动态分析。

3. 社会工程攻击:工具本身无法防御诱骗用户主动提供凭据的钓鱼场景。

4. 过度信任报告:认证结果非绝对安全保证,实际部署前仍需结合业务场景人工审查。

agent-skills-tools 内容

手动下载zip · 3.6 kB
README.mdtext/markdown
请选择文件