创建项目文件夹

02-01 创建项目文件夹

课程定位

这一课进入项目设计与实现计划。第一章已经写出项目说明和使用者故事，现在要把项目落到电脑上的真实位置。

项目文件夹是 AI 编程实战的施工现场。项目说明、输入材料、输出结果、截图、日志、README，都要有自己的位置。文件夹清楚，AI 才能看清现场，学员也能随时回来继续做。

这一课的成果是一个完整的主项目文件夹。

本课目标

• 能为主项目创建独立文件夹。
• 能建立 inputs、outputs、assets、logs 等基础目录。
• 能把项目说明和使用者故事放进项目。
• 能让 AI 读取文件夹并复述结构。
• 能保存项目结构记录。

录制建议

• 建议时长：18 到 25 分钟。
• 直接从桌面或固定工作区开始演示。
• 先展示混乱文件，再展示整理后的项目文件夹。
• 每创建一个目录，都讲它放什么材料。
• 收尾让 AI 复述文件夹结构。

课前准备

• 第一版项目说明。
• 使用者故事。
• 固定 AI 工作台目录。
• 主线 AI 工作台工具。

讲稿正文

可以这样开场：

“项目开始之前，我们先给它找一个家。很多项目做乱，常常源于材料散在桌面、下载目录、聊天记录和临时文件夹里。”

项目文件夹像施工现场。材料放进去，工具进来工作，日志留在里面，最后成果也从这里交付。

建议主项目文件夹这样命名：

2026-06-csv-to-markdown

名字里可以包含日期和项目英文简写。日期方便排序，简写方便命令行使用。

基础结构可以这样建：

2026-06-csv-to-markdown/
  README.md
  project-brief.md
  inputs/
  outputs/
  assets/
  logs/

逐个解释：

• README.md：项目入口，写给未来的自己。
• project-brief.md：项目说明，记录目标、范围、验收。
• inputs/：输入材料，放样例数据和脱敏文件。
• outputs/：输出结果，放生成后的文件或导出记录。
• assets/：图片、截图、图标、参考资料。
• logs/：工作日志、排错记录、修改记录。

这里要强调一个习惯：

“AI 进入项目之前，先让它看文件夹结构。它看清现场以后，再谈计划和代码。”

最后收束：

“项目文件夹是你在数字世界里给项目划出的施工红线。红线清楚，AI 才知道在哪里开工，在哪里停手。”

屏幕演示流程

1. 打开固定 AI 工作台目录。
2. 新建主项目文件夹。
3. 建立 README.md、project-brief.md、inputs、outputs、assets、logs。
4. 把第一版项目说明放进 project-brief.md。
5. 把样例输入放进 inputs。
6. 打开 AI 工作台，让 AI 读取项目文件夹。
7. 要求 AI 复述目录结构和每个文件的用途。
8. 把复述结果保存到日志。

给 AI 的协作卡

我已经为主项目创建了文件夹。
请读取当前项目结构，并按下面格式复述：
1. 项目根目录是什么
2. 你看到了哪些文件和文件夹
3. 每个文件或文件夹可能负责什么
4. 当前还缺哪些基础文件
5. 下一步最适合做什么

请把事实、推测和建议分开。

项目文件夹检查单

• 主项目文件夹已创建。
• README 已创建。
• 项目说明已放入。
• inputs 已创建。
• outputs 已创建。
• assets 已创建。
• logs 已创建。
• AI 已复述项目结构。

课堂练习

让学员为自己的主项目创建文件夹。

要求：

• 文件夹名包含日期和项目主题。
• 至少创建 4 个基础目录。
• 把项目说明放进项目文件夹。
• 让 AI 复述一次结构。

常见卡点

• 文件夹建在随机位置：统一放入固定工作台目录。
• 文件名有大量空格或特殊符号：项目文件夹尽量简短清楚。
• 学员忘记放项目说明：项目说明要和代码放在一起。
• AI 复述不准确：先让它列实际看到的文件，再给建议。

课后作业

完成主项目文件夹搭建。

提交内容：

• 项目文件夹截图。
• 项目结构复述。
• 项目文件夹检查单。

课件页建议

• 第 1 页：项目先有一个家
• 第 2 页：施工现场和施工红线
• 第 3 页：推荐目录结构
• 第 4 页：让 AI 复述现场
• 第 5 页：项目文件夹检查单