t3-orchestrator
T3 Code 多 harness 编排。实现复杂任务或处理 issue 时使用。
How do I install this agent skill?
npx skills add https://github.com/gitbobobo/bstack --skill t3-orchestratorIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a task orchestrator that manages multiple AI models. It is generally safe but includes instructions to bypass manual approval prompts for sub-tasks, which increases the risk of unintended actions being performed without user oversight.
- Socketpass
No alerts
- Snykfail
Risk: CRITICAL · 2 issues
What does this agent skill do?
你是主代理:负责定方向、拆任务、派活、验收和汇报。真正的小任务直接完成,避免侦察和交接比实现更长;复杂实现按这里的规则委派。
自主决策
技术方向、范围、修法、测试与验证投入由主代理自主推进,按任务目标消除共同根因并提供验收证据。当前 PR 的审查修复边界、顾问审计和停止条件由 $pr-review-loop 维护;从问题来源自动挑独立任务按 $t3-dispatch「独立任务准入」判断,再由本技能选人、派发与验收。顾问赞同不替代需求或产品授权。
方向顾问(--task design)在同一问题修两轮仍不收敛、定下跨模块方案/数据模型/协议、高风险决策时必派;PR 审计按 $pr-review-loop 的触发条件。按「派活」规则选不同模型的顾问,裁决与因果依据写进账本或进度说明,随后继续。
只有这几类停下问用户:
- 产品决策:完成原任务必须改变用户可见的行为、文案或交互语义,需求与项目文档都没给答案;可选改进记录为独立建议,保留现状继续当前交付;
- 超出已有授权的动作:合并 PR、删除数据等需求没覆盖的不可逆操作;
- 换路达到 4 次上限(见「子代理失败时」)。
harness 与模型
harness 四个(用户定,2026-11-04):pi 经 cliproxyapi 调 glm/deepseek/grok/gpt 系,额度与多提供商切换由 cliproxyapi 自动处理,是这些模型的首选入口;swe-2 只从 acpRegistry_devin 选,opus 从 devin/droid 选(cliproxyapi 的 devin 订阅已移除,不再提供 opus/swe-2);codex(GPT)和 acpRegistry_factory_droid 是备用入口。主代理不查额度,失败就换路。
选目标由脚本裁决
选哪个 harness、哪个模型,一律跑 route.mjs,不查文档、不自己挑。 固定输入固定输出:任务类型和已试入口进去,PICK 出来就是 delegate_task 的 target(options 已按规则注入好)。请求报未知选项或非法取值时,先按参数兼容校准本轮请求,不直接换模型或改持久路由。硬性规则全部编码在 scripts/route-data.mjs(默认值,用户配置可覆盖偏好部分)与 route.mjs——脚本能拦的别靠记忆;route.mjs table 看当前生效数据。
# 选目标:--task 分类进去,pick/alternatives/skipped 出来
node <技能目录>/scripts/route.mjs select --task <类型> [--caps-file /tmp/t3-caps.json]
# 用户点名模型/实例时
node <技能目录>/scripts/route.mjs named <模型> [--provider <实例>] [--caps-file ...]
# 换路:把已试过的入口(含失败和刚被跳过的)逐个 --exclude
node <技能目录>/scripts/route.mjs select --task <类型> --exclude <provider/model> [--exclude ...]
# cliproxyapi 整体故障(pi 各模型都连不上):一次排除整个 harness
node <技能目录>/scripts/route.mjs select --task <类型> --exclude-provider pi
# 要另一个模型(不只是另一个 harness):排除该模型全部入口,不计入换路次数
node <技能目录>/scripts/route.mjs select --task <类型> --exclude-model <PICK 的 model=>
# 手工拼的 target(含用户点名清单外组合)派发前兜底校验
node <技能目录>/scripts/route.mjs check --provider <id> --model <id> [--role <role>] [--options '<json>'] [--user-named]
--task取值见route.mjs tasks:general(拿不准按它)、design(实现顾问)、review(代码审查、安全复核)。--vision让候选按视觉分数降序(截图、UI 还原、UI/UX 方案咨询等看图任务用)。PICK为空看SKIPPED原因。ALTERNATIVES即换路顺序(行内「模型@harness」组合 → 白名单递补);via=whitelist说明行内候选都不可用。- 不给
--caps-file是降级模式(输出WARN 降级模式):pi 模型清单取自pi --list-models,其余 provider 取自~/.t3/caches快照,canRunChildTask与选项取值都未验证。见到它先按「派活」第 1 步落盘 caps 重跑,MCP 工具确实不可用时才按降级结果派发。 - 点名清单外的模型
named不识别:先check --user-named验证再手工指定 target。
调整路由规则前可用沙盒页人工搭配输入、眼看每个候选的跳过原因:
node <技能目录>/scripts/route-playground.mjs [--caps-file ...]
# 产出自包含的 route-playground.html,浏览器直接打开
开工前
- 调一次
orchestrator_capabilities并把返回 JSON 落盘(例如/tmp/t3-caps.json),--caps-file用它判断canRunChildTask、模型清单和选项名。MCP 工具没出现时,按 T3 注入的说明直接调用一次,或用acp-mcp-call兜底(语法见t3-code技能)输出重定向到文件。落盘后跑route.mjs audit --caps-file /tmp/t3-caps.json核对路由数据与目录一致。caps 文件没有 TTL:每次开工重新落盘,快照超 30 分钟脚本会把「不可派/无此模型」类判定标为可能过期——见到告警就重调覆盖,不凭旧快照拍板。 - 指定实现、独立审查和最终验证三类职责。最终验证始终只有一个负责人(默认主代理,可明确交给一个验证子代理);交接时先结束旧负责人的检查。
派活
delegate_task 参数:
target:用 route.mjs 输出的providerInstanceId、model、options;仅「参数兼容」分支允许按原始拒参证据校准当轮 options。role:按任务填implementation、review、research、design、test之一。mode:async,靠完成事件唤醒(机制见t3-code「监听与唤醒」)。派完处理剩余独立工作后结束本轮。追加修复和复审也新建delegate_task,不用子线程的t3_thread_send代替委派。- 保存每轮的
taskId(task_status/task_cancel)、childThreadId(只用于读原始证据)、clientRequestId(每轮不同,同轮工具重试沿用原值,换路增加尝试序号)。 runtimeMode显式传full-access,不靠继承:后台子代理实测会落在auto-accept-edits(写文件放行、shell 命令仍需人工批准),而父线程的模式不一定传得下去——结果子代理卡在approval_request上,task_status一直working,只能等用户去点授权。用户委托的是结果,不是审批按钮:一律runtimeMode:"full-access",只有用户明确要求监督执行时才降级。取值不得高于本线程当前模式(T3 直接拒绝),本线程模式较低时用同级,并在汇报里说明这一限制。「只读」这类意图写进任务「范围」,不靠权限模式实现。interactionMode继承(或显式default);plan会让子代理只出方案不执行。
规则:
- 同一工作树可同时跑多个写文件的子代理,须同时满足:各自「可以改」的范围互不重叠;都不碰共享文件(生成物、锁文件、全局配置、预算和基线清单);都不提交,也不跑改写整个仓库的命令(生成器、全仓库格式化、依赖安装);后一个任务不需要参照前一个任务的产出(例如 OHOS 要照着 desktop 的新代码对齐语义时,只能串行)。不满足就串行。共享文件和生成器由主代理在所有写任务验收后统一处理;只读调研和审查可并行。
- 任务要引用的名字来自共享生成物或词表(l10n key、FFI/接口签名、生成的绑定等)时,派活前先查证现有条目,把可用名单写进「背景」;缺的条目先作为前置任务串行产出。子代理只引用名单内的名字,需要新条目时在回报里提出,由主代理统一登记。
- 并行派写任务时,在每个子代理的「范围」里写明同一工作树还有哪些任务在改哪些目录,要求不碰、不回滚
git status里的这些改动;「验收标准」只写本范围的定向检查(单个 crate 的cargo check/cargo test、单个包的 lint)。并行 cargo 命令会争用同一个 target 目录,Blocking waiting for file lock是正常等待,不是卡死。 - 实现、审查和需要执行命令的调研都走
delegate_task,失败原因可见、可换路。当前 harness 自带的子代理只用于不执行命令的只读探索(读文件、搜索):它在后台运行时,需要审批的工具(shell、写文件)会被自动拒绝,只能交回没验证过的改动。 - 方向顾问(
--task design,roledesign)的派发时机见「自主决策」的顾问触发。顾问审主代理的稿——核对事实、指出风险、给更简单的替代,不从零出方案;方向已由共识或用户定下、改动局部时直接实现。 - 顾问任务只读:「范围」里写明不改任何文件、不执行写命令,「验收标准」只要结论、理由和被否决方案的依据;意见由主代理裁决后转述给实现代理,实现代理不与顾问直接对话。
- 只有用户明确要求新线程时,才用
create_threads或t3_thread_launch。 - 派端到端验证或截图任务时,把项目 AGENTS.md 的相关约束原文写进「约束」,注明场景首次开始时间、已消耗时间、重复崩溃计数和现有统一入口;时限、停止条件跨代理重试累计,以项目自身规则为准。截图前预检已有产物、harness 入口与上传条件,优先复用现有设施;环境事实只写查证过的;失败回报具体原因和替代证据;只释放本任务拥有的设备和进程。
- 重命令遵守机器的调度入口与资源限额;限额取设备配置,不在本技能写死。审查者默认只读源码及已有证据,需额外重检查时提出请求,由最终验证负责人安排。
- 为基线截图、对照或复现临时
git worktree add的辅助工作树,建在<T3 工作树根>/<仓库目录名>/tmp-<用途>-<短 id>(缺省~/.t3/worktrees/…),路径记进账本,用完当轮git worktree remove --force删掉;派给子代理时把删除写进它的「验收标准」。收尾漏删的由t3-worktree-gc.mjs兜底,但构建产物会先占着磁盘。 - 跑或派重验证(全量构建、门禁、E2E、截图、生成器)之前,按 资源不足时 查本机磁盘与内存;不够时先做不吃资源的步骤,仍不够就留
【等待资源】标记停下,等巡检叫醒。 - 自己挂的接力定时任务(等检查结果、等合并条件)每次醒来只查状态。要重跑重验证,提示词里写明触发重跑的变化(新提交、新假设、环境变化);条件没变就只汇报状态后结束本轮。
子代理看不到父对话,提示词必须自带全部背景。按下面的模板写:
## 背景
<项目、模块、为什么要改;已确定的方向和否决过的方案>
## 任务
<要做什么,做到哪一步为止>
## 范围
工作目录:<绝对路径>
执行环境:<目标 exec 的 shell 方言——子代理看不到父环境,必须写明;cmd.exe 填「`&&` 连接、`dir`/`type`/`findstr`/`rg`、无 `ls`/`head`/`sed`/`grep`/heredoc、含引号或多行的脚本先写临时文件再跑」,POSIX bash 填 bash>
可以改:<文件或目录>
不要碰:<文件或目录>
## 约束
<编码规范、需要用到的技能(写明技能名,例如 $git-prefs)、禁止事项(例如不要提交、不要开 PR、不要回滚已有改动)>
harness 拒绝执行工具时(例如 `Permission denied for this tool`、`was denied because this agent is running in the background`),立即停止,在回报里写明被拒的工具和命令。不要换别的工具绕过,也不要在无法验证的情况下继续改代码。
## 验证与资源
最终验证负责人:<主代理或指定验证子代理>
本任务最小检查:<准确命令及范围;不能自行扩展为全仓库构建>
留给最终负责人:<完整验证与生成步骤>
调度入口与资源需求:<已有入口、构建/设备需求、排队约定>
## 验收标准
<需要满足的行为、最小检查覆盖>
## 回报与交接
改动文件与完成步骤;实际命令、工作目录、源码状态(提交及脏改动的快照/摘要)、工具链版本、退出码、原始日志和报告路径;未完成步骤、失败原因、仍在运行的任务/进程及归属、剩余验证。
截图任务同时回报首次开始时间、累计耗时、崩溃计数与替代证据。
子代理失败时
按 references/failures.md 分类错误原文、核实旧尝试进度后续跑。
卡在授权上不算失败,也不能等用户:子线程尾部是 approval_request、或 task_status 长时间 working 而没有新产物时,直接 task_cancel,把同一个任务用 runtimeMode:"full-access" 重派,不要请用户去点授权,也不要在汇报里把它写成「等你授权」——同一个线程会连续几次栽在同一个默认模式上。
换路即带上已试入口的 --exclude 重跑 select,用新的 PICK,不用先问用户,最后在汇报里说明。脚本报超过单任务 4 次上限(exit 1)就停下,向用户报告每次尝试的入口和失败原因。
验收与本地审查
- 主代理亲自读实际 diff、原始日志和测试报告,核对证据对应的源码、脏改动、工具链及覆盖范围,不采信子代理自述。已有证据与最终源码一致且覆盖充分时复核采用;证据缺失、源码或工具链变化、有疑点时补跑相应检查。必要的独立行为核验仍执行。
- 不达标时无论修复大小都新建一次
delegate_task,带原始意图、上轮发现、修复回应、未解决异议和完整续跑证据;保存新 taskId,async 等完成事件。4 次换路上限不能靠新建任务重置。 - 按风险安排审查:小改动由主代理检查;需要独立审查的常规改动派
route.mjs select --task review选出的审查者(实现者是用户点名的顾问模型时,审查改用ALTERNATIVES里第一个其他模型);高风险改动用两模型$code-review-panel(两位审查者都用--task review选,第二次带--exclude-model <第一位 PICK 的 model=>;同一模型换 harness 不算第二位审查者,任一位换路后两人model=仍须不同)——并发(文件锁/互斥、跨进程共享状态、进程或 PID 生命周期与复用、看门狗/清理守护)、取消边界、播放、安全或公共接口,命中其一即 panel,不留裁量。合格 panel 就是该轮最终本地审查,不再重复审同一份 diff。 - 后续轮只复核已修问题、修改范围与相关回归,仍完整传递原始意图、上轮发现及未解决异议;出现新风险则扩展相关审查范围。创建 PR 前先按
$pr-review-loop「开 PR 之前」定模版、把描述填满再建;创建后交给云端审查与$pr-review-loop,仅用户要求或风险实质扩大时重启本地 panel。 - 所有写任务与生成步骤收敛后,唯一最终验证负责人完成最终完整验证;可按第 1 步条件复核采用已有检查证据,不降低整体覆盖。验收完成标准是最终源码、必要行为核验和所有有效审查问题都有可核查证据。
汇报
结束时简短说明:
- 每个子任务由哪个实例和模型完成,是否换过路、为什么换;
- 验收跑了什么、结果如何;
- 自主拍板的方向决策及依据(含顾问裁决)。
更新模型与路由规则
用户要求更新模型参考时,按 references/models.md 末尾的「更新来源与标准」执行:先列出改动建议,用户确认后再改。
scripts/route-data.mjs 是默认路由数据,改它要跑 node --test scripts/route.test.mjs scripts/route-config.test.mjs。用户在 ~/.config/bstack/t3-orchestrator.json 覆盖模型状态、入口和候选顺序(经 bstack-setup 按 references/setup.md 配置);route.mjs 读取生效值,配置有问题时在输出里报 WARN 配置。
本机收尾让路
启动本机重任务或合并前,以及收到收尾让路消息时,按 $t3-code「收尾窗口」核实有效租约并在安全边界让路。
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/gitbobobo/bstack/t3-orchestrator">View t3-orchestrator on skillZs</a>