SuperAPI AI 工具集

codex-sandbox

通用与其它

查看项目

更新于 10-15 22:38

技能介绍

用途:该技能为每个任务创建一个独立目录(沙箱)并在其中运行 Codex 等写入型智能体,适用于智能体可能用错当前工作目录、需要对 .env、node_modules、构建产物、端口、开发服务器做完全隔离,或偏好“一个任务等于一个文件夹等于一个分支”模型的场景。相比 git worktree 更强调隔离性。

主要能力:命令行工具 Python CLI 加 Bash 包装脚本,脚本为 scripts/codex_sandbox.py(主)与 scripts/codex-task(便捷)。执行 new 时会检测仓库 remote(默认 origin)、创建或更新本地裸镜像、在基础目录下克隆沙箱、从 origin/main 创建并切换任务分支、设置上游跟踪并为需要时推送一次、安装阻止在 main/master 上 commit/push 的安全钩子。

使用方式:由智能体调用而非手动运行。示例:SKILL_DIR="$(git rev-parse --show-toplevel)/.codex/skills/codex-sandboxes" 后执行 python3 "$SKILL_DIR/scripts/codex_sandbox.py" new fix-123。支持 --base-dir、--bare-dir、--remote、--remote-url、--base-branch、--branch、--env-copy 等选项;子命令包括 new、list、path、status、rm。

适用场景与限制:建议每个沙箱只运行一个写入会话,多会话时创建多个沙箱;沙箱处于 main/master 时会拒绝执行,除非传入 --allow-main;远程检测失败可传 --remote-url。原始资料未提供收费、价格、平台支持等信息。