# Auto-Learn 指南

Auto-Learn 是 Quorum 的个人持久化经验层。
它让 agent 在多次会话中记住稳定偏好和可复用工程实践，从而减少重复沟通，提升执行一致性与效率。

## Auto-Learn 是什么

Auto-Learn 将可复用经验保存在用户作用域：

- `~/.quorum/AUTO-LEARNED.md`（高信号索引，会话启动时加载）
- `~/.quorum/learned/*.md`（按主题存放的详细经验）

这是个人经验层，不是项目规则层。

- 项目规则：`AGENTS.md`、`CLAUDE.md`
- 项目知识：`.quorum/MEMORY.md`
- 个人可复用经验：Auto-Learn（`~/.quorum/...`）

## 为什么它有价值

Auto-Learn 的目标是提升日常编码吞吐：

- 减少重复说明：稳定偏好无需每次重说。
- 提升一致性：agent 能持续沿用你的工作方式。
- 加快恢复速度：常见问题的处理套路可直接复用。
- 跨项目复利：一个项目学到的通用习惯可用于其他项目。

## 适合记录什么

建议记录：

- 稳定的沟通和交付偏好
- 跨项目通用的编码/调试/验证流程
- 反复出现问题的通用解决方法

不建议记录：

- 一次性会话上下文
- 项目私有实现细节
- 密钥、凭据、令牌等敏感信息
- 未验证的猜测结论

## 在 TUI 里触发“保存”

最稳妥方式是明确说“记住”。

示例：

- `记住这条偏好：先给最小修复，再给可选重构方案。`
- `请记住我的工作流：改代码后先跑受影响测试。`
- `记住到 tooling 主题：搜索优先用 rg，Python 脚本优先 uv run。`

## 在 TUI 里触发“忘记/删除”

最稳妥方式是明确说“忘记/删除这条记忆”。

示例：

- `忘记这条记忆：回复必须总是很长。`
- `请删除这条偏好：每次提交前都跑全量测试。`
- `在 debugging 主题里忘记这条：先重启机器再排查。`

## 推荐提示词模板

保存模板：

```text
请记住这条长期偏好：
<偏好或可复用实践>
如果已有相似条目，请更新，不要重复新增。
```

忘记模板：

```text
请忘记这条记忆：
<要删除的内容>
如果有近义重复条目，也请一并清理。
```

校验模板：

```text
请简要总结你当前记住的与 <主题> 相关经验。
```

## 配合 `/learn` 命令使用

建议把自然语言触发与 `/learn` 命令组合：

- `/learn list`
- `/learn show <topic>`
- `/learn clean`
- `/learn off`
- `/learn on`

推荐流程：

1. 用自然语言触发“记住/忘记”。
2. 用 `/learn show` 做快速复核。
3. 定期执行 `/learn clean` 清理过时内容。

## 示例文件

- [AUTO-LEARNED 示例](./samples/AUTO-LEARNED.md)
- [主题示例（debugging）](./samples/learned/debugging.md)

## 安全提示

不要让 Auto-Learn 记录任何密钥或凭据。
如果敏感信息误入记忆文件，请立即删除并轮换相关凭据。