做成作品集条目

08-04 做成作品集条目

课程定位

这一课把项目变成可展示成果。作品集条目要说明：这个项目解决了什么问题，怎么使用，交付结果是什么，学员从中学到了什么。

对普通学员来说，第一个 AI 编程项目是一份重要证据：我已经能把一个重复烦恼变成一个数字工具。

这一课的成果是一份「作品集条目」。

本课目标

• 能为项目选择一张截图。
• 能写清项目解决的问题。
• 能写清使用方式和交付链接。
• 能说明技术路线和学习经验。
• 能写出下一步计划。

录制建议

• 建议时长：20 到 30 分钟。
• 用刚发布或打包的项目继续演示。
• 作品集条目要短、清楚、可信。
• 不夸大项目能力，重点写真实问题和真实成果。
• 收尾让学员保存到项目 README 或个人作品集文档。

课前准备

• 发布或打包记录。
• 项目截图。
• README。
• 项目复盘草稿。
• AI 工作台工具。

讲稿正文

可以这样开场：

“项目做完以后，不要只把它留在文件夹里。给它写一张作品集条目，让别人知道它解决了什么，也让未来的自己看到这次成长。”

作品集条目包含六块。

第一，项目名称。

名字简洁，能看出用途。

第二，解决的问题。

写真实烦恼。比如“每次整理 CSV 到文档里，都要手动排版表格”。

第三，使用方式。

写用户怎么操作：打开页面，粘贴 CSV，点击转换，复制结果。

第四，交付结果。

放公开链接、打包位置或截图。

第五，技术路线。

写得朴素即可。比如“静态 HTML + CSS + JavaScript”或“Python 脚本处理 CSV”。

第六，学到的经验和下一步计划。

比如学会了需求澄清、文件结构、报错协作、README、发布。下一步可以增加下载结果或更好的错误提示。

示例：

项目名称：CSV 转 Markdown 小工具
解决问题：把 CSV 表格内容快速转成可复制到文档里的 Markdown 表格。
使用方式：粘贴 CSV，点击转换，复制结果。
交付结果：已发布为网页链接。
技术路线：静态 HTML + CSS + JavaScript。
学习经验：第一次完成了从想法、运行、排错、修改到发布的闭环。
下一步：增加下载 Markdown 文件功能。

最后收束：

“作品集条目是给项目拍一张毕业照。它记录的不只是工具本身，也记录你第一次把烦恼做成工具的过程。”

屏幕演示流程

1. 打开项目发布链接或打包结果。
2. 截取项目主界面。
3. 打开发布或打包记录。
4. 让 AI 根据 README 和记录整理作品集条目。
5. 人工补充真实使用场景和学习经验。
6. 保存作品集条目。
7. 把条目链接或内容写入 README。

给 AI 的协作卡

请根据我的 README、发布或打包记录、项目截图说明，帮我整理一份作品集条目。

请包含：
1. 项目名称
2. 解决的问题
3. 使用方式
4. 交付结果
5. 技术路线
6. 我学到的经验
7. 下一步计划

请写得短、清楚、可信，不夸大项目能力。

作品集条目

• 项目名称：
• 项目截图：
• 解决的问题：
• 使用方式：
• 交付结果：
• 技术路线：
• 学习经验：
• 下一步计划：

课堂练习

让学员为自己的主项目写一份作品集条目。

要求：

• 必须有截图。
• 必须写真实问题。
• 必须写交付结果。
• 字数控制在一屏内。

常见卡点

• 学员写得太像广告：回到真实问题和真实结果。
• 技术路线写太复杂：用最朴素的话说明。
• 没有截图：截主界面或运行结果。
• 下一步计划太大：写一个可执行的小升级。

课后作业

完成主项目作品集条目。

提交内容：

• 项目截图。
• 作品集条目。
• README 中的作品集链接或摘要。

课件页建议

• 第 1 页：给项目拍一张毕业照
• 第 2 页：作品集条目六块内容
• 第 3 页：CSV 转 Markdown 示例
• 第 4 页：短、清楚、可信
• 第 5 页：作品集条目