mcpField
S
skill-security-audit

skill-security-audit

github.com/smartchainark安全10514 次安装37 周前更新
代码仓库

关于 skill-security-audit

用于检查已安装 Claude 和 OpenClaw 技能的安全审计技能,可扫描恶意代码模式并按严重程度整理发现,提供后续审查与处置指引。

主要功能

  1. 01自动发现并扫描技能目录
  2. 02检测 13 类风险模式
  3. 03按严重程度和置信度呈现结果
  4. 04支持指定目录扫描与 JSON 输出
  5. 05提供人工复核和事件处置步骤

适用场景

  1. 01检查已安装技能是否存在恶意模式
  2. 02针对单个技能目录进行安全审查
  3. 03以 JSON 格式处理扫描结果
  4. 04根据高危发现隔离技能并轮换凭据

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/smartchainark/skill-security-audit --skill skill-security-audit

安装后在 Claude Code 中输入/skill-security-audit确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

README.md
LICENSE
.gitignore
blog-post.md
references/
remediation-guide.md
ioc-database.md
threat-patterns.md
scripts/
ioc_database.json
skill_audit.py

详细介绍

技能安全审计

检测已安装的 Claude 和 OpenClaw 技能中的恶意模式。基于 SlowMist 对 ClawHub 平台上 472+ 个恶意技能的分析。

触发条件

当用户提到以下内容时使用此技能:安全审计、security audit、skill 检查、技能安全、scan skills、供应链安全、扫描技能、恶意检测、malicious skill、skill 安全扫描

快速审计工作流

当用户请求安全审计时,请遵循以下 5 个步骤:

步骤 1:运行扫描器
python3 ~/.claude/skills/skill-security-audit/scripts/skill_audit.py

此工具会自动发现并扫描以下位置的所有技能:

  • ~/.claude/skills/
  • ~/.openclaw/workspace/skills/
  • 来自 ~/.openclaw/openclaw.json → skills.load.extraDirs 的额外目录
步骤 2:分析结果

阅读扫描器输出。发现项按技能分组,并按严重程度排序:

严重程度含义所需操作
CRITICAL匹配已知恶意 IOC、凭据窃取或下载并执行立即移除并轮换凭据
HIGH混淆、持久化机制、权限提升需要人工审查,很可能是恶意行为
MEDIUM可疑模式(Base64、网络调用、高熵)审查上下文——可能是合法行为
LOW社会工程式命名、信息提示留意即可
步骤 3:向用户报告

按以下格式呈现发现项:

## Audit Summary
- Skills scanned: N
- Files scanned: N
- CRITICAL: N | HIGH: N | MEDIUM: N | LOW: N

## Critical/High Findings (if any)
For each finding:
- Skill name and file path
- What was detected and why it's dangerous
- Recommended action

## Medium/Low Findings (if any)
Brief summary, noting which are likely false positives
步骤 4:建议采取的操作

对于 CRITICAL 发现项:

  1. 阅读 references/remediation-guide.md,了解事件响应步骤
  2. 如果检测到凭据窃取,请指导用户轮换凭据
  3. 帮助隔离恶意技能

对于 HIGH 发现项:

  1. 帮助用户手动审查标记的代码
  2. 根据上下文判断该模式是合法行为还是恶意行为
步骤 5:后续跟进
  • 提议详细扫描特定技能:python3 skill_audit.py --path /path/to/skill
  • 提议使用 references/threat-patterns.md 深入解释任何发现项

扫描器命令参考

# Scan all discovered skills
python3 ~/.claude/skills/skill-security-audit/scripts/skill_audit.py

# Scan a single skill directory
python3 ~/.claude/skills/skill-security-audit/scripts/skill_audit.py --path /path/to/skill

# JSON output (for programmatic use)
python3 ~/.claude/skills/skill-security-audit/scripts/skill_audit.py --json

# Filter by minimum severity
python3 ~/.claude/skills/skill-security-audit/scripts/skill_audit.py --severity high

# Disable colored output
python3 ~/.claude/skills/skill-security-audit/scripts/skill_audit.py --no-color

# Use custom IOC database
python3 ~/.claude/skills/skill-security-audit/scripts/skill_audit.py --ioc-db /path/to/ioc.json

**退出代码:**0 = 无风险,1 = 低/中风险,2 = 高风险,3 = 严重风险,4 = 扫描器错误

13 类检测项

检测器检测内容严重程度
Base64Detector长度超过 50 个字符的编码字符串(不包括 data:image)MEDIUM→HIGH
DownloadExecDetectorcurl|bash、wget|sh、fetch+eval 模式CRITICAL
IOCMatchDetector已知恶意 IP、域名、URL、文件哈希CRITICAL
ObfuscationDetector使用非字面量参数的 eval/exec、十六进制编码、chr() 链HIGH
ExfiltrationDetectorZIP+上传组合、敏感目录枚举HIGH
CredentialTheftDetectorosascript 密码对话框、钥匙串访问、读取 SSH 密钥CRITICAL
PersistenceDetectorcrontab、launchd、systemd、修改 shell 配置文件HIGH
PostInstallHookDetectornpm postinstall、pip setup.py cmdclassHIGH→CRITICAL
HiddenCharDetector零宽字符、Unicode 双向覆盖字符MEDIUM
EntropyDetector长行的 Shannon 熵 >5.5MEDIUM
SocialEngineeringDetectorcrypto/wallet/airdrop/security-update 命名LOW→MEDIUM
NetworkCallDetectorsocket、http、urllib、requests、fetch、curl、wgetMEDIUM
PrivilegeEscalationDetectorsudo、chmod 777、setuid、修改 admin 组HIGH

理解置信度评分

每项发现都包含一个置信度评分(0-100):

  • 80-100:极有可能是真实威胁
  • 50-79:可疑,建议人工审查
  • 30-49:可能是误报,请检查上下文
  • <30:信息提示,置信度较低

手动审查清单

扫描器标记出问题时,还应检查:

  1. 来源验证 — 此技能来自官方/已验证的来源吗?检查作者的信誉。
  2. 权限范围 — 此技能请求的权限是否超出其所述功能所需?
  3. 脚本审计 — 阅读所有 .sh、.py、.js 文件。查找混淆代码和意外的网络调用。
  4. 依赖项检查 — 如果此技能有软件包依赖项,请运行 npm audit 或 pip-audit。
  5. 更新日志审查 — 最近的更新中是否引入了可疑更改?

更新 IOC 数据库

IOC 数据库位于 scripts/ioc_database.json。添加新指标:

  1. 按照现有架构编辑 JSON 文件
  2. 运行扫描器,验证是否能检测到新增的 IOC
  3. 更新 references/ioc-database.md,使人类可读版本保持同步

参考文档

如需详细信息,请根据需要阅读以下文件:

  • references/ioc-database.md — 完整的 IOC 列表,包含背景信息和来源说明
  • references/threat-patterns.md — 详细介绍 9 种攻击模式(两阶段载荷、Base64 后门、密码钓鱼等)
  • references/remediation-guide.md — 分步事件响应指南(隔离、凭证轮换、清理持久化机制、报告)

评论

支持 Markdown