用途 该技能作为入口,处理“继续推进路线图”这类含义不明确的请求:当用户给出笼统的“继续路线图”指令、未说明是要补文档还是做实现时,由它来判断并交接给对应的下游流程。它自身不撰写文档,也不执行实现。
主要能力
- 定位路线图:按与 executing-roadmap-checkpoints 第一步相同的规则查找。若指定了功能名,读取 docs/<slug>/-roadmap.md;否则用 glob 匹配 docs//*-roadmap.md。匹配为零时报告并停止;匹配多个时通过 AskUserQuestion 让用户逐个选择。
- 读取状态:读取 docs/<slug>/roadmap-state.json 中逐步状态;若文件缺失,则回退为直接读取各步骤的复选框及 steps/<step-slug>/ 目录内容。同时读取 tmp/reports/batch-plan-queue.md 中的第二阶段队列(若存在)。
- 复核阻塞项:对队列中每个 status: blocked 的行,展示其 notes 原因,并通过 AskUserQuestion 询问用户是否已解决(可逐条提问,多项时用多选)。已解决则记录答案、将该行置回 queued,并把解决结果写入 notes(如 resolved: <answer>),供后续 batch-plan-validate 第一阶段起草时使用;仍未解决则保持 blocked,并排除在本次建议之外。脚本不会自行判断阻塞项是否过期。
- 分类未完成步骤:依据 roadmap-state.json 状态(顺序为 not-started → prd-drafted → spec-drafted → spec-validated → plan-drafted → implemented → closed)区分“文档已完成”(spec-validated 及之后)与“文档进行中”(spec-validated 之前,含 not-started)。
- 提出建议而非替用户决定:若尚无任何步骤文档完成,告知用户仍有 N 个步骤待补文档,建议调用 batch-plan-validate 继续起草与校验;在至少一个步骤文档完成前不提供实现选项。若部分完成、部分未完成,报告两类数量后用 AskUserQuestion 让用户选择继续文档还是对已完成文档的步骤开始实现。若所有剩余步骤都已完成文档,则针对下一个这样的步骤询问:只写实现计划(writing-plans-conventions,独立使用),还是写计划并实现(executing-roadmap-checkpoints,该流程会自行写计划,交接前不要预先写好,以免重复其第 4 步工作)。得到答复后交接给对应技能并停止。
使用方式 该技能以技能形式提供,需在支持该技能机制的环境中按名称调用;调用时通常配合用户给出的路线图或功能名。它依赖 roadmap-conventions 约定的文件位置、状态文件结构与三阶段工作流;实际起草与实现逻辑仍位于 batch-plan-validate 与 executing-roadmap-checkpoints 中。安装命令与具体调用示例暂未提供。
适用场景 用户只说“接着做路线图”而未说明做文档还是写代码;需要先确认路线图当前进度、阻塞项是否解除;需要在文档与实现之间做出交接决策。
限制 不进行任何起草或实现;不自行假设阻塞项已解决或仍存在;文档未达 spec-validated 的步骤不提供实现选项;交接即停止,不预先替下游技能完成其工作。