ns-sdd-version-partitioner について
マスターの requirements.md を順次計画できるサブバージョンに分割し、ロードマップと要件の抜粋を作成するスキルです。この文書ベースのバージョン計画を行うチーム向けです。
主な機能
- 01機能、依存関係、データモデルの手掛かりを解析
- 02依存関係の DAG を構築
- 03ドメイン別に分類し、大きなスライスを分割
- 04ロードマップと要件抜粋を作成
- 05各スライスに空の tasks ディレクトリを作成
活用シーン
- 01大規模なリリース要件を順次計画する単位に分割
- 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.jsonreferences/partition-workflow.mdversion-roadmap.template.md詳細
バージョン分割ツール
master の requirements.md を分割し、順次計画できるサブバージョンにします。
ハーネスの確認
../ns-harness/references/artifact-layout.md と ../ns-harness/references/harness-discovery.md を参照してください。ハーネスに core-subversions ルールがある場合は読み込んでください。
対象範囲
- 読み取り専用: master
{product_root}/docs/versions/{version_san}/requirements.md - 禁止事項: タスクや execution-handoff の生成、Gate 1 の再実行
- 読み込まない: 製品のバックエンド/フロントエンドのルール — 構造上の分割のみ行います
アルゴリズム
- master を解析 — 機能、優先順位、データモデルのヒント、レイヤータグ
- DAG を構築 — デフォルトの順序は schema → API → FE → テストです。明示された優先順位があればそれに従います
- 境界コンテキストごとにグループ化 — ドメイン/エンティティごとにまとめます
- 規模が大きすぎるグループを分割する条件:
- 相互依存する機能が 12 を超える、または
- 推定タスク数が約 50、または
- トークン数のヒューリスティックが約 600k
- 規模が小さすぎるグループを統合 — 安全な場合は、約 4 タスク未満の隣接スライスを統合します。サブバージョンあたり4~7 タスクを目標にします
- トポロジカルソート — フォルダー名は
01-slug、02-slug、… とします - 成果物を出力:
- バージョンのルートに
version-roadmap.md subversions/{subversion_san}/requirements.md— 抜粋と、master の../requirements.md#Feature-IDへのリンク- 各スライスに空の
subversions/{subversion_san}/tasks/
- バージョンのルートに
ロードマップの表の列
| NN | slug | 機能 | 依存関係 | 推定タスク数 | 推定トークン数 | ステータス |
status は pending で開始します。
出力チェックリスト
-
version-roadmap.mdを保存 - 抜粋した要件を含むすべてのサブバージョンフォルダーと、空の
tasks/ -
task-*.mdが作成されていない - 人がスライス計画のループ前にレビューできる
参照資料
| ファイル | 用途 |
|---|---|
references/version-roadmap.template.md | ロードマップの構成 |
references/partition-workflow.md | 分割後のオーケストレーターのループ |
統合
分割後 → Gate Roadmap(人が確認)→ Gate 1 を繰り返さずに各スライスを計画(Gate 2~3、タスク)。
コメント
Markdown 対応