blueprint-feature-tracker-status

機能トラッカーの統計情報、フェーズの進捗状況、完了サマリーを表示します。

このスキルを使用するタイミング

次の場合はこのスキルを使用します…	次の場合は blueprint-feature-tracker-sync を使用します…
完了統計とフェーズの進捗状況を読み取り専用で確認したい	TODO.md とトラッカーを照合する必要がある（書き込み）
PRD のカバレッジと着手可能な作業を確認したい	--drain-wave を使って WO エントリーを消化したい
状態を変更せずにブロックされている機能を確認したい	完了率を再計算したい
「現在の状況」を手早く確認したい	低レベルの FR コード編集には、代わりに feature-tracking を使用してください

手順

1. 機能トラッキングが有効か確認します：

   • docs/blueprint/feature-tracker.json を探します
   • 見つからない場合は、次のように報告します：

     このプロジェクトでは機能トラッキングが有効になっていません。
     `/blueprint:init` を実行し、機能トラッキングを有効にして開始してください。
     

2. トラッカーデータを読み込みます：

   • feature-tracker.json を読み込みます
   • プロジェクト名、ソースドキュメント、last_updated を抽出します
   • 統計情報セクションを取得します
   • フェーズ情報を取得します
   • PRD のステータスを取得します

3. 派生指標を計算します（統計情報に含まれていない場合）：

   • すべてのネストレベルでステータス別に機能を数えます
   • 完了率を計算します
   • フェーズごとに機能を数えます
   • ステータス別に PRD を数えます

3a. 統計情報のキャッシュが信頼できることを確認します（読み取り専用）：

このスキルが表示する内容はすべて、機能コレクションの キャッシュである statistics から引用するため、引用する前に検証してください：

bash "${CLAUDE_SKILL_DIR}/../../scripts/blueprint-tracker-check.sh" --project-dir "$(pwd)"

STATUS=ERROR で TYPE=statistics_divergence の行がある場合は、キャッシュされた数値ではなく、再計算された EXPECTED= の数値を表示し、レポートに次の行を追加します：Statistics cache is stale — run /blueprint:feature-tracker-sync。 ほかの ISSUES: 行があれば、「Tracker Integrity」という見出しの下にそのまま表示します。このスキルは書き込みを行わないため、問題を報告し、修正は /blueprint:feature-tracker-sync（その手順 7a）に委ねます。

4. ステータスレポートを表示します：

   Feature Tracker Status
   ======================
   Project: {project}
   Source: {source_document}
   Last Updated: {last_updated}
   
   Overall Progress:
   ==================
   {progress_bar} {completion_percentage}% ({complete}/{total_features})
   
   Complete:     {complete}
   Partial:      {partial}
   In Progress:  {in_progress}
   Not Started:  {not_started}
   Blocked:      {blocked}
   
   Phase Progress:
   ===============
   {For each phase:}
   Phase {N}: {name}
   Status: {status}
   Features: {complete}/{total} complete
   
   PRD Coverage:
   =============
   {For each PRD:}
   {PRD_NAME}: {status}
     Features: {features_implemented count}
     {If tests_passing:} Tests: {tests_passing} passing
   
   {If blocked features exist:}
   Blocked Features:
   =================
   {For each blocked feature:}
   - {FR code}: {name}
     Reason: {implementation.notes or "No reason documented"}
   
   {If not_started features exist and count <= 10:}
   Ready to Start:
   ===============
   {List first 10 not_started features by phase order}
   - {FR code}: {name} (Phase {N})
   
   {If any feature has non-empty implemented_by (monorepo portfolio, v3.3.0+):}
   Portfolio Features (linked to child workspaces):
   ================================================
   {For each portfolio feature with implemented_by:}
   - {FR code}: {name} — derived status: {status}
     Implemented by:
     {For each link:}
       - {link.workspace}/{link.ref} → {status from child feature-tracker}
   
   {If top-level "workspaces" summary present:}
   Workspace Rollups:
   ==================
   {For each workspace key:}
   - {path}: {complete}/{total} ({completion_percentage}%) [last synced: {last_synced_at}]
   

4a. ポートフォリオのリンクを解決します（v3.3.0 以降）： implemented_by が空でない各機能について、参照先の各子 <workspace>/docs/blueprint/feature-tracker.json を開き、ref の FR を調べて現在のステータスを取得します。ワークスペースまたは参照が見つからない場合は、処理を中断せずに警告し、/blueprint:workspace-scan と /blueprint:feature-tracker-sync の実行を提案します。

5. 視覚的な進捗バーを表示します： ASCII の進捗バーを作成します：

   [##########----------] 52.4%
   

   • 完了率には # を使用します
   • 残りには - を使用します
   • 幅は 20 文字です

6. 古いデータがないか確認します：

   • last_updated が 7 日より前の場合は、次のように警告します：

     注：トラッカーは {N} 日間同期されていません。
     `/blueprint:feature-tracker-sync` を実行して更新してください。
     

7. 次のアクションを尋ねます（AskUserQuestion を使用）： 状態に応じて選択肢を動的に作成します：

   • 古い場合 → 「機能トラッカーを同期」を含めます
   • not_started の機能がある場合 → 「次の機能を開始」を含めます
   • in_progress の機能がある場合 → 「現在の作業を続ける」を含めます
   • 常に「詳細な内訳を表示」と「終了」を含めます

   question: "What would you like to do?"
   options:
     {Dynamic options based on state}
     - label: "Sync feature tracker" (if stale)
       description: "Update tracker from project state"
     - label: "Start next feature" (if not_started exist)
       description: "Begin work on the next pending feature"
     - label: "Continue current work" (if in_progress exist)
       description: "Resume work on in-progress features"
     - label: "View features by status"
       description: "List all features filtered by status"
     - label: "Exit"
       description: "Done viewing status"
   

   選択に応じて：

   • 「同期」→ /blueprint:feature-tracker-sync を実行します
   • 「次を開始」→ 次の not_started 機能の詳細を表示し、開始を提案します
   • 「続行」→ in_progress の機能を表示し、作業の続行を提案します
   • 「ステータス別に表示」→ ステータスを尋ね、一致する機能を一覧表示します
   • 「終了」→ コマンドを終了します

出力例：

Feature Tracker Status
======================
Project: gooho
Source: REQUIREMENTS.md
Last Updated: 2026-01-01

Overall Progress:
==================
[##########----------] 52.4% (22/42)

Complete:     22
Partial:      4
In Progress:  2
Not Started:  14
Blocked:      0

Phase Progress:
===============
Phase 0: Foundation
Status: complete
Features: 4/4 complete

Phase 1: Core Gameplay
Status: complete
Features: 8/8 complete

Phase 2: Advanced Features
Status: in_progress
Features: 10/14 complete

Phase 3-8: Future Development
Status: not_started
Features: 0/16 complete

PRD Coverage:
=============
PRD_GAME_SETUP_FLOW: complete
  Features: 4
  Tests: 45 passing

PRD_TERRAIN_VISUAL_ENHANCEMENT: complete
  Features: 6
  Tests: 107 passing

PRD_ENTITY_BEHAVIOR_SYSTEM: complete
  Features: 8
  Tests: 187 passing

PRD_UI_CONTROLS_SYSTEM: partial
  Features: 3/5

Ready to Start:
===============
- FR3.1: Resource Types (Phase 3)
- FR3.2: Resource Gathering (Phase 3)
- FR3.3: Resource Storage (Phase 3)
- FR4.1: Basic Crafting (Phase 4)
- FR4.2: Recipe System (Phase 4)

Note: 14 features ready to start. Run `/blueprint:feature-tracker-sync` before beginning new work.

クイックコマンド（最後に表示）：

Quick commands for feature tracker:
- jq '.statistics' docs/blueprint/feature-tracker.json
- jq '.. | objects | select(.status == "not_started") | .name' docs/blueprint/feature-tracker.json
- jq '.prds | to_entries | .[] | "\(.key): \(.value.status)"' docs/blueprint/feature-tracker.json

エージェント向けの最適化

コンテキスト	コマンド
キャッシュ済み統計のみ	jq -c '.statistics' docs/blueprint/feature-tracker.json
キャッシュは信頼できますか？	bash "${CLAUDE_SKILL_DIR}/../../scripts/blueprint-tracker-check.sh" | grep -E '^(STATUS|ISSUE_COUNT)='
再計算した値とキャッシュ済みの値	bash "${CLAUDE_SKILL_DIR}/../../scripts/blueprint-tracker-check.sh" | grep -E '^(EXPECTED|ACTUAL)_'
ブロックされた機能のみ	jq -r '.. | objects | select(.status? == "blocked") | .name' docs/blueprint/feature-tracker.json