mcpField
T
task-generator

task-generator

github.com/nextstage-brasil开发041 次安装5 天前更新
代码仓库

关于 task-generator

将功能中的一个原子工作切片转为详细 Markdown 任务,供工程师或编码 Agent 使用。适用于后端、前端和基础设施工作,并依据需求、依赖关系和验证标准编写实施说明。

主要功能

  1. 01生成带编号的 Markdown 任务文件
  2. 02覆盖后端、前端和基础设施
  3. 03依据架构及 harness 规则
  4. 04提供分层实施指导
  5. 05记录依赖关系和验证标准

适用场景

  1. 01将功能拆分为可实施的任务切片
  2. 02编写包含 data-testid 契约的前端任务
  3. 03按 API 依赖安排前后端任务顺序
  4. 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