estimate-points

estimate-points

Story単位でフィボナッチ数列のストーリーポイントを見積もるスキル。

見積もりモード

モード	入力	計算式	用途
PERT（三点）	O, M, P	E = (O + 4M + P) / 6, σ = (P - O) / 6	標準。ばらつきも算出
単純	1値	E = 入力値	小さく確信があるStory

フィボナッチ数列

1, 2, 3, 5, 8, 13, 21, 34, 55, 89

13以上は分割推奨。89は理論上の上限。

実行手順

1. 基準点の確認

.claude/planning-skills.local.md から baseline を読み込む。 未設定の場合は setup-baseline スキルへ誘導する。

2. 対象Storyの特定

引数または対話で以下のいずれかを取得:

• 単一Storyファイルパス
• 複数Storyファイルパス
• "all"（docs/plans/stories/*.md のすべて、status=planning または ready のもの）

各Storyについて、フロントマターを Read で確認する。すでに見積もり済み（points > 0）の 場合は再見積もりするかユーザーに確認する。

3. 見積もりモードの選択

各Storyについて AskUserQuestion で以下を確認:

• 「このStoryの見積もりモードはどうするか？」
  • PERT（三点見積もり）
  • 単純見積もり

または最初に「以降すべてPERTで」のように一括指定を促す。

4. 見積もりの入力

PERTモード

3つの値を順に取得:

• 楽観値（O）: 全てが順調に進んだ場合のポイント（フィボナッチ）
• 最頻値（M）: 最も起こりやすいポイント（フィボナッチ）
• 悲観値（P）: 想定される最悪ケースのポイント（フィボナッチ）

質問文には基準点を必ず提示する:

• 「2pt基準: <reference_story_2>」
• 「8pt基準: <reference_story_8>」

入力後、PERT計算:

• E = (O + 4M + P) / 6
• σ = (P - O) / 6
• E をフィボナッチ数列で最も近い値に丸めて points とする

単純モード

単一のフィボナッチ値を取得し、points にそのまま設定。 O = M = P = points として保存する（後段スキルとの互換性のため）。

5. リスク反映の確認

そのStoryに既に identify-risks が実行されているか（YAMLフロントマターの risk_score を確認）:

• 実行済み: 「リスクをPに加算しますか？」と確認し、加算する
• 未実行: 「先に identify-risks を実行することを推奨」と案内（ただし強制はしない）

6. Storyファイルの更新

Story mdのフロントマターを更新:

points: <フィボナッチに丸めたE>
estimation_mode: pert  # or simple
pert:
  optimistic: <O>
  most_likely: <M>
  pessimistic: <P>
  expected: <E（小数2桁）>
  stddev: <σ（小数2桁）>

「見積もり詳細」セクションを更新（基準点比較も記述）。

7. Epic集計の更新

Story が属する Epic md の「Story一覧」表と「全体見積もり」セクションを更新する:

• Story毎の行を更新
• 合計ポイント、PERT合計（E合計）、標準偏差合計（√(Σσ²)）を再計算

8. estimate-validator の自動起動

すべての対象Storyの見積もりが完了したら、Task ツールで estimate-validator エージェントを起動する。

• 呼び出し方: Task ツールに subagent_type: estimate-validator を指定
• 入力プロンプトに含める情報:
  • 見積もり対象だったStoryファイルの絶対パス一覧
  • 該当Epic mdファイルの絶対パス
  • .claude/planning-skills.local.md のパス（baseline参照のため）
• 期待出力: 妥当性レビュー、警告、改善提案

Task ツールが利用不可な環境では、ユーザーに以下を案内する: 「estimate-validator agent を以下のStoryに対して起動してください: <パス一覧>」

9. 結果サマリーの表示

ユーザーに以下を表示:

• 各Storyのpoints・PERT値・基準点比較
• Epic合計
• 13pt以上のStoryリスト（分割推奨）
• estimate-validatorの主な指摘

注意事項

• O ≤ M ≤ P を必ずチェックする。違反していたら入力し直しを促す
• O = M = P の場合（確信度高い）、σ=0 を許容するが「単純見積もりに切り替えるか」をユーザーに確認する
• PERTのEがフィボナッチ非整数になる場合、必ずフィボナッチに丸める
  • 丸めルール: 最も近い値（同距離なら大きい方）
  • 例: E=4 → 5（3より5に近い）、E=6.5 → 8（5と8の中間で同距離 → 大きい方）、E=10 → 8（13より8に近い）
• σが大きすぎる（例: σ ≥ M）Storyは分割を推奨する
• 基準点（baseline）が未設定の状態では実行しない。setup-baselineへ誘導する
• Epic mdに「全体見積もり」セクションが存在しない場合はテンプレートから当該セクションのみ追記する
• Epic自体の見積もりはStory合計の自動算出。ユーザーが明示的にEpic単独で見積もりたい場合のみ受け付ける