为什么这对组合成立
Codex 从运行目录读取 AGENTS.md——这是它的原生惯例,零配置。note.md 的 vault 把文件规则(伴生文件(sidecar)配对、大纲格式、日期链接、块级引用)恰好发布在这个文件里。所以集成就是:cd vault && codex。完事。
Codex 最强的角色是干活的 agent:让它起草、重构文档、批量处理笔记,或者写 vault 里日积月累的小脚本(导入器、链接检查器、报告生成器)。它写的一切都是 vault 里的 markdown,也就意味着它写的一切都会流进你的阅读-批注循环。
配置
- 把 llms-full.txt 里的约定摘要复制进 vault 根目录的
AGENTS.md。 - 加上 vault 专属规则——例如“绝不修改
*.note.md”、“新调研放research/下,文件名带日期前缀”。 - 在 vault 目录运行
codex。它会自动捡起这些规则。 - 在 note.md 里审读它的产出;批注;告诉下一次运行去读伴生文件。
FAQ
Codex 需要 MCP 服务器才能用 vault 吗?
不需要。vault 就是工作目录里的纯文件——Codex 的主场。MCP 端点是给分享 worker 用的(发布页面),基本的 vault 工作用不上。
AGENTS.md 里该禁止什么?
唯一的硬规矩:agent 不写你的 .note.md 伴生文件——那里存的是人的判断。其余(命名、目录、链接风格)都是各家的偏好。