SuperAPI AI 工具集

worker

智能体与模型

查看项目

更新于 10-15 23:57

技能介绍

用途:该技能用于 tmux 版 OMX 团队中的 worker 角色,规范 worker 与 leader 之间的确认、邮箱通信和任务生命周期管理。仅当会话以 OMX Team worker 身份启动时使用;行动前需阅读 AGENTS.md#durable-runtime-invariants-canonical-ssot,其中定义了持久化所有权与协调边界。

前置条件:需要环境变量 OMX_TEAM_WORKER=<team-name>/worker-<n>。技能文件按顺序从以下首个存在路径解析:${CODEX_HOME:-~/.codex}/skills/worker/SKILL.md、~/.codex/skills/worker/SKILL.md、<leader_cwd>/.codex/skills/worker/SKILL.md、<leader_cwd>/skills/worker/SKILL.md。Team 状态根按 OMX_TEAM_STATE_ROOT、worker 身份中的 team_state_root、config/manifest 中的 team_state_root、本地 .omx/state 的顺序解析。

主要步骤:拆分环境得到 teamName 与 workerName;开始任务前先发送启动 ACK:omx team api send-message --input '{"team_name":"<teamName>","from_worker":"<workerName>","to_worker":"leader-fixed","body":"ACK: <workerName> initialized"}' --json。读取 <team_state_root>/team/<teamName>/workers/<workerName>/inbox.md,取第一个未被阻塞的分配。读取 <team_state_root>/team/<teamName>/tasks/task-<id>.json;API 使用纯数字 task_id(如 "1")。编辑前先认领:omx team api claim-task --input '{"team_name":"<teamName>","task_id":"<id>","worker":"<workerName>"}' --json。执行分配的工作,不要直接写任务生命周期字段。通过生命周期 API 完成或失败,从 in_progress 到 completed 或 failed:omx team api transition-task-status --input '{"team_name":"<teamName>","task_id":"<id>","from":"in_progress","to":"completed","claim_token":"<token>","result":"<evidence>"}' --json。仅在需要把被阻塞任务重新排队为 pending 时使用 release-task-claim。检查并确认邮箱消息:omx team api mailbox-list --input '{"team_name":"<teamName>","worker":"<workerName>"}' --json 与 omx team api mailbox-mark-delivered --input '{"team_name":"<teamName>","worker":"<workerName>","message_id":"<MESSAGE_ID>"}' --json。状态转换后写入空闲状态:<team_state_root>/team/<teamName>/workers/<workerName>/status.json,内容为 {"state":"idle","updated_at":"<ISO timestamp>"}。

退出与证据:完成证据需包含任务 id、变更产物、执行的验证及任何阻塞项。ACK、任务状态转换、邮箱确认和状态写入必须能通过 Team API/状态文件观察到。关闭时按 lead 的 inbox 指示执行,并在退出前写入所需的关闭确认。

限制:资料未提供该技能之外的额外功能、收费、平台或效果信息。