groove-utilities-memory-mistakes

用途

groove-utilities-memory-mistakes 用于处理智能体在工作流中犯下的错误：记录事故、修复根本原因，并把经验教训「毕业」到长期记忆，避免同类问题反复出现。当智能体出现你希望防止再次发生的错误时使用它。

主要能力

• 记录工作流事故，包含根本原因与修复方案。
• 将永久性修复写入 .groove/memory/learned/<topic>.md。
• 将事故标记为已解决。
• 支持通过 --list 仅列出未关闭的事故。

使用方式

如果提供了 $ARGUMENTS，则将其作为错误描述（例如 --list 用于仅显示未关闭的事故）。

任务后端

从 .groove/index.md 读取 tasks.backend。事故在配置的后端中作为任务跟踪。如果未配置任务后端（tasks.backend: none），需告知用户先运行 /groove-utilities-task-install。

事故作为 bug 存储在共享的「Groove Memory」里程碑 → 「Mistakes」史诗下。

确保父级层级

在任何操作之前，先解析或创建父级史诗：

1. 查找或创建 Groove Memory 里程碑：
   • beans list -t milestone --search "Groove Memory" -q —— 若非空，使用第一个 ID；否则 beans create "Groove Memory" -t milestone
2. 在该里程碑下查找或创建 Mistakes 史诗：
   • beans list -t epic --parent <milestone-id> --search "Mistakes" -q —— 若非空，使用第一个 ID；否则 beans create "Mistakes" -t epic --parent <milestone-id>

--list

1. 解析 <parent-id>
2. beans list --parent <parent-id> -t bug -s in-progress
3. 以编号列表显示：1. [<id>] <title>
4. 若为空：打印 "No open incidents."

记录并解决事故

1. 解析 <parent-id>
2. 从 $ARGUMENTS 获取描述，或询问："What mistake did I make?"
3. 询问："Root cause — why did it happen?"（可从上下文提出建议；由用户确认）
4. 询问："What fix should be applied?"（提出建议；由用户确认）
5. beans create "<description>" -t bug --parent <parent-id> -s in-progress
6. 立即应用修复（编辑相关文件）
7. 询问："Which learned topic? (e.g. anti-patterns, tools)" —— 根据根本原因提出建议
8. 在 ## YYYY-MM-DD 标题下将教训追加到 .groove/memory/learned/<topic>.md
9. beans update <id> -s completed
10. 报告："Incident resolved → learned/.md"

适用场景

当智能体出现你希望防止再次发生的工作流错误时使用。

限制与约束

• 从 .groove/index.md 读取 tasks.backend；记忆路径始终为 .groove/memory/。
• 需要已配置的任务后端——若 tasks.backend: none，提示用户安装一个。
• 未经用户确认，绝不自动创建事故。
• 解决前必须提供根本原因——不要跳过审计步骤。
• 父级层级是幂等的——创建前始终先检查。
• 如果修复目标是 skills/ 文件：注意 skills/ 由 groove:update 管理；应将修复重定向到 learned/anti-patterns.md。

验收标准

• 事故已记录，包含根本原因与修复。
• 永久性修复已应用到 .groove/memory/learned/<topic>.md。
• 事故已标记为已解决。