用途:作为编排者,把一项边界清晰的编码任务交给独立的实现者(Claude Code CLI 会话),由对方修改工作树,你负责写任务简报、审查产出并自行提交。它不用于让当前 Claude 直接实现;仅当人类明确要求委派给另一个 Claude Code 进程或会话时使用。
不适合的情形:人类要求当前代理直接实现;任务小到可内联完成且未要求委派;claude CLI 缺失或未认证(claude auth status);任务需要比 Claude Code 工具权限与 shell 沙箱更强的宿主隔离,此时应使用隔离容器或 VM。
前提:claude --version 成功;claude auth status 显示已认证(macOS 凭据在登录钥匙串,若编排者自身沙箱拦截钥匙串访问,可能误报未登录,需在提权或沙箱外重跑检查与派发);目标仓库通过 --cd 指定;Linux/WSL2 上需安装 Claude 沙箱依赖。
循环流程:1) 写简报,独立会话没有聊天历史,从 stdin 收到简报并可检查工作树;Claude Code 会自动发现项目 CLAUDE.md,但不会自动加载 AGENTS.md,需自行把关键约束与真实门禁命令写入简报,并告知实现者不要提交,每份简报只放一个任务。2) 派发:node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo,可选 --read-only、--resume-last、--session <id>、--max-turns、--max-budget-usd、--autocompact、--timeout。relay 运行 claude -p --output-format stream-json --verbose,经 stdin 发送简报,默认把产物写入系统临时目录;不使用 --bg 或 --bare,也从不提交。3) 等待:relay 阻塞至 Claude 退出,完成意味着进程退出且 result.json 存在;用法错误退出码 2 且不写 result.json,claude 缺失退出码 127 并写 status: "claude_unavailable",超时与信号会终止整个实现者进程树并保留结果产物。4) 审查:把实现者报告与门禁结果当作声明,先审查对现有测试的修改,自行重跑真实门禁,对照简报读完整 diff(从 touchedFiles 开始),检查未跟踪与暂存内容。5) 落地:门禁通过且 diff 成立后由编排者提交;返工可用增量简报 resume 同一会话,如 echo "..." | node "<skill-dir>/scripts/relay.mjs" --session <id> --cd /path/to/repo。
权限配置:常规配置使用 acceptEdits 权限模式,工具限于 Read、Glob、Grep、Edit、Write 与平台 shell;macOS、Linux、WSL2 启用 Claude shell 沙箱,依赖缺失即启动失败且不降级重试;沙箱内命令自动批准。禁用 MCP 发现与 Claude.ai 连接器,拒绝全部 MCP 工具,子会话无法使用 skills、commands 与 Agent 工具;项目 CLAUDE.md、hooks、认证与本地设置仍加载。字符串规则拒绝常见 git commit、git push、嵌套 claude 及含 claude-delegate 的命令,但别名、脚本与包装可绕过,只是减速带。原生 Windows 不支持 shell 沙箱,仅限制工具面并预批准 PowerShell,不是 OS 隔离;claude.exe 与 claude.cmd 启动路径已实现,其中 claude.exe 直接启动尚未验证。--read-only 使用计划模式,仅 Read、Glob、Grep,并通过 git 状态与指纹报告是否越界;readOnlyViolation 为 true/false/null,只是报告线索而非 OS 边界,忽略路径、完美还原、本地 hooks 写入与并发改动都在覆盖之外。--dangerously-skip-permissions 是显式启用 bypassPermissions,仅在人类明确接受时使用。该技能与 Claude 原生子代理、代理团队和后台会话互补,提供跨编排者契约并让提交权留在编排者手中。区分的参考文档包括 writing-the-brief.md、dispatch-and-poll.md、review-and-land.md、multi-task-queues.md。