用途:维护一份基于证据的项目路线图,说明里程碑优先级和下一步行动,适用于里程碑规划、整体进度查看、距离目标的剩余工作,或通过 /vision 调用。
主要能力:从成员活动推导进度、从成果证据推导完成度,并保留显式的 Confirmed done 覆盖;支持新增里程碑(add <name>)、标记完成(done <n>)、重新打开(reopen <n>)和排序(order <n n ...>)。默认报告解释进度与剩余差距,计数用于支撑评估,界面输出使用里程碑名称和已关联议题标题。
使用方式:先解析并加载 references/tracker.md 定位跟踪器与路线图,本地路线图还需加载 references/scratch.md。无路线图时通过 references/chart.md 创建并保存指针,再对既有工作进行对账与报告;已有路线图则加载 references/reconcile.md 执行编辑并在守卫下刷新状态;创建或对账后加载 references/report.md 生成下一步报告。跟踪器操作用 scripts/tickets.sh 配合已解析的适配器参数,支持 GitHub(配合 git 与 gh)以及 Linear、Jira(用 Python 标准库);退出码 3 表示令牌无法写入,走本地回退。GitHub 地图前沿读取用 scripts/map.sh,可选参数为 owner/repo。
适用场景与限制:遵循显式用户指令和已做决定优先于工作流默认值;仅报告进度不授权实施工作;遇到真实权限或缺失前置条件时说明并完成独立且已授权的工作。对账时先快照正文并防止并发变更,读取不完整则不修改已保存路线图。不编造日期或估算。若项目内含 ## Agent skills 块,可在调用时按 Persona: 和 Style: 读取并应用角色语气,仅作用于主代理对话,交付物、专家角色、仅回复响应和纯 JSON 输出保持原契约;无可用项目或无该行则按普通行为。具体脚本参数与本地回退细节暂未提供完整信息。