文章
让 AI 长期维护项目，需要哪些约定
从目录、边界和验证三个方面，整理一套低维护成本的 AI 协作方式。
AI 能快速修改代码，但长期维护更依赖上下文是否清楚。与其增加复杂工具，不如先把关键约定写进仓库。
目录是第一层说明
稳定的目录让新加入的维护者可以快速定位：
- 内容放在哪里；
- 页面由什么组成；
- 全局设置从哪里修改；
- 完成变更后如何验证。
给约束一个固定位置
项目根目录的 AGENTS.md 面向 AI，README.md 面向人类。两者关注点不同，但不应该互相矛盾。
验证必须可以重复
npm run check
npm run build每次变更都运行同一组命令，能减少“看起来没问题”的误判。
一个简单的检查表
- Frontmatter 是否符合 Schema；
- 草稿是否被生产构建过滤；
- 新页面是否有明确标题和描述；
- 手机端是否仍然可读；
- 是否引入了没有必要的新依赖。