AI 小工具创造入门
第二册

第二册项目练习册

第二册配套练习表,帮助你记录项目地图、终端运行、依赖环境、保存数据、历史记录、Git 保存点和最终验收。

使用说明

这本练习册不是考试卷。

它是你的“项目操作记录本”。

第一册练的是:

我想做什么。

第二册练的是:

我的项目在哪里、怎么运行、怎么保存、怎么验收、怎么继续改。

建议用法:

  • 学第 1 课时,填写项目地图。
  • 学第 2 课时,填写终端运行记录。
  • 学第 3 课时,观察 package.json
  • 学第 4 课时,排查依赖和环境变量。
  • 学第 5 课时,判断要保存什么数据。
  • 学第 6 课时,记录历史记录功能。
  • 学第 7 课时,留下 Git 保存点。
  • 学第 8 课时,完成第二册总验收。

练习 1:我的项目地图

先把项目从“一个陌生文件夹”变成“我能说清楚的地方”。

项目我的记录
项目名称
项目文件夹在哪里
我用什么编辑器打开
主要页面文件可能在哪里
配置文件可能在哪里
启动命令可能在哪里
我最看不懂的文件夹是

请让 AI 帮你解释,但先不要让它改代码。

练习 2:终端运行记录卡

每次项目跑不起来,先记录,不要慌。

项目我的记录
我在哪个文件夹打开终端
我输入的命令
终端显示的地址
浏览器打开的地址
运行是否成功成功 / 失败
如果失败,错误信息在哪里终端 / 浏览器 / 两边都有
错误信息全文

提醒:

终端不是黑客窗口。
终端是项目说话的地方。

练习 3:package.json 观察表

打开 package.json,找到和运行项目有关的信息。

我看到的内容我的记录
项目名
scripts 里有哪些命令
启动命令是哪一个
build 命令是哪一个
主要依赖有哪些
我看不懂的依赖是

如果看不懂,可以问 AI:

请用完全不会代码的人也能听懂的话,解释这个 package.json 里 scripts 和 dependencies 分别是什么意思。

练习 4:项目环境排查表

项目跑不起来时,先判断是哪类问题。

问题类型我的观察是否可能
没装依赖终端提示找不到包或模块是 / 否
命令输错终端提示没有这个 script是 / 否
端口被占用终端提示端口冲突是 / 否
环境变量缺失终端提示 API Key 或 env是 / 否
代码报错终端或浏览器显示文件和行号是 / 否
文件夹不对命令在错误目录运行是 / 否

不要急着重做项目。

先把错误分类清楚。

练习 5:依赖和环境变量记录卡

项目我的记录
是否已经安装依赖是 / 否 / 不确定
安装依赖命令
是否需要 .env 文件是 / 否 / 不确定
需要哪些环境变量名
哪些值不能公开
AI 让我新增了什么依赖
我知道为什么要新增吗知道 / 不知道

注意:

API Key、密码、密钥不要发到公开地方。

练习 6:我要保存什么数据

不要先问“用什么数据库”。

先问:

我要保存什么?
刷新后还要不要存在?
给谁看?
重要吗?
数据是否要保存刷新后要保留是否敏感第一版保存位置
用户输入是 / 否是 / 否是 / 否
生成结果是 / 否是 / 否是 / 否
生成时间是 / 否是 / 否是 / 否
标题或备注是 / 否是 / 否是 / 否
其他是 / 否是 / 否是 / 否

第二册第一版通常选择:

浏览器本地保存。

练习 7:历史记录功能卡

给小工具加历史记录之前,先写清楚第一版只做什么。

功能本课是否做结果
保存一条记录做 / 不做通过 / 不通过
显示历史记录列表做 / 不做通过 / 不通过
刷新后记录还在做 / 不做通过 / 不通过
删除单条记录做 / 不做通过 / 不通过
清空全部记录可选 / 不做通过 / 不通过
登录不做
云数据库不做
部署上线不做

测试记录:

项目我的测试内容
测试输入
测试输出
保存后是否显示是 / 否
刷新后是否还在是 / 否
删除后是否消失是 / 否

练习 8:AI 修改记录表

每次 AI 改完项目,都记录一次。

项目我的记录
这次让 AI 做什么
AI 改了哪些文件
新增了哪些文件
删除了哪些文件
我看懂的改动
我没看懂的改动
项目还能启动吗能 / 不能
原功能还在吗在 / 不在 / 不确定

如果“我没看懂的改动”很多,不要继续加功能。

先让 AI 解释。

练习 9:Git 保存点记录

留下保存点前,先检查项目状态。

检查项我的结果
项目能启动通过 / 不通过
页面能打开通过 / 不通过
原功能还在通过 / 不通过
历史记录能保存通过 / 不通过
刷新后历史记录还在通过 / 不通过
能删除历史记录通过 / 不通过
AI 改动我大概知道通过 / 不通过

保存点记录:

项目我的记录
保存点说明
保存时间
保存前完成的功能
保存后下一步只改什么

保存点说明示例:

完成:历史记录本地保存和删除

练习 10:第二册总验收卡

检查项结果证据
项目能正常启动通过 / 不通过
页面能正常打开通过 / 不通过
第一册原有功能还在通过 / 不通过
能生成或整理结果通过 / 不通过
能保存历史记录通过 / 不通过
刷新后历史记录还在通过 / 不通过
能删除不需要的记录通过 / 不通过
删除后刷新不会回来通过 / 不通过
能说清主要文件通过 / 不通过
能说清运行命令通过 / 不通过
留下 Git 保存点通过 / 不通过
下一步只选一个小目标通过 / 不通过

练习 11:第二册复盘

问题我的复盘
我的小工具现在能做什么
它比第一册多了什么能力
我现在知道项目怎样启动吗知道 / 不知道
我现在知道数据怎样保存吗知道 / 不知道
我现在知道 AI 改了什么吗知道 / 不知道
我留下保存点了吗留了 / 没留
第二册最难的一课是
下一步只改一件事

第二册复盘的重点不是炫耀功能。

重点是确认:

我开始能维护自己的小工具了。

On this page