mcpField
N
ns-sdd-task-generator

ns-sdd-task-generator

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

关于 ns-sdd-task-generator

此技能将单个特性的原子切片转为供工程师或编码 Agent 实施的详细任务文档。它要求遵循项目架构规则与需求,并按后端、前端或基础设施层编写验证标准。

主要功能

  1. 01生成带路径和验证标准的详细任务
  2. 02先读取架构规则及需求文档
  3. 03区分后端、前端与基础设施任务
  4. 04遵循依赖顺序安排任务
  5. 05按前端界面和后端场景补充要求

适用场景

  1. 01将原子特性切片转成可执行的工程任务
  2. 02为编码 Agent 编写含实现位置和验收条件的任务说明

安装

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

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

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

附带文件evals/evals.jsonreferences/task-schema.md

详细介绍

任务生成器

将功能中的一个原子切片转换为详细的 task-NNN-slug.md,供工程师或编码 Agent 使用。

编排器(在该桥接工具存在时,必须启动 task-writer-agent — ../ns-harness/references/subagent-dispatch.md)。本文档是工作正文,不是从 ns-spec-driven 内联执行的邀请。

Harness 发现

参阅 ../ns-harness/references/harness-discovery.md。从 {harness_root}/rules/*.md 加载规则。先阅读 architecture-rules.md。旧版:仅当 {harness_root} 不存在时,才读取 .cursor/rules/*.mdc。严格遵循 requirements.md — 不要编造表或端点。

范围

  • 层级: Backend、Frontend、Infrastructure
  • 不属于此技能: E2E → ns-pm-e2e-test-task-generator;Backend 单元测试 → ns-pm-unit-test-task-generator

黄金规则

不要只写一句话的摘要。实施者必须清楚要做什么、在哪里做(可能涉及的路径)、适用的技术栈和规则,以及验收标准。详细部分不得原样重复摘要。

输入

  • 原子任务描述(来自编排器)
  • 层级类型:Backend | Frontend | Infra
  • {product_root}/docs/versions/{version_san}/requirements.md
  • 任务编号 NNN 和依赖任务

依赖

  • 外键父项先于子项 — 任务顺序须符合迁移/API 顺序
  • Frontend 调用 API → Backend 任务须先于 Frontend 任务
  • 完整文件模板参阅 references/task-schema.md

Frontend 额外要求

任务涉及 UI 时:

  • data-testid 约定 — 使用 kebab-case,并添加前缀(btn-、input-、form- 等)
  • 认证表单:存在相关 Frontend 规则时,使用营销面板、PasswordInput,并添加 i18n 键
  • i18n:所有字符串都通过翻译键处理;日期/货币使用 useFormat()
  • 导航:添加菜单项时使用 groupKey(如果存在导航规则)

Backend 额外要求

当 uses_grogoo: false(默认值)时:使用 Sanctum 和手动模块 — 不得引用 Grogoo。

涉及多租户时:在 criteria 中明确验证 company_id / 所有权。

输出路径

{product_root}/docs/versions/{version_san}/tasks/task-NNN-slug.md

对于子版本:放在 subversions/{subversion_san}/tasks/ 下。

参考资料

文件适用场景
references/task-schema.md完整的 Markdown 模板和标题字段

相关技能

  • ns-pm-unit-test-task-generator — Backend 实施任务之后
  • ns-pm-e2e-test-task-generator — 带 UI 的 Frontend 任务之后
  • ns-sdd-execution-handoff-generator — 该版本的所有任务编写完成之后(规划收尾)

评论

支持 Markdown