2.1 三层结构:背景、约定、状态
AI Context Workspace 的核心是一个三层结构。每一层解决一个问题,三层合起来构成完整的上下文体系。
第一层:背景。 背景是稳定的、不常变的事实。项目的定位是什么?技术栈是什么?领域知识有哪些?这些信息一旦确定,不会频繁变化。背景层的作用是让 AI 在启动时就能理解"这是一个什么样的项目"。
背景应该写在哪里?写在 background/ 目录下。每次进入工作区,AI 先读背景,建立对项目的基本认知。背景是只读的——不是说不让改,而是说不会被任务流程自动修改。改背景是一个显式操作,需要确认。
第二层:约定。 约定是做事的方式。工作流是什么?质量标准是什么?代码风格是什么?这些规则指导 AI 怎么执行任务。约定不像背景那样稳定,但也不像任务状态那样频繁变化。它随着项目演进逐步完善。
约定写在 conventions/ 目录下。每个约定是一份 Markdown 文件,按需读取。AI 不需要把所有的约定都加载到上下文里,只需要加载当前任务相关的部分。
第三层:状态。 状态是当前任务的具体进展。做到哪了?做了哪些决策?有什么证据?完成了什么?状态是高频变化的,每次任务推进都会更新。
状态写在 artifacts/ 目录下。每个任务一个 Artifact,包含生命周期状态、检查结论、交付物引用。这一层是 AI 在任务执行中主要读写的地方。
为什么是三层?
因为这三层的更新频率和读取频率天然不同。背景一年改几次,约定一个月改几次,状态一天改几次。把它们分开,AI 就不用每次都在一堆过时的信息里找当前需要的东西。
更好的比喻是:背景是操作系统,约定是应用配置,状态是当前打开的文档。操作系统不会频繁换,配置会按需调整,文档在持续编辑。三者混在一起管理,你就没法工作了。
三层之间的交互
背景为所有任务提供基础认知。约定规定了任务该怎么执行。状态记录了任务实际执行的情况。一个任务开始时,AI 读取背景理解项目,读取约定知道怎么做,然后创建状态开始执行。任务结束时,状态归档,背景和约定保持不变。
这个结构可以逐层独立演化。你不需要因为改了一个约定而重建整个背景,也不需要因为完成一个任务而重新整理所有约定。
Comments
Post a Comment