agile-metrics

スプリント指標

このスキルを使用して、スプリントの成果物から客観的な指標を抽出し、定量的なサマリーを作成します。

言語

成果物はユーザーの言語で作成します。正しい文法を使い、必要なアクセント記号や文字体系固有の文字も使用してください。ユーザーの言語が不明な場合は、出力を作成する前に確認してください。テンプレートは英語です。見出しと内容を適切な言語に翻訳してください。

プロジェクトルート

このスキルは、エージェントの現在の作業ディレクトリではなく、プロジェクトルート（作業を行うリポジトリ）からの相対パスで成果物を書き込みます。

• プロジェクト内から呼び出された場合は、このスキルに記載された相対パスを使用します。
• 別のディレクトリ（例：隣接するリポジトリ、または別の場所にあるプロジェクト）から呼び出された場合は、すべての成果物のパスの先頭に <project-root>/ を付けます。
• プロジェクトルートが不明確な場合は、書き込む前にハーネスの質問ツールを使ってユーザーに確認します。

プロンプト

CLAUDE.md / AGENTS.md のプロジェクト全体の規約（「Skill Prompting Conventions」）に従います。以下の判断が必要な箇所では、ハーネスの構造化質問ツール（Claude Code では AskUserQuestion、Codex では ask_user_question、OpenCode では question）を使います。選択肢として列挙できないパス、名前、値を尋ねる場合に限り、自由形式のテキストを使用します。

判断事項	構造化する理由	推奨する選択肢
期間	データセットを定義するため	前回のスプリント · 過去 N 日間 · カスタム期間
含める指標（複数選択可）	レポートに影響するため	ベロシティ · リードタイム · サイクルタイム · 不具合率 · カバレッジ · その他

自由形式で尋ねる項目（構造化ツールは使用しません）：

• カスタム指標の定義

一時停止なしモード：ユーザーがスキルの実行中に確認を求めない設定を明示的に有効にしている場合は、すべての構造化プロンプトを「未解決の質問」（または同等の項目）に記載し、処理を止めずに続行します。

目的

• スプリントのデータを具体的な数値にまとめます
• 印象ではなく事実に基づいて、振り返りやスプリントレビューを支援します
• スプリント間のパターン（改善または悪化）を特定します
• キャパシティや計画に関する意思決定を支援します

使用するタイミング

• スプリント終了時、レビューまたは振り返りの前
• チームがパフォーマンスについて話し合うためのデータを必要とするとき
• スプリントを比較し、傾向を特定するとき
• 申告されたキャパシティが適切に調整されているか疑問があるとき

収集する指標

デリバリー

• 計画したストーリー／項目の合計
• 完了した項目と未完了の項目の合計
• 完了率（%）
• スプリント中に追加された項目（スコープクリープ）
• 削除または延期された項目

品質

• スプリント中に見つかったバグ
• デリバリー後に見つかったバグ
• テストカバレッジ（測定可能な場合）
• 終了時点での Lint、型チェック、またはテストの失敗

フロー

• 記録されたブロッカー（件数と平均期間）
• ストーリーの開始から完了までの平均時間
• 「完了」から「進行中」に戻ったストーリー

プロセス

• 実施したステータス確認と予定していた回数
• 作成したステータス終了レポート
• オープンした課題とクローズした課題

プロセス

1. データを収集する

スプリントの成果物を確認します。

• スプリント計画（コミットした項目）
• 課題（オープン、クローズ、ブロック中）
• ステータス確認（ブロッカー、進捗）
• ステータス終了レポート（実施した検証）
• コミットと PR（変更量）

2. 指標を計算する

実際の数値をテンプレートに記入します。見栄えをよくするために丸めないでください。見た目よりも精度が重要です。

3. 傾向を分析する

過去のスプリントのデータがある場合は、次の点を比較します。

• 完了率は改善していますか？
• ブロッカーは減少していますか？
• スコープクリープは適切に管理されていますか？

4. サマリーを作成する

サマリーは、2 分で読める長さにします。

テンプレート

このスキルにある templates/metrics.md をベースとして使用します。

ルール

• メトリクスは振り返りのためのツールであり、評価のためのツールではありません。目標はプロセスの改善であり、人を評価することではありません。
• 数値を良く見せるために操作してはいけません。スプリントがうまくいかなかった場合は、そのことが数値に反映されるべきです。そのうえで、レトロで理由を話し合います。
• スプリントを比較する際は慎重に行ってください。休暇、外部要因による阻害、チームの変更など、状況が異なれば直接比較できません。
• 話し合いのないメトリクスには意味がありません。必ずレトロまたはレビューの場で提示し、単独のレポートとして提示してはいけません。

フローとの関係

flowchart LR
    A["/agile-sprint"] --> B[execution]
    B --> C["/agile-status"]
    C --> D["/agile-metrics"]
    D --> E["/agile-review"]
    E --> F["/agile-retro"]

スプリントメトリクスは /agile-review と /agile-retro にデータを提供します。スプリント中の追跡には /agile-status を使用してください。