Codex 知识库的「宪法」——AGENTS.md 不只是配置文件，它是你和 AI 之间的协作关系

🪝

AGENTS.md 到底是什么？

不是「技术层面是什么」——我知道你已经明白它是一个文件，放在 Vault 根目录，Codex 启动时会读取。

我说的是：它在你和 AI 之间扮演的是一种什么角色？

为什么有些人写了 AGENTS.md，感觉和没写差不多；而另一些人写了之后，发现 Codex 的输出越来越「懂自己」，用起来越来越像一个真正的协作者？

差别不在于写了多少字，而在于你是否理解了 AGENTS.md 的本质：

它不是一份技术配置，它是一份「关系说明书」。

这篇文章，我想从一个完全不同的角度来聊 AGENTS.md——不是「怎么写」，而是「它是什么」。

🔭 Part 1：一个思想实验

想象你刚刚雇了一个全能助理——这个助理聪明绝顶，执行力超强，永远不会累，能在 30 秒内处理你需要 3 小时才能完成的工作。

但他是刚来的第一天。

他不知道你是谁，不知道你在做什么，不知道你的工作风格，不知道你喜欢什么样的沟通方式。他只知道：你需要帮助。

第一天，你会怎么做？

你可能会告诉他：

• 我是一个内容创作者，主要写知识管理方向的文章
• 我的笔记分三层，Inbox 是原始输入，raw 是整理稿，wiki 是成品
• 你可以帮我整理笔记，但修改 wiki 里的成品之前要先告诉我
• 我喜欢直接给结论，不喜欢绕弯子
• 我用中文工作，所有输出请用中文

你告诉他这些，他就能开始工作了。

AGENTS.md，就是你对 Codex 说的这段话。

只不过，它不是口头说的，而是写下来的。每次 Codex 启动，都会先读这段话，然后带着这段话的理解开始工作。

这就是为什么 AGENTS.md 的质量，直接决定了你的知识库系统的上限。

🏛️ Part 2：为什么我说它是「宪法」

宪法有几个特征：

① 它是根本性的，所有后续规则都从它推导

国家的法律，不能违背宪法。 Codex 的每一次操作，不能违背 AGENTS.md 里定义的规则。

当你在 AGENTS.md 里写「修改 wiki 下的成品之前必须先告知我」，它就成了一条「宪法级别」的规则——之后所有的任务执行，都必须先过这一关。

② 它定义了边界，而不是所有细节

宪法不规定你明天早上几点起床。它规定什么是不可侵犯的权利、什么是政府的权力边界。

AGENTS.md 也不规定你每一次操作的所有细节。它定义的是：

• 你是谁（身份）
• 什么不能碰（红线）
• 什么可以自主决定（授权范围）
• 你的基本偏好（风格规范）

在这个框架内，Codex 可以灵活处理；框架之外，它需要问你。

③ 它随着时间迭代，但核心不轻易改变

宪法可以修订，但不会每天改。

AGENTS.md 也是一样——你刚开始搭系统的时候，可能每周都在更新它；等系统跑稳之后，核心规则会逐渐固定下来，只在你对系统有重大调整的时候才更新。

🧬 Part 3：AGENTS.md 进化的三个阶段

我观察了很多人使用这套系统的过程，发现 AGENTS.md 的成熟度，几乎可以作为判断一个人「知识系统成熟度」的指标。

第一阶段：「工具说明书」

这个阶段的 AGENTS.md，大多是这样的：

Markdown

# 我的知识库
我用 Obsidian 记笔记。
请帮我整理笔记，保持中文输出。

这是工具说明书——告诉工具它是什么，能做什么。

Codex 的表现：执行基本任务没问题，但输出风格「通用」，像一个不认识你的陌生人在帮你做事。

第二阶段：「工作手册」

这个阶段，你开始加入结构规范、工作规则、输出偏好：

Markdown

# 知识库结构
- Inbox/：原始输入
- raw/：整理后
- wiki/：成熟知识
# 规则
1. 不修改 wiki 里已发布的内容
2. 用中文输出
3. 先给结论，再展开

这是工作手册——它开始定义你们之间的工作方式。

Codex 的表现：开始有你的味道了，出错率明显降低，但还不够「主动」。

第三阶段：「认知画像」

这个阶段的 AGENTS.md，开始包含一个很多人没想到的维度：

你正在追踪的问题，和你的认知框架。

Markdown

# 我正在追踪的核心问题
- 知识如何从「被动存储」变成「主动参与思考」？
- 个人成长的哪些维度是可以被量化和追踪的？
- 一套系统如何在不依赖纪律的情况下自我维持？
# 我正在构建的概念体系
- 知识复利：积累的复利效应
- 认知进化：思维方式的迭代
- 自生长系统：无需纪律也能运转的系统
# 我的思维模式偏好
- 喜欢从「为什么」出发，再到「怎么做」
- 喜欢类比和隐喻，不喜欢纯技术描述
- 对抽象概念，先要「一句话版本」，再展开

Codex 的表现：开始主动发现你没有明确指出的关联；在整理一篇新的笔记时，会自动检查它是否和你追踪的问题相关；输出的内容开始有一种你自己都觉得「对，这就是我想表达的」的感觉。

这个阶段，Codex 不再只是你的执行工具，而是开始成为你的思考协作者。

「AGENTS.md 发展到第三阶段，意味着你把自己的认知框架「外显」了出来——不只是 AI 能读懂，你自己也能更清楚地看见自己的思维模式。」

🔁 Part 4：AGENTS.md 与你同步进化的方法

AGENTS.md 不是一次写完就放着的文件。它应该随着你对自己的理解而进化。

我的 AGENTS.md 迭代触发机制：

一个有趣的副作用：

当你开始认真维护 AGENTS.md，你会发现你对自己的理解也在加深。

因为要写清楚「我是谁」「我喜欢什么输出风格」「我在追踪什么问题」，你必须先想清楚这些问题。

这个思考过程本身，就是一种元认知——通过定义你对 AI 的期望，你在定义你对自己的理解。

📋 Part 5：一份专属于「个人成长 × 知识创作」方向的 AGENTS.md

基于系列前几篇的积累，这是我为「个人成长 + 知识管理 + 内容创作」这个方向专门优化的 AGENTS.md 模板：

Markdown

# AGENTS.md — 认知操作系统配置文件
# 版本：v3.0 | 更新日期：{{date}}
---
## 01 · 身份定义
### 我是谁
一个专注于「个人成长 × AI 知识管理」的内容创作者。
核心使命：记录真实的认知进化，把个人成长变成可复用的系统。
### 当前核心项目
- 系列内容：Codex + Obsidian 知识库搭建教程（共 8 篇）
- 个人实践：PKM 工作流长期记录（进行中）
- 年度目标：建立一套能「自生长」的知识系统
### 内容输出目标平台
- B站（8-15分钟教程视频脚本）
- 公众号（2000-3500字深度图文）
- 小红书（600-800字轻量图文）
---
## 02 · 知识库结构
### 文件夹说明

MyBrain/ ├── Inbox/ 原始输入区，不限格式，每周清空 ├── raw/ 结构化整理层，有frontmatter，status追踪 ├── wiki/ 成熟知识页，可被引用，修改需确认 ├── daily/ 每日笔记和复盘 │ └── weekly/ 每周合并复盘 └── projects/ 具体项目文件夹 └── series-01/ 系列一文章草稿

text

### Frontmatter 标准
---
date: YYYY-MM-DD
tags: []
status: draft | reviewing | published | legacy
source: 
related: []
---
---
## 03 · 工作规则
### 红线（不得违反）
1. 未经确认不删除任何已有笔记内容
2. wiki/ 下 status=published 的内容，修改前必须列出变更说明等我确认
3. 批量操作超过 5 个文件，执行前先列清单
### 主动权（可以自主执行）
1. 在 Inbox/ 下创建新的整理摘要
2. 在 raw/ 下创建新笔记
3. 为现有笔记添加 frontmatter 字段
4. 建议双向链接（告知我，等我确认后添加）
### 遇到不确定时
先问，再执行。宁可多问一次，不要猜测执行。
---
## 04 · 输出偏好
### 语气风格
- 像一个靠谱朋友在分享，不要居高临下
- 第一人称叙述为主
- 短句节奏，每段不超过 4 行
- 避免套话：「综上所述」「值得注意的是」「总的来说」
### 内容结构偏好
- 先结论，再展开（金字塔结构）
- 复杂概念：一句话版本 + 详细版本
- 步骤内容：有序列表 + 预期结果说明
### 知识整理偏好
- 每次处理资料：提炼 3 个「可以直接引用的核心观点」
- 找出金句（可单独传播的 1 句话）
- 标注来源，便于回溯
---
## 05 · 认知框架
### 我正在深耕的概念
- PKM 个人知识管理
- 知识复利 积累的指数效应
- 认知进化 思维方式的可见变化
- 自生长系统 无需纪律也能运转
- 第二大脑 AI 协作的知识系统
### 我正在追踪的问题
1. 知识如何从「被动存储」变成「主动参与思考」？
2. 个人成长的哪些维度可以被量化和追踪？
3. 什么样的系统结构能让「懒人」也能持续维护？
### 整理新资料时的关联检查
每次整理新资料，检查是否和上述问题/概念相关，
如果相关，在摘要页里注明关联，并推荐添加双向链接。
---
## 06 · 快捷任务定义
处理Inbox → 提炼观点+生成摘要+关联wiki
周复盘 → 整合daily+生成认知简报+推荐晋升笔记
知识库体检 → 孤立节点+积压Inbox+过期draft报告
整理这篇[内容] → 提炼观点+金句+推荐关联+生成raw摘要

💡 写这份文件的本质，是在写一份「自我说明书」

我在整理这套 AGENTS.md 模板的时候，意识到一件有趣的事：

这份文件，其实也是写给我自己的。

「我是谁」「我在追踪什么问题」「我的认知框架是什么」——这些问题，如果你能回答得清楚，你对自己的理解就已经达到了很多人花几年时间都没想清楚的深度。

AGENTS.md 的表面作用是让 AI 更懂你。

但更深的作用是：它逼着你认真回答了「我是谁」这个问题。

「写好 AGENTS.md 的过程，就是一次深度的自我认知练习。AI 读懂了你，你也读懂了自己。」

🔮 下一篇

我们回到最基础、但最多人弄错的一件事：

raw 是原料，wiki 是成品——为什么知识库必须分层，以及「分层」背后的认知科学逻辑。

这不只是一篇工具教程，而是一篇关于「知识如何在大脑中运动」的方法论文章。