# A2md 对话记忆

用于集中保存 Codex / AI 助手在 A2md 项目中的对话记录、决策、文件变更和后续事项。

## 1. 保存目录

`/Users/ar/Projects/A2md/.codex-sessionhistory`

- 上述目录是本项目默认使用的对话记忆写入目录。
- 目录说明与模板以以下文件为准：
  - `/Users/ar/Projects/A2md/.codex-sessionhistory/README.md`
  - `/Users/ar/Projects/A2md/.codex-sessionhistory/_templates/session.md`

## 2. 保存规则

- 文件名格式必须为：`YYYY-MM-DD-对话标题-主题.md`。
  - 对话标题：本轮对话所属的大类，如 `规则树管理大师`、`研发项目初始化`、`Mac与软件使用`。
  - 主题：本份记录的具体主题，控制在 20 个字符以内。
  - 不得省略“对话标题”。
  - 示例：`2026-06-24-规则树管理大师-项目初始化.md`。
- 主题必须能概括本轮 session 的核心内容，控制在 20 个字符以内。
- 主题优先使用中文短语，避免空格、`/`、`:` 等不适合作为文件名的字符。
- 如果同一日期、同一对话标题、同一主题已有记录，使用序号避免覆盖：
  - `YYYY-MM-DD-对话标题-主题-01.md`
  - `YYYY-MM-DD-对话标题-主题-02.md`

每个会话文件至少包含：

- 基本信息：日期、对话标题、会话主题、保存依据、记录状态。
- 用户问题/诉求：用户这轮真正想完成什么。
- 回复内容：实际做了哪些操作。
- 回复建议备忘：给过的重要命令、路径、口令或可复用操作。
- 关键决策：后续需要继承的判断和约定。
- 相关文件：涉及哪些文件。
- 未决问题：还有什么没有定。

## 3. 使用限制

这个目录是一套“可执行的保存约定”，但不是系统级自动钩子。

当前可行方式：

- 用户明确要求保存时，由助手写入对应文件。
- 项目 `AGENTS.md` 已引用本规则后，助手在本项目内按规则执行。
- 会话结束前，用户要求“保存本轮记忆”，助手按模板落盘。

当前不可保证：

- 不依赖助手执行、自动监听所有未来对话。
- 在所有项目中无条件自动保存每一个消息轮次。

## 4. 推荐执行口令

可以在会话末尾直接说：

> 保存本轮对话
>
> 保存会话