ns-sdd-requirements-generator について
ns-sdd-requirements-generatorは、製品のドキュメントツリーにバージョン別の要件書を作成するスキルです。確認済みの技術スタックに合わせて内容を調整し、新規・既存プロジェクトに対応します。
主な機能
- 01バージョン別requirements.mdの作成
- 02技術スタックプロファイルの選択
- 03新規プロジェクトの基盤要件を整理
- 04UI/UXと受け入れ基準の記載
- 05データモデルとエンドポイントの明示
活用シーン
- 01製品バージョンの要件書作成
- 02新規プロジェクトの要件整理
- 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.jsonreferences/stacks/generic.mdintelligent-saas.mdlaravel-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.md | Laravel + 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.md | Laravel/React スタック |
references/stacks/intelligent-saas.md | エージェント拡張 SaaS |