核心用法
agentsec 是一款专用于 AI Agent 技能的安全审计 CLI 工具，基于 OWASP Agentic Skills Top 10（OWASP AST10）标准执行漏洞扫描与合规评估。
主要功能场景：
- 自动发现扫描：无需配置路径，自动识别 Claude Code、OpenClaw/ClawHub、Codex 等主流平台的技能目录，同时扫描项目内
./skills文件夹 - 安全审计：检查恶意技能、供应链投毒、过度授权、不安全元数据、反序列化风险、隔离薄弱、更新漂移等 10 类风险
- 策略执行：内置
default/strict/permissive/owasp-agent-top-10四级策略预设，支持自定义策略文件 - 报告输出：支持 text/JSON/SARIF/HTML 四种格式，可直接集成 CI/CD 门禁（exit code 0/1 判定）
典型工作流：
# 零安装快速扫描 npx agentsec # 严格策略审计并输出 JSON npx agentsec --policy strict --format json --output audit.json # CI/CD 门禁集成 npx agentsec --policy strict || exit 1
显著优点
1. 零配置开箱即用：自动检测多平台技能路径，无需手动指定扫描范围
2. 标准化合规：直接对接 OWASP Agentic Skills Top 10 权威标准，审计结果具备行业认可度
3. 多格式报告生态：SARIF 格式可对接 GitHub Advanced Security 等代码扫描平台，HTML 适合向非技术 stakeholders 汇报
4. 灵活策略体系：从开发调试（permissive）到企业级生产（strict）覆盖全生命周期
5. CI/CD 原生集成：通过 exit code 和多种机器可读格式无缝嵌入 DevSecOps 流水线
潜在局限与风险
| 局限/风险 | 说明 |
|-----------|------|
| **静态分析边界** | 仅基于技能元数据和代码模式进行静态扫描，无法检测运行时动态行为（如 LLM 提示注入的实际执行效果） |
| **依赖外部标准** | OWASP AST10 为标准草案演进中，规则集可能随版本更新产生 Breaking Changes |
| **Node 生态依赖** | 需 Node.js 环境运行，对纯 Python/Go 技术栈团队存在额外依赖成本 |
| **误报可能** | `strict` 策略下可能产生较多需要人工复核的中低风险告警 |
| **供应链本身** | `agentsec` 作为 npm 包存在被投毒风险，建议锁定版本并使用私有 registry |
适合人群
- AI Agent 开发者：在技能发布前执行安全自检
- DevSecOps 工程师：为 Agent 平台构建 CI/CD 安全门禁
- 企业安全团队：对第三方技能进行准入审核与持续监控
- 平台运营方：Claude Code、OpenClaw 等生态的技能市场安全治理
常规风险提醒
- 扫描结果仅为静态分析快照，不能替代运行时安全测试与红队评估
- 敏感项目建议离线执行或审计
--output报告文件的访问权限 - 策略文件（
.agentsecrc）中的配置若包含凭据或内部规则，需纳入版本控制保密管理