怎么让 AI 读取项目?
03-03 怎么让 AI 读取项目?
Section titled “03-03 怎么让 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 读取项目,是工作台里的开门动作。这个动作做稳了,后面修改会稳很多。”
屏幕演示流程
Section titled “屏幕演示流程”- 打开
AI-Workspace/projects/demo-site。 - 展示文件区里的文件。
- 在对话区输入项目读取表达。
- 让 AI 列出文件结构。
- 人工对照文件区检查。
- 打开 README,核对 AI 是否理解项目用途。
- 故意补充一句真实项目用途,让 AI 重新复述。
- 保存项目现场复述记录。
让学员打开自己的项目文件夹,并让 AI 输出三栏:
- 确定看到的文件。
- 根据文件名做出的推测。
- 下一步建议。
学员用文件区逐项核对,并标出 AI 猜测部分。
练习完成后,让学员补一句纠正信息:
我补充一下真实背景:这个项目的用途是:现在最重要的目标是:请重新复述项目现场。- AI 复述太泛:要求它列出具体文件名。
- AI 看不到项目:确认工具打开的是正确文件夹。
- AI 把猜测当事实:要求它分栏说明。
- 项目缺说明:先补一个 README。
- 学员一上来就让 AI 修改:先做现场复述,再下修改指令。
保存一份项目现场复述记录,包含:
- 文件结构。
- 项目用途。
- AI 的推测。
- 学员纠正后的版本。
- 下一步最小动作。
补充要求:
- 把记录放进
logs文件夹。 - 文件名可以写成
2026-06-05-project-check.md。 - 下次开工前先读这份记录。
- 第 1 页:标题“开工前先让 AI 看屋子”
- 第 2 页:读取项目文件夹
- 第 3 页:事实、猜测、建议
- 第 4 页:人工核对
- 第 5 页:纠正 AI
- 第 6 页:现场复述记录
- 第 7 页:开工前固定表达