mcpField
N
ns-sdd-version-partitioner

ns-sdd-version-partitioner

github.com/nextstage-brasil开发067 次安装1 周前更新
代码仓库

关于 ns-sdd-version-partitioner

此技能将主版本的 requirements.md 按依赖和领域拆分为可顺序规划的子版本，并生成路线图与需求摘录。适用于使用该文档流程进行版本规划的团队。

主要功能

  1. 01解析特性、依赖与数据模型线索
  2. 02按依赖构建有向无环图
  3. 03按领域分组并拆分过大切片
  4. 04生成路线图及子版本需求摘录
  5. 05为每个切片建立空 tasks 目录

适用场景

  1. 01将大型版本需求拆成顺序规划的切片
  2. 02在开始逐切片任务规划前供人工审阅路线图

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/nextstage-brasil/skills --skill ns-sdd-version-partitioner

安装后在 Claude Code 中输入/ns-sdd-version-partitioner确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

evals/
evals.json
references/
partition-workflow.md
version-roadmap.template.md

详细介绍

版本拆分器

将主 requirements.md 拆分为多个子版本，以便按顺序规划。

探查 Harness

参见 ../ns-harness/references/artifact-layout.md 和 ../ns-harness/references/harness-discovery.md。如果 Harness 中存在 core-subversions 规则，请阅读。

范围

  • **仅读取：**主 {product_root}/docs/versions/{version_san}/requirements.md
  • **不要：**生成任务、execution-handoff 或重新运行 Gate 1
  • 不要加载产品后端／前端规则——仅进行结构拆分

算法

  1. 解析主文档——功能、前置关系、数据模型提示、层标签
  2. 构建 DAG——默认顺序：架构 → API → FE → 测试；遵循明确指定的前置关系
  3. 按有界上下文分组——按领域／实体聚类
  4. 拆分过大的分组，条件如下：
    • 存在跨依赖的功能数 > 12，或
    • 预估任务数约为 50，或
    • 采用约 600k token 的启发式阈值
  5. 合并过小的分组——在安全的情况下，将相邻且任务数少于约 4 的切片合并；每个子版本目标为 4–7 个任务
  6. 拓扑排序——文件夹命名为 01-slug、02-slug、……
  7. 生成产物：
    • 版本根目录下的 version-roadmap.md
    • subversions/{subversion_san}/requirements.md——摘录，并链接到主文档 ../requirements.md#Feature-ID
    • 每个切片对应的空 subversions/{subversion_san}/tasks/

路线图表格列

| NN | slug | 功能 | 依赖项 | 预估任务数 | 预估 token 数 | 状态 |

将 status 初始设为 pending。

输出检查清单

  • 已保存 version-roadmap.md
  • 所有子版本文件夹均包含需求摘录和空的 tasks/
  • 未创建 task-*.md
  • 人工可在切片规划循环前进行审核

参考资料

文件适用时机
references/version-roadmap.template.md路线图结构
references/partition-workflow.md拆分后的编排循环

集成

拆分后 → Gate Roadmap（由人工确认）→ 规划每个切片（Gate 2–3，任务），无需重复 Gate 1。

评论

支持 Markdown