agent-kanban

Agent Kanban v2 の割り当て済みエージェント

Agency Agent にすでに付与されている Realmroot ID を使用してください。削除された ak CLI を実行したり、AK 認証情報、Machines、ランタイム Sessions、メールボックスの状態、署名キー、Agent ロールを作成したりしないでください。

タスクのライフサイクル

1. 汎用の Toolbox リソース操作で Task を読み取ります。

   realmroot toolbox get agent-kanban/tasks/<task-id> --include --json
   

   返された表現を正としてください。Task の PATCH 操作では独自に楽観的同時実行制御が行われます。409 が返された場合は、再試行するか判断する前に Task を再読み込みしてください。

2. 対象のリポジトリを変更する前に、Task を取得します。

   realmroot toolbox post agent-kanban/tasks/<task-id>/claims --json
   

   取得が拒否された場合は、リポジトリを変更せずに停止してください。Task に現在割り当てられている、検証済みの Realmroot Agent アクターのみが Task を取得できます。

3. 役立つ進捗を Task Note リソースとして記録します。

   realmroot toolbox post agent-kanban/tasks/<task-id>/notes \
     --content-type application/json \
     '{"detail":"Implemented the parser and verified malformed input."}' --json
   

   Realmroot Toolbox v0.5.0 以降では、必要な冪等性キーが生成され、この呼び出しの一時的な再試行でも同じキーが再利用されます。明示的な Idempotency-Key を指定するのは、結果が不明のままになった以前の呼び出しで使用したキーが分かっており、そのキーを使って復旧する場合に限ってください。

4. 作業を実施し、変更した動作と境界を証明するための最小限のチェックを実行します。レビュー可能なブランチでリポジトリの作業を行ってください。認証が必要な GitHub コマンドには Realmroot の GitHub Resource を使用します。たとえば、realmroot exec github -- git push や realmroot exec github -- gh ... を使用します。

5. 結果、実施した正確なチェック、残っているブロッカーがあればその内容を記載した最終ノートを投稿し、Task をレビューに提出します。

   realmroot toolbox get agent-kanban/tasks/<task-id> --include --json
   realmroot toolbox patch agent-kanban/tasks/<task-id> \
     --content-type application/merge-patch+json \
     '{"status":"in-review","pullRequestUrl":"https://github.com/owner/repo/pull/123"}' --json
   

   Task にプルリクエストがない場合は、明示的に空の表現を提出します。

   realmroot toolbox patch agent-kanban/tasks/<task-id> \
     --content-type application/merge-patch+json \
     '{"status":"in-review"}' --json
   

Agency の作業 Session が終了する前に、取得した Task をレビューに提出する必要があります。作業を続行できない場合は、最終 Task Note でブロッカーを説明し、現在の状態を提出してください。非アクティブな Session が in_progress として残らないようにしてください。

公開コマンド

AK リソースには、Toolbox の汎用動詞先行操作を使用してください。

realmroot toolbox get agent-kanban/tasks/<task-id> --json
realmroot toolbox get agent-kanban/tasks/<task-id>/notes --json
realmroot toolbox post agent-kanban/tasks/<task-id>/notes \
  --content-type application/json @note.json --json
realmroot toolbox post agent-kanban/tasks/<task-id>/claims --json
realmroot toolbox patch agent-kanban/tasks/<task-id> \
  --content-type application/merge-patch+json \
  '{"status":"in-review"}' --json
realmroot toolbox agent-kanban task wait <task-id> in-review --wait-seconds 25 --json

task wait は、AK が生成する唯一のリソース先行型の便利コマンドです。削除された task claim、task release、task review、task reject、task complete、task cancel エイリアスは使用しないでください。

サーバーコントラクトのデプロイ後も Toolbox に削除済みのエイリアスが表示される場合は、キャッシュされた操作一覧を一度更新してください。

realmroot toolbox sync agent-kanban

生成されたコマンドのリクエスト形式が不明な場合は、フラグを推測せず、コントラクトを確認してください。

realmroot toolbox patch agent-kanban/tasks/<task-id> --generate-body

割り当てによって、Enbor Session が直接開始されます。初期プロンプトには Task ID と正確な AK Context ID が指定されます。すべての Toolbox 操作にその Context を使用し、操作を開始する前に Task を読み取ってください。自身に付与された Agent ID を使って Task を取得してください。Session ID を書き込んだり、推測したりしないでください。AK の Session アノテーションには作成時のレシートが記録され、Claim には検証済みの実行 ID が記録されます。

レビューが却下されると、同じ Session にフィードバックが送られます。Task と Notes を再読み込みし、既存の Claim のもとで作業を続け、完了したら新たにレビューを提出してください。完了とキャンセルによって、関連付けられた Session は終了します。受信トレイのメッセージは、起動や作業再開の手段ではありません。

個人の Owner ID が user:<subject-id> としてエンコードされた過去の業務参照では、Context ID は <subject-id> です。組織の Owner ID は変更せずに使用してください。遅延スケジューリングは実装されていません。

障害への対応

• 401 または無効な DPoP：Realmroot の権限を利用できません。代替の認証情報を作成しないでください。
• 403：検証済みのアクターまたは付与された権限に必要な権限がありません。リクエスト本文を変更しても権限は付与されません。
• 409：影響を受けたリソースを再読み込みし、現在の状態に基づいて判断してください。競合する遷移を確認せずに再実行しないでください。
• 412：条件付き削除で古いリソース ETag が使用されました。削除が引き続き適切か判断する前に再読み込みしてください。
• 429 または 503：Retry-After に従ってください。Task PATCH の結果が不明な場合は、再試行するか判断する前に現在の表現を再読み込みしてください。Claim の作成は冪等性キーによって保護されています。