Security Scan

affaan-m/ECC/docs/zh-CN/skills/security-scan

作者 affaan-mef648e01899ba3e8dc6371642deaaf64b4477775無授權條款275K 個星標收錄於 2026年10月9日更新於 2026年10月9日儲存庫4 天前更新

使用AgentShield扫描您的Claude代码配置（.claude/目录），以发现安全漏洞、配置错误和注入风险。检查CLAUDE.md、settings.json、MCP服务器、钩子和代理定义。

僅含說明Security
AI 產生的概覽

使用 AgentShield 掃描器稽核 Claude Code 設定檔的安全問題。

功能
此技能引導代理使用 AgentShield 工具稽核專案的 .claude/ 設定。它涵蓋掃描 CLAUDE.md、settings.json、mcp.json、鉤子與代理定義，以找出硬編碼金鑰、過於寬鬆的允許清單、提示詞注入模式與命令注入。它也說明輸出格式、自動修復、對抗式多代理深度分析模式，以及用於 CI 的 GitHub Action。
適用情境
適用於設定新的 Claude Code 專案、修改 settings.json、CLAUDE.md 或 MCP 設定之後、提交設定變更之前，或加入已有 Claude Code 設定的程式碼庫時。它也用于定期的安全衛生檢查。
執行需求
需要 AgentShield CLI，可透過 npm 全域安裝或使用 npx 執行，並需要 Node.js/npm。深度分析模式需要 ANTHROPIC_API_KEY。取得套件需要網路存取。此技能不含指令碼，僅為說明文件。

安全扫描技能

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

何时激活

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

扫描内容

文件检查项
CLAUDE.md硬编码的密钥、自动运行指令、提示词注入模式
settings.json过于宽松的允许列表、缺失的拒绝列表、危险的绕过标志
mcp.json有风险的 MCP 服务器、硬编码的环境变量密钥、npx 供应链风险
hooks/通过 ${file} 插值导致的命令注入、数据泄露、静默错误抑制
agents/*.md无限制的工具访问、提示词注入攻击面、缺失的模型规格

先决条件

必须安装 AgentShield。检查并在需要时安装：

bash
# Check if installednpx ecc-agentshield --version
# Install globally (recommended)npm install -g ecc-agentshield
# Or run directly via npx (no install needed)npx ecc-agentshield scan .

使用方法

基础扫描

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

bash
# Scan current projectnpx ecc-agentshield scan
# Scan a specific pathnpx ecc-agentshield scan --path /path/to/.claude
# Scan with minimum severity filternpx ecc-agentshield scan --min-severity medium

输出格式

bash
# Terminal output (default) — colored report with gradenpx ecc-agentshield scan
# JSON — for CI/CD integrationnpx ecc-agentshield scan --format json
# Markdown — for documentationnpx ecc-agentshield scan --format markdown
# HTML — self-contained dark-theme reportnpx ecc-agentshield scan --format html > security-report.html

自动修复

自动应用安全的修复（仅修复标记为可自动修复的问题）：

bash
npx ecc-agentshield scan --fix

这将：

  • 用环境变量引用替换硬编码的密钥
  • 将通配符权限收紧为作用域明确的替代方案
  • 绝不修改仅限手动修复的建议

Opus 4.6 深度分析

运行对抗性的三智能体流程以进行更深入的分析：

bash
# Requires ANTHROPIC_API_KEYexport ANTHROPIC_API_KEY=your-keynpx ecc-agentshield scan --opus --stream

这将运行：

  1. 攻击者（红队） — 寻找攻击向量
  2. 防御者（蓝队） — 建议加固措施
  3. 审计员（最终裁决） — 综合双方观点

初始化安全配置

从头开始搭建一个新的安全 .claude/ 配置：

bash
npx ecc-agentshield init

创建：

  • 具有作用域权限和拒绝列表的 settings.json
  • 遵循安全最佳实践的 CLAUDE.md
  • mcp.json 占位符

GitHub Action

添加到您的 CI 流水线中：

yaml
- uses: affaan-m/agentshield@v1  with:    path: '.'    min-severity: 'medium'    fail-on-findings: true

严重性等级

等级分数含义
A90-100安全配置
B75-89轻微问题
C60-74需要注意
D40-59显著风险
F0-39严重漏洞

结果解读

关键发现（立即修复）

  • 配置文件中硬编码的 API 密钥或令牌
  • 允许列表中存在 Bash(*)（无限制的 shell 访问）
  • 钩子中通过 ${file} 插值导致的命令注入
  • 运行 shell 的 MCP 服务器

高优先级发现（生产前修复）

  • CLAUDE.md 中的自动运行指令（提示词注入向量）
  • 权限配置中缺少拒绝列表
  • 具有不必要 Bash 访问权限的代理

中优先级发现（建议修复）

  • 钩子中的静默错误抑制（2>/dev/null、|| true）
  • 缺少 PreToolUse 安全钩子
  • MCP 服务器配置中的 npx -y 自动安装

信息性发现（了解情况）

  • MCP 服务器缺少描述信息
  • 正确标记为良好实践的限制性指令

链接

來源與署名

來源：affaan-m/ECC位於docs/zh-CN/skills/security-scan提交ef648e0

授權條款： 無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架

更多來自 affaan-m/ECC 的技能

Unified Notifications Ops

affaan-m

設計統一的通知策略，對來自 GitHub、Linear、鉤子與聊天工具的通知進行分類、路由、去重與升級。

Productivity & Workflow275K4 天前更新

Verification Loop

affaan-m

執行六階段程式碼驗證流程，並產出 PASS/FAIL 就緒報告。

Software Development275K4 天前更新

Ui To Vue

affaan-m

將批次 UI 設計截圖轉換為使用 Vant、Element Plus 或 Ant Design Vue 的 Vue 3 元件。

Software Development275K4 天前更新

Unified Memory

affaan-m

指導代理透過本機 ECC Memory Vault 在不同執行框架之間共享持久脈絡與交接資訊。

AI & Agents275K4 天前更新

Visa Doc Translate

affaan-m

透過 OCR 將簽證文件影像翻譯成英文，並產出原圖與譯文對照的雙語 PDF。

Documents & Office275K4 天前更新

Team Builder

affaan-m

互動式挑選器：探索可用的代理角色，讓使用者最多選五個，平行執行同一任務並彙整結果。

AI & Agents275K4 天前更新

更多Security技能

Kyc Rules

anthropics

精選

將公司的 KYC/AML 規則表套用於已解析的開戶紀錄，評定風險並給出處理路由。

Security39K2 週前更新

Kyc Rules

anthropics

精選

將公司的 KYC/AML 規則表套用於已解析的開戶紀錄，評定風險並給出處理路由。

Security39K2 週前更新

Compliance Tracking

anthropics

精選

追蹤合規要求、稽核準備情況，以及 SOC 2、ISO 27001、GDPR、HIPAA 和 PCI DSS 等框架的證據。

Security27K今天更新

Google Cloud Scc Remediation

google

精選

指導修復 Google Cloud Security Command Center 發現項目，提供需使用者核准的方案與參考手冊。

Security21K昨天更新

Google Cloud Recipe Auth

google

精選

指導使用者、服務帳戶與工作負載如何對 Google Cloud 服務與 API 進行驗證與授權。

Security21K昨天更新

Dpop Adoption

google

精選

指導為 Google OAuth 平台實作 OAuth 2.0 DPoP（RFC 9449）傳送方約束的更新權杖。

Security21K昨天更新