关于 task-generator
将功能中的一个原子工作切片转为详细 Markdown 任务,供工程师或编码 Agent 使用。适用于后端、前端和基础设施工作,并依据需求、依赖关系和验证标准编写实施说明。
主要功能
- 01生成带编号的 Markdown 任务文件
- 02覆盖后端、前端和基础设施
- 03依据架构及 harness 规则
- 04提供分层实施指导
- 05记录依赖关系和验证标准
适用场景
- 01将功能拆分为可实施的任务切片
- 02编写包含 data-testid 契约的前端任务
- 03按 API 依赖安排前后端任务顺序
- 04记录实施说明和验证要求
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ nextstage-brasil/ skills --skill task-generator安装后在 Claude Code 中输入/task-generator确认已加载。
附带文件evals/evals.jsonreferences/task-schema.md
详细介绍
任务生成器
将功能的一个原子切片转换为详细的 task-NNN-slug.md,供工程师或编码 Agent 使用。
Harness 发现
参见 ../nextstage-harness/references/harness-discovery.md。从 {harness_root}/rules/*.md 加载规则。先阅读 architecture-rules.md。旧版规则:仅当 {harness_root} 不存在时,才读取 .cursor/rules/*.mdc。严格阅读 requirements.md——不得臆造表或端点。
范围
- 层级: Backend、Frontend、Infrastructure
- 不属于此技能: E2E →
e2e-test-generator;Backend 单元测试 →unit-test-task-generator
黄金规则
不得只写一行摘要。实施者必须清楚要做什么、在哪里做(可能涉及的路径)、适用哪些技术栈和规则,以及验证标准。详细部分不得原样重复摘要。
输入
- 原子任务描述(来自编排器)
- 层级类型:Backend | Frontend | Infra
{product_root}/docs/versions/{version_san}/requirements.md- 任务编号
NNN和依赖任务
依赖关系
- FK 父项必须先于子项——任务顺序应与迁移/API 顺序一致
- Frontend 消费 API 时,Backend 任务必须先于 Frontend 任务
- 完整文件模板参见
references/task-schema.md
分类
- 错误 — 现有功能中的 Bug
- 改进 — 对现有功能的行为变更
- 实现 — 新功能
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 模板和头部字段 |
相关技能
unit-test-task-generator— Backend 实现任务之后e2e-test-generator— 涉及 UI 的 Frontend 任务之后execution-handoff-generator— 该版本的所有任务编写完成之后(规划收尾)
评论
支持 Markdown