/do

description: 委派模型**改文件/落盘/执行**。隐含 --write(子进程获得 Edit/Write/Bash 全权)。主 Claude 会智能补 --with-context、选模型。
argument-hint: '[--<model>] [--with-context] <任务(可多行)>'
allowed-tools: Bash(node:*), AskUserQuestion

把任务委派给指定模型,**写模式**——子进程获得 Read/Grep/Glob/Edit/Write/Bash 全权,可改文件、可执行命令。 **委派的目的是把重活的 token 留在子进程,别搬回主上下文**——给方向和路径,读写实活交给子进程。

原始参数(可能多行,含特殊字符):

$ARGUMENTS

怎么做

1. **拣 flags**:识别 `--<modelKey>`(见 `${CLAUDE_PLUGIN_ROOT}/config/models.json`)、`--with-context`、`--resume`、`--effort <档>`、`--json`、`--quiet`。**`--write` 由命令自动加,不用让用户重复传。** `--effort`(none/low/medium/high/xhigh/max)调思考强度,claude/codex 模型通用;用户说"深想一点/xhigh""快速点/别想太多"之类就补上。不传则各 harness 用自己的默认档。

• **续历史会话并写**:`/gkd:do --resume [<sessionId>] <补充>` 可续上次(或点名续某次)委派**并给写权限**(即使原会话是只读)。续接语义、sessionId 检索 SOP、UUID 误拣防范、`--with-context` 互斥等规则,统一见 `commands/resume.md`——此处不复述,避免两处漂移。

2. **选模型**:

• 用户显式指定或自然语言提名("用 GPT 改")就用之;没说就自己判断挑一个合适的,拿不准就**不传**、让 runtime 用默认
• **视觉约束(须自觉遵守):任务涉及图片时,只能从这些支持视觉的模型里选**:!`node "${CLAUDE_PLUGIN_ROOT}/scripts/gkd-runtime.mjs" --list-vision`。
• 本机装了 codex CLI 时 `--codex` 可用(走 codex harness、GPT 原生工具循环,不是又一个便宜模型;要 harness 差异 / 独立第二意见 / GPT-image生成时选它)。**codex 也支持 `--with-context`**,首次会把当前对话导入成 codex thread(约 1-2s)。**codex 写模式的两点差异务必知悉**:① 写边界由 codex 自己的 sandbox(`workspace-write`)定义,不是 gkd 的 allowed-tools 粒度;② **codex 写模式默认关闭网络**——装库/联网命令(npm install、git fetch 等)会失败,这类任务别派给 codex。

3. **`--with-context` 自己判断**:任务若回指了主对话里才有、任务文本没写清的信息,就加 `--with-context` 把主对话 fork 给子进程;任务完全自洽就不加;**拿不准就用 `AskUserQuestion` 问用户**(选项:带上对话历史 / 干净委派)。

4. **跑**(任务文本第一个非 flag token 起,保留所有换行):

node "${CLAUDE_PLUGIN_ROOT}/scripts/gkd-runtime.mjs" \
  --write \
  <拣出+补的 flags> \
  "$(cat <<'__GKD_TASK_EOF__'
<把任务原文逐字粘进来,保留换行,不重排/总结/翻译>
__GKD_TASK_EOF__
)"

单引号 heredoc 终止符 + 外层 `"$(...)"` 让多行任务成为**单个 argv 参数**(裸用 `$ARGUMENTS` 会被 shell 拆成多条命令,别这么写)。

5. **运行模式**:**默认 `run_in_background: true`**。Bash 前台默认 2 分钟超时会杀子进程丢进度,而装库/批量改/多次 LLM 调用常超时。只有确信 < 30 秒(改单文件一两行)才前台,且必须传 `timeout: 600000`,绝不用默认。不确定就后台。

> runtime 内部对委派子进程有默认 **30 分钟**超时兜底(防子进程僵死),到点 SIGTERM→SIGKILL 并归一成失败。若这次是**预计会超 30 分钟的大任务**(超大批量改、逐文件长生成),在 runtime 命令前加环境变量提高上限或关闭:`GKD_TIMEOUT_MS=3600000`(1 小时)或 `GKD_TIMEOUT_MS=0`(禁用),否则任务会在 30 分钟被杀、白烧 token。常规任务不用管,用默认即可。

输出处理

• 后台:Bash 立刻返回 task_id,报给用户("已在后台启动,task: `<id>`,跑完会通知")并**立刻还控制权,不要 TaskOutput 阻塞**。收到 `<task-notification>` 后 Read 那个 `.output` 文件,把 result 汇报给用户。
• 前台:stdout 直接就绪,直接汇报。
• stderr 末尾 `[gkd]` 行确认实际模型;`❌ 失败` 时把 result 里的 API 错误原文如实告知用户。