| name | subagy-dispatch |
| description | This skill should be used when the user wants to dispatch / delegate / send a coding task to the sub-agy backend for asynchronous execution.
Triggers on: "派发", "dispatch", "delegate", "派给 agy", "antigravity", "agy", "把任务交给 agy", "后台执行代码任务", "异步执行计划".
It writes raw task text to the inbox, runs `sub-agy run`, then blocks with `sub-agy watch` and transitions to harvest.
|
sub-agy dispatch（派发计划）
把用户给出的代码执行任务派发给 sub-agy，由本机 agy 在独立 git worktree 里异步执行。
命令假设 sub-agy 已安装（推荐 uv tool install --editable /path/to/sub-agy）。若未安装，可 export SUB_AGY_HOME=/path/to/sub-agy 后使用 uv run --project "$SUB_AGY_HOME" sub-agy ...。
触发条件
- 用户说“派发”“dispatch”“delegate”“派给 agy”“让 agy 做”“后台执行这个计划”。
- 用户给出计划文件路径，或直接给出一段任务描述。
输入解析
- 若用户提供的是已存在的
.md 文件路径，把它当作计划文件。
- 否则把用户输入的原始任务文本先写成计划文件：
mkdir -p "<project>/.subagy/inbox"
cat > "<project>/.subagy/inbox/<timestamp>.md" <<'EOF'
---
scope: []
acceptance: []
constraints: []
---
<原始任务文本>
EOF
<timestamp> 用 date +%Y%m%d-%H%M%S 或 ISO-8601 格式。- frontmatter 中的
scope/acceptance/constraints 先留空列表占位，方便后续补全。
模型与思考强度抉择
派发每个计划前，主 agent 必须按任务复杂度自主抉择 --effort（以及必要时的 --model / --timeout）：
- 默认值：model =
gemini-3.7-flash（flash 系列，配额友好），effort = medium。不传旗标即为此默认值，无需显式传参。
- effort 自主抉择（每次派发前主动判断，在汇报卡片中注明所选档位与理由）：
| 任务特征 | effort |
|---|
| 单文件小改、文案/文档、机械重命名、简单脚本 | low |
| 常规多文件特性、带测试的修改（默认档） | medium |
| 跨模块架构调整、复杂调试、需要长链路推理的计划 | high |
- model 抉择：默认不更换（
gemini-3.7-flash）。仅当用户明确要求时更换；可用 slug 可通过 agy models 查询（flash 系列优先）。
- timeout 抉择：按任务规模通过
--timeout 透传（默认 30m）。
派发单个计划
sub-agy run --plan "<plan.md>" --cwd "<project根>" [--model gemini-3.7-flash] [--effort low|medium|high] [--timeout 30m] [--no-worktree]
--model、--effort、--timeout、--no-worktree 与 src/sub_agy/cli.py 完全一致。run 默认立即返回 job_id，作业在 detached supervisor 里继续执行。
批量派发
多个计划文件时逐个 run，收集所有 job_id 后统一进入下一步。
阻塞等待（Codex 桌面端模式）
Codex 没有 Claude Code 的 Bash run_in_background 主动唤醒机制，因此派发后必须原地阻塞等待。但为了尽早收割完成的作业，使用增量收割策略：
按派发顺序逐 job 单独 watch（而非把多个 id 塞进一个 watch 命令）：
sub-agy watch j-001 --strict --cwd "<项目根>" --timeout <该作业的等待上限>
sub-agy watch j-002 --strict --cwd "<项目根>" --timeout <该作业的等待上限>
watch --strict：全部终态且仅含 done → exit 0；任一 error/cancelled/interrupted → exit 1。- 超时 exit 124，但仍会打印当前状态；此时可重新执行原命令 续等（幂等）。
- 单个 job 终态后，
watch 输出 JSON 数组（单元素）：job_id, state, round, agy_status, summary, contract_ok, tests_passed, elapsed_seconds, tokens, diff_stat, result_path, events_path, worktree, branch。
- 超时建议值：
该作业的 timeout × (queue_position 或 1) + 30m 余量（考虑排队等候）。
- 退出码：终态 → 0（strict 下仅 done）或 1（任一非 done 终态）；job 不存在 → 3；超时 → 124。
watch 返回后的处理
watch 返回后，立即按输出中的 state/contract_ok/tests_passed 进入验收流程（harvest 技能规则）：
- 验收不通过 → 自动
sub-agy feedback <id> "<具体修复要求>" 打回（仅 done/error 状态）。若判断上一轮失败主要由于思考强度不足（需升级 effort），建议以更高 --effort 重新 run 新作业，因为 feedback 会复用原作业的 meta.json 档位。
- 验收通过 → 只给出
git merge agy/<id> 建议，绝不自行合并/提交/cleanup。
- 若状态为
cancelled/interrupted，向用户说明并等待指示。
输出示例
派发后向用户汇报（作业卡片中注明档位、理由，以及完成后 tokens/用时见 harvest）：
已派发作业 j-20260820-120000-ab12（档位: model=gemini-3.7-flash effort=medium，常规多文件修改），分支 agy/j-20260820-120000-ab12，正在 watch 阻塞等待完成（完成后 tokens/用时见 harvest 汇总）...
回退方式
如果 sub-agy 不在 PATH：
export SUB_AGY_HOME=/path/to/sub-agy
uv run --project "$SUB_AGY_HOME" sub-agy run --plan task.md --cwd ./my-project
