自学读本：跟着读、照着做，卡住就问 AI
你好，我是吴老师。
这份是给你自己读的——不用等我讲，你一段一段往下看，看到让你停下来的地方，就照着做一遍。看不懂的整段复制给 AI，加一句"请一次只解释一个概念，讲完问我一个小问题"。
读完之后，你应该能：说出 WorkBuddy、Skill、烧录分别是什么；把这门课的学习方法（六步学习链）讲给同学听；完成第一次环境检查，并确认 AI 真的读到了板子的资料。
用时：30–40 分钟。准备：电脑上装好并登录 WorkBuddy、接入课程 Skill、打开课程项目文件夹；触摸屏板、能传数据的数据线。
一、先看看我们面前这块板子
它不大，却能显示画面、感受手指的触摸，还能发光、播放声音、连接网络。以后我们会用它做一些自己的作品：一盏表达心情的灯、一个提醒学习的小助手，或者一个可以和你交流的设备。
不过，今天先聊一个问题：假如你有一个想法，却还不会写程序，这个想法能不能变成真的？
在这门课里，我们会借助一个叫 WorkBuddy 的 AI 软件。你可以用平时说话的方式，把想法告诉它，让它帮助你编写程序、编译，再把程序烧录到这块板子上。
"烧录"这个词听起来有点吓人——不是真的拿火去烧。它只是把板子能执行的程序写进它的存储器。程序写进去之后，板子就能脱离电脑，按照程序自己工作了。
二、AI 写程序，那你要学什么？
你可能会问："吴老师，代码都是 AI 写的，那我做什么呢？"
请你想象一个场景：你对 AI 说"做一盏好看的灯"，它给你做了一盏不停闪烁的红灯——可你想要的是一盏安静变化的蓝灯。
AI 确实完成了一段程序，但它做对你的想法了吗？没有。
所以你要学的第一件事，是把想法说明白：什么颜色？什么时候亮？多久变化一次？怎样才算做好？这些都要你来决定。
第二件事，是看真实的结果。AI 说"上传成功"，你要亲自看看灯是不是真的亮了，亮的是不是你要的颜色。
第三件事，也是我最看重的——继续问：
- 灯亮了，就问："它为什么会亮？"
- 灯变黄了，就问："灯里只有红、绿、蓝，黄色是从哪里来的？"
- 你改了一个数字，灯的变化不同了，就问："这个数字到底控制了什么？我怎样验证？"
这门课不会带着你逐行背代码，也不急着讲括号、分号和语法。遇到重要的代码，我们只看看它和眼前的现象有什么关系。我希望你能做出作品，也能用自己的话解释作品为什么能工作。
三、给 AI 一份这块板子的"说明书"
现在我们有三样东西：你、WorkBuddy、触摸屏板。还差一样：这门课程配套的 Skill。
你可以先把 Skill 理解成一份给 AI 使用的"硬件说明书和操作经验"。里面记录着：这块板子用什么芯片、灯接在哪个引脚、可以参考哪些程序、编译和烧录时要注意什么。
为什么非要给 AI 这些资料？因为不同板子的连接方式不一样。AI 如果只凭一般知识猜，可能把灯的引脚写错，也可能用错屏幕的驱动方法——轻则东西不亮，重则花屏。
接入 Skill，就是让 AI 有机会按照我们这块板子的实际资料来做事情。
这里要分清两件事：
| 东西 | 是给谁的 | 存在哪里 |
|---|---|---|
| Skill | 给电脑上的 AI 看的资料 | 电脑里 |
| 程序 | 板子要执行的东西 | 编译后烧进板子的 Flash |
Skill 不是烧进板子里的程序。板子最后运行的，是编译、烧录进去的程序。
四、角色分工：一条链上的三个角色
顺着图看：你把想法说出来 → WorkBuddy 读 Skill、按板子资料写程序 → 电脑编译并烧录 → 板子执行、灯亮起来 → 你观察、追问。这里面你的想法和判断才是起点和终点，AI 负责中间的体力活。
有一点要提醒你：Skill 只是让 AI"有机会"做对。它读过资料，也不代表每次都对。所以每节课我们都要请它说清楚依据，并用实验检查。
五、先把工作台准备好
请和我一起做四件事：
- 电脑上装好并登录 WorkBuddy；
- 课程提供的
esp32s3-touchboard-hardware-devSkill 已按配套说明接入； - 课程项目文件夹已经在 WorkBuddy 中打开；
- 触摸屏板放在干燥的桌面上，用支持传输数据的 USB 线连上电脑。
第 4 条有个坑要提醒你：只支持充电的线，可能让板子亮起来，却不能下载程序。第一次连接时，最好找吴老师一起确认板子上的 USB 接口。
这两节课的板端实验不需要连接 WiFi，也不需要填云端 API 密钥。账号、密码这些信息，不要放进截图或作业里。
界面找不到接入入口时，先不要猜着点，找吴老师一起完成。
六、第一次对话：让 AI 证明它"认识"这块板子
准备好后，把下面这段话发给 WorkBuddy：
我是刚开始学习 AI 硬件编程的学生，正在跟吴老师学习。
我使用的是课程配套的 ESP32-S3 触摸屏板。
请先读取已接入的 esp32s3-touchboard-hardware-dev Skill，
按照其中的入口说明查阅板卡、引脚、环境和编译烧录资料。
现在先检查准备情况，不修改程序、不烧录：
1. 告诉我你实际读到的 Skill 路径，以及板载 RGB 灯的引脚资料来源。
2. 检查电脑是否有课程需要的编译和烧录工具。
3. 执行 arduino-cli board list，列出检测到的板子和端口。
4. 用我能听懂的话，告诉我哪些准备好了、哪些还缺少。
如果读不到 Skill 或不能执行本机命令，请明确告诉我，
不要假装已经检查成功，也不要猜测硬件参数。
看完 AI 的回答，请用三个标准打分：
| 检查点 | 好的回答长什么样 | 敷衍的回答长什么样 |
|---|---|---|
| Skill 路径 | 给出实际文件路径 | 只说"好的，我了解了" |
| 板子检测 | 报告检测到的板子和端口 | 不提设备，直接说"一切正常" |
| 没把握的事 | 明确说"查不到/做不到" | 含糊带过，假装成功 |
如果它找不到 Skill，找吴老师检查接入；如果没检测到板子，先检查数据线、接口和驱动。这个检查通过了，下一课才能顺利让 AI 操作硬件。
七、以后每一课，我们都这样学
这门课的学习方法，其实只有六个步骤：
说清目标 → 让 AI 实现 → 观察结果 → 追问原理 → 改一个条件验证 → 自己讲出来。
举个例子，做一个"每秒换色"的灯：
| 步骤 | 做什么 | 例子 |
|---|---|---|
| 1. 说清目标 | 把要求说得能检查 | "让灯每隔一秒换一种颜色" |
| 2. 让 AI 实现 | 把要求发给 AI，它负责编程烧录 | "颜色按红绿蓝循环" |
| 3. 观察结果 | 亲眼看，不轻信"上传成功" | 是不是真的每秒一换？顺序对吗？ |
| 4. 追问原理 | 拆开看为什么 | 电从哪来？指令怎么到达灯？ |
| 5. 改一个条件验证 | 只改一个数字，先猜后试 | 一秒改成两秒，其余不动 |
| 6. 自己讲出来 | 用自己的话讲一遍 | 讲给同学听，讲不通就是没懂 |
第 5 步特别重要：一次只改一个条件。改了时间，就别同时改颜色。这样灯的变化，你才知道是哪个条件造成的。
你可以把这句话记在笔记上：
说清目标 → 让 AI 实现 → 观察结果 → 追问原理 → 改一个条件验证 → 自己讲出来。
八、复制提示词以后，再加上你自己的话
每节课我都会给你一些可以复制的提示词，它们能帮你起步。但我希望你慢慢学会自己补充要求：
- "帮我做个灯" → 可以说得更具体："请让板载 RGB 灯一直亮蓝色，用较低亮度。烧录后，我会检查它能不能保持蓝色至少十秒。"
- "我没看懂" → 可以继续说："你刚才提到数据线。我不明白数据线和供电线有什么不同，请用这块板子的 RGB 灯举例。"
如果 AI 一次讲得太多，直接发这段：
我想理解原理，但刚才的解释里有些词我还不懂。
请一次只解释一个概念，先用生活中的例子，再对应到真实硬件。
请指出这个比喻有哪些地方和真实硬件不一样。
每次解释后问我一个小问题，等我回答再继续。
先不要讲代码语法，也不要直接替我回答问题。
AI 说得流畅，不代表每句话都准确。如果它说的和实验不一致，你可以问："你的依据是什么？能不能查一下这块板子的资料，再设计一个实验验证？"——提出这样的追问，就是在认真学习。
九、出问题时，你也是实验的参与者
如果灯没亮，不要只发"坏了"两个字。AI 看不到你桌上的板子，它需要你提供观察结果。
试着这样说：
"我想让灯一直亮蓝色。AI 显示上传成功，但板上的小灯没有亮，屏幕仍显示原来的画面。我刚才没有拔过线。"
如果有报错，把相关报错文字一起发过去。不要为了让实验显得成功而省略异常——异常往往正是找到原因的线索。
这里有个很重要的区分：
- 观察：灯是蓝色、上传成功、我按了三次按钮——是事实；
- 推测：红蓝通道可能反了、程序可能没烧进去——是猜想，要用实验验证。
AI 负责检查代码和工具，你负责提供真实的现场现象。我们一起把原因找出来。
十、动手做
任务 1：完成第一次环境检查
把第六节那段提示词发给 WorkBuddy，然后对照表格给它打分。
如果一切顺利，你会得到：Skill 的真实路径、本机工具检查结果、板子和端口的列表。把这个结果保存好——以后每一课烧录前，都要用它核对"AI 有没有找对板子"。
任务 2：练习"追问原理"
AI 回答完检查结果后，从它的回答里挑一个你不太懂的词（比如"编译"、"端口"、"Flash"），发给它：
刚才你提到____这个词，我还不太懂。
请一次只解释一个概念，先打比方，再对应到这块板子，
并告诉我这个比喻哪里和真实情况不一样。讲完问我一个小问题。
它问你的问题，你要真的回答，不要跳过——这一步练的就是"自己讲出来"。
挑战：写下你的第一个作品想法
先别看 AI 的回答，用三句话回答下面的问题：
- 你想用这块板子做什么？请说出一个具体行为（不是"做很酷的东西"，而是"它每天下午 5 点用蓝色闪三下提醒我休息"）。
- WorkBuddy、Skill 和触摸屏板，分别帮你完成什么？
- AI 说"完成了"之后，你准备怎样确认？
不需要说得像课本一样。你能把自己的意思说明白，就可以开始了。
十一、自检小测
先自己想，再点开对答案。
1. "烧录"是什么意思？真的用火烧吗？
不是。烧录是把板子能执行的程序写进它的存储器。程序写进去之后，板子就能脱离电脑自己运行。
2. 代码都是 AI 写的，学生还要做什么？
把想法说明白（颜色、时间、判断标准）；看真实的结果，不轻信"上传成功"；不断追问原理；改一个条件验证；最后用自己的话讲出来。
3. Skill 是什么？它和程序有什么区别？
Skill 是给电脑上的 AI 看的"硬件说明书和操作经验"，不是烧进板子的东西。程序才是板子要执行的。AI 读 Skill 是为了按这块板子的实际资料做事。
4. 这六个步骤的顺序是什么？
说清目标 → 让 AI 实现 → 观察结果 → 追问原理 → 改一个条件验证 → 自己讲出来。
5. "改一个条件验证"为什么要一次只改一个？
同时改两个条件，出结果后你分不清变化是哪一个造成的。一次只改一个，才能确定因果。
6. 灯没亮时，应该怎样向 AI 描述问题？
描述观察事实：想要什么效果、AI 报了什么、实际看到什么、自己动过什么；有报错就附上报错文字。不要只说"坏了"，也不要把推测当结论。
十二、出发前，先把三句话带走
第一句：想法是你的，作品是你的，AI 只是帮你把想法变成现实的那双手。
第二句："完成了"不是终点，亲眼看到灯亮、能讲出它为什么亮，才是终点。
第三句：出问题不可怕，把现象说清楚，你就已经参与进实验里了。
下一课，我们先让一颗小小的 RGB 灯亮起来。然后我会和你一起追问：一颗灯，究竟是怎样变出不同颜色的？
本课的配套资源
本节配套的演示程序源码与可烧录固件，已整合到课程页面底部的「配套资源 · 在线烧录」区——插上你的 ESP32-S3 触摸屏板（Chrome / Edge 浏览器），点「在线烧录」即可直接写入，无需安装软件。
给 AI 的第一句话（每次新开对话都先说这句）：
请使用课程的 esp32s3-touchboard-hardware-dev Skill，
我现在做第 0 课（认识课程与工作台检查），需要你帮我____。
改动前先说清依据的项目文件路径，烧录前先运行 arduino-cli board list 确认端口。