用途
groove-utilities-task-create 用于在已配置的后端中创建一个新任务。它是 groove 体系中任务创建的唯一权威来源——其他需要创建任务的技能(如 work compound、daily 等)必须遵循本规范并调用本技能,而不是自行定义创建规则。
主要能力
创建任务时,任务包含标题、类型、状态、可选父任务,以及(针对非琐碎任务)丰富的正文。创建完成后返回任务 ID 供引用。
验收标准:
- 任务在后端中存在,且所有必填字段均已填充
- 创建后向用户显示任务 ID
- 非琐碎任务(功能开发、缺陷、计划、阶段任务)具有丰富正文——当任务代表真实工作或阶段时,绝不以空正文创建
- 当上下文暗示存在父任务时(例如每日任务或工作史诗下的阶段任务),设置父任务
使用方式
约束条件:
- 从 .groove/index.md 读取 tasks.backend 以确定后端
- 若 tasks.backend: none,则不执行任何操作并给出友好提示
- 若参数中未提供标题,则在继续前询问用户标题和类型
- 从当前上下文(未完成任务、近期工作)推断父任务,若存在歧义则与用户确认
- 默认状态为 in-progress(而非 todo)——任务是在工作正在进行时创建的
- 创建过程中不得自动将任何任务标记为已完成
后端映射:
- beans:beans create "<title>" -t <type> --parent <id> -s in-progress;正文通过 beans update <id> -d "<body>" 设置,或在基于文件的后端下编辑 .groove/tasks/ 中的任务文件
- linear:通过 linear CLI 或 MCP 创建 issue,并指定合适的团队/项目
- github:gh issue create --title "<title>" --body "<body>" --milestone <milestone>
正文(标准):对于任何非琐碎任务,始终提供正文。使用后端的正文/描述字段(或任务文件内容)。标准正文分节:Context(该任务所属的工作或会话)、Goal(高层意义上“完成”的含义)、Acceptance Criteria(具体条件的清单)、Links(指向 CHANGELOG、规格、learned 文件或其他产物的链接)。仅当某分节确实不适用时才省略。
类型:使用后端的类型(例如 beans:task、bug、feature、epic、milestone)。当后端没有 chore 类型时(例如 beans),阶段任务和书挡任务(每日 Start/End、工作阶段如 "YYYY-MM-DD, Compound — topic")使用 task 类型。
层级:当任务属于更大单元(例如某个每日任务、某个史诗)的一部分时,设置父任务。若调用方未指定父任务,则在可能时从上下文推断。
始终向用户回显所创建任务的 ID 和标题。
适用场景
适用于需要在 groove 配置的后端中创建任务的工作流,尤其是功能开发、缺陷修复、计划、阶段任务等非琐碎工作,以及需要统一任务创建规范的场景。
限制
- 依赖 .groove/index.md 中的 tasks.backend 配置;若为 none 则不执行操作
- 未提供标题时需先询问用户
- 父任务存在歧义时需与用户确认
- 创建时不得自动标记任务为已完成
- 具体后端行为取决于所配置的后端(beans、linear、github 等)