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
   • 获取 statistics 部分
   • 获取阶段信息
   • 获取 PRD 状态

3. 计算派生指标（如果 statistics 中没有）：

   • 统计所有嵌套层级中各状态的功能数量
   • 计算完成百分比
   • 统计各阶段的功能数量
   • 统计各状态的 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 功能 → 包含“同步功能跟踪器”
   • 如果存在 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

Agentic 优化

上下文	命令
仅查看缓存统计数据	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