用途:作为 Horde 任务内的工作节点(worker)正确协作,或将外部代理、脚本作为 worker 接入任务。多个 worker 可在同一仓库的不同 Git worktree 中并行编辑,本技能给出防止结果被破坏的强制协调规则。如果你是提交并监督工作的个人代理,而非亲自执行,应改用 horde 技能。
判断是否为 worker:为你配置了带 Horde 工具的协调 MCP 服务器、环境中设置了 HORDE_WORKER_TOKEN,或收到的指令包含目标、验收标准、写入范围和 worktree 路径。该令牌限定为 worker 作用域,并强制任务与 worker 绑定到你自身身份。
操作顺序(跳过第 2、3 步会导致第 4 步失败):先用 read_context、pending_questions、read_messages 读取上下文,注意原始目标与强制约束优先于较窄的任务说明;随后 register_workspace 声明运行时分配的 worktree;再用 claim_paths 认领将要编辑的仓库相对路径或目录前缀(. 表示整个仓库),重叠认领会被告知归属者。需要他人的路径时发消息请求 transfer_claim,只有转移才真正改变归属。在 worktree 内工作、测试并提交,未提交的工作不会被集成。最后用 set_worker_status 如实汇报 idle、working、blocked、stopped。
提问:信息缺失时不要臆造或擅自改变契约,用 request_question 提交问题、证据与建议,human_only 为 true 表示需人工决定。这会阻塞你的任务但不影响其他分支。
通信:用 send_message 发消息(id 可自定义以保证重试安全,destination 可为 worker id、group:NAME 或 task),actionable: true 可唤醒空闲的受管 worker。编辑前和宣布完成前都要读邮件,并用 acknowledge_messages 明确逐收件人确认。
记录与委派:可用 add_knowledge、put_artifact、reuse_artifact 记录决策与产物,worker 不能将自身输出标为 verified。任务确为多个独立部分时可用 delegate_task、list_children、integrate_child 创建受限子任务;子任务报告成功不算证明,须由 integrate_child 导入提交并运行校验。
接入外部代理:先执行 horde call register_worker '{"task":"TASK_ID"}' 获取 id 与 token,将 token 作为协调 MCP 桥(horde mcp)环境中的 HORDE_WORKER_TOKEN 交给 harness,再注册其独立 worktree 并在编辑前取得认领。切勿将个人代理桥给 worker。
限制:写入未认领路径会被拒绝,越界改动会被扣留而不集成;不得擅自扩大认领范围;不得编造 id;不得凭他人或子任务的说法标记完成;不得自我认证输出。消息推送在已运行的 CLI harness 会话中非推送式,本轮实现中由 read_messages 与下次调用上下文获取。