groove-utilities-memory-graduate

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

groove-utilities-memory-graduate

Promote a stable workflow insight from

<memory>/learned/

into

AGENTS.md

as a permanent constraint — visible to every agent session without needing to run prime.

Use $ARGUMENTS as the topic or insight text if provided.

将稳定的工作流洞见从

<memory>/learned/

升级收录到

AGENTS.md

作为永久约束——无需运行 prime 即可对所有 Agent 会话可见。

如果提供了 $ARGUMENTS，则将其用作主题或洞见文本。

Outcome

结果

The lesson is appended to a

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

<!-- groove:learned:end -->

section in

AGENTS.md

, making it permanently visible to all future sessions.

经验会被追加到 AGENTS.md 中的

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

<!-- groove:learned:end -->

区块，使其对所有未来会话永久可见。

Acceptance Criteria

验收标准

Insight is appended to the
```
## Graduated Learnings
```
section in
```
AGENTS.md
```
Section is created if it does not exist
User confirms the exact text before writing
Source
```
learned/<topic>.md
```
entry is marked as graduated (not deleted)

洞见被追加到 AGENTS.md 的
```
## Graduated Learnings
```
章节
若章节不存在则自动创建
写入前需用户确认最终文本
源文件
```
learned/<topic>.md
```
中的条目会被标记为已收录（不会删除）

Steps

步骤

Read
```
memory:
```
from
```
.groove/index.md
```
If $ARGUMENTS names a topic, read
```
<memory>/learned/<topic>.md
```
and show its entries. Otherwise, list all
```
*.md
```
files in
```
<memory>/learned/
```
and ask which topic to graduate from.
Show the file contents; ask: "Which entry should be graduated? (paste or describe it)"
Show the exact text that will be written to AGENTS.md; ask: "Confirm? (yes / edit / skip)"
If confirmed: write to AGENTS.md (see section management below)
Mark the entry in the learned file by appending
```
[graduated YYYY-MM-DD]
```
inline after the bullet
Report: "Lesson graduated to AGENTS.md → ## Graduated Learnings"

读取
```
.groove/index.md
```
中的
```
memory:
```
配置
如果 $ARGUMENTS 指定了主题，读取
```
<memory>/learned/<topic>.md
```
并展示其条目。否则，列出
```
<memory>/learned/
```
下所有
```
*.md
```
文件，询问要从哪个主题收录。
展示文件内容；询问："Which entry should be graduated? (paste or describe it)"
展示将写入 AGENTS.md 的最终文本，询问："Confirm? (yes / edit / skip)"
若确认：写入 AGENTS.md（参见下方的章节管理规则）
在源学习文件的对应条目后方追加
```
[graduated YYYY-MM-DD]
```
进行标记
反馈："Lesson graduated to AGENTS.md → ## Graduated Learnings"

Section management in AGENTS.md

AGENTS.md 的章节管理规则

Look for a

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

<!-- groove:learned:end -->

block:

If the block exists: append the new insight as a bullet under
```
## Graduated Learnings
```
inside the block
If the block does not exist: append the following to the end of
```
AGENTS.md
```
:

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

查找

<!-- 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>


Each entry is a single bullet: `- <insight text> *(from learned/<topic>.md, graduated YYYY-MM-DD)*`

Stable workflow insights promoted from

.groove/memory/learned/

. These apply to every session.

<insight text>


每条条目为单个列表项：`- <insight text> *(from learned/<topic>.md, graduated YYYY-MM-DD)*`

Constraints

约束

Never graduate without explicit user confirmation of the exact text
Never delete the source entry from
```
learned/<topic>.md
```
— mark it as graduated with
```
[graduated YYYY-MM-DD]
```
inline; the full context stays in the file
The
```

```
section is user-owned — groove update will not overwrite it
Keep graduated lessons concise — one actionable sentence per bullet; ask user to trim if longer
If AGENTS.md does not exist: create it with just the graduated learnings section
If the same insight is already present in the block (exact match): skip and report "Already graduated."

未获得用户对最终文本的明确确认前，不得执行收录操作
不得删除
```
learned/<topic>.md
```
中的源条目——仅追加
```
[graduated YYYY-MM-DD]
```
进行标记，完整上下文会保留在文件中
```

```
区块归用户所有——groove 更新不会覆盖该区块
保持收录的经验简洁——每个列表项为一句可执行的表述；如果过长请要求用户精简
如果 AGENTS.md 不存在：创建该文件，仅包含已收录经验章节
如果区块中已存在相同洞见（完全匹配）：跳过操作并反馈 "Already graduated."