关于 ns-sdd-task-generator
此技能将单个特性的原子切片转为供工程师或编码 Agent 实施的详细任务文档。它要求遵循项目架构规则与需求,并按后端、前端或基础设施层编写验证标准。
主要功能
- 01生成带路径和验证标准的详细任务
- 02先读取架构规则及需求文档
- 03区分后端、前端与基础设施任务
- 04遵循依赖顺序安排任务
- 05按前端界面和后端场景补充要求
适用场景
- 01将原子特性切片转成可执行的工程任务
- 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— 该版本的所有任务编写完成之后(规划收尾)