AI Agent 用起来很爽，坑也不少。这个系列把实战里踩过的坑和有效的方法一个个写下来，一篇只讲一个关键点。开篇聊项目管理里最容易忽略、却影响最大的基础：工作空间的目录规划。

1. 痛点：Agent 越能干，工作区越乱

用 Agent 干活，本质上是雇了一个"手很快、但记性要靠文件撑"的员工。

它每轮任务都会产生文件：文章草稿、生成的脚本、下载的素材、调试用的临时输出。没有规划的时候，这些文件会全部堆在根目录。

几个月后回头看，目录里躺着一堆说不清来源的文件：不知道是哪次任务的、不知道还有没有用、更不敢随便删。

问题不在懒，在缺少一个"锚"。Agent 每次创建文件都需要判断"该放哪"，没有标准，它就凭感觉放，而感觉每次都不同。

更要命的是，这种事不报错。文件放错位置不会让任务失败，于是没人管，直到乱到没法找。

2. 关键经验：标准先行，初期就定目录规划

我的做法很简单：让 Agent 在接手项目的第一天，就把工作空间的目录结构规划定下来，写进它的行为准则。

这不是分享目录具体怎么组织，而是强调一个动作：初期就把规划做出来、写下来、让 Agent 遵守。

目录和文件是动态变动的，今天新增一个项目，明天删掉一个模块，都很正常。但只要标准摆在那里，不管怎么变，每个文件都有它该去的位置，就不会乱。

我把这套标准写进了 Agent 的 AGENTS.md，放在最顶部，并明确标注优先级最高。

2.1 规划本身要足够简单

太复杂的目录树，Agent 记不住，人也不想维护。够用就好，通常三层以内：

工作区根目录/
├── AGENTS.md          # 行为准则（含空间管理标准）
├── MEMORY.md          # 长期记忆
├── skills/            # 系统目录，只读不动
└── projects/          # 任务产物按项目归档
    ├── 项目A/
    ├── 项目B/
    └── legacy/        # 历史遗留，保留可恢复

核心就三条：根目录只放核心配置文件，任务产物按项目归档，临时产物放 /tmp 用完就清。

2.2 规则要可执行

光有目录树不够，还要有硬性规则。规则不用多，每条都能直接照着做：

  • 根目录保持干净，产物一律归档，不散落
  • 文件命名小写加连字符，语义清晰
  • 临时/中间产物放 /tmp，任务结束即清理
  • 删除优先用 trash，可恢复，不用 rm
  • 定期自查散落文件和过期临时文件

标准越简单，Agent 越容易遵守，自查也越容易。定计划的人少写一条，执行的人就少错一处。

3. 具体操作：什么时候立规矩，怎么开口

原则讲完，给可以直接抄的操作。三步：选时机 → 发一条立规矩的 prompt → 验证它真的立住了。

3.1 时机：第一天，任务开始前

别等工作区乱了再收拾，趁还没乱就立。

  • 新项目 / 新工作区：Agent 接手的第一天，第一个任务开始之前
  • 已有工作区：找一个任务间隙补上，当天生效
  • 标准立好再让 Agent 干活：它每次创建文件，都有一个判断依据

一句话总结：立规矩的时间点，永远在"第一次干活之前"，而不是"第一次弄乱之后"。

3.2 立规矩的 prompt（两种方式，按需选用）

第一次会话里发给 Agent。两种方式输入不同，输出一样——都会形成一份书面标准，后续按标准走。

方式一：人定标准，Agent 执行

适合你已经清楚标准长什么样（自己有洁癖，或团队已有规范），直接告诉它怎么弄：

在开始任何任务之前，先完成工作区的初始化：

1. 阅读并整理 AGENTS.md、PROFILE.md、MEMORY.md、SOUL.md，搞清楚身份、用户背景、已有内容
2. 制定工作空间目录规划：根目录只保留核心配置文件，任务产物按 projects/<任务名>/ 归档，文件命名小写加连字符
3. 把空间管理标准写进 AGENTS.md（行为准则）和 MEMORY.md（长期记忆）
4. 按规划建立目录骨架，把散落的旧任务产物归位归档
5. 完成后向我汇报目录树摘要

注意：除非我明确要求，不要反复征求我的意见，自己拿主意并执行。

方式二：人提要求，Agent 自己定标准

适合你只有一个模糊的意图（比如"保持干净"），具体怎么组织交给 Agent 设计。标准是它自己产出的，它最容易记住、也最容易遵守：

正式干活之前，先把工作区打理好。我只有一个要求：空间管理必须干净、有标准、可持续。

具体怎么定，你来：
- 制定一套工作区目录规划：根目录、任务产物、临时文件该怎么摆，你设计
- 把标准写进你的行为准则和长期记忆，以后一直按这套标准走
- 把现有散落文件按标准归位归档
- 完成后汇报你的目录树和这套标准的关键条款

除非我明确要求，不要反复征求我的意见，自己拿主意并执行。

两种方式怎么选：

  • 方式一：输入明确，执行快，结果可预期。适合你已经有一套成熟标准、"按我说的来"的场景
  • 方式二：输入模糊，Agent 要自己设计，可能给出你没想到的方案，也顺便检验它的能力。适合你信任它、或者刚上手想看它怎么干活
  • 殊途同归：两种方式的输出都是"写进文件的标准"，之后所有会话按标准执行，不再重复讨论

两条 prompt 都以同一句话收尾："除非我明确要求，不要反复征求我的意见，自己拿主意并执行"。没有它，Agent 会为了"尊重用户"每步都来问你要个确认，标准就立不起来了。

3.3 验证：让 Agent 证明标准立住了

  • 立完规矩让它汇报目录树——说不清楚，就是没做
  • 看它第一个任务的产物落点：进了 projects/ 而不是根目录，才算真懂
  • 隔一两天做一次自查："有哪些散落文件？归档一下"，把自查变成习惯

4. 落地一次看看效果

说个真实的例子。最近我给自己做了一次"立规矩"，全程不到十分钟。

第一步，读现有的 AGENTS.md、PROFILE.md、MEMORY.md、SOUL.md，搞清楚我是谁、用户是谁、之前干过什么。

第二步，把空间管理标准写进 AGENTS.md（行为准则）和 MEMORY.md（长期记忆），让以后的每次会话都按它执行。

第三步，按标准建好目录骨架，把散落的旧文件归档归位：

projects/
├── izone-blog/            # 主项目：写文、发布
├── silver-moon-spritesheet/  # 精灵图分析项目
└── legacy/                # 历史遗留归档

第四步，把归档动作提交 git。万一以后想找回，随时可以回溯。

立完规矩当天就验证了一次：中途我用错了命令，把目录建出了字面花括号名。以前这种事会被忽略，但这次因为标准在，一眼就发现了，立刻重建纠正。

5. 三个容易踩的坑

5.1 光写标准，不执行

把目录规划写进配置文件只是第一步，关键是 Agent 要真的按它执行。可以在标准里加一句"除非用户明确要求，否则自己拿主意并执行"，既不会每件事都来问你，也不会因为没人管就散漫。

5.2 一开始就设计复杂的目录树

几十个子目录的规划看起来很专业，但 Agent 记不住，人也不想维护，最后流于形式。从简单开始，够用就行，确实需要了再加。

5.3 只规划，不维护

标准不是定一次就完事。把"定期自查"也写进标准，让 Agent 主动处理散落文件和过期临时文件。标准立在那里，也要有人定期擦灰。

5.4 立规矩的 prompt 太笼统

"把工作区整理一下"不是立规矩。没有明确的五步指令和"自己拿主意"授权，Agent 不知道自己该定什么、定到哪算完成。

6. 小结

让 Agent 高效工作，空间管理是最容易被忽略、也最值得先做的基础。

这个系列第一篇的关键点就一个：标准先行。让 Agent 在初期就制定好工作空间的目录结构规划——目录和文件是动态变动的，但标准摆在那里，就不会乱。

下一篇继续聊实战经验，欢迎关注。

版权声明：如无特殊说明，文章均为本站原创，转载请注明出处

本文链接：https://tendcode.com/subject/article/ai-agent-playbook-01-workspace-planning/

许可协议：署名-非商业性使用 4.0 国际许可协议