groove-utilities-memory-promises

groove-utilities-memory-promises

如果提供了 $ARGUMENTS，则将其用作承诺文本；否则使用标志：

• --list：显示所有未解决的承诺
• --resolve <N>：将承诺 N 标记为已解决

结果

在会话中延后的事项会在被遗忘前记录下来，或对现有未解决的承诺进行检查并将其解决。

验收标准

• 记录新承诺，并附上日期和可选的上下文
• --list 清晰地显示所有带编号的未解决承诺
• --resolve N 将承诺 N 标记为已解决

任务后端

从 .groove/index.md 读取 tasks.backend。承诺会作为任务记录在配置的后端中。如果未配置任务后端（tasks.backend: none），请告知用户先运行 /groove-utilities-task-install。

承诺会作为任务存储在共享的「Groove Memory」里程碑 →「Promises」史诗层级下。这样可以让它们井然有序，并与主要工作任务列表分开。

确保父级层级结构

每次操作前，解析或创建父级史诗：

1. 查找或创建 Groove Memory 里程碑：
   • beans list -t milestone --search "Groove Memory" -q — 如果输出不为空，则使用第一个 ID；否则运行 beans create "Groove Memory" -t milestone 并获取新 ID
2. 在该里程碑下查找或创建 Promises 史诗：
   • beans list -t epic --parent <milestone-id> --search "Promises" -q — 如果输出不为空，则使用第一个 ID；否则运行 beans create "Promises" -t epic --parent <milestone-id> 并获取新 ID

将 Promises 史诗 ID 用作所有承诺任务的 <parent-id>。

--list

1. 解析 <parent-id>（见上文）
2. 运行 beans list --parent <parent-id> -s todo -t task
3. 显示为带编号的列表：1. [<id>] <title> — 位置编号用于 --resolve N，方括号中为 beans ID
4. 如果列表为空：打印「No open promises.」

--resolve <N>

1. 解析 <parent-id>；运行 beans list --parent <parent-id> -s todo -t task
2. 查找第 N 项；如果未找到：打印「No open promise #N」并退出
3. 运行 beans update <id> -s completed
4. 确认：「Promise #N resolved.」

默认操作 — 添加承诺

1. 解析 <parent-id>（见上文）
2. 如果提供了 $ARGUMENTS，则从中获取承诺文本；否则询问：「What's being deferred?」
3. 可选地询问：「Any context? (enter to skip)」
4. 运行 beans create "<text>" -t task --parent <parent-id> -s todo -p deferred
5. 如果提供了上下文：运行 beans update <id> -d "<context>"
6. 确认：「Promise captured: [] 」

约束

• 每次调用开始时，都要从 .groove/index.md 读取 tasks.backend
• 需要配置任务后端 — 如果 tasks.backend: none，提示用户安装一个
• 未经用户确认，绝不自动记录承诺 — 始终明确征求确认
• 里程碑／史诗父级层级结构具有幂等性 — 创建前务必先检查，绝不重复创建
• 使用 -s todo 表示未解决，使用 -s completed 表示已解决；使用 -p deferred 表示不是当前进行中的工作
• 不要自动解决所有承诺；除非用户要求使用 --resolve-all，否则一次只解决一项
• --resolve-all 需要确认：在继续之前询问「Resolve all N open promises?」