Qoder Delegate 是一套编排流程,把一项边界明确的编码任务委托给 Qoder CLI(qodercli)执行,你负责写简报、审查结果并最终提交。它只依赖 shell 和文件访问。
适用条件:任务足够大、值得委托;不适合小改动、未安装或未认证 qodercli、或需自行写代码/仅用交互式 Qoder 会话的情形。
前置检查:command -v qodercli、qodercli --version、qodercli --list-models;缺失则按 Qoder 官方 Quick Start 安装,用 qodercli login 认证,自动化可设 QODER_PERSONAL_ACCESS_TOKEN。
模型与上下文:按 qodercli --list-models 给出的实际值选择模型,不要臆造;未指定则省略 --model 用默认。--context-window <n> 可选,仅当请求或需要明确预算时传正整数,且只对受支持模型生效,遇不支持应报错而非静默改值。
五步循环:1) 写简报,含目标、现状、改什么、不改什么、项目真实门槛和收尾报告约定,并告知不要提交;2) 用捆绑 relay 调度:node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo,可选 --model、--context-window 32768、--resume-last、--resume <id>;3) 等待完成,relay 阻塞至 Qoder 退出,可用后台命令运行并以 result.json 为准,不要信进度显示(预运行错误退出 2,缺 qodercli 退出 127 并写 qoder_unavailable);4) 独立审查,自行重跑门槛、对照简报读 diff、检查 --add-dir 工作区、做迁移往返与悬空引用检查;5) 由编排者提交,门槛通过且 diff 成立后才提交,需返工则用 --resume-last 或 --resume <id> 发增量简报后重审。权限模式默认 auto,另有 default、accept_edits、dont_ask、plan、bypass_permissions;非默认模式在非受信目录会回退,须以 result.json 中 actualPermissionMode 为准。授权上不得越界扩大范围,需先询问;其他细节(原生 Windows 支持等)暂未提供。