--- name: ascend310b-curriculum-planning description: Ascend310 教材的课程计划与内容映射。用于规划第1章至第10章、案例1至案例9、样例代码和 Presentation 的学习目标、先修关系、评估证据和教学顺序;要求 observable objectives、可复现实验和 310B 硬件边界,不改变冻结标题,不虚构板端结果。 --- # 教材课程计划 ## 范围 用于教材层计划,而不是直接改正文: - 理论章节与案例之间的先修关系; - 每章/案例的学习目标、可观察产出和评估证据; - `samples/` 入口与教学内容映射; - `src/presentation/` 课件的课堂节奏; - 8T/20T 实验、摄像头、CANN 和模型依赖的覆盖检查。 本 skill 参考教育 Agent Skills 的学习目标、能力拆解和评估有效性思想,但以本仓库冻结命名、样例入口和板端证据为准。课程计划、学习目标、练习和评估说明使用简体中文,技术标识保留原形;写入学生文档的英文主导正文由`prose-language`阻断。 ## 唯一计划产物 教材级课程计划只维护一份:`docs/curriculum_plan.md`。首次创建时复制 [curriculum-plan-template.md](references/curriculum-plan-template.md)。`ascend310b-writing-case` 必须消费该文件中的学习目标、先修、形成性检查和最终证据,不得另建平行教学矩阵;`ascend310b-writing-academic` 只负责证据与论证,不成为第二份课程计划。 ## 计划矩阵 每行至少填写: ```text 对象: 第N章 / 案例N / 附录 / 课件 学习结果: 学生能做什么(observable verb) 先修: 需要的前置概念或实验 理论: 对应 src/book、src/experiment 或 src/appendix 页面 代码: 对应 samples/ 入口 概念顺序与 worked example: 初学者课程必须记录概念递进及具体示范例子/图示 形成性检查点: 初学者课程必须给出预测题、检查题或短任务及可检查产出/反馈标准 评估: 代码、日志、数值、任务指标或演示证据(最终证据) 硬件: 8T/20T、摄像头、NPU、CANN 条件 缺口: 尚无证据的内容 ``` 学习结果使用“解释、实现、诊断、验证、比较、设计”等可观察动词,不用“了解、熟悉、掌握”这种无法评估的词。形成性检查点用于教学过程反馈,不替代“评估”字段中的最终证据;不能只写“可选练习”或“后续补充”,不适用的非教学参考对象须说明理由。计划矩阵可以保留内部路径,但写入学生可见教材时不得带上 `.dot` 源、字体名、pt/dpi 或作者自检备注。`human-review: pending` 只保留在外部任务或审查元数据中,不进入发布正文。 ## 工作流 1. 运行 `ascend310b_writing_progress` 和 `ascend310b_writing_audit`,了解当前篇幅、冻结名和断链。 2. 阅读 `src/book/README.md`、`src/experiment/README.md`、`src/presentation/README.md` 和 `samples/case-index.json`。 3. 在 `docs/curriculum_plan.md` 建立唯一“章节—案例—代码—课件—证据”矩阵;已有文件时更新而不是另建副本。 4. 检查先修顺序:必要理论概念是否在完整实验前讲清,案例代码是否对应真实 `samples/` 入口;`case4.md` 必须自行提供必要知识,只链接自己的源码、图片和外部来源,不链接或依赖任何其他仓库文档。 5. 检查评估:每个案例至少有一个真实可运行证据;没有板端证据的结论标为 `untested`。 6. 检查 8T/20T、摄像头、模型和 CANN 依赖;不要把某板结果当作全平台结果。 7. 只修改唯一计划文件和用户要求的源页面;sidebar 由 `ascend310b-writing-vuepress` 维护,冻结标题改名需用户明确批准。 8. 完成后复跑 audit/progress,推送前运行 `ascend310b_writing_push_check`。 ## 评估原则 - 学习目标、形成性检查点、课堂任务和最终证据必须对齐;初学者课程必须有具体的过程反馈,不能只承诺以后添加练习。 - 案例的演示截图不能替代 API、数值和性能证据。 - 同一评估只测一个主要能力,不要把模型精度、性能和 UI 混成一个“通过”。 - 如果没有可复现输入和命令,该目标保持 `blocked` 或 `untested`。 - 课程计划可以建议新增实验,但不能伪造实验已经执行。 ## 停止条件 - 学习目标不可观察或没有评估方式。 - 先修关系形成循环。 - 章节/案例/样例入口不一致。 - 案例结论没有当前 310B 证据。 - 需要修改冻结名但没有用户明确要求。