Workplan

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

成熟度：成熟

概要

Workplan は、ワークアイテムに添付する Markdown ドキュメントです。SDD フローの中心的なアーティファクトであり、人とエージェントが形作り、その後、下流で Duo Developer や他のエージェントが使用します。

ワークアイテムの説明（仕様）には、なぜ、何を行うかを記載します。Workplan に記載するのは、どのように行うかのみです。なぜ、何を行うかの変更は説明に記載し、Workplan はそれに従います。Workplan がどのように行うかに重点を置くよう、生成プロンプトを更新する作業は、Issue 630891で追跡しています。

エピック：WS-2：仕様からコードまでのユーザージャーニーの構築

ユーザードキュメント：Workplan

名称

計画の名称は Workplan で、1 語で表記します。親ウィジェットの名称は Implementation です。AgentPlan は旧コード名で、今もバックエンドと GraphQL に残っています。API の互換性、データベースのテーブル、オブジェクトストレージのパスを含むバックエンドの名称統一は、Issue 630474で追跡しています。

データモデル

Workplan は、別のテーブル work_item_agent_plans に保存し、work_item_id でワークアイテムに結合します。Issue のテーブルは大きすぎるため、直接拡張できません。Workplan の内容と準備状況スコアのフィードバックはオブジェクトストレージに保存できるため、読み取りにネットワークの往復が必要になることがあります。内容の存在のみを確認したい場合にその往復を避ける作業は、Issue 616229で追跡しています。

このテーブルには、ワークアイテムで AI 計画が有効かどうか（ai_planning_enabled）と、準備状況スコアも保存します。

API サーフェス

Workplan は、GraphQL ウィジェット型 WorkItemWidgetAgentPlan を通じて公開します。主なフィールドは、次のとおりです。

非同期フローは、WorkItemGenerateWorkplan と WorkItemResumeWorkplan の各ミューテーションで開始および再開します。非同期 Workplan フローを参照してください。

Workplan は、MCP ワークアイテムツールを通じても読み書きできるため、外部のエージェントやツールが利用できます。

ウィジェット

Implementation ウィジェットは、デフォルトでは非表示です。ユーザーが Plan を選択すると、ワークアイテムの AI 計画が有効になります。その後、ウィジェットには次のものを表示します。

• Workplan のステータス。未作成、ワークアイテムのレビュー中、生成中、入力待ち、レビュー準備完了、キャンセル、失敗のいずれかです。
• スコアが存在する場合の準備状況のレベル。
• フローが入力を待っている間の、未解決の質問の件数と質問間の移動機能。
• Workplan の表示、編集、再生成、削除、および Implement のアクション。

フローを開始または再開すると、そのセッションを Duo ドロワーで開きます。これには、Plan、Generate、Regenerate、Try again、Continue が含まれます。生成した Workplan は要求されたときにのみ開くため、バックグラウンドの実行が完了してもユーザーの作業を中断しません。ステータスインジケーター上の、セッションへの直接のショートカットは、Issue 631233で引き続きフォローアップとなっています。

Workplan はサイドパネルで開きます。ユーザーは、必要に応じてテンプレートを使用し、Workplan を手動で作成することもできます。Workplan のテンプレートは、ファイル名が .plan で終わる説明テンプレートです。

ユーザーが AI によるフローを開始した場合にのみ Implementation ウィジェットを表示することは、Issue 605174で決定しました。計画を有効にした後は、無効にできません。

生成

Plan は、非同期の workplan/v1 フローを開始します。このフローは、ワークアイテムを詳細化し、必要に応じて明確化のための質問をして、Workplan を書き込みます。非同期 Workplan フローと人の関与を参照してください。

権限と機能の利用制御

1. ライセンス対象機能：Workplan は Premium と Ultimate ティアで利用でき、ai_workflows のライセンス対象機能を再利用します。
2. ワークアイテムタイプ：Issue とタスクです。子タスクを持つ Issue も含みます。
3. ユーザーの権限：Workplan の作成と編集には、ワークアイテムを更新する権限が必要です。生成時には CI フローの権限 create_duo_workflow_for_ci も確認し、現在は Developer 以上が必要です。フロントエンドとワークアイテムのミューテーションは、引き続き update_work_item を確認するため、アクションが表示されても、そのユーザーが実行できるとは限りません。生成、再開、実装の権限の整合は、Issue 634208で追跡しています。
4. Duo の利用可否：Workplan の生成には、Duo Agent Platform と workplan/v1 の基盤フローが利用可能である必要があります。基盤フローが利用できないときに Plan ボタンを無効にすることは、Issue 629825で予定しています。ボタンは、まだフローの利用可否を確認しません。

未完了のフォローアップは、次のとおりです。

• Workplan の内容をオンデマンドで読み込み、ウィジェットの状態には内容の存在を示すフィールドを使う
• Workplan の作成と更新のタイムスタンプを表示する
• Plan ボタンから実装に直接進めるようにする
• クローズされたワークアイテムでの計画コントロールの動作。Implement ボタンは、クローズされたアイテムではすでに非表示です。残る計画コントロールは、別のフォローアップです。
• hasAgentPlan の型ポリシーを、widgets フィールドの廃止後に追加する

決定

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