# Roadmap

> PACE 可选 stage。至少两个可独立验收交付切片或用户明确要求拆分时触发。

- Skill: `wenjunduan/roadmap` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add wenjunduan/roadmap`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wenjunduan/roadmap/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: wenjunduan (https://skillmd.com/u/wenjunduan)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wenjunduan/roadmap

---


# /roadmap — 大需求拆分 (v9.6.4 新)

## 触发条件

```python
def needs_roadmap(user_input, brainstorm_output=None):
    if explicit_kws(["路线图", "拆分", "roadmap", "分步推进", "分阶段"]):
        return True
    if independent_deliverable_slices(user_input) >= 2:
        return True
    if brainstorm_output and brainstorm_output.recommends_roadmap:
        return True
    return False
```

模块数只辅助风险等级，不单独触发拆分；不可拆的跨模块不变量可在单 sprint 完成。阶段义务见 [PACE stages](../pace/references/stages.md)，依赖和整合见 [execution-contracts](../pace/references/execution-contracts.md)。

## 数据结构

```
.ai_state/roadmap/{slug}/
├── roadmap.md          # 主文档: 背景 / 拆解 / 排期
├── items.yaml          # 机器可读子 feature 清单
└── drafts/             # 可选: 调研笔记 / 备选方案
```

## 路径限制

roadmap 只对 Feature / Refactor / System 路径有意义.
Hotfix / Bugfix / Quick **不进 roadmap** (本就是小改动).

## 例外

- `_index.skip_roadmap = true`: 大需求也不强制 roadmap (主 agent 一次性处理, 风险自担)
- 用户显式 "我自己拆": 不进 roadmap stage, 用户直接说"先做 X 再做 Y"

## 不要做 (借 OMO 教训)

- 不引入 milestone / epic / story 三层 (太重, 不是 PMS)
- 不引入跨 roadmap 依赖 (一次只跑一个 roadmap)
- 不引入自动调度算法 (主 agent + 用户决定顺序)
- 不允许 roadmap 中途插队新 item (除非用户显式说 "插队")

## 详细 playbook

完整工作流、模板、schema 与联动细节见 `references/playbook.md` —— 按需 Read, 不进热路径。