mcpField
W
worker

worker

github.com/yeachan-heoエージェントワークフロー33.7k137 回インストール今日更新
リポジトリ

worker について

workerは、OMX Teamのワーカー向けにタスクの取得、実行、連携、終了を案内するスキルです。Team APIで割り当てと状態を更新し、確認可能なステータスと完了証跡を残します。

主な機能

  1. 01OMX Teamワーカーセッションが前提
  2. 02Team APIで起動を確認
  3. 03最初の未ブロック割り当てを取得
  4. 04ライフサイクルAPIでタスク状態を更新
  5. 05メールボックスを確認してメッセージを受領確認

活用シーン

  1. 01OMX Teamで割り当てられたタスクの取得
  2. 02変更成果物と検証を含む完了報告
  3. 03作業中に届いたメールボックス指示への対応

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/yeachan-heo/oh-my-codex --skill worker

インストール後、Claude Code で/workerを入力して読み込まれたか確認します。

詳細

Worker Skill

When to use

OMX Team のワーカーとしてセッションが開始された場合にのみ使用してください。行動する前に AGENTS.md#durable-runtime-invariants-canonical-ssot を読んでください。そこに永続的な所有権と調整の境界が定義されています。

Inputs and preconditions

  • 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、ワーカーの ID にある team_state_root、config/manifest の team_state_root、ローカルの .omx/state。

Operational steps

  1. 環境を teamName と workerName に分割し、タスク作業の前に開始 ACK を送信してください: 
    omx team api send-message --input '{"team_name":"<teamName>","from_worker":"<workerName>","to_worker":"leader-fixed","body":"ACK: <workerName> initialized"}' --json
  2. <team_state_root>/team/<teamName>/workers/<workerName>/inbox.md を読み、最初にブロックされていない割り当てを取得してください。
  3. <team_state_root>/team/<teamName>/tasks/task-<id>.json を読んでください。API では、数値のみの task_id（例: "1"）を使用します。
  4. 編集の前にクレームしてください: 
    omx team api claim-task --input '{"team_name":"<teamName>","task_id":"<id>","worker":"<workerName>"}' --json
  5. 割り当てられた作業を行ってください。タスクのライフサイクルフィールドを直接書き込まないでください。
  6. ライフサイクル 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
    release-task-claim は、ブロックされたタスクを pending に戻す場合にのみ使用してください。
  7. メールボックスのメッセージを確認し、確認応答してください: 
    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
  8. 遷移の後に、アイドル状態を書き込んでください: <team_state_root>/team/<teamName>/workers/<workerName>/status.json に {"state":"idle","updated_at":"<ISO timestamp>"} を書き込みます。

Exit and evidence

完了の証拠には、タスク ID、変更された成果物、実施した検証、およびブロッカーがあればそれを明記してください。ACK、タスクの遷移、メールボックスの確認応答、ステータスの書き込みは、Team API/状態ファイルを通じて確認できる必要があります。シャットダウン時には、リーダーの inbox の指示に従い、終了前に必要なシャットダウンの確認応答を書き込んでください。

コメント

Markdown 対応