为什么这对组合成立
Codex 从运行目录读取 AGENTS.md——这是它的原生惯例,零配置。note.md 的 vault 把文件规则(sidecar 文件配对、大纲格式、日期链接、块级引用)恰好发布在这个文件里。所以集成就是:cd vault && codex。完事。
Codex 最强的角色是干活的 agent:让它起草、重构文档、批量处理笔记,或者写 vault 里日积月累的小脚本(导入器、链接检查器、报告生成器)。它写的一切都是 vault 里的 markdown,也就意味着它写的一切都会流进你的阅读-批注循环。
配置
- 把 llms-full.txt 里的约定摘要复制进 vault 根目录的
AGENTS.md。 - 加上 vault 专属规则——例如“除 Smart Lookup fenced answer 外,把
*.note.md视为人拥有”、“新调研放research/下,文件名带日期前缀”。 - 在 vault 目录运行
codex。它会自动捡起这些规则。 - 在 note.md 里审读它的产出;批注;告诉下一次运行去读sidecar 文件。
FAQ
Codex 需要 MCP 服务器才能用 vault 吗?
不需要。vault 就是工作目录里的纯文件——Codex 的主场。若更适合工具接口,已发布的本地只读 Vault MCP 提供 search 与 vault_info;分享 Worker 的 MCP 是另一套发布接口。
AGENTS.md 里该禁止什么?
把 .note.md 视为人拥有。Smart Lookup 的 fenced answer 回写是唯一狭窄例外;普通 agent 不应改高亮、问题或已采纳结论。其余(命名、目录、链接风格)都是各家的偏好。