mcpField
A
ak-plan

ak-plan

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

ak-plan について

ak-planは、承認された作業をAgent KanbanのBoardとTaskに分解し、Agentを割り当ててレビューまで進行を管理するスキルです。独立してレビューできる境界、依存関係、受け入れ条件に沿って作業を整理します。

主な機能

  1. 01既存のBoard、リポジトリ、Taskの確認
  2. 02アーキテクチャ、担当範囲、依存関係の定義
  3. 03確認用の計画全体のプレビュー
  4. 04Board、リポジトリ、割り当て済みTaskの作成
  5. 05進捗の追跡と提出物のレビュー

活用シーン

  1. 01プロジェクト要件のレビュー可能なTaskへの分解
  2. 02依存作業と並行作業の調整
  3. 03成果の追跡とブロッカーの報告

インストール

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

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

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

同梱ファイルagents/openai.yaml

詳細

AK Plan

作成前に計画する

分割する前に、リポジトリと既存の AK リソースを確認します。

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

アーキテクチャの方針、共有コントラクト、責任範囲、依存関係グラフを定義します。時系列の手順や役職ではなく、個別にレビュー可能な動作またはモジュールの境界に基づいて作業を分割します。最後にすべてをまとめた QA タスクを設けるのは避けてください。各 Task は、その実装と検証を担当します。

完全な Board／Task のプレビューをユーザーに提示し、作成前に確認を得ます。各 Task の目標、担当者、リポジトリ、依存関係、受け入れ確認項目をすべて含めてください。

リソースを作成する

Board または Repository は、まだ存在しない場合にのみ作成します。

realmroot toolbox post agent-kanban/boards --content-type application/json @board.json --json
realmroot toolbox post agent-kanban/repositories --content-type application/json @repository.json --json

schedulable: true を返す、利用可能な Agent を選択します。

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

選択した Agent の subject を assignedTo として使用します。適切な Agent が存在せず、呼び出し元に Agent をプロビジョニングする権限がある場合は、agent-kanban/agents を通じて作成します。

承認された各作業項目について、担当者を割り当てずに 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 を指定します。

実際の前提条件は dependsOn にエンコードします。ファイルまたはコントラクトが重複する Task は統合するか、順序付けします。並列実行するのは、互いに独立した Task のみにしてください。

実行とレビュー

作成後、ユーザーが停止を求めない限り、すべての Task が終端状態になるまで続行します。継続カーソルを使用して、待機時間に上限を設けます。

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

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

受け入れの証拠または実装が不十分な場合は却下し、Task が再び in-review 状態になるまで待ちます。要求された成果が証明された場合にのみ完了とします。検証済みのレビュアーの主体が Task の assignedTo と同じ場合は、いずれの判断も試みないでください。別の権限を持つ主体がレビューする必要があります。

前提となる Task が完了したら、その依存 Task を再評価します。 最終的な Task の状態、レビュー結果、未解決の外部ブロッカーを報告します。

コメント

Markdown 対応