小学语文单元学情分析
运行前提
- 确认 WorkBuddy 已启用并授权“ima 知识库”连接器。
- 确认当前任务已挂载包含小学语文课标、对应教材教参的 IMA 知识上下文。
- 直接使用运行环境提供的 IMA 上下文；不要在本技能中设计或解释连接器调用过程。
- IMA 不可用时停止规范性分析，请教师检查连接器或上传课标、教参。不要自行改用网络材料。
强制模板约束
- 最终 DOCX 只能由
scripts/build_report.py填充assets/template.docx生成。 - 禁止从空白文档新建，禁止调用其他文档模板，禁止按描述“仿照”排版。
- 禁止在脚本失败后改用 WorkBuddy 自带文档工具重新排版。
assets/template.docx是用户提供的“二年级6班 第一单元 学情简析.docx”的原样副本，固定 SHA-256 为723333E229453CAA47E8CEC59FAE3C7215AC9749A86D77A60B46A9B41707EC9E。- 模板缺失、哈希不一致、脚本报错或模板指纹验证失败时，停止交付并明确报告错误。
快速工作流
- 用一条消息确认年级、班级、教材版本、册次、单元和班级总人数。
- 用一张清单请教师一次性提供等级人数、测评数据、课堂观察、优势、薄弱点、注意力情况和未知数据。
- 汇总“事实确认卡”，只列已提供事实、计算结果、来源、冲突和缺项，请教师完成第一轮确认。
- 基于 IMA 规范性资料和已确认事实形成“分析确认卡”，只列四个能力维度、已掌握、欠缺、数据黑洞和教学重点，请教师完成第二轮确认。
- 仅在数据冲突、证据不足或教师大幅修改时发起第三轮确认，并且只询问未解决项。
- 锁定已确认事实、规范性依据、分析结论、未知项和教学决策；锁定后不重新检索或反复改写。
- 仅在此时读取 template-spec.md 和 payload-template.json，生成一份 JSON 内容矩阵。
- 必须运行
scripts/build_report.py，将内容矩阵填入assets/template.docx；不得使用任何替代生成方式。 - 完成三轮验证，全部通过后再交付 DOCX。
证据规则
按以下优先级处理信息：
- 课标、教材和教参要求：以 IMA 中对应版本的规范性资料为准。
- 班级事实：以教师确认的班级材料为准。
- 人数和百分比：由脚本计算。
- 无证据内容：写明“待测”“无直接数据”或“待课堂观察”，不得补写成事实。
规范性资料与教师描述冲突时询问教师；不得静默选择。每项核心结论必须能追溯到 IMA 依据、教师确认材料或计算结果。
教师确认要求
- 第一轮只确认事实，不提前讨论教学建议。
- 第二轮只确认分析判断，不展示完整文档。
- 每轮只展示新增或未确认项，不重复长文本。
- 两轮必做，第三轮按需；教师明确“全部确认并生成”后直接进入锁定状态。
三轮自我验证
第一轮：数据与证据
运行：
python scripts/validate_report.py --payload <payload.json> --stage evidence
检查人数闭合、百分比、字段完整性、数据来源、未知项标记和未确认推测。失败时只修正内容矩阵中的失败字段，再运行本轮。
第二轮：教学逻辑
只做一次简短审查：
- 单元目标是否符合 IMA 课标、教参；
- 四个能力维度是否完整；
- 掌握、欠缺和数据黑洞是否相互一致；
- 核心结论是否有证据；
- 每条教学调整是否与数据发现一一对应。
只修改不合格字段，不全文重写。记录“教学逻辑：通过”后继续。
第三轮：模板与文件
运行：
python scripts/validate_report.py --payload <payload.json> --docx <report.docx> --stage structure
验证程序必须比较输出文档与 assets/template.docx 的页面、段落样式、表格属性和单元格格式指纹。通过后再将 DOCX 渲染一次，逐页检查截断、错位、跨页表头和乱码。失败时局部修复并重跑本轮。
三轮未全部通过时不得输出正式文档。最终只向教师显示三项通过状态，不展示内部推理。
性能约束
- 每个任务只使用一次已挂载的 IMA 上下文；教材信息变化时才刷新。
- 不启动并行代理，不做开放式资料扩展。
- 不在确认阶段生成完整初稿。
- 只生成一个内容矩阵和一个正式 DOCX。
- 用脚本完成计算、模板填充和结构校验。
- 失败后局部修改，不重新执行整个流程。
交付
交付严格匹配样例结构和版式的 .docx，并附：
三轮验证结果：
1. 数据与证据：通过
2. 教学逻辑：通过
3. 模板与文件：通过
