AGENTS.md on 拾光集

Codex + Obsidian 长期记忆配置：让 AI 跨项目记住工作进度和关键决策

Tue, 28 Jul 2026 19:42:00 +0800

Codex 每次开始新任务时，最麻烦的问题之一，就是需要重新解释项目背景、工作习惯和之前做过的决定。

解决这个问题的一种方法，是把 Obsidian 作为 Codex 的外部长期记忆库，将项目规划、关键决策、工作流程和每日复盘记录保存在本地 Markdown 文件中。

需要说明的是，这种方案并不是给 Codex 增加真正意义上的“永久大脑”，而是建立一套：

任务前读取历史信息，任务后更新工作记录的本地记忆工作流。

目前 Codex 已经提供本地 Memories 功能，相关文件默认保存在 ~/.codex/memories/，并可通过 /memories 控制当前对话是否读取或生成记忆。Obsidian 方案的价值，则在于记忆内容更加透明、可编辑、可分类，也更方便跨项目和跨工具使用。

一、Codex + Obsidian 的工作原理

整个流程可以分为四步：

在 Obsidian 中建立固定的记忆库目录。
使用 AGENTS.md 告诉 Codex 应该读取哪些笔记。
每次任务开始前，读取相关项目状态和历史决策。
任务完成后，将结果、问题和下一步计划写回 Obsidian。

Codex 会在执行任务前读取 AGENTS.md。你既可以在 ~/.codex/AGENTS.md 中设置全局规则，也可以在具体项目目录中添加项目级规则。

二、推荐的 Obsidian 记忆库结构

可以在 Obsidian Vault 中建立下面的目录：

Codex-Memory/
├── 00_INDEX.md
├── 01_GOALS/
│   └── long-term-goals.md
├── 02_PROJECTS/
│   ├── website.md
│   └── automation.md
├── 03_DECISIONS/
│   └── decision-log.md
├── 04_WORKFLOWS/
│   └── working-rules.md
├── 05_PREFERENCES/
│   └── user-preferences.md
└── 06_DAILY/
    └── 2026-07-28.md

各目录可以分别保存：

00_INDEX.md：记忆库入口和目录说明。
01_GOALS：长期目标和当前重点。
02_PROJECTS：不同项目的背景、进度和待办事项。
03_DECISIONS：重要选择、原因和最终结论。
04_WORKFLOWS：代码规范、发布流程和操作步骤。
05_PREFERENCES：常用格式、表达习惯和工具偏好。
06_DAILY：每日任务总结和复盘记录。

不要让 Codex 每次读取整个 Obsidian 仓库。更合理的方式是先读取索引，再根据当前任务加载相关笔记，这样可以减少无关上下文和 Token 消耗。

三、配置 Codex 的 AGENTS.md

在全局 Codex 目录或项目根目录中创建：

`1`	`AGENTS.md`

Windows 用户通常可以放在：

`1`	`C:\Users\你的用户名\.codex\AGENTS.md`

示例内容：

# Codex 长期记忆规则

## Obsidian 记忆库

记忆库路径：

D:\Obsidian\Codex-Memory

## 开始任务前

1. 首先读取 `00_INDEX.md`。
2. 根据当前任务判断所属项目。
3. 读取对应的 `02_PROJECTS` 项目文件。
4. 检查 `03_DECISIONS` 中是否存在相关历史决策。
5. 只读取与当前任务直接相关的笔记，不要扫描整个仓库。

## 完成任务后

1. 更新对应的项目状态。
2. 将重要决策写入 `03_DECISIONS/decision-log.md`。
3. 将当天完成内容写入 `06_DAILY/YYYY-MM-DD.md`。
4. 记录遇到的问题、解决方案和下一步计划。
5. 不要保存密码、API Key、Cookie 或其他敏感信息。

## 记忆写入原则

只保存未来仍然有价值的信息，包括：

- 长期目标
- 项目背景
- 技术选择
- 关键决策及原因
- 可复用工作流程
- 用户明确表达的长期偏好

不要保存临时聊天、重复内容和一次性任务信息。

四、设置每日复盘

仅在 AGENTS.md 中写入“每天凌晨复盘”，并不会让 Codex自动执行。

要实现定时复盘，还需要使用：

Windows 任务计划程序
Linux 或 macOS 的 Cron
支持定时任务的 AI Agent
已经包含夜间整理功能的 Obsidian AI 项目

每天执行的复盘任务可以使用下面的提示词：

读取今天的项目记录和每日笔记。

请完成以下工作：

1. 总结今天完成的主要任务。
2. 提取值得长期保存的关键决策。
3. 更新对应项目的当前状态。
4. 合并重复或已经失效的信息。
5. 将复盘结果写入今天的每日笔记。
6. 不要写入密码、Token、Cookie 或其他敏感数据。

部分开源项目已经实现了夜间整理、索引更新和跨项目记忆功能，但不同项目的自动化程度并不相同。例如，codex-obsidian-memory-loop 明确定位为手动复盘工作流，而不是后台自动监控系统。

五、原生 Codex Memory 与 Obsidian 的区别

方案	主要特点	适合场景
Codex 原生 Memories	自动从历史对话生成本地记忆	希望简单开启、减少手动维护
Obsidian 记忆库	内容透明、可编辑、可分类	项目管理、知识沉淀、跨工具复用
AGENTS.md	固定 Codex 的读取和执行规则	编码规范、项目流程、记忆读取入口
定时复盘脚本	自动整理每日记录	长期项目和持续知识维护

更实用的方式不是二选一，而是组合使用：

使用 Codex Memories 保存自动生成的上下文。
使用 Obsidian 保存经过确认的重要知识。
使用 AGENTS.md 定义读取和写回规则。
使用定时任务完成每日整理。

六、使用时需要注意的问题

不要保存敏感信息

不要把下面的信息写入记忆库：

API Key
登录密码
Cookie
私钥
客户隐私资料
未脱敏的内部数据

Codex 官方也建议在共享 Codex 目录或记忆文件前检查其中是否包含敏感内容。

不要无限追加笔记

记忆库并不是越大越好。

如果所有对话和日志都永久保存，Codex 检索时反而更容易读到过期信息。建议定期执行：

删除重复记录
标记失效决策
合并相似笔记
更新项目当前状态
保留决策发生的时间和原因

重要操作仍需人工确认

Codex 可以参考历史记录，但涉及删除文件、修改生产环境、付款、发布和权限调整时，仍然应该由用户最终确认。

七、适合使用这套方案的人

这套 Codex + Obsidian 长期记忆工作流，比较适合：

同时维护多个代码项目的开发者
经常使用 Codex 处理重复任务的人
希望沉淀项目决策和踩坑记录的个人用户
使用多个 AI 编程工具的团队
希望将 Obsidian 打造成 AI 第二大脑的人

它真正解决的问题，不是让 Codex 永远记住所有聊天，而是让重要信息以本地文件的形式保存下来，并在需要时被准确读取。

Codex 最近变“啰嗦”了？在 AGENTS.md 加上这句提示词试试

Mon, 27 Jul 2026 22:04:00 +0800

最近使用 Codex 时，你可能会遇到这样的情况：

以前只需要一句话，Codex 就能直接修改代码、运行测试并完成任务；现在却经常输出大量过程说明，需要反复确认和引导，真正的代码修改反而变慢了。

遇到这种情况，可以尝试在 Codex 的 AGENTS.md 文件中加入下面这句指令：

`1`	`DO NOT send optional commentary.`

它的意思很简单：

不要发送非必要的过程说明。

这句提示词能解决什么问题？

Codex 在执行任务时，可能会主动输出以下内容：

接下来准备检查哪些文件
为什么选择某种实现方式
还可以继续做哪些可选优化
是否需要运行额外测试
大量并非必须的解释和总结

这些内容并不一定有错，但在需求已经非常明确时，过多的过程播报会让交互显得拖沓，也会占用额外的输出 Token。

加入这条指令后，Codex 通常会更倾向于：

直接读取代码并开始修改
减少不必要的进度说明
只保留与结果有关的信息
缩短最终回复
降低无效输出带来的 Token 消耗

简单理解就是：

需求明确时，直接做事，不要边做边反复解释。

正确添加到哪个文件？

正确的文件名是：

`1`	`AGENTS.md`

Codex 官方支持通过 AGENTS.md 为项目添加长期指令。每次开始任务前，Codex 会读取适用范围内的规则，并将其作为项目上下文的一部分。

方法一：只对当前项目生效

在项目根目录创建：

你的项目/
├── AGENTS.md
├── package.json
├── src/
└── README.md

然后在 AGENTS.md 中写入：

1
2
3

# Codex Instructions

DO NOT send optional commentary.

这种方式只会影响当前项目，适合先测试实际效果。

方法二：让所有项目默认生效

在 Codex 的全局目录中创建：

`1`	`~/.codex/AGENTS.md`

Windows 通常对应：

`1`	`C:\Users\你的用户名\.codex\AGENTS.md`

写入：

1
2
3

# Global Codex Instructions

DO NOT send optional commentary.

全局文件适合保存个人长期偏好，例如回复风格、代码习惯和默认工作方式。项目目录中的 AGENTS.md 则更适合保存当前仓库的技术规范。Codex 会按照目录层级加载这些指令，距离当前工作目录更近的规则优先级更高。

更实用的完整写法

只写一句话虽然简单，但容易被理解成“完全不要解释”。为了避免 Codex 省略必要的错误信息，可以改成下面这种更明确的版本：

# Response Style

DO NOT send optional commentary.

Start working directly when the task is clear.
Do not provide routine progress updates.
Do not explain self-evident code.
Do not add unnecessary comments to generated code.
Report only blockers, important decisions, test results, and the final outcome.

对应的中文含义是：

任务明确时直接开始执行
不要发送常规进度播报
不要解释一眼就能看懂的代码
不要生成没有实际价值的代码注释
只报告阻塞问题、重要决策、测试结果和最终结果

这种写法比单独一句 DO NOT send optional commentary. 更稳定，因为它明确规定了哪些内容可以省略，哪些关键信息仍然必须保留。

它为什么可能让 Codex 感觉更快？

这条指令并不会直接提升模型的推理能力，也不会真正修改 Codex 模型。

它主要减少的是可见输出中的冗余内容。

对于需要多次读取文件、调用工具和修改代码的任务，Codex 可能会在工具调用之间发送进度说明。减少这些非必要文本后，交互过程会更紧凑，用户感受到的等待时间和 Token 消耗也可能有所下降。

OpenAI 的 Codex 提示指南同样建议：代码本身足够清楚时，不要添加重复解释功能的注释；只有复杂逻辑确实需要说明时，才使用简短注释。

这条指令不能解决哪些问题？

需要注意，DO NOT send optional commentary. 并不是官方发布的“Codex 降质修复代码”。

它无法直接解决以下问题：

项目上下文过长或包含过时信息
AGENTS.md 中存在互相冲突的规则
当前模型或推理强度选择不合适
任务描述过于模糊
依赖、测试环境或项目本身存在问题
Codex 没有获得读取或执行命令所需的权限

目前可以确认的是，这句话已经出现在 Codex 用户反馈和部分开源项目的 AGENTS.md 中，但相关效果主要来自用户实践，并不代表 OpenAI 官方承诺它能够恢复模型质量。

使用建议

建议先把它添加到某一个项目根目录的 AGENTS.md 中，而不是直接加入全局配置。

测试几次真实任务后，重点观察：

Codex 是否减少了无意义的过程说明；
是否仍然能够报告报错和测试结果；
是否出现回复过于简略、遗漏重要信息的情况；
实际代码质量有没有改善。

如果发现 Codex 连关键问题也不再说明，可以将规则改成：

`1`	`Avoid optional commentary, but always report blockers, failed checks, security risks, and important implementation decisions.`

这样既能减少“唠嗑”，又不会隐藏真正需要关注的信息。

总结

DO NOT send optional commentary. 的核心作用，不是让 Codex 突然变得更聪明，而是限制它输出不必要的过程说明。

对于需求明确、希望 Codex 直接修改代码的用户，这条规则可能带来三个实际变化：

回复更短
过程更直接
可见输出消耗的 Token 更少

如果 Codex 最近只是变得啰嗦、频繁汇报进度，这条指令值得尝试；如果问题是代码错误增多、理解需求失败或任务无法完成，则还需要继续检查模型设置、项目上下文、权限以及 AGENTS.md 中是否存在冲突规则。