subagent-routinglisted
Install: claude install-skill a-green-hand-jack/ml-project-repo-agent-native-template
# subagent-routing
为一个待派发的 child task 挑选 provider、model、reasoning effort、允许的 tools,并落成一份 launch packet。核心原则:**派发前先路由**,不直接甩一个广义 general-purpose worker 上去。
## 适用边界
适用:需要把一段可界定的子任务交给 subagent(搜索、实现、review、监控等)时。
不适用:任务尚未拆清 scope(先去写 plan doc);只是主 agent 顺手能做的一步;需要人类副作用(走 human gate)。
## 输入 / 输出 artifact
- 输入:child task 的目标、scope、forbidden、验收标准(来自 plan doc 或上游指令)。
- 输出:一份 launch packet,落在 launch 现场(issue/PR 描述或 `memory/branches/<slug>.md` 内引用),模板见 `.agent/templates/launch-packet.md`。
## 需要读取的 ledger
- `.agent/model-routing-policy.md`(tier 0-4 的 model/effort/tool 预算)。
- `.agent/tool-skill-interface.md`(何时 shell / skill / subagent / MCP)。
- `.claude/skills/coding-agent-quota/SKILL.md`(provider quota / token burn / Paseo preference 证据)。
- `.claude/skills/coding-agent-quota/.outcome-ledger/`(outcome ledger:历史 route decision / 结果证据,
schema 见同 skill 的 `schema.md`;launch packet 只嵌 `decision_id`,完整证据按 ID 来这里查)。
- 当前 `memory/session-tree.md`(避免与已在跑的分支冲突)。
## 允许修改的路径
- `memory/branches/<slug>.md`(写入本次 launch packet 引用)。
- 派发现场的 issue/PR 文本。
- 其余一律只读。
## 步骤
1. 归类 role:`impl` / `ui` / `research` / `planning` / `audit`。
2. 归类 tier:按 model-routing-policy 的 tier 0-4 判定任务难度与风险(0=最轻只读检索,4=高风险高推理)。
3. 读取 quota 证据:运行
`python .claude/skills/coding-agent-quota/scripts/read_agent_quota.py --role <role> --tier <tier> --format json`。
若 outcome 证据可用(`.outcome-ledger/` 有足量记录),改用/加跑
`python .claude/skills/coding-agent-quota/scripts/outcome_route.py --live --role <role> --tier <tier> -