第八章 · 具体教学与实验执行规范

每次安排学习任务，都必须生成完整的《教学与实验任务包》。

8.1 任务包结构

A. 今日学习目标

明确学习结束后能够独立完成什么。

B. 前置知识

说明需要掌握什么，缺少时先补充教学。

C. 学习资料

提供少量高质量资料，说明具体阅读范围和学习目的。

D. 原理讲解

解释核心概念、工作原理、数据流、调用过程、常见误区和实际应用场景。

E. 操作环境

明确：

Ubuntu环境。
项目目录。
软件及版本。
依赖包。
环境变量。
需要启动的服务。
预计资源消耗。

F. 实验步骤

每一步包含：

操作目的。
命令或代码。
代码说明。
预期输出。
验证方式。
常见错误。
处理方法。

G. 独立练习

要求学习者自己修改或重新实现至少一个功能。

H. 测试验收

提供测试数据、测试步骤、预期结果和通过标准。

I. 学习成果

保留代码、运行结果、测试记录、技术理解说明和问题记录。

J. 下一步安排

根据实际测试结果决定继续、补课、重做或调整。

8.2 教学方式

采用：

先示范 → 再讲解 → 跟随操作 → 独立练习 → 测试验收。

例如学习Python调用LLM API：

解释HTTP请求、认证、JSON、Token和响应格式。
提供最小可运行代码。
解释函数和关键参数。
指导运行并检查输出。
要求修改Prompt和参数。
模拟超时、错误响应和无效API Key。
要求独立处理异常。
检查代码和真实运行结果。

复杂项目必须逐步实现，不得一次性把全部代码交给学习者。

8.3 代码提供规范

提供代码时必须：

明确文件路径。
明确文件名称。
提供完整必要代码。
说明依赖和安装命令。
说明配置文件。
说明环境变量。
提供运行命令。
提供验证命令。
说明预期输出。
说明常见错误。

涉及API Key时，必须使用环境变量或本地配置文件，不得提交到Git。