怎么写工作日志？

03-04 怎么写工作日志？

课程定位

这一课教工作日志。

工作台项目会经历多次修改、报错、刷新、提交。学员如果不记录，很快就会忘记自己做过什么。工作日志像工坊里的铅笔印和木屑，能告诉未来的自己：今天从哪里开始，走到了哪里。

这一课要把日志从“正式文档负担”变成“下次开工路标”。学员只要会写 5 行，就能明显减少反复问自己“我上次做到哪了”的崩溃感。

本课目标

• 让学员知道工作日志记录什么。
• 让学员会创建 logs 文件夹。
• 让学员会用 5 行记录一次工作过程。
• 让学员会让 AI 从对话中整理日志。
• 让学员完成第一份工作日志。

录制建议

• 建议时长：22 到 30 分钟。
• 不要把日志讲成正式文档。
• 现场写一份非常短的日志。
• 强调日志服务未来的自己。
• 演示一次“自己写 5 行”和“让 AI 整理一版”。

讲稿正文

可以这样开场：

“你今天觉得自己肯定记得：我改了什么、跑了什么命令、哪里报错。三天以后再打开项目，很多细节会消失。”

工作日志不用漂亮。它只要回答五件事：

• 今天想做什么。
• 我让 AI 做了什么。
• 我运行了什么命令。
• 发生了什么结果或报错。
• 最后留下了什么状态。

推荐文件：

logs/2026-06-05.md

示例：

# 2026-06-05 工作日志

目标：生成个人主页第一版。
动作：让 AI 创建 index.html 和 style.css。
命令：用浏览器打开 index.html。
结果：页面能打开，标题和介绍已显示。
下一步：调整按钮颜色和页面间距。

这里要告诉学员：

“工作日志写给未来的自己看。它能让你下次回来时，少问一句：我上次做到哪了？”

工作日志还有一个隐藏价值：它能让 AI 更快接手。

下次打开项目时，可以直接把日志交给 AI：

这是我上次的工作日志。
请先复述当前项目做到哪一步。
请告诉我今天继续做时，最应该先检查哪 3 件事。

如果学员觉得自己不会写，就让 AI 先整理：

请根据我们刚才的对话，帮我整理一份 5 行工作日志。
格式是：目标、动作、命令、结果、下一步。
请用大白话写，方便我下次回来继续做。

但要补一句人工责任：

“AI 可以帮你整理，最后那句‘下一步’最好由你亲自确认。因为项目真正要往哪里走，还是你说了算。”

最后收束：

“日志不是给别人看的汇报，它是给未来自己的路标。路标越清楚，下次开工越省心。”

屏幕演示流程

1. 在项目中创建 logs 文件夹。
2. 新建当天日期的日志文件。
3. 写下目标、动作、命令、结果、下一步。
4. 回到对话区，让 AI 根据刚才对话整理一版日志。
5. 对比 AI 版和人工版，补充真实状态。
6. 把日志路径写进 README。
7. 模拟下次开工：把日志交给 AI，让它复述项目进度。

课堂练习

让学员回顾刚才的项目读取或安装过程，写一份 5 行日志：

• 目标：
• 动作：
• 命令或工具：
• 结果：
• 下一步：

然后让 AI 整理一版，学员人工检查三点：

• 有没有漏掉关键动作。
• 有没有把猜测写成事实。
• 下一步是否符合自己的真实目标。

常见卡点

• 学员觉得日志太麻烦：先写 5 行。
• 学员不知道命令是什么：从终端复制刚才运行的命令。
• 学员只写成功结果：报错也要记录。
• 学员日志放散了：统一放在项目的 logs 文件夹。
• 学员完全依赖 AI 整理：最后的状态和下一步要人工确认。

课后作业

给当前练习项目补一份工作日志，并在 README 里写一句：日志放在 logs 文件夹。

补充要求：

• 日志文件名使用日期。
• 至少写满 5 行。
• 把日志交给 AI，让它复述你当前做到哪一步。
• 保存 AI 复述结果。

课件页建议

• 第 1 页：标题“给未来的自己留路标”
• 第 2 页：为什么会忘
• 第 3 页：5 行日志法
• 第 4 页：现场写一份
• 第 5 页：让 AI 整理日志
• 第 6 页：下次开工怎么用
• 第 7 页：课后作业