用途:将主 {product_root}/docs/versions/{version_san}/requirements.md 按结构化方式拆分为多个子版本,便于后续按切片顺序规划。只做结构分区,不生成任务、不生成 execution-handoff,也不重新运行 Gate 1。
主要能力:解析主需求中的 Features、优先级、数据模型线索与层标签;构建 DAG,默认顺序为 schema → API → FE → tests,并遵循显式优先级;按限界上下文(领域/实体)聚类;对超大分组进行拆分(超过 12 个带交叉依赖的 feature,或约 50 个预估任务,或约 60 万 token 启发式);合并过小切片,目标每个子版本 4–7 个任务;拓扑排序生成 01-slug、02-slug 等文件夹。
输出:在版本根目录生成 version-roadmap.md,表头列为 | NN | slug | Features | deps | tasks est. | tokens est. | status |,初始 status 为 pending;生成 subversions/{subversion_san}/requirements.md(含摘录及指向主需求 ../requirements.md#Feature-ID 的链接);为每个切片创建空的 subversions/{subversion_san}/tasks/。不会创建 task-*.md。
集成流程:分区完成后进入 Gate Roadmap(人工确认),再逐切片规划(Gates 2–3、任务),无需重复 Gate 1。
限制:只读取主 requirements.md,不要加载产品前后端规则;不生成任务;需人工在切片规划循环前审查。Harness 发现与 artifact 布局参见 ../ns-harness/references/artifact-layout.md 和 ../ns-harness/references/harness-discovery.md;相关模板与工作流见 references/version-roadmap.template.md 和 references/partition-workflow.md。