SuperAPI AI 工具集

skill-intake-sandbox-gate

安全与审计

查看项目

更新于 10-16 18:28

技能介绍

Skill Intake Sandbox Gate 是一个面向第三方 AgentSkills/MCP 工具的安全引入门禁工作流,主要用于在审查、导入或重写第三方技能(如来自 ClawHub、MCP Market、GitHub)到 misskim-skills 时,先进行静态安全扫描与决策。

用途 该工作流的目标是在任何第三方技能或工具包接触生产自动化之前,对其进行安全评估。它强调优先获取源码树(git 仓库或技能文件夹),而不是直接“安装并运行”,并将候选技能放在临时路径下,暂不执行。

主要能力 工作流包含以下步骤:

  1. 收集来源:优先使用源码树,将候选技能放在临时路径。
  2. 运行门禁(静态扫描):在技能文件夹中执行命令 python3 scripts/gate.py --path <skill-folder> --out /tmp/skill-gate-report.json --md /tmp/skill-gate-report.md,生成 JSON 和 Markdown 报告。
  3. 解读结果:risk_level=low 表示可能可以安全重写/导入;risk_level=medium 表示需要隔离、人工审计和有限范围重写;risk_level=high/critical 表示拒绝或从零重写(不执行)。
  4. 决策:根据报告选择 ACCEPT(仅当低风险、价值明确且能力最小化时)、QUARANTINE(保留参考,不在自动化中执行)或 REWRITE(推荐,内部重建技能,使用最小权限和确定性脚本)。
  5. 重写模式:在 misskim-skills/skills/<name>/ 下创建新的内部技能文件夹,仅复制必要的流程说明、确定性脚本(无隐藏下载)和显式允许的网络端点(如有);移除自动更新器、遥测、curl | bash、任意 shell 执行、凭据处理或隐式密钥读取。
  6. 记录引入:将决策和理由追加到引入日志文件:misskim-skills/INTAKE_LOG.md、misskim-skills/intake-log.md、misskim-skills/intake-log/<date>-*-trend-raw.json(如适用)。

门禁检查内容(摘要) 静态扫描覆盖以下方面:

  • 进程执行:subprocess/child_process/os.system/exec/spawn、shell 管道。
  • 网络:requests/httpx/aiohttp/fetch/axios/socket、硬编码域名。
  • 文件写入/破坏性操作:rm -rf、递归删除、chmod/chown、持久化。
  • 权限:sudo、系统服务编辑、launchd/systemd、防火墙规则。
  • 密钥指标:环境变量/密钥文件读取、令牌模式、.npmrc、.env。

资源

  • scripts/gate.py:静态扫描器 + JSON/MD 报告生成器。
  • references/policy.md:允许/拒绝规则 + 决策标准。
  • references/threat-model.md:技能引入的威胁模型。

适用场景 适用于需要安全审查第三方技能或工具包的团队,尤其是在将这些技能集成到自动化流程之前。它帮助识别潜在风险,如任意代码执行、网络访问、文件破坏、权限提升和密钥泄露。

限制 该工作流依赖静态扫描,可能无法检测所有运行时风险。决策需要人工判断,尤其是中风险情况。重写模式要求内部维护技能,可能增加工作量。具体支持的平台、收费情况、价格、效果等暂未提供。