SuperAPI AI 工具集

isolated-setup-doctor

智能体与模型

查看项目

更新于 10-15 19:57

技能介绍

用途:这是安全智能体配置之上的诊断层。verify 静态检查安装是否正确,doctor 则检查常见工作流是否被沙箱配置功能性阻断,用于发现过度严格的允许列表。安装本身存疑时先跑 verify;安装已知正常但工作流以沙箱形态失败(代理不可达、socket 错误、端口权限错误)时跑 doctor。

运行前先做运行时路由:优先使用操作者明确指定的运行时,否则用当前会话运行时;仅安装可执行文件或配置目录不构成选择依据。Codex 需先满足 docs/adapters/codex.md 的静态验证,再在 Codex 沙箱内跑共享实时探测,失败分别归因于原生沙箱/网络拒绝、审批策略或 POSIX agent-iso 层,不要为 Codex 失败开 .claude 设置变更。Gemini CLI 按 docs/adapters/gemini.md 先验证 profile 再诊断实际工具结果,区分策略拒绝、沙箱扩展、hook/信任失败与包装器或认证问题。Claude Code 则继续执行下方探测;无法确定 harness 时询问一次。

八项探测:1) SSH 代理/Yubikey 可达性,命令 bash <skill-dir>/scripts/probe-1-ssh-agent.sh;2) 本地回环端口绑定,probe-2-localhost-bind.sh;3) 经容器网关的 Podman/Docker,probe-3-container-gateway.sh;4) 每项目临时目录 TMPDIR,probe-4-scratch-dir.sh;5) 签名密钥可读(gpg.format=ssh),probe-5-signing-key.sh;6) gh 在沙箱外运行,probe-6-gh-outside-sandbox.sh;7) prek 与 uv 在沙箱内可用,probe-7-dev-tools.sh;8) 全局 git hook 目录可读,probe-8。

黄金规则:只读,每个探测都是小型、确定、无副作用的检查;绝不编辑设置文件、绝不用 dangerouslyDisableSandbox 运行命令、绝不安装任何东西。失败时只呈现并指向目录条目,不自动修复。即使早期失败也要跑完所有探测,不要停在第一个 ✗。区分 ✗(失败)与 ⊘(不适用):✗ 表示探测已运行且被沙箱阻断,⊘ 表示因缺少前置条件而跳过。报告需给出探测命令、退出码与相关 stderr 片段。每个 ✗ 映射到 docs/setup/sandbox-troubleshooting.md 的编号条目,不转述修复内容。

限制:签名中需要实际触摸或终端的条目由 setup-isolated-setup-verify 检查 10 验证,而非本技能。~/.claude/settings.json 在沙箱内通常不可读,排除项检查可能只看到项目范围文件,用户级排除会导致误报。gh 排除仅在 Bash 调用的每一段都是 cd … 或 gh … 时生效,管道、$(…) 替换、循环或任何文件重定向都会使其回到沙箱内。资料未提供收费、价格、平台支持范围等信息。