非同期 Workplan フロー

SDD の詳細は、Spec-Driven Developmentを参照してください。

成熟度：定義中

概要

非同期 Workplan フローは、Duo Chat を使わずに、バックグラウンドでワークアイテムを詳細化し、その Workplanを生成します。これは、計画を繰り返し改善するための Duo Chat とライブプレビューの UI である、対話型ビルダーの以前の計画に代わるものです。1 人のユーザーがチャットセッションで 1 つの計画を作り込む代わりに、ユーザーは複数のフローを並列に開始し、ページを離れ、フローが入力を必要とするときに戻れます。コラボレーションは、ワークアイテムのディスカッションで行います。人の関与を参照してください。

エピック：WS-3：Workplan の構築。最初の作業計画のリファインメントループは完了しています。フォローアップは、ワークストリームで継続しています。

要件

1. エージェントは自ら提案します。 質問が生じても、フローは最初の不明点で止まりません。質問を一覧にし、それぞれに選択肢を示し、推奨する回答を述べます。これにより、エージェントの推奨を信頼するユーザーと、引き渡す前にレビューして繰り返し改善したいユーザーの両方に対応します。
2. 通知は必須です。 フローが入力を必要とするときは、ユーザーに通知する必要があります。
3. 調査は先に行います。 Workplan には可能な限り多くの調査結果を含め、低コストのモデルが実装でき、人が正確にレビューできるようにします。
4. 並列作業を考慮します。 別々のサブエージェントが担当すべきタスクがある場合は、Workplan に明記します。

フロー

sequenceDiagram
    actor User
    participant WI as Work item
    participant Rails as GitLab Rails
    participant DAP as Duo Agent Platform (workplan/v1)

    User->>WI: Select Plan
    WI->>Rails: WorkItemGenerateWorkplan
    Rails->>DAP: Create and start workflow (runs in CI)
    DAP->>WI: Read work item, comments, and project
    alt Decision needed
        DAP->>WI: Post clarifying question and mention user
        DAP-->>Rails: Status input_required (NEEDS_INPUT)
        User->>WI: Reply to question
        User->>WI: Select Continue
        WI->>Rails: WorkItemResumeWorkplan
        Rails->>DAP: Resume with eligible replies or best-assumptions instruction
    else More context needed
        DAP->>WI: Ask user to expand the description
        DAP-->>Rails: Pause at context_gate
        User->>WI: Update description and select Continue
        WI->>Rails: WorkItemResumeWorkplan
        Rails->>DAP: Resume research with the original goal
    end
    DAP->>WI: Write Workplan
    opt Readiness scoring available
        DAP->>WI: Read plan and context, write score and feedback
    end
    DAP-->>Rails: Status COMPLETED

1. ユーザーが Plan を選択します。フロントエンドは、WorkItemGenerateWorkplan ミューテーションを呼び出します。
2. Ai::DuoWorkflows::GenerateWorkplanService が、ワークアイテムのプロジェクトに対して workplan/v1 の基盤フローを開始します。フローは、Duo Agent Platform を通じて CI で実行します。目標には、対象のワークアイテムのみを指定します。AI Gateway にあるフローのシステムプロンプトで、計画の形式、曖昧さへの対応、質問するタイミングを定義します。
3. 調査では、GitLab API ツールを通じて要件、コメント、リポジトリの背景情報を収集し、その結果を計画担当に渡します。どちらの段階でも、明確化のための質問を投稿してユーザーにメンションし、input_required 状態で一時停止できます。
4. 明確化のための質問には、ユーザーが返信して Continue を選択します。フロントエンドは WorkItemResumeWorkplan を呼び出し、プロジェクトで Guest より上のロールを持つユーザーからの有効な返信を転送します。質問として含めるのは、質問のペイロードを持つフローノートのみです。進捗ノートや背景情報のリクエストは除外します。再開にスレッドの解決は必要なく、未回答の質問が再開を妨げることもありません。有効な返信がない場合、フローには、最も妥当と考えられる仮定に基づいて続行するよう指示します。
5. 説明に調査に十分な背景情報がない場合、どちらの段階でも context_gate に進みます。ユーザーは説明を追加し、Continue を選択します。再開サービスは元の目標を送信するため、調査は、返信がないことを推測の許可と見なすのではなく、更新されたワークアイテムを読み取ります。これは、マージリクエスト 257208で実装されています。
6. 計画担当は Workplan を書き込み、完了のコメントを投稿します。準備状況のスコアリングが利用可能な場合、同じフローがスコアリング段階に進み、スコアとフィードバックを書き込みます。

ウィジェットは、generationStatus を通じて進捗を表示します。値は、NOT_STARTED、GENERATING、NEEDS_INPUT、COMPLETED、CANCELED、FAILED のいずれかです。キャンセルは失敗と区別します（マージリクエスト 258021）。実行を開始または再開すると、そのセッションを Duo ドロワーで開きます。

ライフサイクルと安全性

• ワークアイテムごとに単一のフロー：1 つのワークアイテムには、終了状態にない Workplan フローを 1 つだけ保持できます。排他的なリースにより、2 つの同時リクエストが両方ともフローを開始することを防ぎます。
• ワークアイテム間でのフローの同時実行：異なるワークアイテムのフローは同時に実行できるため、ユーザーは複数のワークアイテムを並列に詳細化できます。
• 権限：ワークアイテムのミューテーションは update_work_item を確認しますが、CI フローの開始には、加えて create_duo_workflow_for_ci（現在は Developer 以上）が必要です。再開時には、ワークアイテムの更新権限とプロジェクトでのリモートフローの利用可否を確認し、元のフロー所有者の ID を維持します。これらの境界は、まだ整合していません。ロールポリシーは、Issue 634208で追跡しています。
• 回答の資格：再開サービスは、Guest 以下のロールからの返信を除外し、スレッドの解決状況にかかわらず有効な返信を収集します。これは、スレッドの解決状況を使う質問カウンターとは異なります。Guest による回答について両者を整合させる作業は、Issue 631546で追跡しています。
• プロジェクトのワークアイテムのみ：フローは CI で実行するため、グループレベルのワークアイテムには対応していません。
• ツールの承認：フローが使用するツールは事前に承認する必要があるため、フローはツールの承認のために停止しません。承認するツールを限定するために、専用の Workplan ツールが必要になる可能性があります。
• 人の入力を求めるゲート：調査、計画、背景情報の各ゲートでは、外部でのやり取りを使います。ユーザーがワークアイテムで操作し、明示的に再開します。これらは、セッションドロワーでのツール呼び出しの承認や却下を求めるリクエストではありません。
• 可観測性：フローには LangSmith による計測を組み込んでいます。追跡イベントは、Issue 631134で追跡しています。

未完了の作業

• Workplan の調査を、計画担当が委任するサブエージェントにする
• 起動時に未解決の質問をフローに渡す
• 起動したユーザーを目標に含める
• Duo Chat で作成したワークアイテムに対して計画を自動的に開始する
• フローのコメントを解決可能なディスカッションとして投稿することと、最初の返信前にディスカッションを解決できるよう、ワークアイテムの UI を対応させること

決定

ページのソースコードを見る - ページの編集 - please contribute.