security-scan

name	security-scan
description	使用 AgentShield 扫描 Claude Code 配置（.claude/ 目录）中的安全漏洞、配置错误和注入风险。检查 CLAUDE.md、settings.json、MCP 服务端、钩子（Hooks）和智能体（Agents）定义。

安全扫描技能 (Security Scan Skill)

使用 AgentShield 审计 Claude Code 配置的安全问题。

启动时机

• 设置新的 Claude Code 项目时
• 修改 .claude/settings.json、CLAUDE.md 或 MCP 配置后
• 提交配置变更前
• 接入具有现有 Claude Code 配置的新仓库时
• 定期进行安全健康检查

扫描对象

文件	检查内容
CLAUDE.md	硬编码的密钥（Secrets）、自动执行指令、提示词注入（Prompt Injection）模式
settings.json	过度宽松的允许列表（Allowlist）、缺失的拒绝列表（Denylist）、危险的绕过标志位
mcp.json	存在风险的 MCP 服务端、硬编码的环境密钥、npx 供应链风险
hooks/	由插值引起的命令注入、数据泄露、静默错误抑制
agents/*.md	无限制的工具访问、提示词注入攻击面、缺失的模型规范

前提条件

必须安装 AgentShield。请检查并根据需要进行安装：

# 确认是否已安装
npx ecc-agentshield --version

# 全局安装（推荐）
npm install -g ecc-agentshield

# 或通过 npx 直接运行（无需安装）
npx ecc-agentshield scan .

使用方法

基础扫描

针对当前项目的 .claude/ 目录运行：

# 扫描当前项目
npx ecc-agentshield scan

# 扫描特定路径
npx ecc-agentshield scan --path /path/to/.claude

# 按最小严重程度过滤扫描
npx ecc-agentshield scan --min-severity medium