AP 教学复盘助手

要解决的问题

AP 教学里的复盘往往被"数据完整"拖死：教师要么先搭一套数据库，要么在十几个表格里来回复制。结果是——出分之后想找一条证据链，却发现成绩、作业、反馈散落在不同文件夹，模考分数和行动决定完全没连上。

hts-ap-teaching-loop 的思路是反过来的：先把记录成本压到最低，再让数据自己长成复盘材料。

核心能力

首次使用只问一个问题：你属于哪种情况——还没有整理方式、已有一些文件夹、还是先试用。选①时，技能只收集学年和 AP 学科，给出一个极简档案的预览，教师回复"确认"才动文件；没有文件工具时，输出可复制的目录结构与最短操作说明。

只维护三个核心对象，不默认建多层目录：

• AP教学台账：记录任务、考试、结果和下一步
• 教学反思日志：记录证据、解释、行动和验证
• Evidence：保存原始成绩、作品、报告和教学材料

每次记录只给少量结论。日常任务和小测：最多 3 项发现、3 项行动；模考和年度复盘先给一页式摘要，再允许下钻。每次上传后只给一条归档建议（如 Evidence/01_成绩与评估/ + 20260920_Unit2_Test.xlsx），只建议，不擅自移动或改名。

三个工作流覆盖全年：开始新学年（目标同时换算成人数，并检查 5分率 ≤ 4+率 ≤ 3+率，同时维护固定班级口径与有效参考口径）；记录一次任务或考试（先判级，A级 可直接跟踪出分率，C级 只用于能力诊断）；阶段或年度复盘（套用 证据 → 解释 → 行动 → 验证 固定反思链，每个判断标注是数据事实、分析发现、待验证假设还是行动决定）。

跨学科不硬编码题型，优先用用户文件里的官方标签：英语与人文看文本类型、论证与 Rubric；数学看 Units 和 Justification；实验科学看 Science Practices 与图表；Capstone 看 Performance Tasks 与答辩。读取 Instructional Planning Report 时动态识别 Reporting Category Type，而不是假定所有学科都按 AP Lang 分类。

适用边界

必须字段只有学年、学科、班级、匿名编号、任务名称与日期、得分、考试范围。推荐字段和深度字段缺失时不拒绝分析，只标"待补充"。

隐私方面默认使用 Student A、A01 这类匿名编号；小样本必须提示比例可能被单个学生显著影响；不把一次考试结果归因于教学质量，也不把相关性写成因果。预测用于教学决策，不是成绩承诺。考试版本、缺考、换算表、评分条件不同的情况要明确标注。

没有文件工具时，输出可复制的 Markdown 表格或 CSV，并说明哪些内容尚未真实写入文件。