用途:对照需求文档(如 REQUIREMENTS.md)跟踪功能实现状态,使用层级化 FR 编码(FR1、FR2.1、FR2.1.1 等)维护一个 JSON 跟踪文件,作为功能与任务的唯一事实来源。
主要能力:支持五种功能状态(complete、partial、in_progress、not_started、blocked);按开发阶段(phase-0、phase-1 等)分组功能;通过 prd 字段关联 PRD,并记录 PRD 实现的功能与测试通过数;自 v1.1.0 起在 feature-tracker.json 中包含 tasks 段,跟踪进行中与待办任务,替代 work-overview.md;将 TODO.md 作为复选框同步目标;维护聚合统计(总数、各状态数量、完成百分比)。
使用方式:跟踪文件位于 docs/blueprint/feature-tracker.json,可选本地 schema 副本在 docs/blueprint/schemas/feature-tracker.schema.json。可用 jq 查看统计、列出未完成功能、按阶段筛选等,例如 jq '.statistics' docs/blueprint/feature-tracker.json。可用 ajv 校验:ajv validate -s schemas/feature-tracker.schema.json -d docs/blueprint/feature-tracker.json。相关命令包括 /blueprint:feature-tracker-status 与 /blueprint:feature-tracker-sync,后者可加 --summary 生成 markdown 概览。同步流程为:加载跟踪文件状态、与 TODO.md 比对、验证实现状态、重算统计、更新 TODO.md 并报告。
适用场景:功能实现状态变化、新增或完成 PRD、重大开发里程碑后、生成状态报告前、开始新开发阶段时。
限制:schema 对 FR 编码、阶段、PRD 命名有严格校验;状态验证依赖文件存在、测试通过、TODO 勾选等证据;资料未提供安装方式、收费与平台信息。