A Worked Example · Feedback Into Action

一件作品怎样经过反馈与修改

用社区图书交换目录的虚构教学案例,完整展示任务书、初稿、导师反馈、学生回应、版本修改、模拟复测与成长评价。

教学方案草案 · v0.1 · 2026年10月25日。用于说明拟定的教学组织;具体开课、课时、教师与学籍学分安排在正式入学前确认。

案例说明

虚构教学示例。以下角色、对话、评分与测试数据均为教学设计中的模拟材料,用来展示指导和修改过程。页面呈现项目文档与界面文案样例。

项目为“社区图书交换目录”,适合在具备 AI 基础与初步编程能力后尝试。学生以“小林”作为示例角色,计划用六周完成一个只处理虚构书目信息的网页原型。项目导师负责过程指导,学科教师复核关键知识与证据解释。

第一步:先写清任务书

  • 使用者:希望查找可交换图书的学习伙伴。
  • 核心问题:书目信息分散,无法快速知道有什么书、作者是谁、目前是否可交换。
  • 交付范围:一页书目目录,支持按书名或作者搜索,显示分类与状态,并提供没有结果时的提示。
  • 样例数据:八条虚构书目,不录入真实姓名、电话、住址或交易信息。
  • 资源预算:现有电脑、课程提供的开发环境,工具与材料新增支出目标为零;实际使用条件需导师核对。
  • 个人职责:学生负责需求、数据、代码解释、测试与修改。AI 可以辅助代码草稿和问题分析,学生保留来源与人工检查记录。

开始前约定的验收任务

  1. 用完整书名或部分书名找到对应条目。
  2. 用作者姓名找到该作者的书目。
  3. 没有匹配时给出说明,并能恢复全部列表。
  4. 每条书目均显示分类和明确状态。
  5. 仅使用键盘能够进入搜索框、执行搜索并清空条件。

学生能够解释数据字段、筛选条件和结果显示的关系,并说明哪些代码得到 AI 帮助,是作品说明中的共同要求。

第二步:提交V1原型与第一次自评

V1界面文案样例

社区图书交换目录
输入书名或作者,查找想交换的图书。
搜索框:输入关键词 按钮:搜索
星空观察入门|林远|可交换
城市里的植物|周宁|暂不可用

上面的书名与作者均为虚构。原型的宣传文案写了“书名或作者”,代码却只检查书名;没有匹配时只显示空白;状态虽有文字,但没有说明含义。清空动作依赖一个不可通过键盘操作的图标。

学生的第一次自评

“我已经做出了列表和搜索。用完整书名可以找到书。我请 AI 帮忙写了筛选函数,但还不能解释作者搜索为什么没有效果。我认为目前作品基本完成,需要再把页面做漂亮一些。”

学生提交V1快照、代码片段、八条样例数据和三分钟演示,并在记录中标出尚未理解的筛选逻辑。

第三步:导师把反馈写成可以执行的行动

观察到的证据导师反馈下一步行动再检查的办法
文案写能搜作者,实际只有书名匹配功能与说明需要一致。先解释当前筛选条件,再决定怎样支持两个字段把书名与作者分别匹配,合并结果条件搜索“林远”及部分书名,各检查一次
输入无匹配词后页面空白使用者无法判断是没有结果还是页面出错增加没有结果的说明与清空入口输入“海底”,检查提示并恢复列表
“暂不可用”没有解释使用者需要知道状态表达什么,哪些动作仍未实现给出状态说明,保持描述与原型范围一致请同伴读说明,再复述自己的理解
清空图标只能用鼠标验收任务包含键盘使用,需要可聚焦、可执行的控件改为有文字的按钮,检查焦点顺序只用Tab和回车完成查找与清空
无法说明 AI 给出的筛选函数需要理解和核验关键步骤写出输入、判断、输出,使用新样例手动推演不看 AI 对话,解释一个新关键词怎样得到结果

导师交流中的关键问题

“先用‘林远’运行一次。你预期出现什么?现在出现什么?请指出代码里检查作者的那一行。如果没有这一行,你准备怎样改?修改后用什么新例子证明它确实工作?”

导师请学生先预测、操作和解释,再提供必要提示。反馈按核心任务排序:先修正搜索与空结果,再处理状态与键盘操作,最后调整视觉细节。

第四步:学生回应反馈,形成V2修改单

“我把‘做漂亮’放到后面,先解决功能与说明不一致的问题。我会检查书名和作者两个字段,处理空输入,增加清空按钮。对于键盘操作,我需要先学习按钮和焦点的基本用法,再进行测试。”

修改记录样例

  • 变更01:搜索词先去除首尾空格;空输入时显示全部书目。
  • 变更02:分别检查书名与作者字段,任一匹配即可显示。
  • 变更03:无匹配时显示结果说明,提供“清空搜索,查看全部”。
  • 变更04:补充“可交换”与“暂不可用”的含义;样例只展示目录,交换由课堂中的模拟流程处理。
  • 变更05:使用带文字的搜索与清空按钮,补充键盘焦点检查。
  • 变更06:保存 AI 建议、采用的部分、人工修改和新样例推演。

V2界面文案样例

社区图书交换目录
按书名或作者查找,目录共8条虚构书目。
搜索框标签:书名或作者 按钮:搜索 按钮:清空搜索
搜索“林远”:找到1条结果
星空观察入门|作者:林远|分类:科学|状态:可交换
状态说明:“可交换”表示该样例条目可进入课堂模拟;“暂不可用”表示本次模拟中不可选择。

没有结果时:“没有找到相关书目,请调整关键词,或清空搜索查看全部。”

学生怎样解释关键逻辑

“先整理输入;输入为空就返回全部书目。对于每条书目,分别检查书名和作者是否包含关键词,至少一个匹配就显示。显示之后再计算结果数量。如果数量为零,显示没有结果的说明。我用新作者和带空格的输入重新检查过这个过程。”

第五步:用相同任务复测

下表为模拟复测数据。每项使用相同的样例书目和操作步骤,以比较版本差异;不据此推断真实教学成效。

验收任务V1模拟观察V2模拟观察留下的证据
书名或部分书名查找通过通过输入与结果截图
作者查找未通过:返回空白通过:找到对应条目作者输入与结果记录
无结果说明与恢复未通过:空白且没有恢复入口通过:显示提示,可清空恢复无匹配与清空操作记录
分类与状态说明未通过:缺分类、状态不清楚通过:字段完整,可复述含义条目与说明截图、同伴复述
键盘查找与清空未通过:清空控件不可聚焦通过:Tab与回车可完成键盘操作记录

V2在这五项模拟任务中达到原型验收要求。手机布局、扩大书目数量后的表现及真实社区使用仍需另行验证,进入下一版本的工作清单。

第六步:复评怎样写

导师第二轮反馈样例

“第二版已经回应作者搜索、空结果、状态和键盘操作四类问题。你能解释筛选过程,也保留了修改依据。下一步请用一条新书目和不同屏宽再次验证,并把‘完成原型’与‘适合真实社区使用’分开记录。继续保留尚未验证的内容。”

评价维度与模拟评分

示例使用四级描述:1级需要持续提示,2级能在支持下完成,3级能独立完成并解释,4级能迁移到新情境并支持同伴。评价依据过程证据和新的操作任务,不把平均分当作正式成绩。

评价维度V1模拟等级V2模拟等级变化依据
需求与验收23能把文案、功能与验收任务对应
方法理解13能解释筛选逻辑并推演新输入
证据与核验13能按相同任务比较版本,标明未验证项
沟通与回应23把导师与同伴意见变成明确修改单
自我管理23根据重要性调整任务,记录困难与求助

第七步:学生完成反思与下一步

“我最初把页面能打开当作完成,后来发现说明、功能和测试需要互相对应。AI 帮助我更快写出草稿,但真正让我能继续修改的是理解输入、判断和输出。我学会先解决使用者无法完成任务的问题,再调整外观。下一步我要检查手机操作和更多样例数据。”

学生把任务书、V1、第一轮反馈、回应、V2、复测、第二轮反馈与反思放入同一条作品记录,任何读者都能找到一次修改的来由和结果。

这个案例怎样连接三类课程

  • 基础学科:英语负责说明与表达,数学负责分类、逻辑和数据解释,科学负责可重复的测试,人文讨论公共服务与信息使用责任。
  • 项目课程:完成编程、界面、功能与测试,把需求做成原型。
  • 生活课程:安排时间、判断工具成本、管理任务优先级并及时求助。
  • 社会课程:完成访谈、同伴试用、反馈沟通与作品展示,清楚说明贡献。

完整记录顺序可用于其他项目:任务书 → 初稿 → 自评 → 导师反馈 → 学生回应 → 修改版本 → 复测 → 复评 → 下一步。每门课程的具体标准随项目性质调整。