case-teaching-note

概述

该技能用于编写与案例叙事（由 case-business-case 产生）配套、面向教师的教学笔记。案例本身是故事，教学笔记则是教学法：它在课程中的位置、用哪些理论框架解读、用哪些问题推动讨论、以及如何评估。

适用时机

触发条件：

• 案例根目录已存在 case.md，或调用方提供了某个变体的 case.md，且作者需要配套的教学材料。
• 作者要把已有案例改用于不同受众（不同课程、层级或时间预算）。
• 作者希望在试讲后更新苏格拉底式问题。

跳过条件：

• 尚无案例叙事（应先运行 case-business-case）。
• 交付物是研究档案而非教学工具。
• 属于非案例教学场景（纯讲授、实验课等）。

工作流程

1. 读取与状态检查：在读写产物前，读取 internal/state.json，检查适用的阻塞项并确定 work_target。若存在阻塞，记录一条 blocked 历史并停止。

2. 读取案例：阅读 case.md 及其证据包（位于 research/ 或 research/manual-evidence-brief.md）。

3. 作者访谈：读取 internal/intake.yaml。若已设置 discipline 和 audience_level 则使用它们；discipline 是列表，若列出多个领域，应选择同时服务各领域的问题、视角与板书，而非只取其一。写第一版前不必先询问，使用作者已有信息与默认值并在笔记中说明：已存储的层级，或作者请求隐含的层级，否则默认为研究生层级；根据案例理论给出的建议性课程位置；80 分钟课堂；证据与学科所支持的视角。笔记写好后，提出可调整上述选择（层级、课程位置、课堂时长、理论视角）：作者选定某一项时，仅就该项询问并修订笔记，同时把层级或学科答案写入 internal/intake.yaml 与 config（discipline 写入列表，可多选）；课程位置、课堂时长与视角保留在笔记中。

4. 理论扫描：结合 research/extraction-log.md 或手动简报中的引用与作者上传材料，选取一组聚焦于决策点的理论视角，并标明哪些由案例直接支持、哪些需要外推。

5. 学习目标：选择数量可控、可衡量的目标（常见 3–5 个），每个对应案例证据与评分标准中的一项，并根据作者目的与可用时间调整数量。

6. 课堂计划（以 80 分钟为例）：

• 第 1 段（15 分钟）：冷开场与背景，用苏格拉底式问题引出学生的假设。
• 第 2 段（20 分钟）：困境与数据，用问题检验理解并迫使明确取舍。
• 第 3 段（20 分钟）：决策时刻，用问题引出立场并迫使辩护。
• 第 4 段（20 分钟）：总结与迁移，把案例与先前案例或学生自身经验联系起来。
• 预留 5 分钟缓冲（75 分钟活动 + 5 分钟缓冲）。按作者时间预算缩放各段，同时保留简短的总结/迁移环节。泛化、小组作业、休息或嘉宾演讲属于可选项而非必需；参见分时模板。

1. 板书计划：可视觉化的序列（Mermaid 流程图或结构化大纲），使同事无需备注即可在白板上复现。

2. 课前/课中/课后任务：课前阅读或短写作、课中小组提示、课后反思或跟进。

3. 评估：评分标准（形成性或总结性）——若 case-classroom-test 已运行则取其标准，否则默认 5 项标准（问题识别、框架应用、证据使用、立场辩护、迁移）。

4. 状态更新：选择文件前检查阻塞项并读取 work_target。变体写入其 teaching_note 路径；该字段为空时使用 variants/<variant-id>/teaching-note.md 并在 work_target 中记录该路径。主版本使用 case-<slug>/teaching-note.md。替换前先归档先前的根级笔记及其阅读副本。保留当前目标；设置 stage: "case-teaching-note"、next_skill: "case-classroom-test"，并在 internal/state.json 中追加历史。

5. 读者格式：文档中所有读者可见的标题、题注、交叉引用与标签均使用文档语言，并采用 references/taxonomy.md 中的术语（如葡萄牙语用“Anexo”而非“Exhibit”）。teaching-note.md 开头使用 references/reader-formats.md 规定的封面前置信息：案例标题与日期、教学笔记标签、仅限教师提示，以及案例封面图（若有）。以此 Markdown 为准，渲染同目录 HTML 与 PDF，记录全部三个路径，向作者列出所有生成路径，并提供打开选项，仅推荐先打开 teaching-note.md，其次 PDF；遵循 references/reader-formats.md。

6. 披露：将本次运行的输入、输出、AI 贡献、人工贡献、检查项与待检项追加至 internal/disclosure.md。

产物路径与状态

以下根级路径为默认值。选择文件前先从 state 读取 work_target；若指向变体则使用相应路径并保留主版本。调用方的新显式目标会更新 work_target。部分运行或阻塞时，保留最后成功的阶段，并记录限制与下一步。完成时，将该技能存为 stage，根据实际剩余工作选择 next_skill，追加历史，清除 current_skill，并刷新 updated_at。评审或课堂报告可能指出修订点，但其完成不代表案例已获批准。

继续流水线

本技能完成后，遵循 references/pipeline-flow.md：用一句话告知作者下一步，并在同一回合运行 next_skill；仅在文档列出原因时停止。每回合以提问工具与可选选项结束（例如“Seguir com a pesquisa”）。

输入

• case.md 及其证据包（research/ 或 research/manual-evidence-brief.md）。
• 作者访谈答案。
• 可选：case-classroom-test 已产出的评分标准。

输出

• case-<slug>/teaching-note.md —— 标准教学笔记。
• case-<slug>/teaching-note.html 与 case-<slug>/teaching-note.pdf —— 该 Markdown 的阅读副本。
• 更新后的 internal/state.json（含历史记录）。

限制

• 不生成案例叙事（由 case-business-case 负责）。
• 不在课堂中运行案例（由 case-classroom-test 负责）。
• 不投稿期刊（由 case-peer-review 负责）。
• 不生成学员指南或幻灯片（属于展示流水线的下游）。
• 不虚构理论引用——每条引用必须来自证据包、手动简报或作者上传材料。
• 引用来源时，高亮引文使用笔记语言，原文可作为 Original: 附后；遵循 references/reader-formats.md，不要先放源语言再注释。
• 不把 HTML 或 PDF 作为源文件编辑，须从 Markdown 重新生成。

参考文档

• references/taxonomy.md —— 各语言下读者可见术语：标题、题注、交叉引用与封面标签（葡萄牙语中“Exhibit”为“Anexo”）。用于所有面向读者的文档。
• references/pipeline-flow.md —— 如何进入下一技能、何时停止，以及每回合结束时的提问。
• references/class-plan-template.md —— 60/80/90/180 分钟变体与问题阶梯。
• references/socratic-questions.md —— 各段好问题的标准。
• references/case-folder-convention.md —— 文件夹与状态模式，含英/葡术语。
• references/reader-formats.md —— 标准 Markdown、HTML 与 PDF 副本、需列出的路径及推荐打开的主交付物。

常见陷阱

• 在教学笔记中逐字引用案例正文——笔记应转述与分析，而非重复。
• 要求未声明的准备——问题必须能凭案例证据与已声明的前置条件或指定阅读作答；所需理论应通过阅读或先修课程提供，不要插入案例正文。
• 时间超支——计划须符合可用时间，并留 5 分钟缓冲。
• 理论过载——只选目标所需视角，更少可能已足够。
• 缺少教师分析——问题保持开放，但教师版笔记应包含演算、合理回答、取舍与指导，以便他人使用。