用途:该技能用于在一个工程任务中协调多个代理工具(harness):Codex 作为用户的唯一控制面,Codex Gateway 负责调度,Claude Manager 决定实现简报与层级,Codex Worker 执行实现,独立 Claude 审查者在全新只读会话中做验收。适用于实质性工程工作或用户明确要求的跨工具协作;小问题回答和常规配置修改可直接处理。
主要能力:支持创建任务并保存用户原始消息全文与不可变任务契约;由 Manager 决定实现层级;Gateway 代为向 Worker 派发执行;预检可选,仅在有价值时做覆盖/证据检查;正常与复杂任务要求在新只读 Claude 会话中依据原始需求、修订、diff 路径与 CI 证据验收,Manager 据此决定接受、返工或升级;支持后续消息持久排队、状态查询、暂停、恢复、取消、崩溃后 reclaim 控制器以及放弃并标记终态;核验推送是否真正到达目标远程分支。所有请求 ID 幂等。
使用方式:控制器脚本 scripts/harness.py 支持 Linux,要求 Python 3.11+ 且环境中原生 CLI 已认证;安装技能不会安装这些工具或提供凭据。状态存放在 ~/.local/state/harness-orchestration/tasks/,无守护进程、不自动启动。示例命令:python3 H create TASK --original /absolute/message.txt --contract /absolute/contract.json;python3 H run TASK manager --request-id ID;python3 H run TASK worker --request-id ID;python3 H message TASK --message-id ID --file /absolute/follow-up.txt;python3 H status TASK、pause TASK、resume TASK、cancel TASK、recover TASK。契约格式参考 references/task-contract.example.json,角色说明在 references/ 下按需加载。模型 ID、effort、派发预算、Sol 每周刹车与自动返工上限在 models.json 中配置,不写在各提示词里。
适用场景:需要 Codex、Claude 等多工具分工的工程任务;需要独立审查与 CI 证据的验收流程;需要暂停、取消、崩溃恢复与推送核验的受控协作;有明确用户授权的提交/推送(合并、部署、发布需单独授权)。
限制:不改变用户默认交互模型或设置;Worker 与审查者不得演变为另一个 Gateway;不授予合并、部署、花费、发布或权限变更;派发前校验原始消息与契约哈希,旧无哈希任务不可静默升级;进程运行中看不到新消息,需暂停后再恢复派发;取消为终态且不回滚已有编辑或远程影响;外部动作非恰好一次,不确定执行不得自动重放;CLI 错误属于阻塞项,不得据以禁用钩子、信任检查、认证或沙箱;规划交接的 WIP 推送仅在契约允许且用户授权时可用;未提供使用量读数时 Manager 须显式判断受限派发是否合理;适配器无法验证任意粘贴的 CI 声明,审查者也非绝对可靠。