每个使用Claude Engineer、ChatGPT或Lovable这类工具的开发者最终都会遇到同样的瓶颈。

你启动一个新项目时，一切都像魔法一般。AI 能理解你的愿景，写出清晰的组件，你的开发速度快如光速。然后第二周来临了。代码库变得越来越大，你添加了几个嵌套的目录，突然之间，AI 就失控了。它忘记了你的路由是怎么工作的，试图重新安装几天前你已经确定好的依赖。最糟糕的是，它意外覆盖了一个你已经修复好的功能。

如果你喜欢在模型之间切换——比如根据使用限制从 Claude 3.5 Sonnet 切换到 Gemini 1.5 Pro——那么接入新模型就会变成一场绝对的噩梦。你浪费掉数百个 token，只是为了解释“不，不要用那个数据库库，用这个。”

为了解决这个问题，我在根目录下构建了一个轻量级框架，名为 .ai_context 协议（.ai_context protocol）。它能让 AI 保持接地，强制执行严格的防护栏，并大幅降低 token 开销。

以下是它的具体工作原理，以及为什么你应该将其用于当前的项目。

核心方案：AI 上下文的路由器
大多数人让他们的 AI 工具盲目地扫描整个工作区，或者在提示中来回传递大段代码。这会快速耗尽你的 token 限制，并用简单任务中不需要的噪声填满大语言模型的工作记忆。

.ai_context 协议通过在你的项目根目录引入五个简单的 Markdown 文件来改变这一点：

纯文本
你的项目根目录/
├── .ai_context/
│ ├── README.md <-- “路由器” 和 规则
│ ├── completed_features.md <-- 只读历史日志
│ ├── 未来路线图.md <-- 严格待办事项
│ ├── 架构图.md <-- 文件树 & 结构流程
│ └── 秘密清单.md <-- 安全跟踪环境变量
这里的真正魔法在于README.md文件。它充当着交通控制器的角色。不是让AI同时加载所有文件，而是README.md明确规定了允许代理打开其他文件的时机。

如果你只是要求修复一个小的CSS错误，AI会读取README，意识到不需要触及路线图或秘密日志，然后就此停止。巨大的令牌节省。

为何这实际上有效（从人类视角）

1. 零摩擦模型交接
   当你切换到一个全新的人工智能代理时，无需编写长篇大论的解释。只需简单提示它："读取 .ai_context/README.md 并告诉我们下一个任务是什么。"新模型就能立即跟上节奏，无需猜测。

2. 防止幻觉的护栏
   

3. 防弹安全(Bulletproof Security)
   我们都见过AI代理不小心将秘密令牌或API密钥直接硬编码到客户端文件中。而secrets_manifest.md会严格记录环境变量的位置映射，但绝不暴露实际值。它强制AI在编写后端逻辑之前检查你的.gitignore配置。

如何立即设置它
如果你想试试这个，我编写了一个单提示设置脚本。你只需复制提示，放入你的工作区AI代理中，它就会自动生成整个文件夹结构并填充你当前的仓库布局。

完整提示链接

如果你在构建遗留项目、经营副业，或者完全投入AI辅助开发循环中，这就是那本缺失的使用手册。它只需要两分钟设置，却能彻底改变AI处理你代码的可靠性。

你是如何防止工作空间代理偏离上下文的？在下方留言——我很想知道其他人是怎么组织这个的。