如何整理工作空间让 Agent 更好地理解你的项目

如何整理工作空间，让 Agent 更好用？

你的文件夹越整齐，Agent 理解得越快、产出越准确。
就像给新员工一个干净的办公桌 vs 一堆乱纸——效率差十倍。

Agent 看到这样的文件夹会"头疼"
未命名.txt
新建文档.docx
新建文档(2).docx
aaa.csv
最终版.xlsx
最终版(真的最终).xlsx
IMG_20260514_203015.jpg
发给老板的.pptx
备份.zip
temp.txt
→ Agent 无法判断哪个文件重要、哪个是最新版、文件之间是什么关系
这样的文件夹 Agent 一眼就懂
README.md ← 项目说明
📂 data/ ← 原始数据
各平台数据_0512-0518.csv
用户反馈_0518.txt
📂 reference/ ← 参考资料
上周周报_0505-0511.md
竞品分析笔记.md
📂 notes/ ← 会议/碎片记录
选题会议_0512.md
老板要求.txt
📂 output/ ← Agent 的产出放这里
（空的，等 Agent 来填）
1
用文件夹分类，别把所有东西堆在一起
Agent 第一步是 ls 看文件夹结构。如果所有文件平铺在根目录，它需要一个个猜每个文件是什么。分了文件夹之后，文件夹名本身就是分类标签——Agent 看到 data/ 就知道里面是原始数据，看到 reference/ 就知道是参考资料。
❌ 全堆在一起 15 个文件平铺
Agent 需要逐个 cat 才能判断
浪费时间和 token
✅ 分 4-5 个文件夹 data/ reference/ notes/ output/
Agent 看目录名就知道去哪找什么
读取更精准、更省 token
2
文件名要能"自我介绍"
Agent 在 ls 阶段只能看到文件名，还没打开文件。好的文件名让 Agent 不用打开就知道里面是什么。加上日期能让 Agent 判断哪个是最新版。
❌ 看名字猜不出内容 未命名.txt
aaa.csv
最终版(真的最终).xlsx
新建文档(2).docx
✅ 名字就是内容摘要 老板要求_0512.txt
各平台数据_0512-0518.csv
竞品分析_2026Q2.md
选题会议记录_0512.md
3
放一个 README.md —— Agent 的"新员工手册"
Agent 进入文件夹后第一个读的就是 README。这个文件告诉 Agent：这是什么项目、文件夹里有什么、目标是什么。有 README 和没有 README 的差距，就像新员工第一天有人带 vs 没人带。
README.md 模板
# 项目名称
一句话说明这是什么项目。

## 背景
这个项目要解决什么问题？谁在用？

## 文件说明
- data/ → 原始数据
- reference/ → 参考资料和历史文档
- notes/ → 会议记录和碎片笔记
- output/ → Agent 的产出放这里

## 当前任务
接下来需要 Agent 做什么。越具体越好。
4
输入和输出分开放
你给 Agent 的原始素材和 Agent 生成的成果，不要混在一起。分开后好处：你能清楚看到 Agent 产出了什么；Agent 也不会误把自己上次的产出当成原始数据重新处理。
❌ 全混在一起 data.csv
周报.md ← 哪个是你写的？
周报_v2.md ← 哪个是 Agent 写的？
周报_final.md ← 已经分不清了
✅ 输入 / 输出 分开 data/data.csv ← 你的原始数据
output/周报_0518.md ← Agent 产出
一目了然，不会搞混
5
给 Agent 一个"任务简报"文件
除了 README（项目总览），你还可以放一个 TASK.md 专门写当前任务要求。Agent 读完 README 了解项目背景后，再读 TASK 就知道此刻要做什么——就像每天早上给员工一张当日任务单。
TASK.md 示例
# 本周任务：生成 5/12-5/18 运营周报

## 要求
1. 参考 reference/上周周报 的格式
2. 从 data/ 里的 CSV 计算各平台数据
3. 回应 notes/老板要求.txt 里的每个问题
4. 产出文件放到 output/ 目录

## 特别注意
- 老板特别关心抖音爆款的分析
- 粉丝增长目标是 16 万，要算完成率
通用工作空间模板（可直接用）
README.md ← 项目是什么
TASK.md ← 当前要做什么

📂 data/ ← 原始数据和素材（你给的）
平台数据.csv
调研问卷.xlsx
...

📂 reference/ ← 参考资料（格式模板、历史文档、竞品资料）
上期周报.md
品牌手册.pdf
...

📂 notes/ ← 碎片化信息（会议记录、老板要求、随手笔记）
会议记录_0512.md
老板要求.txt
...

📂 output/ ← Agent 的产出（空的，等它来填）