Skip to content

怎么让 AI 读取项目?

这一课训练工作台开工前的关键动作:让 AI 读取项目。

很多项目出问题,起点就在于 AI 没看清现场。它不知道文件结构、不知道 README 写了什么、不知道当前项目做到哪一步,就容易凭空给方案。

这一课要让学员养成开工前的第一句:请先说明你看到的项目。学员以后每次打开项目,都先让 AI 复述现场,再开始修改。

  • 让学员会在工具里打开项目文件夹。
  • 让学员会要求 AI 复述项目结构。
  • 让学员会区分 AI 的事实、猜测和建议。
  • 让学员会纠正 AI 的错误复述。
  • 让学员完成一份项目现场复述记录。
  • 建议时长:25 到 35 分钟。
  • 一定要用真实项目文件夹演示。
  • 先让 AI 读取,再让学员人工核对。
  • 如果 AI 复述错了,正好示范怎么纠正。
  • 不要把这一课讲成工具按钮教学,重点是开工习惯。

可以这样开场:

“工作台开工前,先让 AI 看一眼屋子。施工队进门后,第一件事是确认图纸和材料。”

打开项目文件夹后,输入:

请先说明你看到的文件结构。
请区分三类内容:
1. 你确定看到的内容。
2. 你根据文件名推测的内容。
3. 你建议我下一步做的事。

这个表达很重要。

“你确定看到的内容”,对应事实。比如 AI 真的看到了 README.md、inputs、index.html。

“你根据文件名推测的内容”,对应猜测。比如它根据 demo-site 猜这是一个网页项目,这只是推测。

“你建议下一步做的事”,对应方案。方案可以参考,但要先确认事实。

学员要学会检查 AI 的复述:

  • 文件名有没有漏。
  • 文件夹有没有说错。
  • README 有没有读到。
  • 项目用途有没有猜偏。
  • AI 有没有把猜测当成事实。

如果 AI 说错,可以直接纠正:

你这里猜错了。这个项目实际用途是课程资料导航页。
请基于这个信息重新复述项目现场,并标出哪些内容是你亲眼看到的。

这里要讲一个底层习惯:

“AI 很擅长接话,所以它会主动补全。我们使用工作台时,不怕它猜,怕的是我们分不清它在哪里猜。只要让它把事实、猜测、建议分开,合作就会清醒很多。”

再给一个更完整的开工表达:

你现在是我的项目协作助手。
开工前请先完成现场检查:
1. 列出你看到的文件和文件夹。
2. 阅读 README,并复述项目目标。
3. 标出你不确定的地方。
4. 暂时不要修改文件。

最后收束:

“让 AI 读取项目,是工作台里的开门动作。这个动作做稳了,后面修改会稳很多。”

  1. 打开 AI-Workspace/projects/demo-site。
  2. 展示文件区里的文件。
  3. 在对话区输入项目读取表达。
  4. 让 AI 列出文件结构。
  5. 人工对照文件区检查。
  6. 打开 README,核对 AI 是否理解项目用途。
  7. 故意补充一句真实项目用途,让 AI 重新复述。
  8. 保存项目现场复述记录。

让学员打开自己的项目文件夹,并让 AI 输出三栏:

  • 确定看到的文件。
  • 根据文件名做出的推测。
  • 下一步建议。

学员用文件区逐项核对,并标出 AI 猜测部分。

练习完成后,让学员补一句纠正信息:

我补充一下真实背景:
这个项目的用途是:
现在最重要的目标是:
请重新复述项目现场。
  • AI 复述太泛:要求它列出具体文件名。
  • AI 看不到项目:确认工具打开的是正确文件夹。
  • AI 把猜测当事实:要求它分栏说明。
  • 项目缺说明:先补一个 README。
  • 学员一上来就让 AI 修改:先做现场复述,再下修改指令。

保存一份项目现场复述记录,包含:

  • 文件结构。
  • 项目用途。
  • AI 的推测。
  • 学员纠正后的版本。
  • 下一步最小动作。

补充要求:

  • 把记录放进 logs 文件夹。
  • 文件名可以写成 2026-06-05-project-check.md。
  • 下次开工前先读这份记录。
  • 第 1 页:标题“开工前先让 AI 看屋子”
  • 第 2 页:读取项目文件夹
  • 第 3 页:事实、猜测、建议
  • 第 4 页:人工核对
  • 第 5 页:纠正 AI
  • 第 6 页:现场复述记录
  • 第 7 页:开工前固定表达