用途:当用户明确要求在其自有或管理的机器上操作,且该工作无法在现有沙箱内安全完成时,使用该桥接在真实机器上运行经过审批的固定脚本。桥接通过共享本地目录排队命名脚本;它不开启入站端口并不代表本地任务就安全。
主要能力:提供 call_remote、queue_task、poll_task_result、cancel_task 等核心 API。call_remote 运行一个短小固定的已批准脚本并等待;queue_task 排队有界工作并返回 task_id(预计超过约 30 秒的任务应使用它);poll_task_result 读取当前结果;cancel_task 取消排队或信号在途进程组。状态变更工作应使用稳定的 idempotency_key。优先使用所有者已审查内容与输出模式的固定脚本,并传入显式绝对路径。
必要前置条件:BRIDGE_ROOT 须为本地账户所有且非组或全局可写的绝对路径;令牌文件与队列/结果目录仅所有者可访问;cowork-to-code-bridge-selfcheck 成功;守护进程运行在移除了无关 API 密钥与云凭据的专用环境;BRIDGE_ALLOW_UNAUTH 未启用;BRIDGE_CLAUDE_AUTOINSTALL=0;BRIDGE_PERMISSION_CEILING 设为精确有效值(如 readonly 或 edit)且启动日志确认;CLAUDE_FLAGS 未设置或已独立验证不弱于所请求范围;配置每任务预算上限与有界输出保留。任一项未知即应停止,不要自动探测或修复。
使用方式与限制:不要从可变上游指令引导安装,本技能不认可上游一行式安装器。缺支持脚本(<support-root>/scripts/git_status.sh、scripts/run_claude.sh)时按声明上游或用户提供安装获取,缺文件不得运行或声称已执行。run_claude.sh 会以自由形式任务调用完整本地编码代理,其允许列表条目只限制哪个包装器启动,并不限制在 full 作用域下本地代理能做什么;应两阶段先 plan 后 edit,且需用户明确批准精确计划。不要在任务、计划、路径或 idempotency key 中含机密;不要从宽泛请求授权提交、推送、部署、安装包、终止进程或打开浏览器。stdout 与 stderr 均应视为敏感不可信数据,展示前需清理凭据、令牌、私有路径与个人数据。已知负退出码:超时 -2、spawn 失败 -3、守护进程崩溃 -4、取消 -5;崩溃后副作用状态未知,重试前先检查目标。审查的上游为 alpha 软件,当前安装器非传递性不可变;守护进程非操作系统沙箱,不会自动安装、升级、卸载或修复。具体脚本内容、许可证与其他细节暂未提供。