convert-points-to-time

convert-points-to-time

ストーリーポイントを実時間に換算するスキル。レートは実行時にユーザーが入力する。

換算モデル

• 入力: 1pt = X 時間
• 出力: Story単位、Epic単位の時間集計
• 標準偏差も時間換算（PERTモードのStoryのみ）

実行手順

1. レートの取得

AskUserQuestion で以下を確認:

• 「1ストーリーポイントを何時間として換算するか？」
• ヒント表示:
  • 例1: 「2pt = 半日 → 1pt = 4時間」
  • 例2: 「8pt = 1週間（40時間） → 1pt = 5時間」
  • 例3: 「ベロシティから算出 → 過去スプリントの完了pt合計 / 投入時間合計」

設定ファイルに points_to_hours が保存されている場合、それをデフォルト値として提示し、 「設定値を使う / 別の値を入れる」を選ばせる。

2. 対象の特定

引数または対話で対象を決定:

• 単一Storyファイル
• "all" → docs/plans/stories/*.md 全件
• "epic " → 該当Epic配下のStory全件

各Story mdを Read で読み込み、フロントマターから以下を取得:

• points
• pert.expected, pert.stddev
• estimation_mode

3. 換算計算

各Storyについて:

• 期待時間: points × rate
• PERTモードの場合:
  • 期待時間: pert.expected × rate
  • 標準偏差時間: pert.stddev × rate
  • 信頼区間: 期待時間 ± 標準偏差時間 を表示
• 単純モードの場合: 期待時間のみ

4. 集計と表示

Story単位の表

Story	Points	期待(h)	σ(h)	範囲(h)
...	...	...	...	E-σ 〜 E+σ

Epic単位の集計

• 合計期待時間: Σ(E × rate)
• 合計標準偏差時間: √(Σ((σ × rate)²))
• 人日換算: 1人日 = 8時間（または設定値）として日数表示
• 信頼区間（68%, 95%）の表示

補足表示

• 「リスク反映後のPで換算済みのため、これは『リスク織り込み済み見積もり』」
• 13pt以上のStoryがある場合は警告（換算精度が低い）
• 単純モードのStoryは標準偏差なし（- 表示）

5. 出力形式

ユーザーに確認:

• チャットに表で表示するのみ
• Markdownファイルに保存（docs/plans/<epic-id>-time-estimate.md など）

ファイル保存を選んだ場合、レート・換算日時・対象範囲を明記したヘッダーを付ける。

注意事項

• レートは設定ファイルに保存されている場合のみデフォルト値として提示し、それ以外は実行時にユーザーから取得する。本スキルは設定ファイルへの書き込みを行わない（保存したい場合はユーザーに points_to_hours 手動設定を案内する）
• 人日換算用の hours_per_day は設定ファイルに保存されていればそれを使い、未設定なら 8 をデフォルトとして提示する
• フロントマターのpointsを書き換えない（あくまで参照のみ）
• ベロシティ算出機能は本スキルでは扱わない（将来拡張）
• 信頼区間（68%, 95%）は対象Storyが3件以上の場合のみ表示する。少数の場合は「件数不足のため信頼区間は省略」と明示する
• Storyに points: 0 のものがある場合は警告し、estimate-points への誘導を行う