Duo Agent によるエピック要約

関連する Issue、コメント、ステータスに基づいてエピックステータスを要約するプロセス。

概要

このドキュメントでは、進行中のエピックについて週次サマリーを生成するプロセスについて説明します。

問題

特定のエピックの現在のステータス、健全性、および次のステップを効率的に確認することが難しい場合があります。

解決策

標準化されたプロンプトで Duo Agent を使用して、チームにも適切な形式でサマリーを生成します。サマリーは特定の時点でどのような状況だったかのスナップショットとしても機能します。

進行中の Issue とそのワークフローステータスの表を作成する
ブロッカーや障害を表示する
以前のサマリーで見逃したステップを指摘する
ウェイトによる完了進捗率を計算する
関係者に通知する

プロセス

ステップ 1: 週次 DRI 更新

DRI を務めている各エピックについて、エピックの URL をプロンプトに追加して実行します。

エピック要約プロンプト（クリックして展開）

このエピックのエピック要約マークダウンテンプレートを記入し、更新のトップレベルコメントを作成してください。

SUMMARY セクションには、このエピックの最後の更新サマリー以降に何が起こったかについての説明的な更新を提供してください。次のステップが達成されたかどうか、または達成されなかった理由を評価するために、以前の更新からの次のステップを評価してください。

COMPLETE セクションは、すべての Issue ウェイトの割合としての完了済み Issue の総ウェイトである必要があります。

STATUS は「エピックの健全性ステータスは何ですか？」に答えるものです。スコープの増加（より多くの Issue が追加され、プロジェクトの途中で大幅な総ウェイト増加）、遭遇した障害やブロッカー、期限日の達成リスクに基づいて、このエピックの健全性ステータスを評価してください。(:large_green_circle: On track  | :large_yellow_circle: Needs Attention  | :red_circle: At risk) のみを使用してこの質問に答えてください。

DUE_DATE_AT_RISK は「期限日はリスクがありますか？」に答えるものです。(:large_green_circle: On track  | :large_yellow_circle: Needs Attention  | :red_circle: At risk) のみを使用してこの質問に答えてください。

NEXT_STEPS セクションには、このエピックを完了に向けて進める次のステップについてカバーしてください。

NOTIFY セクションは、このサマリーを読むことに興味があるユーザーのリストである必要があります。形式は "@user, @user2, etc" のようにしてください。

障害、リスク、ブロッカーのセクションには、遭遇したブロッカーと障害の追加サマリーを提供してください。障害がない場合はセクション全体を削除してください。

残作業のセクションは、Issue、ウェイト、ステータスの見出しを持つ表である必要があります。更新を行う時点での Issue の状態のスナップショットです。スコープが増加し、追加の Issue が追加されるなど、特に時間の経過とともに進捗を確認する場合に役立ちます。進行中で完了していない Issue のみを含めてください。ステータス列には Issue の現在のワークフロータグを含める必要があります。

テンプレートは以下の通りです

# ステータス更新 - 2025年1月1日

## :clipboard: 要約
<!-- 最後の更新以降に起こったことの簡潔で説明的な更新。更新では、以前の更新からの次のステップが達成されたかどうか、または達成されなかった理由も評価してください -->

1. **完了:** xx%（xx% からの変化）<!-- これはウェイトによる完了率である必要があります -->
1. **ステータス:** :large_green_circle: On track  | :large_yellow_circle: Needs Attention  | :red_circle: At risk
1. **更新:**

## :construction: 障害、リスク、ブロッカー
<!-- 遭遇したブロッカーと障害の追加サマリー。障害がない場合はセクション全体を削除してください -->
1.
1.

## :todo: 残作業
<!-- 更新を行う時点での Issue の状態のスナップショット。スコープが増加し、追加の Issue が追加されるなど、特に時間の経過とともに進捗を確認する場合に役立ちます -->

| Issue | ウェイト | ステータス |
|-------|--------|--------|
| <!-- Issue リンクに + を使用してください --> | | ~"workflow::verification" |
|  | | ~"workflow::in dev" |
|  | | ~"workflow::in review" |

* 総 Issue 数:
* 総クローズ済み Issue 数:
* 見積もり済み Issue の総ウェイト:
* 完了済み Issue の総ウェイト:
* 現在、`x` 件の未見積もり Issue を含む Issue ウェイトの `xx%` が完了しています。

## 🎯 次のステップ
<!-- 次の期間（更新のケイデンスに合わせて）に完了する次のステップ -->
1.
1.

## 通知
<!-- このアップデートを受け取るべき人をタグ付けしてください - PM/EM、チームのエンジニア、ステークホルダー -->
cc: `@...`