TeachBench · 教师个人工作台（单文件 HTML 构建器）

何时使用

触发场景（出现任意一条即加载本 skill）：

• 用户要做一个「XX 工作台 / XX 管理系统」且要求单文件、双击即用、离线可用、无登录。
• 教师 / 班主任 / 教务类场景：班级管理、课程表、学生、成绩、座位、宿舍、积分、评语、工作留痕、待办。
• 任何「单文件 HTML + localStorage 持久化 + 自适应 Excel 导入 / Word 导出」的个人效率工具。
• 用户提到：个人工作台、单文件 HTML、离线、localStorage、JSON 备份、SheetJS、docx、自适应导入、角色切换（班主任/科任老师）等关键词。

核心原则（用户硬性偏好，不可违背）

1. 个人工作台模式：单用户自用，不做账号 / 登录 / 角色权限 / 管理后台。
2. 单文件交付：一个 HTML 承载全部 CSS + JS，零外部依赖（组件库走 CDN 动态注入，失败自动降级）。
3. 数据：localStorage 持久化 + 完整 JSON 导出 / 导入备份。
4. 升级不清空：存储带 version 字段，载入时只补默认字段、迁移旧结构，绝不覆盖用户已有数据。
5. 视觉：米白 #f6f4ee / 浅灰 / 浅绿 #4c8a6b 教育办公配色；中文；字号 ≥13px；电脑优先、平板自适应；图标用 SVG 图形，禁用单汉字当图标。
6. 交互：新增 / 编辑 / 删除 / 导入 / 生成通知书一律用弹窗；所有删除二次确认；所有导入弹窗报告识别结果（表头行 / 导入数 / 新建数 / 重复数 / 忽略数）。
7. 角色视角：单用户角色切换（如「班主任 / 科任老师」），不站在班级 / 学校角度设计；科任老师任教学科允许多个、本人自由增删，不依赖班级科任老师表。
8. 绝不出现点击无反应的占位功能；组件加载失败必须明确提示并降级。

完整工作流（输入 → 输出）

阶段 0：需求输入与澄清

收到任务后，先做只读侦察：确认工作区是否为空、有无历史相关交付（相邻目录 / 记忆文件），避免重复造轮子。

必须先问、会影响交付的技术决策（用 AskUserQuestion，最多 2-3 个，其余自行判断）：

1. 外部组件加载方式：CDN 联网 + 自动降级（推荐，能产真正 .xlsx/.docx）还是完全离线内联（只能产 CSV/打印）。
2. 是否预置演示数据（让仪表盘 / 分析开箱即见，还是只预置空数据）。
3. 若涉及多角色，确认角色的权限边界（隐藏哪些模块、某模块只看本人数据等）。

判断多用户 / 单用户：涉及「多人同时用、各看各的数据」时，单页工作台不满足，应转微信小程序 + 云开发方案；否则走本 skill 的单文件路线。

阶段 1：架构设计（产出数据模型 + 引擎划分）

1. 设计存储 schema（见 references/data-model.md）：顶层 {version, currentClassId, role, teacherSubjects, classes[]}；每班数据相互独立。
2. 划分共享引擎：图标、弹窗/确认/Toast、导入引擎、导出引擎、路由导航、顶栏、全局搜索。
3. 约定模块清单与别名字典（见 references/field-aliases.md）。

阶段 2：实现（按固定顺序成稿）

1. 地基：HTML 骨架 + CSS 设计系统 + 静态壳（侧栏 / 顶栏 / 工作区 / 弹窗 / Toast 容器）。
2. 核心引擎：工具函数、SVG 图标、状态 load/save/migrate、Toast / 确认 / 弹窗、导航路由、顶栏（班级切换 / 全局搜索 / 提醒 / 导出中心）。
3. 导入引擎（通用，所有模块共用）：表头定位（前 12 行按别名字典打分取最高行）、列别名匹配（剩余列保留为附加字段）、多工作表选最优、统一结果报告、各类型去重规则。
4. 导出引擎：SheetJS 多 sheet 真 .xlsx（支持 merges/列宽）、CSV 降级、docx（横向座位表 / 通知书）、打印降级。
5. 模块：按「仪表盘 → 班级 → 课程表 → 学生 → 成绩 → 座位 → 宿舍 → 积分 → 评语 → 留痕 → 待办 → 自定义功能 → 演示数据 → 初始化」顺序逐个实现。
6. 使用函数声明（可提升），避免模块间引用顺序问题。

阶段 3：验收（必做，交付前逐条核验）

1. 语法检查：提取 <script> 内容写入临时 .js，用 node --check 校验，报错定位到具体行修复。
2. 无头浏览器 smoke test：起本地静态服务器（python -m http.server），用 Playwright 打开，跑自动化检查脚本（见 references/smoke-test.md），确认：全部模块渲染零报错、导入函数正常、导出生成真 .xlsx、班级数据隔离、弹窗/确认可用、角色切换与权限过滤生效。
3. 逐条核对质量验收清单（见下）。

阶段 4：交付

1. 写工作日志到 {workspace}/.workbuddy/memory/YYYY-MM-DD.md（append）。
2. present_files 打开预览 + 附简洁交付说明（文件名 / 大小 / 用法 / 实测结果 / 遗留注意点）。

核心提示词模板（可直接复制使用）

> 变量用 {{...}} 占位，使用前替换。

T1 · 初始任务规格（生成完整单文件工作台）

你是一名资深产品经理 + 前端工程师 + 交互设计师。请为{{用户}}制作「{{产品名}}」，最终交付一个可双击打开的单文件 HTML，所有按钮/表单/弹窗/增删改查/导入/导出/班级切换/数据保存必须真正可用，不允许静态界面或占位功能。

一、交付与数据要求
1. 只交付一个 HTML 文件，CSS/JS 全部内联。
2. 不依赖服务器/数据库/登录。
3. localStorage 保存，刷新后数据仍在；升级版本不得清空旧数据（带版本迁移）。
4. 支持完整 JSON 备份与恢复。
5. Excel 导入导出用 SheetJS，Word 导出用 docx（浏览器端组件）；组件加载失败必须清晰提示并降级，不能点击无反应。
6. 中文、字号适中、布局紧凑；电脑优先并兼容平板。
7. 所有删除二次确认，所有导入显示识别结果。

二、整体界面
1. 左侧浅色功能栏 + 右侧工作区。
2. 顶部显示当前班级/姓名/学科/全局搜索/提醒/导出中心。
3. 图标用图形符号，不用单个汉字当图标。
4. 米白/浅灰/浅绿教育办公配色；新增/编辑/删除/导入/生成通知书用弹窗。

三、模块清单（每块列字段 + 自适应导入要求 + 导出要求）
{{各模块具体要求，参考 references/data-model.md 的模块清单}}

四、导入通用要求
1. 自动寻找表头（不要求第一行）。
2. 不依赖固定列顺序，支持常见中文字段别名。
3. 多工作表文件自动选最匹配的工作表。
4. 导入后提示表头行/导入数/自动新建数/重复数/忽略数。

五、质量验收
生成后自行检查：按钮可点、弹窗正确、删除二次确认、数据刷新留存、班级数据隔离、导入列序/表头自适应、多 sheet 选择、导出为真 xlsx/docx、无过小字号/按钮溢出/课程表过宽、控制台零 JS 报错、无占位功能。

T2 · 需求澄清提问（AskUserQuestion 选项）

问题1：组件加载方式？
- CDN 联网 + 自动降级（推荐）：能生成真正的多工作表 .xlsx 和 .docx；加载失败降级为 CSV/打印并明确提示。
- 完全离线内联：零外部依赖，但只能产 CSV/HTML 表格，不满足 .xlsx/.docx 硬性要求。

问题2：演示数据？
- 预置演示数据（推荐）：40 名学生 + 1~2 次考试 + 若干积分/评语/待办/座位/宿舍，开箱即见全部功能，可一键清空。
- 只预置学生：数据更干净，但仪表盘/分析首次打开是空的。

T3 · 角色权限扩展（在已有单文件工作台上加角色）

在这版框架上增加一个「{{角色B}}」角色视角（单用户个人模式，非班级/学校视角）：
1. 顶栏新增「{{角色A}} / {{角色B}}」一键切换，角色持久化。
2. 角色B 隐藏这些模块：{{模块列表}}；其余模块可见。
3. 某模块（如成绩）角色B 只能查看/编辑{{本人数据维度，如：任教学科}}，其余列与汇总列隐藏。
4. {{数据维度，如任教学科}}允许多个、本人自由增删（不依赖班级表）。
5. 学生管理权限与角色A 完全一致（或按需指定只读）。
6. 同步过滤：侧栏、全局搜索、导出中心、智能导入类型检测、仪表盘快捷入口/近期动态，避免隐藏数据绕路泄露。
先发一个静态模板（角色切换 + 侧栏隐藏 + 数据列过滤 + 权限说明卡）给我看，确认后再落地。

T4 · 验收自查（语法 + 无头浏览器）

语法检查（bash）：

node -e "const fs=require('fs');const h=fs.readFileSync('{{file}}','utf8');const m=h.match(/<script>([\s\S]*)<\/script>/);fs.writeFileSync('_check.js',m[1]);" && node --check _check.js && echo OK && rm -f _check.js

无头浏览器 smoke test 脚本见 references/smoke-test.md。

T5 · 交付说明（present_files 后的回复格式）

交付说明：文件名/大小/用法（双击打开，组件需联网加载一次，失败自动降级）。
内置演示数据说明 + 已实测项 + 遗留注意点 + 下一步可调整项。

质量验收清单（17 条，逐条核验）

1. 所有按钮可点击；2. 新增/编辑/生成功能正确弹窗；3. 删除按钮有效且二次确认；4. 各模块数据刷新后留存；5. 切换班级数据相互独立、新班默认无学生；6. Excel 导入不依赖列序、表头不在首行能识别；7. 多工作表能选最优；8. 导出为真 .xlsx/真 .docx（非 HTML 伪装）；9. 无过小字号/按钮溢出/课程表过宽；10. 控制台零 JS 语法错误；11. 无点击无反应占位功能；12. 角色切换后侧栏/数据列正确过滤；13. 组件加载失败有降级与提示；14. 升级不清空旧数据；15. 附加字段导入时保留、导出时包含；16. 双击可直接打开；17. 平板自适应不错位。

复用结构（随取随用）

• 数据模型 schema + 模块清单 + 引擎设计：见 references/data-model.md
• 10 类字段别名字典：见 references/field-aliases.md
• 无头浏览器 smoke test 脚本：见 references/smoke-test.md

权限声明

• 完全本地运行：构建产物为单个 HTML 文件，双击打开即用，无需服务器、无需账号、无需登录。
• 数据仅存浏览器本地（localStorage），不向任何远端上传；用户可一键导出/导入 JSON 备份。
• 网络依赖为可选且可降级：仅在加载 SheetJS（Excel 导入/导出）、docx.js（Word 导出）、JSZip（Word 解析）三个浏览器端组件时联网一次；加载失败自动降级（Excel → CSV、Word → 打印预览）并提示，不影响核心功能。
• 无外部 API Key、无凭证收集；Skill 本身不读取、不修改、不上传技能目录之外的任何文件。
• 无敏感数据外发；用户在班级 / 学生 / 成绩 / 宿舍等模块录入的所有信息均留在本地浏览器。

使用说明（供发布页 / 用户首次接触时参考）

1. 用户提出教师工作台/班级管理/成绩管理等单文件 HTML 需求时，Skill 自动加载。
2. 若用户对「是否允许 CDN 联网」和「是否预置演示数据」存在分歧，先用 T2 模板提两个澄清问题再开工。
3. 按 ## 完整工作流 顺序交付：地基 → 核心引擎 → 导入/导出引擎 → 16 模块 → 演示数据 → 初始化。
4. 验收必做：用 references/smoke-test.md 的脚本在无头浏览器跑一遍，确保零 JS 错误后再交付。
5. 交付物是一个 HTML 文件 + JSON 备份约定；升级不会清空旧数据。