学会让 AI 编程助手先计划之后，你就可以进入更真实的场景：别人丢给你一个项目，你完全不知道它是干什么的，也不知道从哪里启动。
这一章的目标不是让你立刻改代码，而是学会先问 AI 三件事：
先问：打开哪个文件
再问：运行哪条命令
再问：失败复制哪段报错
最后问：哪些文件暂时别乱改
这一步非常适合小白。你不需要先看懂所有文件，只要让 AI 先给你下一步动作。
学完这一章，你应该能做到：
- 打开陌生项目后，先让 AI 编程助手只读分析；
- 让 AI 编程助手告诉你先打开哪个文件；
- 让 AI 编程助手给你能复制的启动命令；
- 运行失败时，知道该复制哪段报错继续问；
- 改代码前，先让 AI 告诉你哪些文件不要乱动。
如果还没有打开可用的 AI 编程工具，先按第一章从官网安装并完成第一个练习，再继续这一章。
本章可直接复制的提示词
你要做的事：打开陌生文件夹后，让 AI 直接告诉你下一步做什么。
【可直接复制给 AI】
我是编程小白。请先查看当前文件夹，不要修改任何文件。
请直接告诉我：
1. 我应该先打开哪个文件；
2. 应该输入什么命令运行；
3. 如果运行失败，我应该复制什么报错给你；
4. 我下一步应该先做什么。
【说明】
- AI 会告诉你先看哪个文件；
- 给你下一步要运行的命令；
- 告诉你失败时要复制哪段报错。
不满意继续这样问：
请只给我三个动作：
1. 打开哪个文件；
2. 运行哪条命令；
3. 失败后复制哪段报错。
4.1 打开陌生文件夹，第一句复制这段
真实开发里，很多时候你不是从 0 写项目，而是接手别人留下来的项目。
可能是：
老板丢给你一个旧项目
同事离职了，项目没人维护
你下载了一个开源项目，但看不懂
你买了一个模板，想改成自己的产品
你从 GitHub clone 了项目，但跑不起来
你打开文件夹，里面一堆目录，不知道从哪下手
这时候很多新手会直接问 AI 编程工具：
这个项目怎么改？
这句话太大了。
AI 编程工具不知道你要改哪里，也不知道你是否已经理解项目。
更稳的方式是：
先让 AI 编程工具带你读项目。
不要先问“这个项目怎么改”。先复制这段：
我是编程小白，刚打开一个陌生文件夹。
请先查看当前文件夹，不要修改任何文件。
请只告诉我：
1. 我现在应该先打开哪个文件；
2. 我应该复制运行哪条命令；
3. 如果运行失败，我应该复制哪一段报错给你；
4. 哪些文件暂时不要乱改。
请直接告诉我下一步动作。
【说明】
- AI 会告诉你第一个要看的文件；
- AI 会给你一条启动命令；
- AI 会提醒你失败时复制哪段错误；
- AI 会标出暂时不要乱改的文件。
如果它开始解释很多概念，【继续追问】
请只回答：
1. 打开哪个文件；
2. 运行哪条命令；
3. 失败复制哪段报错。
4.2 案例一：老板丢来项目，第一句别问“怎么改”
假设你拿到一个陌生项目，打开后看到这些文件：
app/
src/
components/
public/
package.json
README.md
next.config.js
tsconfig.json
tailwind.config.ts
你可能完全不知道这是干嘛的。
很多人第一句会问：
帮我看看这个项目怎么改。
这句不够好。
因为“怎么改”没有目标。
AI 编程工具可能会开始猜：
是不是要改页面？
是不是要改 API？
是不是要改样式？
是不是要优化结构？
是不是要修 bug？
更稳的第一句话应该是：
请先阅读当前当前文件夹，不要修改任何文件。
请用中文告诉我：
1. 这个项目大概率是什么类型
2. 使用了哪些技术栈
3. 主要目录分别负责什么
4. 本地启动命令可能是什么
5. 构建命令可能是什么
6. 如果我是新接手的人，第一天应该先看哪些文件
注意：
- 只分析，不修改
- 不新增文件
- 不运行高风险命令
- 如果信息不够，请告诉我还需要看哪些文件
这条提示词适合所有陌生项目。
AI 编程工具可能会先看哪些文件
它通常会优先看：
package.json
README.md
next.config.js
vite.config.ts
astro.config.mjs
tsconfig.json
src/
app/
pages/
components/
如果是 Python 项目，会看：
pyproject.toml
requirements.txt
app.py
main.py
README.md
如果是 Go 项目，会看：
go.mod
main.go
cmd/
internal/
如果是后端项目，会看：
routes/
controllers/
services/
middlewares/
config/
.env.example
你要怎么判断 AI 编程工具读对了
AI 编程工具回复后，你先不要让它改代码。
先检查它是否说对了这些内容：
如果它把项目类型说错了，说明它可能没读到关键文件。
这时候你要先确认自己打开的目录是不是项目根目录。
终端输入：
pwd
ls
Windows PowerShell：
pwd
dir
4.3 案例二：从 package.json 找出项目怎么跑
前端项目里，package.json 是最重要的文件之一。
你接手陌生项目时，第一件事不是乱点页面，而是先看：
scripts
dependencies
devDependencies
因为启动命令、构建命令、测试命令通常都藏在里面。
直接让 AI 编程工具读 package.json
你可以这样问：
请只阅读 package.json，不要修改任何文件。
请告诉我：
1. 这个项目用的是什么框架
2. 启动命令是什么
3. 构建命令是什么
4. 测试命令是什么
5. lint 命令是什么
6. 包管理器更像 npm、pnpm 还是 yarn
7. 哪些依赖说明这个项目的主要功能
输出时请按表格展示。
如果你在 IDE 插件里，可以用 @ 指定文件：
请阅读 @package.json，不要修改文件。告诉我这个项目怎么启动、怎么构建、怎么测试。
这样比让 AI 编程工具自己到处找更稳。
AI 编程工具应该怎么判断包管理器
可以让它看这些文件：
package-lock.json
pnpm-lock.yaml
yarn.lock
bun.lockb
一般判断方式：
你可以问：
请根据锁文件判断这个项目应该用哪个包管理器，不要直接运行安装命令。
推荐输出格式
让 AI 编程工具用这种格式输出：
请按这个格式输出：
项目框架：
包管理器：
启动命令：
构建命令：
测试命令：
lint 命令：
关键依赖：
我下一步应该运行的命令：
这样你复制到飞书也很清晰。
不要直接让 AI 编程工具安装依赖
新手容易直接说：
帮我安装依赖并启动项目。
不推荐第一步就这样做。
更稳的顺序是：
先分析 package.json
再确认包管理器
再确认 Node 版本
再运行安装命令
可以这样问：
请先分析 package.json 和锁文件，判断我应该用什么命令安装依赖。不要直接执行。
等它说清楚后，你再决定是否运行：
npm install
或者：
pnpm install
4.4 案例三：让 AI 编程工具给项目画一张“文件导图”
很多项目看起来很乱，不是因为真的乱，而是你还不知道目录职责。
例如 Next.js 项目可能有：
app/
components/
lib/
hooks/
styles/
public/
data/
Astro 项目可能有：
src/pages/
src/components/
src/layouts/
src/content/
public/
后端项目可能有：
routes/
controllers/
services/
models/
middlewares/
config/
你可以让 AI 编程工具帮你“画地图”。
提示词
请根据当前当前文件夹，给我生成一份“文件导图”。
要求：
1. 不要修改任何文件
2. 只解释和项目开发最相关的目录
3. 每个目录用一句话说明作用
4. 标出新手最应该先看的 5 个文件
5. 标出暂时不要乱改的文件
6. 用中文输出，适合复制到飞书文档
输出格式：
目录：
作用：
新手是否需要先看：
是否建议谨慎修改：
适合输出成表格
你可以要求它这样输出：
让 AI 编程工具标出“危险文件”
这个很实用。
你可以继续问：
请根据当前当前文件夹，列出新手不应该随便改的文件。
请按风险等级分为：
- 高风险
- 中风险
- 低风险
并说明原因。
通常高风险文件包括：
.env
.env.production
next.config.js
vite.config.ts
package.json
数据库迁移文件
支付相关文件
认证相关文件
部署配置文件
4.5 案例四：README 过期了，让 AI 编程工具重写新人说明
很多旧项目最痛苦的地方是 README 过期。
常见情况：
README 写的是两年前的命令
项目已经换成 pnpm，但 README 还写 npm
README 没写环境变量
README 没写构建命令
README 没写如何部署
README 写得太简略，新人看不懂
这时候 AI 编程工具很适合帮你生成一份“新人接手说明”。
第一步：先让 AI 编程工具对比 README 和 package.json
请阅读 README.md 和 package.json，不要修改文件。
请帮我检查：
1. README 里的启动命令是否和 package.json 一致
2. README 是否缺少安装依赖说明
3. README 是否缺少环境变量说明
4. README 是否缺少构建命令
5. README 是否适合新人接手项目
请只输出问题清单，不要修改。
第二步：让 AI 编程工具生成新版 README 结构
请基于当前项目，给我一份新版 README 大纲。
要求：
1. 适合新同事接手项目
2. 包含安装、启动、构建、测试
3. 包含目录说明
4. 包含环境变量提醒
5. 包含常见问题
6. 先只输出大纲，不要修改文件
第三步：确认后再让它修改 README
可以，按这个大纲修改 README.md。
限制：
1. 只允许修改 README.md
2. 不要修改 package.json
3. 不要新增文件
4. 不要编造不存在的命令
5. 如果不确定某个命令，请写“待确认”
6. 修改完成后总结你改了什么
README 推荐结构
# 项目名称
## 项目简介
## 技术栈
## 本地开发
### 安装依赖
### 启动开发环境
### 构建项目
### 运行测试
## 文件清单
## 环境变量
## 常见问题
## 新人接手建议
翻车点
不要让 AI 编程工具编造不存在的命令。
错误提示词：
帮我完善 README。
更好的提示词：
请只根据 package.json 和现有文件写 README。不要编造不存在的命令。
如果它不确定，就让它写：
待确认
4.6 案例五：让 AI 编程工具找出项目里最危险的 3 个地方
接手项目第一天，不一定要马上写功能。
更重要的是先知道：
哪里不能乱动。
因为有些文件一改就会出大事。
比如：
登录逻辑
支付逻辑
数据库迁移
环境变量
部署配置
鉴权中间件
API 网关配置
计费相关代码
提示词
请根据当前当前文件夹，帮我找出新手接手时最需要谨慎的 3 个地方。
要求：
1. 不要修改任何文件
2. 只根据现有目录和文件名判断
3. 不要编造不存在的业务逻辑
4. 每个风险点说明为什么危险
5. 每个风险点说明我应该先看哪些文件
6. 给出第一天不建议修改的文件清单
输出格式：
风险点：
相关文件：
为什么危险：
新手应该怎么查看：
暂时不要做什么：
AI 编程工具可能会列出的风险
如果是 Web 项目，可能包括：
登录鉴权
API 请求
环境变量
支付逻辑
数据库 schema
部署配置
如果是 AI API 项目，可能包括：
API Key 管理
Base URL 配置
模型路由
计费逻辑
错误码处理
限流配置
如果是内容站，可能包括：
sitemap
canonical
robots.txt
数据文件
页面 slug
构建脚本
让 AI 编程工具给出第一天任务清单
接着问：
请根据刚才的风险分析，给我一份“接手项目第一天任务清单”。
要求：
1. 不修改代码
2. 每个任务不超过 30 分钟
3. 先理解项目，再运行项目，再小改文档
4. 标出每个任务的验收方式
它可以输出类似：
4.7 本章通用提示词模板
下面这些模板可以直接复制。
模板一：读懂陌生项目
请先阅读当前当前文件夹，不要修改任何文件。
请用中文告诉我：
1. 这个项目是什么类型
2. 技术栈是什么
3. 主要目录分别负责什么
4. 启动命令是什么
5. 构建命令是什么
6. 新手第一天应该先看哪些文件
注意：
- 只分析，不修改
- 不运行高风险命令
- 不编造不存在的信息
模板二：分析 package.json
请只阅读 package.json 和锁文件，不要修改任何文件。
请告诉我：
1. 项目框架
2. 包管理器
3. 启动命令
4. 构建命令
5. 测试命令
6. lint 命令
7. 关键依赖
8. 我下一步应该运行什么命令
请按表格输出。
模板三：生成文件导图
请根据当前当前文件夹，生成一份文件导图。
要求：
1. 每个目录一句话说明作用
2. 标出新手应该先看的文件
3. 标出需要谨慎修改的文件
4. 不要修改任何文件
5. 输出适合复制到飞书文档
模板四：检查 README 是否过期
请阅读 README.md 和 package.json，不要修改文件。
请检查：
1. README 启动命令是否正确
2. README 是否缺少安装依赖说明
3. README 是否缺少环境变量说明
4. README 是否缺少构建命令
5. README 是否适合新人接手
请只输出问题清单，不要修改。
模板五：第一天任务清单
请根据当前当前文件夹，给我一份接手项目第一天任务清单。
要求：
1. 不修改代码
2. 每个任务不超过 30 分钟
3. 先理解项目，再运行项目，再小改文档
4. 每个任务都要有验收方式
5. 标出哪些文件暂时不要乱改
4.8 本章总结
接手陌生项目时，不要一上来就让 AI 编程工具改代码。
正确顺序是：
先读项目
再看 package.json
再理解目录
再检查 README
再找风险点
最后才开始小改
这一章你需要记住五句话：
第一句：
请先阅读当前文件夹，不要修改任何文件。
第二句：
请只阅读 package.json，告诉我启动和构建命令。
第三句：
请生成一份文件导图。
第四句：
请检查 README 是否和项目实际情况一致。
第五句：
请找出新手接手时最危险的 3 个地方。
学会这一章，你就不会再面对陌生项目时一脸懵。
你可以先让 AI 编程工具做你的“项目导游”，带你看懂项目，再让它当“开发助手”，帮你安全修改。
下一章可以继续讲：
项目跑不起来时，如何把终端红字、环境变量、依赖版本和启动命令交给 AI 编程工具排查。