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. 04纳入 UI/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。

Harness 发现

参阅 ../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/ 中加载一个配置：

配置适用情况
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} 下操作
  • 如提供了调研内容，将其纳入非功能需求或验收标准
  • 对于前端功能：纳入设计简报中的 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.mdAgent 增强型 SaaS

评论

支持 Markdown