mcpField
A
ak-task

ak-task

github.com/saltboエージェントワークフロー493140 回インストール6 週間前に更新
リポジトリ

ak-task について

ak-task は、Realmroot Toolbox を通じて agent-kanban のタスクを作成、割り当て、監視、レビュー、キャンセルするエージェントスキルです。作成前の内容プレビュー、回数を限定した待機、重要な更新前の状態再取得を重視します。

主な機能

  1. 01ボード、リポジトリ、タスク、エージェントの確認
  2. 02作成前のタスク内容プレビュー
  3. 03タスク作成とエージェント割り当て
  4. 04カーソルを使った状態変化の待機
  5. 05ノート確認と提出物の検証
  6. 06タスクのレビューまたはキャンセル

活用シーン

  1. 01スケジュール可能なエージェントへのタスク準備と割り当て
  2. 02無制限のポーリングを避けた進捗確認
  3. 03承認または却下前の提出物検証

インストール

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

$npx skills add https://github.com/saltbo/agent-kanban --skill ak-task

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

同梱ファイルagents/openai.yaml

詳細

AK Task

作成前

汎用の Toolbox 読み取り操作を使って、Board、Repository、既存の Tasks を特定します。

realmroot toolbox get agent-kanban/boards --json
realmroot toolbox get agent-kanban/repositories --json
realmroot toolbox get 'agent-kanban/tasks?boardId=<board-id>' --json

利用可能な Agents を確認します。

realmroot toolbox get 'agent-kanban/agents?schedulable=true' --json

選択した Agent の subject を assignedTo として使用します。適切な Agent が存在せず、プロビジョニングが許可されている場合は、agent-kanban/agents を通じて作成します。

あいまいな点を解消し、作成前に Task の正確なプレビューをユーザーに提示します。プレビューには、タイトル、Board、Repository、担当者、説明、依存関係、受け入れチェックを含める必要があります。

作成と割り当て

担当者未割り当ての Task を作成し、その後 assignedTo フィールドを更新します。

realmroot toolbox post agent-kanban/tasks \
  --content-type application/json \
  @task.json --json

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

Realmroot Toolbox は、必要な冪等性キーを生成し、この呼び出しの一時的な再試行で同じキーを再利用します。前回の呼び出しの結果が不明なままの場合に、そのときの既知のキーを使って復旧するときに限り、Idempotency-Key を明示的に指定します。

Task の本文では、boardId、title、description、repositoryId、labels、dependsOn、createdFrom、scheduledAt などの lowerCamelCase のリソースフィールドを使用します。Task の作成時には scheduledAt を省略してください。遅延スケジュールには対応していません。PATCH の結果が不明な場合は、再度書き込む必要があるか判断する前に Task を再読み込みしてください。別の Task を作成してはいけません。

監視

上限付きの task wait 呼び出しを使用し、返されたカーソルを次の呼び出しに引き継ぎます。無制限のポーリングループを作成してはいけません。

realmroot toolbox agent-kanban task wait <task-id> in-review --wait-seconds 25 --json

意味のある状態変更のたびに、汎用の GET 操作を使って Task と Notes を確認します。キャンセルされた Task は終端状態です。

レビュー

Task が in-review になったら、提出された作業を検証し、レビューの判断を行う前に 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-progress","statusReason":"Describe the required correction"}' --json

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

受け入れの証拠または実装が不十分な場合は却下し、新しい in-review の Task 状態になるまで待ちます。依頼された成果が証明された場合に限り完了とします。検証済みのレビュー担当者アクターが Task の assignedTo と同じ場合は、いずれの判断も行ってはいけません。別の承認済みプリンシパルがレビューする必要があります。

終端状態ではない Task をキャンセルするには、同じ Task のパッチ操作を使います。

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

コメント

Markdown 対応