每次WorkBuddy培训我都会讲的Agent底层认知——构建项目分身

智见AI-大鹏3470 曝光 · 50 收藏

在过去给很多企业、高校和专业机构做 AI 落地培训时，有一个关于 Agent 的底层方法，是我每一次都会完整讲一遍的——项目分身。

只要你尝试用 AI 去推进一个真实的项目，往往会遇到两个非常头疼的问题：

第一，材料多而且杂。文件夹里往往堆着前辈留下的材料、不同时期的旧版本、参考表、课标规范。直接让 AI 写方案，它根本不知道哪份已经过时，经常把错位材料当成当前依据，吐出一堆进不了业务流程的废稿。

第二，新开对话进度全部丢失。一个复杂项目往往要跨好几天、分很多轮对话才能做完。每次新开一个窗口，AI 就完全失忆了，你又得把背景、前几天确认过的口径从头交代一遍。

项目分身，主要就是为了解决这两个问题。

这篇文章我把项目分身的完整构建方法拆解给你。看完之后，你可以清楚知道：

  1. 什么时候该用项目分身；
  2. 如何用自然语言在一分钟内完成初始化；
  3. 建完之后，如何做到「换对话不换文件夹，AI 10 秒无缝接手」。

文末我也附上了一段开箱即用的通用初始化提示词，你可以直接复制到自己的项目中跑通。

一、接手复杂项目，为什么需要立一个「项目分身」

很多人习惯直接在聊天框里向 AI 交代任务。如果只是一篇短邮件、一份临时通知，这样没问题。

但真实工作通常具有这几个特征：

  • 需要参考本地现有的多份文件；
  • 过程中会产生很多半成品与草稿；
  • 有些关键的业务判断必须由人拍板；
  • 任务无法在一轮对话内彻底完成。

这种时候，单靠输入框里的对话是管不住的。新员工来团队接手一个真实项目，他能把事情推进下去，靠的是几个清晰的支撑点：

  • 现有的资料分别放在哪里？哪份是核心依据，哪份只供格式参考？
  • 哪些原始底稿是只读的，绝对不能改动？
  • 当前阶段做到了哪一步？下一步要交出什么文件？
  • 碰到哪些重大改动，必须停下来请示负责人？

Prompt 是敲门；项目分身是房间、工位和交接本。

项目分身不是给 AI 设一个人设，而是给 Agent 建立一个可维护、守规矩的工作现场。

这个现场由两部分构成：一套清楚的「四区工位」，加上两份分工明确的「核心文本」。

二、第一步：理清四区，把工作工位立起来

真实项目只要开始运转，就一定会产生大量的过程文件：外部原件、长图 OCR 识别出来的文本、调研片段、废弃草案、最终成稿。

如果所有文件都混在文件夹根目录下，不仅自己找起来费劲，AI 也极容易抓错文件，甚至误覆盖原始凭证。

项目分身的第一步，是把文件夹按干活顺序规范成四个区域：

这批原始资料我已经确认过了，有些是核心依据，有些只能作为格式或背景参考。

先不要急着生成最终成果，请按真实工作的干活顺序，把这个项目用自然语言初始化好：

1. 文件夹理清成标准四个区：
- 01_原始材料：所有外部输入、客户原件、参考资料放这里。只读不改，不覆盖、不重命名。
- 02_过程草稿：中间处理、OCR 文本、评估清单、未拍板的草稿放这里。这是草稿箱，不是定稿。
- 03_内容底稿：已经确认的事实源、拍板的方案框架、采用的标准模板放这里。后续干活都从这里读。
- 04_交付成果：最终交得出去的正式文件（Word、PDF、PPT、表格、交付报告）放这里。

2. 在项目根目录创建两个核心文件：
- CODEBUDDY.md：长期工作规则（系统提示词）。写清楚项目是做什么的、四个文件夹分别放什么、原件绝对只读、改变方向先问我、做完关键步骤后主动更新项目总览。
- 00_项目总览.md：当前动态看板。写上当前目标、已确认事实与约束、现有成果、待确认事项、下一步具体动作。

先把目录整理方案和这两份文件的草稿给我看一眼。我确认后，你再真正移动文件、落盘。

这四个区域的职责明确固定：

  • 01_原始材料（原件保护）：外部发来的资料、官方教材、客户给的原始底稿放这里。这个文件夹只读。严禁 AI 改名、修改或覆盖。需要加工时，必须先复制到 02 区再动手。
  • 02_过程草稿（草稿箱）：所有的中间探索、OCR 提取的文本、临时抓取的数据、未定稿草案放这里。这里是草稿箱，文件写乱了也不会污染其他区域。
  • 03_内容底稿（共用事实源）：经过人确认拍板的阶段性设计、统一口径、整体蓝图放这里。后续所有的写稿、做表、做课件，都从这里取料。
  • 04_交付成果（正式成品）：最终交得出去的正式 Word、PDF、PPT 或报告放进来。

工位划分清楚后，Agent 进文件夹干活就有了明确的空间边界。它知道去哪里找输入，知道草稿扔在哪里，也知道最终成品该送去哪里。

三、第二步：双文件分工，规则与进度物理分离

工位划分好后，需要在项目根目录建立两份核心 Markdown 文件。

很多使用 AI 的人容易把所有的规则、背景、每天的进展全部写进同一个长文档里。

这样做会导致系统提示词越来越臃肿，甚至把上周做完的旧任务当成永久铁律，引发上下文混乱和指令冲突。

因此，长期规则与动态进度必须物理分离：

你在窗口跟业务员说的话 = 用户提示词（只管今天这一单办什么业务）
业务员入职时领的员工手册 = 系统提示词（规定他日常怎么按规矩办事）

1. `CODEBUDDY.md`：项目的长期规则

这份文件相当于这个项目的「员工工作手册」。

它只写长期稳定、不会轻易变动的规矩：

  • 说明这个项目是做什么的；
  • 规定四个文件夹分别放什么，声明 01_原始材料 绝对只读；
  • 规定「移动文件、删除文件、改变重要方向前，必须先列出方案等我确认」；
  • 规定「每次新对话启动，首先阅读本文件与 00_项目总览.md」；
  • 规定「完成关键任务后，必须把成果送进 04 区，并主动去更新总览」。

2. `00_项目总览.md`：项目的动态看板

这份文件相当于桌面上的「工作交接备忘录」。

它记录随着项目推进而不断流动的真实状态：

  • 当前阶段的核心目标；
  • 已经确认拍板的关键判断；
  • 现有材料清单，已经完成了哪些步骤；
  • 当前还缺什么、卡在什么地方；
  • 下一步具体要执行什么动作。

规则手册保持稳定，交接便签随时更新。

有这两份文件立在根目录，Agent 就同时拥有了行为规范和进度记录。

四、底层机制：两类提示词与跨生态标准

这里有必要讲清楚两个底层机制，搞明白之后，你在使用任何 Agent 工具时都会更清楚它的运作原理。

1. 用户提示词 vs 系统提示词

我在培训现场经常打一个比方：政务服务大厅。

  • 用户提示词：你在对话输入框里临时打的那行字（例如「帮我把 Lesson 1 的大纲整理出来」）。它的作用范围是单次任务，关掉窗口或换个对话，这句话就随历史记录封存了。
  • 系统提示词：会话启动的一瞬间，被系统自动加载进模型底层的预设规则。它规定了模型遵守哪些红线、何时请示。它的作用范围是全会话持续生效。

在支持项目工作台的现代 Agent 工具里，根目录下的 `CODEBUDDY.md` 会在每次对话开启时，被系统自动读取并作为系统提示词注入到底层。

这就是为什么你不需要每次开窗口都重复交代「原件别删、成果放 04」，因为这些规矩早就加载给它了。

2. 改名 `AGENTS.md`，通杀全生态

在培训答疑中，常有学员问：如果不仅使用 WorkBuddy，还使用团队统一的 Codex、Trae 或者其他开发级工具，这套方法还能用吗？

这是完全通用的。

在开源 Agent 生态中，通用的标准命名是 AGENTS.md。如果你把项目根目录下的 CODEBUDDY.md 直接重命名为 `AGENTS.md`：

  1. WorkBuddy 完全原生支持识别；
  2. 字节的 Trae、Anthropic 的 Claude Code、主流开源的 Codex 等工具打开该项目时，也会自动读取它作为全局项目规则。

这份规则文件因此成为一份能在多个工具之间自由迁徙的通用数字资产。

3. 全局规则与项目规则分层

在实际使用中，规则通常分为两层：

  • 全局规则：存放在用户根目录（如 ~/.workbuddy/ 或全局配置目录），记录个人的语言偏好、常用模型和通用行为习惯。进入任何项目，全局规则都会随行加载。
  • 项目规则：存放在具体项目根目录，只针对当前项目的四区工位、原件保护和业务流程做约束。

两层规则职责分开，互不冲突。

五、开箱即用：通用初始化提示词

现在主流 Agent 工具基本都支持通过自然语言直接下达结构化指令。

当你接手了一个堆满参考资料的新文件夹时，把该文件夹设为工作空间，复制下面这段提示词直接发给 AI：

请接手当前项目，不要让我重复讲背景。先读取项目规则和当前状态文件，告诉我接下来该做什么。

这段提示词的三个核心控制点：

  1. 「先不要急着生成最终成果」：制止模型在拿到材料的瞬间直接生成半成品。
  2. 「01 原件只读不改」：守住数据底线，确保外部输入与客户原件不被污染。
  3. 「先给我看方案，我确认后再落盘」：在执行物理移动、创建文件夹前保留确认环节，方案确认后回复一句「确认」，再落盘执行。

六、硬验收：换对话，不换文件夹

检验项目分身是否真正建立成功，标准非常简单：

把当前的对话窗口关闭。

在同一个项目文件夹下，新建一个完全空白的对话窗口。你可以尝试换一个反应更快的轻量模型（例如 Flash 模型），发送一句话：

下面这张图来自一次真实测试。我在同一个项目里新建了一个空白 Thread，只问当前进度和下一步。WorkBuddy 没有让我复述背景，而是主动读取 00_项目总览.md，随即列出了已完成的主线和下一步优先级。

如果它能在短时间内读完两份核心文件，准确说明项目当前处于什么阶段、已经完成了哪些事、下一步该交付什么——

这就证明项目分身已经生效。

后续无论这个项目持续多久、换了多少轮对话，只要打开这个文件夹，任何会话都能依据文件直接接续工作。

长期规则 ─── 写入 CODEBUDDY.md（或 AGENTS.md）
动态看板 ─── 写入 00_项目总览.md

结语

在企业和机构推进 AI 应用时，关键在于把常规的业务管理逻辑，沉淀为 Agent 能够理解的工作现场：

  • 材料按状态进四区；
  • 规则与边界写进系统提示词；
  • 进度与下一步写进项目总览；
  • 关键变更保留人工确认。

把工位理清、把规矩和看板立在文件里，AI 自然能够稳定接手任务。

你的项目文件夹/
├── 01_原始材料/          外部输入、客户原件、课标规范（只读不改）
├── 02_过程草稿/          中间分析、OCR 文本、试探草案、废稿（草稿箱）
├── 03_内容底稿/          已确认蓝图、拍板方案、采用的标准（共用事实源）
└── 04_交付成果/          能正式打印、提交或进入流程的成品（终态）