用途:将 feature-tracker.json 与 TODO.md、taskwarrior sidecar 及 PRD 对账,管理任务进度。自 v1.1.0 起 feature-tracker.json 是进度追踪的唯一事实来源,tasks 段取代 work-overview.md。
主要能力:
- 全量同步(默认):检测 sidecar、校验追踪器、回填实现证据(文件存在性 + git log 提交去重)、按固定决策表推断状态(含永不降级保护)、汇总统计,并处理 TODO.md 复选框与追踪器之间的差异。
- 生成摘要(--summary):只读输出 markdown 进度报告,不修改文件。
- Sidecar 排空(--drain-wave):把已完成的 WO 从 tasks.pending 移入 tasks.completed,证据来自 taskwarrior 注解、--evidence-files 或 --evidence,并在 implementing_wos 全部关闭时翻转 FR 状态。
用法:/blueprint:feature-tracker-sync [--summary] [--drain-wave WO-A,WO-B,...] [--evidence-files <list>] [--evidence <text>]。核心脚本:bash "${CLAUDE_SKILL_DIR}/scripts/blueprint-feature-tracker-sync.sh" --home-dir "$HOME" --project-dir "$(pwd)"。
适用场景:对账 TODO.md 与追踪器、排空 WO、重算统计、生成进度摘要、解析 portfolio 链接(v3.3.0+ 根蓝图)。
限制:追踪器缺失或 JSON 无效时报错;sidecar 模式下跳过 TODO.md 对账;--evidence 仅限单个 WO 且文本不含单引号;WO 列表与 --evidence-files 长度不一致时拒绝运行;不关闭 taskwarrior 任务,仅编辑追踪器。具体平台与收费信息暂未提供。