一份给零基础同学的项目教案

从一个想法,
到一款小程序。

一个真实的制作故事:我们如何和 Codex 对话,把不够清楚的想法,慢慢做成能玩、能测试、能分享的作品。

不用先会写代码。
先学会表达、观察、反馈和验证。

性格旅程分享封面:海岛、城市和大山三段风景
THE CASE / 真实案例性格旅程海岛 · 城市 · 大山

01 / 项目成品封面从这里开始 ↘

一个想法✳第一次对话✳做出初版✳发现问题✳修改与测试✳继续完善

BEFORE WE START / 这堂课

学会和 AI 一起
把想法做出来。

01说清楚想做什么、给谁用。

02看懂真实反馈怎样变成修改。

03写出需求,并列出一项测试方法。

适合零基础
可在浏览器中离线阅读

01

FIRST, THE IDEA

先认识这个作品

这是一个把自我探索放进故事里的免费小程序。用户选择一段旅程,在情景中回答问题,最后得到一份结果报告。

01 / 海岛

心屿来信

认识自己的性格偏好

02 / 城市

城光手记

发现自己的工作动力

03 / 大山

山间回声

探索应对压力与恢复的方式

创作者 · 原话
请给我现在3个游戏的定位

一个产品可以有很多内容,但每一部分都需要回答:它是给谁用的?用户能从中得到什么?

+ 看看小程序的首页和海岛画面展开过程截图

这两张图来自准备提审时的开发者工具截图,展示三个旅程入口和海岛答题画面。

首页 · 选择旅程
海岛 · 情景答题

这一站学到:先把目标讲明白,不用一开始就说出所有技术细节。

02

MAKE IT VISIBLE

让人物走进故事

有了三段旅程,接下来要让它们看起来像三个真实的地方。场景、人物、文字和动作,都需要一起考虑。

创作者 · 原话

所有的人物在说话的时候,左右晃动过快,有没有其他的表现他在互动的方式

Codex · 处理过程整理

调整人物动作:说话时不再快速切换身体姿势,改用缓慢呼吸、短暂眨眼和自然的回应动作。

后来又发现

气泡挡住人脸、有人物说话时一直闭眼。于是继续调整气泡位置,并检查人物的待机和说话表情。

“气泡不要挡住人脸” — 创作者原话
大山场景 · 开发者工具模拟器截图
+ 看看人物表情是怎样检查的展开图片

团队逐帧查看人物的睁眼、眨眼和说话姿势,避免把眨眼帧当作默认表情。下面是实际检查用的表情对照图。

这一站学到:把“看起来不对”说具体:哪里、什么时候、希望变成什么样。

03

WRITE BEFORE VOICE

先把故事讲顺,再配音

画面出来后,创作者发现另一个更重要的问题:题目之间接不上,人物说话也不够连贯。

THE TURNING POINT / 一次方向调整

“整个游戏问答,在剧情上不够连贯,很多问题前言不搭后语。”

接着,创作者提出先整理文案和题目,语音合成先不做。这让大家能够先专心检查故事,而不是反复给还在变化的文字配音。

01整理情节

人物为什么相遇、这一站要做什么。

02试读题目

前后是否衔接,选择是否自然。

03再做声音

文案确定后,再合成并检查配音。

城市旅程 · 开发者工具模拟器截图

文字和声音,也是一段互动

正式配音完成后,人物对白会朗读,已经读过的文字逐渐变红。用户还能跳过或重听。正文始终保留,声音暂时不可用也能继续阅读。

创作者 · 原话

语音的部分,说完就用红色字体替代,现在只是在说那个字有显示

这句话促成了字幕显示方式的调整:读过的部分保留红色,而不是只突出正在读的字。

+ 看看朗读后的文字效果展开过程截图

浏览器联调画面中,已经朗读过的文字呈红色。它用于检查文字显示,真实手机听感仍需要单独测试。

这一站学到:先确认内容本身,再投入时间制作声音和其他包装。

04

LISTEN, THEN IMPROVE

一个“跳过去了”的问题

有时候,用户感觉到的问题并不是一句“修复一下”能说明白的。真正有用的信息,来自具体的操作过程。

创作者 · 原话摘录

有时候点“我会”的时候会自动跳过,我不知道是把选择跳过了,还是本来就没有选择

Codex · 处理过程整理

检查打开选项、点击答案和进入下一题的顺序,增加对当前题目和点击动作的校验;调整按钮文案,让用户知道下一步是选择答案。

创作者 · 后续原话

每次选择答案的时候,加一个音效和点击效果,比如发光什么的

创作者 · 再次反馈

基本ok了,不过点击答题之后,加一个淡出效果最好。

WHAT CHANGED / 调整后的答题节奏

  1. 01读题
  2. 02展开选项
  3. 03选择并反馈
  4. 04看到回应
  5. 05进入下一题

每个阶段都有明确反馈,用户知道自己选了什么,也知道什么时候会前进。

A REAL SCREEN / 过程截图

让每一次选择
都被看见。

这张图展示的是浏览器联调中的选项画面。实际微信效果还需要在手机上亲自确认。

截图:测试样例
+ 领取报告的页面也经过调整展开两张截图

创作者觉得“暂不填写”的选项比较粗糙。后来,领取页换成更清楚的选填提示和建议标签;报告操作按钮也分成两行。

领取报告 · 选填页面
城市报告 · 模拟作答结果

这一站学到:一次反馈不必解决所有问题;先修逻辑,再根据体验继续打磨。

05

TEST IT FOR REAL

在手机上,问题才会出现

电脑上的预览能帮助检查画面,但声音、触摸、相册和微信分享,还需要在真实设备上体验。

创作者 · 真机反馈
没声音,卡顿,没弹出框,反正哪里都不对,请你做一次全面测试

这不是一个单独的问题。接下来的工作是把它拆开:声音、流畅度、选项、设置和报告,分别检查。

01

电脑先检查

用自动检查和浏览器预览,确认画面、按钮和基础流程。

02

开发工具再检查

在微信开发者工具里编译,观察小程序运行和控制台提示。

03

手机亲自体验

扫码运行,听声音、点选项,查看相册和分享是否正常。

过程截图:在微信开发者工具中查看模拟器与调试信息
+ 为什么 iPhone 静音时没有声音?看排查经过

创作者发现,关闭 iPhone 的实体静音开关后,小程序又能发声。随后根据平台的音频设置调整播放方式,并再次使用手机预览检查。

这个例子提醒我们:同一个现象可能与设备、系统设置或程序有关,先复现和缩小范围,再决定怎么改。

“似乎可以了” — 用户对后续声音调整的反馈

这一站学到:自动测试、模拟器和真人手机测试互相补充,不能用其中一种代替全部。

06

FROM PROJECT TO PRODUCT

做好以后,还要让人用上

作品从电脑走到微信,需要准备小程序账号、资料和可运行的版本。上传代码只是其中一步。

01完善资料

名称、头像、服务类目等信息,要与实际功能一致。

02配置与测试

按实际情况完成备案、域名和隐私相关设置,并进行真机检查。

03上传开发版

使用微信开发者工具上传准备好的代码。

04审核与发布

在微信后台提交审核,通过后再发布。

不同主体与功能对应的具体要求,请以当时微信后台显示为准。案例中用户后来反馈小程序已上线;后续更新的开发版上传记录不等于已审核发布。

+ 几个新同学可能会遇到的词展开解释
本地预览
先在自己的电脑上打开检查。地址中的 localhost 或 127.0.0.1 只指当前设备,不能直接作为分享给他人的公网链接。
开发者工具
微信提供的开发软件,可用来编译、预览和上传小程序。
真机测试
在实际手机上操作,检查声音、触摸、相册和分享等体验。
开发版、审核、发布
代码上传后先形成开发版,提交审核并通过后,还需要发布,用户才能使用对应的新版本。

NAME & AVATAR / 名称与头像

产品信息,也要经过选择。

创作者希望名称容易被搜索,也为头像挑选了更直观的插画。名称审核遇到问题后,又根据平台反馈调整。

这里展示的是创作者选用的头像素材。

AND THEN / 上线后继续完善

分享出去的,
也应该是一张完整的图。

创作者 · 原话

小程序分享这个,似乎显示不全,我可以自己选择图片吗,或者你给我一些建议

后来为首页和三个场景分别准备分享封面;在报告页分享时,封面会读取用户本次的真实结果。下面是一个测试报告生成的分享效果。

这一站学到:作品上线不是终点;真实使用后的反馈,会带来下一轮改进。

07

YOUR TURN

现在,轮到你了。

你不需要先想出一个很大的项目。从一个身边的小问题开始,试着把想法说清楚。

01

哪句话更容易让 Codex 帮到你?

选择一个你认为最清楚的表达。

请选择更具体的需求

A LITTLE PROMPT LAB

写下你的第一个需求

填完下面三项,就能生成一段可以发给 Codex 的起步描述。

内容只在当前页面中处理,不会发送到服务器。

THE NEXT STEP IS YOURS

不用一次说得完美。
从第一次对话开始。

说出想法,看看结果,再用具体的反馈把它一点点变好。

回到开头 ↑

关于这份教案

用户对话摘录来自本次项目交流,Codex 的处理步骤根据项目记录整理,并非逐字回复。图片来自项目留存的模拟器、浏览器测试截图及分享素材;带“测试样例”的结果由模拟答案生成。

本教案为独立静态项目。页面不连接原小程序的账号、后台或用户数据,也不收集练习内容。

给授课老师的使用提示

课前准备:每位学生准备一台能打开浏览器的设备;课堂中的需求生成练习可离线完成,后续与 Codex 实际交流需自行确认账号及使用条件。

45 分钟示例:5 分钟认识作品;10 分钟看需求与画面;10 分钟讨论剧情和交互;10 分钟理解测试与上线;10 分钟填写需求并分享。

练习成果:请学生提交一段需求描述、一条针对初版的具体反馈,以及一项自己会执行的测试。看是否写清使用者、功能、操作位置和预期结果。

图片和资料说明

项目中保留了图片来源及校验记录,详见随教案附带的 素材与事实说明.md。由于部分早期聊天截图未留存,教案采用文字摘录和可核对的项目截图。

按 Esc 或点击右上角关闭