用途
Roadmap Planning 是一个已弃用的路线图与里程碑任务批次规划技能存档。根据其说明，该文件仅保留用于迁移参考，不应在新工作中使用；新工作应改用 milestone-planning 技能。
该技能的核心目标是把产品方向塑造成可以独立交付和验证的成果。它强调在拆解之前先建立规划边界，读取仓库说明、现有路线图或 issue 约定、相关产品上下文以及当前请求。
主要能力
建立规划边界
当已有路线图工件合适时更新它；否则在仓库一致的位置提出最小的有用 Markdown 工件。在拆解前说明目标、约束、当前证据和成功信号。
根据请求选择分支：
- 对于独立目标，直接塑造几个可独立验证的交付切片，仅在没有本地形式时使用 references/roadmap-template.md；
- 对于新里程碑，在形成任务批次前准备并评分候选，然后在放置确认结果前阅读 references/milestone-planning-handoff.md；
- 对于已有里程碑，阅读同一交接参考并协调其交付地图。
保留精确的未决决策，让模糊的未来问题保持其当前的不确定性水平。该技能在没有文档布局、任务跟踪器、标签、里程碑层级、工作流阶段或确认状态的情况下仍可使用。
准备候选工作
从持久证据和完整候选集构建新的里程碑批次，而不是仅依据最新提示或第一个待办项。恢复已完成和未完成的里程碑、用户反馈、能力缺口、事件、研究、未来方向、未决决策、依赖和完整待办列表。
候选丰富是可选的。当用户要求时，或在待办列表为空、稀疏或明显过时时提供一次简短提醒。拒绝后继续规划，不再设置门槛。
仅添加具有粗略边界和合理阶段证明的可调度候选成果。将目标型或模糊想法保留在 Future Directions 下。在评分前协调重复项、被取代的工作以及已在别处完成的成果。
对候选评分
遵循仓库已有的评分体系；否则使用一个基于证据的 0 到 10 整体评分：
- 9–10：延迟有显著且近期的成本；
- 7–8：高价值，值得近期考虑；
- 4–6：明确价值，当前延迟成本有限；
- 1–3：低影响、低延迟成本或机会型；
- 0：建议移除或关闭，或作为未来问题保留而非活跃待办工作。
对候选成果评分，而不是对后续派生的执行任务评分。记录一条简洁理由，基于用户或业务影响、延迟成本、明确承诺、战略价值、运营或安全风险以及解锁价值。不要求组件公式；存在仓库既有 WSJF、RICE 或其他模型时使用它们。
保持依赖显式并与数字优先级分离。前置条件可能获得相同或更高分数，因为它解锁重要工作，尤其是解锁多个成果时；而“Depends on”决定执行顺序。
在里程碑选择前扫描完整待办列表。仅在证据变化时重新评分；未变化的分数保持不变，不追加评分历史。在维护本地 Markdown 且没有更强约定时，按当前分数降序排序，并保持同分顺序稳定。
代理生成的评分是建议。当无法从仓库证据确定业务价值或战略权衡时询问用户，并让用户确认最终里程碑边界。
形成里程碑批次
读取用户提供的期望任务数量；否则在检查领先候选后提出一个紧凑批次并请用户确认。将该数量视为软规划边界，绝不是固定的仓库默认值。
仅当用户或仓库提供时，才将时间盒、截止日期或发布窗口视为可选约束。
从最高分候选开始，仅以规划粒度展开可能的入选项。一个待办成果可能变成两到三个里程碑任务，并占用批次中相应数量的位置。
让原子性和依赖决定任务边界。当与请求数量有实质性偏离时，需要可见理由和用户同意。
主题相似性是次要的。当每个入选任务都有有意义的边界时，一个里程碑可以包含不相关的高分成果。
在里程碑中保留一次入选候选分数和选择理由。里程碑任务不继承分数；按推荐执行顺序列出它们，并仅建模真实依赖。
当里程碑持久拥有候选的完整入选成果后，将该候选移出待办。当仅选择可验证部分时，将待办条目重写为剩余成果并重新评分。
里程碑规划定义任务边界、粗略范围、成功信号、依赖以及任何真实的跨任务集成需求。当单个任务开始开发时，创建任务规格以及任何有理由的设计或计划。
放置规划结果
遵循仓库已有的跟踪器和工件约定：
- 在跟踪器中，为每个确认的原子任务创建或更新一个持久条目，并从里程碑链接这些条目；
- 在本地里程碑文件夹约定中，从里程碑参考物化规划交接，为每个确认的原子任务生成一个非空任务工件；
- 在单文件约定中，保持任务地图紧凑，仅内联没有其他持久所有者的字段。
保持里程碑工件作为链接的全局地图。当任务工件存在时，将每个规划交接保留在任务工件中。每个确认的任务获得一个持久的单独所有者。
补全里程碑地图
在推荐下一个任务前覆盖整个里程碑：
- 检查入选成果、可选外部约束、退出标准和材料约束是否明确；
- 清点对入选成果有贡献的已完成、活跃和提议任务，保留有效的已完成工作而不是重新规划；
- 将每个退出标准直接链接到满足它的任务。未覆盖的标准意味着计划不完整：添加任务、调整标准，或在 Open Decisions 下保留真正全局的未决选择；
- 添加完整覆盖所需的最小缺失有意义任务，保持在成果级别，使任务行为和技术设计留给其所属技能；
- 在里程碑索引中保留有序任务链接和状态列表。从上到下的顺序表达推荐执行顺序，而不是硬依赖。当存在跨任务开始或完成依赖时，在 Mermaid 图中显示它们，并明确标记完成或验证门。任务独立时省略图；
- 仅将全局规划缺口保留为未决决策或未来问题，而不是隐藏在看似完整的任务列表中。
里程碑计划使其完整交付形态和关闭路径可审查。任务状态和真实依赖足以恢复可继续的内容；不要添加全局当前焦点游标。
当入选成果或退出标准变化、发现的工作改变覆盖、已完成任务使假设失效，或关闭审计发现缺口时重新规划。协调受影响的剩余地图，同时保留稳定的已完成工作。关闭里程碑会协调并重新评分受影响的待办工作；新里程碑仅在用户指示下开始。
塑造原子任务
将一个任务视为一个规格可以描述、可以独立实现、审查、交接、验证和完成的最小有意义工程交付。
仅当非用户可见或部分能力创建了有界、可验证且安全保留并直接支持后续工作的状态时，才允许它。
将实现、测试、必要文档、任务级验证和审查修正保留在任务内。将文件编辑、端点、迁移命令、测试编写步骤和其他孤立操作保留在它们支持的有意义交付内。
仅当每个结果支持独立规格和有意义的阶段证明时才拆分。将仅作为一个成果才有价值的工作合并。
当待办候选扩展为多个任务时，每个原子任务都计入用户确认的批次。
将优先级保留在待办候选和入选成果理由上。通过列表顺序和硬依赖表达里程碑执行。
仅当任务本地验证无法覆盖真实的跨任务交互、兼容性、迁移、发布或端到端风险时，才添加里程碑级集成证明。仅当集成工作量大时，才将其作为单独任务。
将具体的未决选择记录为未决决策，包含其影响和决策点。保留模糊的未来问题，不虚构所有者、日期或推测性任务树。
完成标准
规划在以下情况完成：
- 工件反映请求的分支及其持久证据；
- 每个切片或原子任务都有有意义的成果、粗略边界和阶段证明；
- 里程碑选择有用户确认的批次、每个确认任务的持久所有权，以及入选和剩余待办成果的协调所有权；
- 每个里程碑退出标准链接到其贡献任务；
- 真实硬依赖可见，而不将列表顺序变成依赖；
- 当仓库使用任务工件时，任务本地细节位于其中，而里程碑保持为链接的全局地图；
- 未决决策和未来问题保留其实际不确定性；
- 任务级规格、技术设计和实现顺序推迟到其所属工作开始时。
配套技能
当已安装时，使用 grilling 处理未解决的产品方向，使用 research 处理重大外部不确定性。这些配套技能来自 mattpocock/skills，可通过 npx skills add mattpocock/skills --skill <name> 安装。仅当用户要求任务级规格时，才将具体切片发送给 task-spec；路线图工作不授权实现。
限制
该技能已被弃用，仅用于迁移参考，不应在新工作中使用。新工作应使用 milestone-planning 技能。