タスク状態遷移ガイド (Task Status Transition Guide)

このドキュメントでは、GIIPシステムにおいてAIエージェントが実行するタスクの各状態が何を意味し、どのようなプロセスを経て変化し、どこに記録されるかを説明します。

1. 概要

タスク状態管理は、分散されたAIエージェントが連携するための重要なメカニズムです。すべての状態変化はデータベースではなくファイルベースで行われ、特定のPowerShellスクリプトがこれらのファイルを読み取り、修正することで状態が遷移します。

2. 状態遷移フロー (Transition Flow)

stateDiagram-v2
    [*] --> Pending : [発生] Orchestratorがファイルを生成
    Pending --> In Progress : [開始] launch_subsession.ps1を実行
    In Progress --> Completed : [完了] エージェントの作業と検証が完了
    Completed --> [*] : [終了] MASTER_ISSUE_LIST.mdに反映

giipdb/dispatch/

launch_subsession.ps1

launch_role.ps1

Status

3. 技術的な仕組み (Technical Mechanics)

3.1 状態の認識 (

check_status.ps1

)

• 探索:

  giipdb/dispatch/

  フォルダ内の

  TASK_*.md

  ファイルをスキャンします。
• パース: ファイル上部の

  **Status**:

  パターンを正規表現で探し、現在の状態を抽出します。

3.2 状態の更新 (

launch_subsession.ps1

)

• 自動化:

  Pending

  状態のタスクを発見すると、ファイルの内容を読み取り、

  -replace

  を使用して

  **Status:** In Progress

  に強制的に置換します。
• 注意: このプロセスはファイルの物理的な修正を伴うため、エンコーディングエラーや正規表現のマッチング失敗時にファイル内容が破損する恐れがあります。

3.3 スクリプト別の違い

• launch_subsession.ps1

  : バックグラウンドエージェントを即座に実行し、ファイルを直接修正します。

• launch_role.ps1

  : ユーザーとの対話のためにファイルを修正し、クリップボードにプロンプトを生成します。

4. 記録および同期ポイント

タスクの状態が変化した際、エージェントは次の2箇所に記録を残す必要があります：

1. 個別タスクファイル:

   giipdb/dispatch/TASK_*.md

   (Source of Truth)
2. マスターリスト:

   giipdb/docs/00_Master/MASTER_ISSUE_LIST.md

   (管理ダッシュボード)

5. トラブルシューティング

• 状態が変わらない: ファイル上部の

  **Status:**

  フォーマットが正確か確認してください（タイポや空白に注意）。
• 内容の消失: ファイルのエンコーディングが

  UTF-8 BOM

  でない場合、スクリプト処理中に内容が文字化けしたり破損したりすることがあります。必ずエンコーディングを確認してください。

最終更新日: 2026年3月20日