用途:当你希望把一项有边界的编码任务交给单独的 Qoder 实现者完成,然后自行审查其 diff 时使用;前提是用户明确要求委派给该实现者。编排者负责撰写任务简报、把握判断、最终审查并提交,Qoder 在其会话中修改工作树。任务太小宜直接内联完成,且 qodercli 未安装或未认证、或你只想用交互式 Qoder 会话时,不适用本技能。
前置检查:运行 command -v qodercli、qodercli --version、qodercli --list-models;缺失时按 Qoder 官方 Quick Start 安装,用 qodercli login 认证,或设置 QODER_PERSONAL_ACCESS_TOKEN 用于自动化。--list-models 成功说明当前账户可返回实时模型目录。选择模型时若用户指定,须使用 --list-models 中的精确当前值,不要臆造或固定目录条目;否则省略 --model 使用默认。--context-window <n> 可选,仅在用户要求或任务需要明确预算时传正整数,且仅对受支持模型生效,不支持时应暴露错误而非静默更换。
流程(每个任务五步,1、4、5 需判断,2、3 为机械操作):1. 写简报,含目标、现状、要改与不改的内容、项目真实门禁、结束报告约定,并告知 Qoder 不要提交,一项任务一份简报;2. 派发,使用捆绑的 relay:node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo,可选 --model "<值>"、--context-window 32768、--resume-last(仅增量简报)、--resume <id>(仅增量简报),--help 查看全部选项;3. 等待完成,relay 会阻塞至 Qoder 退出,完成以进程退出且 result.json 含状态为准,不要相信进度显示;4. 审查,不要相信自我报告,自己重跑项目门禁、对照简报阅读 diff(从 touchedFiles 开始)、单独检查 --add-dir 工作区、运行相关 guard 技能、对删除或重命名做往返迁移与悬空引用 grep;5. 落地提交,仅在门禁通过且 diff 成立后提交,需返工时用 --resume-last 或 --resume <id> 发增量简报再审查。
权限模型:print 模式无法显示审批提示,relay 默认 auto;default 可能拒绝需提示的操作,accept_edits 允许工作区编辑但可能拒绝 shell 操作,dont_ask 失败即关闭,plan 映射为 default 加 Qoder 的 Plan 工作状态,bypass_permissions 仅用于明确信任的运行。在受信任目录外请求非默认模式时 Qoder 会回退到 default,请检查 result.json 中的 actualPermissionMode。授权:委派需用户主动选择;一旦提出,落地通过门禁的验证工作是契约,但仍有两条限制——暴露而不吸收(报告 Qoder 的设计决策与非阻塞偏差)、范围变更时停下(超出简报前先询问)。
限制:需要已安装并认证的对应 CLI、Node 18+ 与 git;relay 从不提交,只返回结构化结果 JSON;原生 Windows 下的 relay 启动尚未验证;运行时脚本来自 UPSTREAM-NOTICE.md 所记载修订。相关参考文档有 writing-the-brief.md、dispatch-and-poll.md、review-and-land.md、multi-task-queues.md。