security-scan 技能用于使用 AgentShield 审计 Claude Code 配置安全问题。适用场景包括：新建 Claude Code 项目、修改 .claude/settings.json、CLAUDE.md 或 MCP 配置后、提交配置变更前、加入含现有配置的新仓库时，以及定期安全卫生检查。
扫描对象与检查项：CLAUDE.md 检查硬编码密钥、自动运行指令、提示词注入模式；settings.json 检查过度宽松的允许列表、缺失的拒绝列表、危险的绕过标志；mcp.json 检查风险 MCP 服务器、硬编码环境变量密钥、npx 供应链风险；hooks/ 检查插值命令注入、数据外泄、静默错误抑制；agents/*.md 检查未受限工具访问、提示词注入攻击面、缺失模型规范。
前置条件：需安装 AgentShield。检查：npx ecc-agentshield --version；全局安装：npm install -g ecc-agentshield；也可用 npx 直接运行：npx ecc-agentshield scan .
用法：npx ecc-agentshield scan 扫描当前项目；--path 指定路径；--min-severity medium 过滤严重程度。输出格式含终端、JSON、Markdown、HTML，例如 npx ecc-agentshield scan --format json。自动修复：npx ecc-agentshield scan --fix，仅处理可自动修复项，将硬编码密钥替换为环境变量引用、收紧通配符权限，不修改仅限手动建议项。深度分析：npx ecc-agentshield scan --opus --stream，需 ANTHROPIC_API_KEY，运行攻击者、防御者、审计员三智能体管道。初始化安全配置：npx ecc-agentshield init。
CI 集成可用 GitHub Action：affaan-m/agentshield@v1，参数 path、min-severity、fail-on-findings。评分 A 90-100 安全，B 75-89 次要问题，C 60-74 需注意，D 40-59 重大风险，F 0-39 关键漏洞。
限制：部分检查与深度分析依赖 AgentShield 安装与 API Key；使用前请核对版本与配置，暂未提供其他平台或价格信息。