讲师指南 · 业务助手智能体培训

课程目标

让零代码基础的学员,在 1-2 天内能用 Codex 做出一个可用的业务网页应用,覆盖 4 种典型场景(A/B/C/D)。

学员交付物:

1 份 PRD 文档(版本号 ≥ v0.1)

1 个单文件 HTML Demo(双击即开,CRUD 可用)

1 份 checklist-<产品名>.md(全勾)

1 份 CHANGELOG.md(记录所有改动)

课时建议

合计:5 小时(1 天) 升级版:加 1 天做「跨部门联合 demo」(可选)

课前准备

讲师侧:

[ ] 自己跑一遍 walkthrough,确保熟悉 4 场景

[ ] 准备 3-5 个真实业务场景(自己行业的例子)

[ ] 把 3 个参考 demo 在自己机器上跑通,准备好截图/录屏(备用)

[ ] 打印评分量表(给学员每人一份)

学员侧:

[ ] 装好 Codex(桌面版 / 浏览器扩展)

[ ] 拿到 Skill 包(目录或 zip)

[ ] 跑 python work/smoke_test.py,期望 78/78

[ ] 选一个真实业务,自己想好 3 轮对话内容

讲解要点

第一段:Skill 是什么(15 分钟)

Skill = 给 Codex 读的「说明书」,让 Codex 知道「你被启用后该怎么干活」

这个 Skill 的工作流:4 阶段 + 4 场景

学员的角色:不是程序员,是「业务产品经理」

强调:不需要懂 HTML / CSS / JS

第二段:演示(20 分钟)

用 walkthrough-hr-recruitment.md 投影

重点演示:

30 秒场景判断

三件套(PRD / 代码 / CHANGELOG)一起改

场景 C 的冻结老版本 + 迁移函数

边演示边让学员看 checklist 怎么用

第三段:学员实战(60-90 分钟)

每人选一个真实业务(不能是 HR,跟讲师业务不同)

复制 student-checklist.md → outputs/checklist-<产品名>.md

边做边勾,卡了就举手

讲师每 15 分钟巡场一次,问「卡在哪了」

第四段:复盘 + 评分(30 分钟)

抽 2-3 个学员 5 分钟演示

讲师用 instructor-rubric.md 现场打分

学员也用同一份量表互评,看评分标准是否一致

常见学员错误(讲师提前知道怎么救场)

评分

用 instructor-rubric.md 评分:

90+:优秀,可直接交付生产

75-89:良好,需要少量打磨

60-74:合格,需要中等打磨

< 60:不合格,需要返工

讲师不只看最终交付物,要看 checklist 过程——一个 60 分交付物 + 完整 checklist,比 90 分交付物 + 空白 checklist 学得多。

课后动作

[ ] 收集所有学员的 checklist,统计平均完成度

[ ] 选 3-5 个优秀 demo,作为下期班的范本(脱敏后)

[ ] 收集学员反馈,改进 Skill 或课程设计

[ ] 把 1-2 个失败案例(脱敏)加到「常见学员错误」表里

培训变体

讲师 FAQ

Q:学员电脑装 Python 失败怎么办?

A:本 Skill 的 smoke_test 用 Python(Codex 自带)。如果学员 Python 没装,跳过 smoke_test 也能用 Skill——但讲师没法验证安装。备选:让学员跑 node -v 看 node 装了没,作为粗略验证。

Q:学员的 Codex 版本太老,不识别 Skill 怎么办?

A:让学员更新 Codex 到最新版本。Skill 触发词可能不兼容老版本。

Q:学员选的「业务」太复杂,做不完怎么办?

A:让他砍需求。一个 1 天培训能做完的「业务」必须有:

1-3 个实体(比如「候选人」+「面试评价」)

单一用户角色

简单流程(2-3 步)

不要实时多人协作

不要复杂权限

如果学员选了「要做个全公司 OA」,劝他先做其中一个模块。

Q:学员中文打字很慢,1 天做不完怎么办?

A:可以用「实时语音转文字」工具(飞书妙记 / 通义听悟),或者让学员 2 人一组 1 个 demo(其中 1 人负责打字,1 人负责业务思考)。

Q:学员的 demo 在手机上打不开?

A:Skill 默认做移动端适配。如果学员做出来移动端不能用,讲师要现场演示「开发者工具 → 切到 iPhone 模式 → 看看哪里出问题」,让学员自己修。