From efcb8d2100ef4fc9df5980aafb69d38a63ddc2ba Mon Sep 17 00:00:00 2001 From: Ariver <shanghai3168@gmail.com> Date: Wed, 10 Jun 2026 12:00:31 +0800 Subject: [PATCH] Update local session history policy --- .gitignore | 4 ++++ AGENTS.md | 16 +++++++++------- 2 files changed, 13 insertions(+), 7 deletions(-) diff --git a/.gitignore b/.gitignore index 5a5d866..7342ec4 100644 --- a/.gitignore +++ b/.gitignore @@ -18,3 +18,7 @@ # Local scratch notes. /项目管理规范.md + +# Local Codex session memory and runtime data. +/.codex/ +/.codex-sessionhistory/ diff --git a/AGENTS.md b/AGENTS.md index 6d52102..d381b36 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -36,13 +36,15 @@ ## 对话记忆保存规则 -本项目必须严格执行对话记忆保存。 +本项目需要保存重要会话记忆，但不得为了普通会话记录频繁打断用户审批。 -- 保存根目录：`/Users/ar/Projects/X-sessionhistory/Taglauncher/` -- 每一轮与 Taglauncher 有关的实质对话 / 决策 / 文件修改 / 排查过程，都必须保存为一个独立 Markdown 文件。 -- 文件名格式：`YYYY-MM-DD-主题.md`。 -- 主题必须概括本轮 session 的核心内容，控制在 20 个字符以内，优先使用中文短语，避免空格、`/`、`:` 等不适合作为文件名的字符。 +- 首选保存目录：项目根目录下的 `.codex-sessionhistory/`，即 `/Users/ar/Projects/Taglauncher/.codex-sessionhistory/`。 +- 只在发生以下情况时保存会话记录：关键决策、文件修改、发布 / 构建 / QA 结论、重大问题排查、用户明确要求保存、阶段性收尾。 +- 纯询问、路径确认、状态查询、简单说明、无实质决策或无文件变更的对话，不强制保存。 +- 文件名格式：`YYYY-MM-DD-主题.md`；主题必须概括本轮 session 的核心内容，控制在 20 个字符以内，优先使用中文短语，避免空格、`/`、`:` 等不适合作为文件名的字符。 - 如果同一天同主题已有记录文件，必须创建新文件并追加序号，避免覆盖：`YYYY-MM-DD-主题-01.md`、`YYYY-MM-DD-主题-02.md`。 - 保存内容至少包括：用户目标、已完成事项、关键决策、文件变更、未决问题、后续建议。 -- 在最终答复用户前，必须完成本轮会话记录保存；如果因为权限、路径或上下文不足无法保存，必须在最终答复中明确说明。 -- 跨项目对话以主要项目保存；如果多个项目都有实质决策或改动，应分别在对应项目文件夹保存摘要，或保存到 `/Users/ar/Projects/X-sessionhistory/_CrossProject/`。 +- 如果首选目录在当前沙盒下不可写，不得发起额外权限审批；必须改存到当前 Codex 工作区的 `.codex-sessionhistory/Taglauncher/`，并在最终答复中说明实际保存位置。 +- 只有首选目录和当前工作区备用目录都不可写时，才允许跳过保存，并在最终答复中说明原因。 +- 如果确需保存，应一次性保存本轮完整摘要，避免为了会话记录反复修正。 +- 跨项目对话以主要项目保存；如果多个项目都有实质决策或改动，应按同样的首选目录 / 当前工作区备用目录规则分别保存摘要。 -- Gitblit v1.9.3