mcpField
N
ns-sdd-requirements-generator

ns-sdd-requirements-generator

github.com/nextstage-brasil開発068 回インストール1 日前に更新
リポジトリ

ns-sdd-requirements-generator について

ns-sdd-requirements-generatorは、製品のドキュメントツリーにバージョン別の要件書を作成するスキルです。確認済みの技術スタックに合わせて内容を調整し、新規・既存プロジェクトに対応します。

主な機能

  1. 01バージョン別requirements.mdの作成
  2. 02技術スタックプロファイルの選択
  3. 03新規プロジェクトの基盤要件を整理
  4. 04UI/UXと受け入れ基準の記載
  5. 05データモデルとエンドポイントの明示

活用シーン

  1. 01製品バージョンの要件書作成
  2. 02新規プロジェクトの要件整理
  3. 03既存コードベース向け要件の生成

インストール

コマンドをコピーしてターミナルで実行します。

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

インストール後、Claude Code で/ns-sdd-requirements-generatorを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

evals/
evals.json
references/stacks/
generic.md
intelligent-saas.md
laravel-react.md

詳細

要件ジェネレーター

{product_root}/docs/versions/{version_san}/ に構造化された requirements.md を作成します。

ハーネスの検出

../ns-harness/references/harness-discovery.md と ../ns-harness/references/artifact-layout.md を参照してください。書き込みを開始する前に、{product_root}/docs/versions/{version_san}/ を作成してください。

入力

  • スコープの説明(ns-sdd-clarify-requirements によって補足されている場合があります)
  • {product_root}、{version_san}
  • 任意:design-brief.md、スタックプロファイル、ブラウンフィールドマップ、オーケストレーターからのウェブ調査

スタックプロファイル

スタックが判明している場合は、references/stacks/ からプロファイルを1つ読み込みます。

プロファイル使用する場合
generic.mdデフォルト — スタックに依存しない構成
laravel-react.mdLaravel + React のモノレポが検出または確認された場合
intelligent-saas.mdバックエンド + フロントエンド + agent-api の場合

プロファイルまたは検出されたスタックが該当しない限り、フレームワーク固有のツールには言及しないでください。

ドキュメントの構成

Markdown ドキュメントのみを生成します(会話形式の前置きは付けません)。

## Main objective of the version:

{executive summary}

## Technology stack:

{confirmed stack — reference applicable rules when harness has them}

## UI/UX guidelines:

{from design-brief when frontend in scope — omit if backend-only}

## Data model and APIs:

{tables, FK order, key endpoints — source of truth for tasks}

## Feature grouping:

### Feature 001 - TITLE

**Precedence:** None | Feature NNN
**Layers:** Backend | Frontend | Infrastructure | Tests
**Detailed description:** ...

#### Acceptance criteria:

- [ ] ...

## Non-functional requirements (NFRs):

...

新規プロジェクトの順序

プロジェクトがグリーンフィールドの場合、(スタックプロファイルに従って)インフラストラクチャ/セットアップの機能をドメイン機能より先に配置します。順序は、インフラ → データベース → キャッシュ/キュー → バックエンドモジュール → フロントエンド → テストです。

言語

成果物についてユーザーが別の言語を明示的に指定しない限り、英語を使用します。

ルール

  • 確認済みの {product_root} のみで作業します
  • 調査結果が提供された場合、NFR または受け入れ基準に反映します
  • フロントエンド機能については、デザインブリーフの UI/UX セクションを含め、該当する場合はビジュアルトークンの受け入れ基準を記載します
  • データモデルのセクションは重要です。テーブルの作成順序とエンドポイントを明記します

統合

  • 生成後:Gate 1(requirements_confirmed)— ../ns-harness/references/gates.md を参照してください
  • 次のステップ:Gate 2 の後に ns-sdd-analyze-consistency
  • Intelligent SaaS/agent-api の場合:親の ns-spec-driven は ns-langgraph-agents を読み込む必要があります — ../ns-spec-driven/references/agent-runtime-integration.md を参照してください

参考資料

ファイル使用する場合
references/stacks/generic.mdデフォルト
references/stacks/laravel-react.mdLaravel/React スタック
references/stacks/intelligent-saas.mdエージェント拡張 SaaS

コメント