Skill Safety Auditor

概述

skill-safety-auditor 技能对技能执行全面的安全审计，用于识别漏洞、不安全的代码模式、权限问题及合规性违规。它有助于确保技能在发布或部署前符合安全标准。

适用场景

• 技能开发过程中，用于早期发现问题
• 将新技能发布至生产环境之前
• 作为发布审批流程的一部分
• 当用户明确要求对某技能执行“audit”（审计）或“security check”（安全检查）时
• 定期开展安全审查期间
• 审查第三方技能时

核心概念

审计类型

漏洞类别

严重程度等级

• Critical：存在即时安全风险，必须在发布前修复
• High：存在显著风险，强烈建议修复
• Medium：存在中等风险，应予以处理
• Low：属于轻微问题，可酌情修复
• Info：仅提供信息参考，无需强制处理

输入

支持以下输入：

• 技能目录路径
• 审计类型指定
• 输出格式偏好
• 漏洞类型筛选器

输出

生成以下内容：

• 含检测结果的控制台输出
• JSON 格式的审计报告
• 汇总统计信息
• 通过/失败状态标识

工作流

快速安全检查

1. 对目标技能运行 quick-scan
2. 审查是否存在需立即处理的问题
3. 优先修复 Critical / High 级别问题

全面审计

1. 启用详细输出模式运行完整审计
2. 按严重程度逐条审查所有发现项
3. 生成 JSON 报告存档备查
4. 按优先级顺序处理各项问题
5. 修复后重新运行审计以验证效果

发布前审计

1. 启用全部检查项对技能执行审计
2. 生成正式审计报告
3. 与团队共同评审报告
4. 修复所有 Critical / High 级别问题
5. 对已接受的 Low 风险项进行书面记录

命令

快速扫描

./scripts/quick-scan.sh /path/to/skill

完整审计

./scripts/audit-skill.sh /path/to/skill --verbose

生成报告

./scripts/audit-skill.sh /path/to/skill --output report.json

按类型筛选

./scripts/audit-skill.sh /path/to/skill --types secrets,injection

列出历史审计记录

./scripts/list-audits.sh [--skill ] [--since 2024-01-01]

输出格式

控制台输出

🔍 Starting security audit: my-skill
================================
✅ SKILL.md exists
Scanning for secrets...
Scanning for injection vulnerabilities...
[high] injection: eval() detected
  File: src/utils.js:15
  Recommendation: Avoid eval(), use safer alternatives

================================
Validation complete:
  Errors: 0
  Warnings: 1
❌ Validation FAILED

JSON 报告

{
  "audit_id": "AUDIT-20240313-001",
  "skill": "my-skill",
  "timestamp": "2024-03-13T10:30:00Z",
  "summary": {
    "critical": 0,
    "high": 1,
    "medium": 2,
    "low": 3,
    "info": 1
  },
  "findings": [
    {
      "id": "SEC-001",
      "severity": "high",
      "type": "injection",
      "file": "src/utils.js",
      "line": 15,
      "description": "eval() detected - potential code injection",
      "recommendation": "Avoid eval(), use safer alternatives"
    }
  ],
  "passed": false,
  "recommendations": [
    "Remove eval() from src/utils.js:15",
    "Add input validation to all user inputs"
  ]
}

审计检查项

密钥检测

• API 密钥和令牌
• 数据库密码
• 私钥
• 访问凭证
• 环境变量命名模式

代码安全性

• eval() 的使用
• Function 构造函数调用
• setTimeout/setInterval 传入字符串参数
• 子进程执行（如 exec, spawn）
• 动态代码执行（如 new Function()）

文件权限

• 全局可写文件
• 数据文件被赋予可执行权限
• 敏感文件的可访问性过高

依赖项

• 已知 CVE 漏洞
• 已弃用的包
• 潜在危险的包（如具有高权限行为的包）

网络安全

• HTTP 与 HTTPS URL 混用
• 不安全的 API 端点
• 缺失证书校验逻辑

质量规范

• 技能发布前必须执行审计
• 须修复所有 Critical / High 级别问题
• 对已接受的风险项需明确文档化
• 修复后必须重新执行审计验证
• 需长期保留审计历史记录

典型触发示例

• “对该技能执行安全问题审计”
• “发布前进行安全检查”
• “扫描硬编码密钥”
• “检查注入类漏洞”
• “对技能 X 执行安全审计”

限制条件

• 仅支持静态分析，无法检测运行时漏洞
• 可能对合法代码模式产生误报
• 无法验证外部服务本身的安全性
• 不测试实际运行时行为
• 仅覆盖已知漏洞模式，无法识别新型攻击向量

相关资源

scripts/

• audit-skill.sh — 完整安全审计脚本
• quick-scan.sh — 快速安全检查脚本
• list-audits.sh — 查看审计历史记录
• test.sh — 测试技能功能正确性

references/

• 安全最佳实践指南
• 常见漏洞模式参考
• OWASP 指南参考文档