技能 (Skill)：定义路线图 (Production v3.0.0)

目的 (Purpose)

从战略目标推导"可驱动决策的路线图"，而非任务列表。路线图不是里程碑集合，而是路径表达。

核心目标（Core Objective）

首要目标：生成用户确认的可驱动决策的路线图文档，每个阶段明确包含里程碑、关键举措、成功指标与推进条件。

成功标准（必须满足所有要求）：

✅ 核心模型完整：每个阶段必须包含里程碑（Milestone）、关键举措（Strategic Bets）、成功指标（Metrics）和推进条件（Promotion Criteria）。
✅ 有序结构与路径感：采用 Now / Next / Later 划分阶段，体现演进路径。
✅ 结果与指标导向：成功指标优先量化，里程碑为成果导向，绝非功能列表或 TODO 的混入。
✅ 避免虚假精确：Later 阶段仅说明方向，不写具体时间。
✅ 目标追溯与约束：建立目标映射，且明确约束「Backlog 必须映射到路线图，不属于路线图的需求默认不做」。
✅ 用户确认与持久化：用户明确批准，并写入约定路径（默认 docs/process-management/roadmap.md 或依规范 milestones.md）。
✅ 容量分配按 strategic_goal：路线图必须声明每个 strategic_goal 占当前 cycle 容量的百分比，所有目标百分比之和必须为 100%。百分比由用户敲定，不得由本技能推断（依据 ADR 20260417-unified-value-driven-prioritization-model 决策 3.4）。

验收测试：读者能否一眼看到演进路径（包含推进条件）？能否通过成功指标验证阶段成果，而非单纯检查任务列表？

交接点：路线图获批并持久化后，交接至待办规划、需求分析（analyze-requirements）或执行对齐（align-planning / plan-next）。

范围边界 (Scope Boundaries)

本技能负责：

从战略目标中推导并划分阶段（Now / Next / Later）。
为每个阶段定义里程碑、关键举措（2–5个）、成功指标和推进条件。
组织并生成结构化的路线图文档。
坚持项目约定路径。

本技能不负责：

定义使命、愿景、北极星或战略目标（使用 define-mission、define-vision、define-north-star、design-strategic-goals）。
编写具体需求或拆分任务（使用 analyze-requirements、breakdown-tasks）。
创建具体的 Backlog 项目（使用 capture-work-items）。

使用场景 (Use Cases)

战略目标确立后：需要将高层的战略目标转化为具体阶段、关键举措与指标。
阶段流转评估：通过"推进条件"（Next → Now）决定团队是否可以进入下一阶段。
规划与对齐会议：为团队和利益相关者提供清晰的路径表达与决策依据，淘汰不符合当前路径的杂乱需求。

行为 (Behavior)

第 0 阶段：Norms Resolution（v3.2 新增）

按 specs/artifact-contract.md §8 Runtime Norms Resolution Protocol 的 §8.2 / §8.3 / §8.5 实现：读项目规范若声明了 roadmap artifact_type 的 path_pattern，则使用项目值；否则 fall through 到技能默认（docs/process-management/roadmap.md 或 docs/process-management/milestones.md）。本技能为固定路径治理产出，只用 path_pattern 覆盖机制（roadmap 本身是 Now/Next/Later 分层的容器）。

交互（互动）政策

默认：输出至 docs/process-management/roadmap.md 或遵循项目既有规范。自动读取 docs/project-overview/strategic-goals.md 作为输入依据。
推断与确认：基于现有的项目状态或上下文提炼关键举措与指标；涉及核心决策或覆盖既有文档前，向用户请求明确确认。

执行过程

加载战略目标：读取现有战略目标及项目背景。
划分阶段：结构化为 Now / Next / Later 视角。
定义里程碑：确保以成果为导向。
提炼关键举措：每个阶段提炼 2–5 个关键举措（Strategic Bets）。
定义成功指标：为阶段成果设定验证标准，优先量化。
定义推进条件：明确进入下一阶段的前提（如 Next → Now 的切换条件）。
建立目标映射：确保阶段目标和 Backlog 可以映射到战略。
敲定容量分配：询问用户当前 cycle 每个 strategic_goal 占多少百分比容量。
- 呈现 strategic-goals 列表，逐项询问或要求用户一次性给出分配
- 校验百分比之和 = 100%，不等时 halt 并提示修正
- 建议默认分层（示例：用户价值 60% / 市场扩张 20% / 工程健康 20%），但由用户敲定
- 工程健康目标不得为 0%（依据 ADR 1 决策 3.5：工程健康须有容量）
生成路线图文档：按照输出结构模板生成文档草案（含"容量分配"章节）。
确认与持久化：用户确认后持久化写入并标注最后更新日期。

输出结构模板 (内嵌契约)

# 路线图

## 路线概览

Now / Next / Later（含推进条件简述）

## 容量分配（当前 cycle）

| Strategic Goal | 百分比 | 说明 |
| 目标 1（用户价值） | 60% | 核心交付 |
| 目标 2（市场扩张） | 20% | 邻近扩展 |
| 目标 3（工程健康） | 20% | 治理与技术债，不得为 0 |

> 本分配由 `promote-roadmap-items` 技能在容量护栏中消费（ADR 20260417 决策 3.4）。
> 百分比之和必须为 100%；工程健康目标不得为 0%。
> 战略刷新或容量调整需重跑本技能。

---

## Now

### 里程碑
- ...

### 关键举措
- ...

### 成功指标
- ...

---

## Next

### 推进条件
- ...

### 里程碑
- ...

### 关键举措
- ...

---

## Later

仅方向，不写时间

---

## 里程碑详情（附录）

| Milestone | Scope | Metrics | Goals |

输入与输出 (Input & Output)

输入：

必填：战略目标（文档或路径）；项目背景。
可选：愿景/北极星指标；时间范围或阶段偏好。

输出：

工件：决策级路线图文档。
位置：docs/process-management/roadmap.md 或 milestones.md（依项目规范）。
内容：含路线概览、Now/Next/Later 详情（里程碑、关键举措、指标、推进条件）。
生命周期：living（随阶段推进持续更新）。

限制 (Restrictions)

硬边界 (Hard Boundaries)

路线图映射约束：明确「Backlog 必须映射到路线图，不属于路线图的需求默认不做」。
结构强制：每个阶段必须包含核心模型（里程碑、关键举措、成功指标、推进条件），缺一不可。
容量分配不得省略：每个 strategic_goal 必须有百分比，和 = 100%；工程健康目标不得为 0%。
容量分配不得由本技能推断：必须由用户敲定，可提建议但不自动写入。
无覆盖：未经用户明确确认，不覆盖既有路线图文件。

反模式（避免）

功能列表：将路线图降级为功能特性堆砌。
TODO 混入：掺杂具体执行级别的任务。
无指标：无法验证里程碑是否达成。
无关键举措：只有目标没有对应的战略动作。
虚假精确：在 Later 阶段写明具体日期/时间。

技能边界 (Skill Boundaries)（避免重叠）

不要做这些（其他技能负责）：

定义战略目标：使用 design-strategic-goals。
拆分具体需求/任务：使用 analyze-requirements 或 breakdown-tasks。
编写待办：使用 capture-work-items。

何时停止并交接：

用户回复「已批准/确认」等 → 路线图完成，持久化文档并交接给 align-planning 或待办规划。

自检 (Self-Check)

核心成功标准（必须满足所有标准）

核心模型完整：文档包含里程碑、关键举措、成功指标、推进条件。
有序结构与路径感：路线图基于 Now / Next / Later 展现演进路径。
结果与指标导向：内容为成果导向，无功能或 TODO 列表。
避免虚假精确：Later 阶段未包含具体时间，仅指明方向。
目标追溯与约束：体现了路线图到战略目标的映射关系，约束了 Backlog。
容量分配完整：每个 strategic_goal 有百分比，和 = 100%，工程健康 ≠ 0%。
用户确认与持久化：用户已批准，并写入约定路径。

验收测试

读者能否一眼看到演进路径（包含推进条件）？能否通过成功指标验证阶段成果，而非单纯检查任务列表？

若否：需补充成功指标或推进条件，剔除功能性 TODO 列表。
若是：路线图符合生产级要求，继续转交。

示例 (Examples)

示例 1：根据战略目标生成生产级路线图

背景：已有包含 3 项指标的战略目标，需制定演进路径。流程：

读取目标并按 Now / Next / Later 视角划分。
为 Now 定义明确的 3 项关键举措与量化成功指标。
定义 Next 阶段的"推进条件"（如"当核心架构验证达到 10k QPS 时，启动 Next 阶段"）。
在 Later 中列出长远探索主题（无日期）。
呈现文档草案并获批后写入 docs/process-management/roadmap.md。结果：路线图持久化，清晰驱动下一步的资源分配与决策。

示例 2：纠正任务列表反模式

背景：用户要求「帮我把这些 Backlog 任务排期做成路线图」。流程：

向用户说明本技能的原则：路线图是路径表达与决策模型，而非任务清单。
将具体的 Backlog 抽象为对应的关键举措与阶段性里程碑。
补充各阶段的成功指标与推进条件，去除细碎的 TODO。
提供草案并与用户确认。结果：将需求列表成功转换为符合生产级的决策路线图。

示例 3：容量分配必填（边缘场景）

背景：用户草拟 roadmap 但跳过容量分配章节，要求直接持久化。流程：

检测到路线图缺"容量分配"。
halt 并解释："容量分配是 promote-roadmap-items 的护栏依据（ADR 20260417 决策 3.4），缺失会导致晋升无法按战略目标控制。"
呈现 strategic-goals 列表：
- 目标 1（用户价值）：? %
- 目标 2（市场扩张）：? %
- 目标 3（工程健康）：? %
用户给出 70/20/10。
校验和 = 100 ✓；工程健康 10% 非 0 ✓。
写入"容量分配"章节，持久化。结果：roadmap 含有 promote-roadmap-items 可消费的容量分配，体系闭环。

附录：输出合约 (Appendix: Output Contract)

本技能产出 Roadmap Document：

元素	格式	必填字段	路径模式
文档主体	Markdown	front-matter（artifact_type=roadmap / lifecycle=living）；章节：里程碑节点 / 战略赌注 / 成功指标 / 容量分配 / 升迁标准	roadmap.md 或 milestones.md（按项目 norms）
里程碑节点	列表项	id（如 M1）/ scope / success_criteria / strategic_goal_ref / status（pending/in-progress/done/blocked）	「里程碑节点」节
容量分配	表格	strategic_goal_id / percentage / rationale；总和=100%	「容量分配」节，供 promote-roadmap-items 消费
升迁标准	列表项	from_tier / to_tier / required_evidence	「升迁标准」节

define-roadmap