Skill Security Audit
审计 skills 目录中的安全风险，生成报告。
🚀 快速使用
安全安装（推荐）
# 替代 clawdhub install，自动审计
bash skills/skill-security-audit/scripts/safe-install.sh weather
# 安装指定版本
bash skills/skill-security-audit/scripts/safe-install.sh my-skill --version 1.2.3
# 有警告也强制安装
bash skills/skill-security-audit/scripts/safe-install.sh risky-skill --force
安全发布
# 替代 clawdhub publish，发布前审计
bash skills/skill-security-audit/scripts/safe-publish.sh ./my-skill --slug my-skill --version 1.0.0
# CRITICAL 问题会阻止发布，无法绕过
手动审计
# 审计单个 skill
bash skills/skill-security-audit/scripts/audit.sh skills/target-skill
# 审计所有 skills
bash skills/skill-security-audit/scripts/audit.sh skills/
# 包含文档文件（更严格）
bash skills/skill-security-audit/scripts/audit.sh skills/ --include-docs
# 输出 JSON（给程序用）
bash skills/skill-security-audit/scripts/audit.sh skills/ --json
🛡️ 检测项目
| 类别 |
严重程度 |
检测内容 |
| 凭据泄露 |
🔴 CRITICAL |
OpenAI/Anthropic/AWS/GitHub/Google/Slack API key |
| JWT Token |
🔴 CRITICAL |
长 JWT token（100+字符，可能是真实凭据） |
| 数据库凭据 |
🔴 CRITICAL |
MongoDB/MySQL/Postgres/Redis 连接串含密码 |
| 私钥 |
🔴 CRITICAL |
RSA/DSA/EC/PGP 私钥 |
| 硬编码 Cookie |
🟠 HIGH |
a1/web_session/id_token 等 cookie 值 |
| 硬编码密码 |
🟠 HIGH |
password/secret/api_key 硬编码值 |
| 危险命令 |
🟠 HIGH |
rm -rf、eval()、curl | bash |
| 敏感目录 |
🟠 HIGH |
~/.ssh、~/.aws、/etc/passwd |
| sudo |
🟡 MEDIUM |
sudo 命令（权限提升） |
| 网络请求 |
🟡 MEDIUM |
HTTP 到非白名单域名 |
| 权限问题 |
🟡 MEDIUM |
chmod 777 |
| 依赖风险 |
🟢 LOW |
未锁定版本的依赖 |
📋 安装/发布行为
safe-install.sh
| 问题级别 |
默认行为 |
可覆盖 |
| CRITICAL |
❌ 阻止安装 |
--allow-critical（危险！） |
| HIGH/MEDIUM |
⚠️ 询问确认 |
--force |
| LOW |
✅ 允许 |
- |
safe-publish.sh
| 问题级别 |
默认行为 |
可覆盖 |
| CRITICAL |
❌ 阻止发布 |
不可覆盖 |
| HIGH |
⚠️ 询问确认 |
--force |
| MEDIUM |
⚠️ 询问确认 |
--force |
| LOW |
✅ 允许 |
- |
🔇 忽略误报
行内忽略
# security-audit: ignore-next-line
EXAMPLE_KEY="sk-test-not-real-key-for-documentation"
文件忽略
创建 .security-audit-ignore：
scripts/test_*.sh
references/examples/*
assets/*
📁 文件结构
skill-security-audit/
├── SKILL.md
├── scripts/
│ ├── audit.sh # 核心审计脚本
│ ├── safe-install.sh # 安全安装 wrapper
│ └── safe-publish.sh # 安全发布 wrapper
└── references/
└── detection-rules.md # 检测规则详情
⚙️ 设置别名（可选）
# 添加到 ~/.bashrc 或 ~/.zshrc
alias skill-install='bash ~/clawd/skills/skill-security-audit/scripts/safe-install.sh'
alias skill-publish='bash ~/clawd/skills/skill-security-audit/scripts/safe-publish.sh'
alias skill-audit='bash ~/clawd/skills/skill-security-audit/scripts/audit.sh'
# 使用
skill-install weather
skill-publish ./my-skill --slug my-skill
skill-audit skills/
xiwan