groove-utilities-memory-graduate

用途

groove-utilities-memory-graduate 用于将一条稳定的工作流经验从 .groove/memory/learned/ 提升到 AGENTS.md，作为永久约束，使其对每个智能体会话可见，无需运行 prime。

主要能力

• 从 .groove/memory/learned/<topic>.md 读取经验条目并展示。
• 将选定的经验追加到 AGENTS.md 的 <!-- groove:learned:start --> / <!-- groove:learned:end --> 区块中的 ## Graduated Learnings 小节。
• 若该区块不存在，则创建它。
• 写入前要求用户确认确切文本。
• 将源 learned/<topic>.md 中的条目标记为已提升（不删除）。

使用方式

1. 记忆路径始终为 .groove/memory/。
2. 如果 $ARGUMENTS 指定了主题，则读取 .groove/memory/learned/<topic>.md 并展示其条目；否则列出 .groove/memory/learned/ 下所有 *.md 文件，并询问要从哪个主题提升。
3. 展示文件内容，询问：“Which entry should be graduated? (paste or describe it)”
4. 展示将写入 AGENTS.md 的确切文本，询问：“Confirm? (yes / edit / skip)”
5. 若确认，则写入 AGENTS.md（见下方区块管理）。
6. 在 learned 文件中该条目后内联追加 [graduated YYYY-MM-DD] 进行标记。
7. 报告：“Lesson graduated to AGENTS.md → ## Graduated Learnings”

AGENTS.md 中的区块管理

查找 <!-- groove:learned:start --> / <!-- groove:learned:end --> 区块：

• 若区块存在：在区块内 ## Graduated Learnings 下追加新经验作为一条项目符号。
• 若区块不存在：将以下内容追加到 AGENTS.md 末尾：

<!-- groove:learned:start -->

Graduated Learnings

Stable workflow insights promoted from .groove/memory/learned/. These apply to every session.

• <insight text> <!-- groove:learned:end -->

每条条目为单条项目符号：- <insight text> (from learned/<topic>.md, graduated YYYY-MM-DD)

适用场景

当某条经验足够稳定、适用于未来所有会话时使用。

限制

• 未经用户对确切文本的明确确认，绝不提升。
• 绝不从 learned/<topic>.md 删除源条目——用 [graduated YYYY-MM-DD] 内联标记为已提升；完整上下文保留在文件中。
• <!-- groove:learned:* --> 区块归用户所有——groove update 不会覆盖它。
• 保持已提升经验简洁——每条项目符号一句可操作的话；若过长请用户精简。
• 若 AGENTS.md 不存在：创建它，仅包含 graduated learnings 区块。
• 若同一经验已存在于区块中（完全匹配）：跳过并报告“Already graduated.”