groove-utilities-task-update 是一个任务更新实用工具,用于在已配置的后端中更新现有任务。
用途
该工具的核心目标是更新任务的状态、正文或元数据。所有更新都发生在配置好的后端中,进度备注以追加方式写入,不会覆盖任务正文中已有的内容。当任务被标记为完成时,工具会先在任务正文中写入一段解决方案——可以是“变更摘要(Summary of Changes)”或“废弃原因(Reasons for Scrapping)”——然后再将任务标记为完成。
主要能力
- 更新后端中指定字段。
- 保留已有正文内容,新内容以追加方式添加。
- 已完成任务的正文中包含“变更摘要”或“废弃原因”段落。
- 在任务被标记为完成或废弃前,要求用户确认。
验收标准
- 指定字段已在后端更新。
- 已有正文内容被保留,新内容以追加方式添加。
- 已完成任务的正文中包含“变更摘要”或“废弃原因”段落。
- 在任务标记为完成或废弃前,用户已确认。
使用方式与约束
- 从 .groove/index.md 读取 tasks.backend 以确定后端。
- 如果 tasks.backend: none,则不执行任何操作,并给出友好提示。
- 绝不在正文缺少解决方案段落的情况下将任务标记为完成。
- 如果任务正文中没有解决方案,则要求用户提供。
- 用户必须明确确认完成——不得自动完成。
- 进度备注应作为带日期的项目符号追加到“Progress”段落之下。
后端映射
- beans:beans update <id> -s <status> 和 beans update <id> -d "<body>"
- linear:通过 linear CLI 或 MCP 更新 issue
- github:gh issue edit <number> --body "<body>" 以及 label/close 命令
适用场景
适用于需要在统一配置下管理任务状态的团队或个人,尤其是使用 beans、linear 或 github 作为任务后端的工作流。
限制
关于该工具的更多细节(如具体收费、价格、平台支持范围、实际效果等)暂未提供。