teacher-paper

name teacher-paper description 教师智能出题技能 - 覆盖小学一年级到高三全科目（语文、英语、政治/道德与法治、历史、地理、数学、物理、化学、生物），全题型，按用户提供的材料/真题样卷/题型分值分布参数化出卷；结合本地资料（Word/PDF/PPT/Excel/MD/TXT/图片）与在线真实素材（新闻/科普/公版古籍/英语分级读物等）生成学生试卷，产出可直接打印的 Word 试卷 + Word 参考答案及解析。默认九年级语文·长沙中考。理科含图题须用户提供图片，本技能不自动配图。触发时机：用户要求出题、组卷、制作试卷、生成练习题、制作考试卷，或提到'出题''组卷''试卷''考试卷''练习题'等关键词。 user-invocable true allowed-tools ["Read","Write","Edit","Bash","Agent","AskUserQuestion","WebFetch","WebSearch"] metadata {"version":"3.32.1","author":"teacher-paper-skill"} Teacher-Paper 教师智能出题技能 🔴🔴🔴 第一铁律：阅读材料禁止编造 🔴🔴🔴 非连续性文本、现代文（小说/散文）、古诗词、文言文、名著的 选文与材料，必须取自真实来源 ： 非连续性文本 → 必须摘自真实新闻报道/科普文章 （来源见 references/material-sources.md ），用 fetch_web.py 抓取， 原文落盘到 工程/materials/ 。 古诗文/名著 → 必须是真实存在的作品 ，用 fetch_web.py 从古诗文网/ctext 核验原文，落盘 materials/。 现代文 → 优先选《读者》《意林》等真实美文 ；教师自创文（需有真实创作背景，非 AI 生成）须在 meta.source 显式写 原创-已声明 ，并在 meta.json 补注 "origin_note": "教师原创，YYYY年作" 。 assemble.py build 有硬门禁 ：任何含选文的材料文件，meta 缺 source + source_file （或 source_file 指向的 materials/ 文件不存在）， 直接拒绝出卷 。 严禁先编造内容再补一个假来源 ——这是命题的红线，宁可流程慢，不可凭空捏造选文。 🔴 忠实节选铁律（保真：可删减，禁造假） ：选文 可删掉与命题无关的部分（含中间段落），但保留的每段文字必须逐字取自真实原文 ——禁止改字、禁止编造、禁止打乱原文顺序。卷面出处一律标 "节选自《X》" ，禁用"改编自/整理自/编写自/原创"等字样。build 有 _check_faithful_excerpt 硬门禁：material 每段须为 source_file 原文的逐字子串且按原文先后顺序，否则 exit 2 拒绝出卷。 🔴 关于 --allow-unsourced （强制绕过门禁，慎用） ：build 提供 --allow-unsourced 可跳过溯源/完整性门禁强制出卷。 默认绝不使用 ；仅在用户 明确知情并要求 时才加，且 一旦使用必须显式告知用户"本卷已绕过真实性门禁，选文未经溯源校验，请自行核对来源" 。 不得为图省事自行加此参数 。 核心命题理念 "以命题促教学，用原创提素养" 本技能以 自包含脚本作为稳定底座 ，同时会优先复用当前电脑/当前 AI agent 已有的 Office、MCP、Pandoc、OCR 等能力。任何 AI agent、任何电脑上，都先扫描能力，再选择最稳路径；只有没有稳定 Word 生成后端时，才安装最小兜底依赖。 六个自包含脚本： setup.py （环境自检/装依赖）、 read_material.py （读文档）、 fetch_web.py （抓网页）、 ocr_image.py （图片OCR兜底，无识图能力时用）、 assemble.py （原子化组卷·init/build）、 make_paper.py （生成 Word）。 关于脚本路径（重要，跨工具通用） ：下文命令里的 <SKILL_DIR> 代表 本 skill 的实际所在目录 ，不是固定路径。不同 AI 工具/电脑上 skill 位置不同， 不要写死 。开始前先确定它：本 SKILL.md 文件所在目录就是 <SKILL_DIR> ；脚本在 <SKILL_DIR>/scripts/ 。 setup.py 运行时会用自身位置自动解析并打印出 skill 目录 ，照此替换即可。 默认场景 ：未指定时按 初三/九年级·语文·中考模拟 、长沙中考标准（21题/120分/120分钟）出卷。 适用范围（重要） 支持全科目 ：语文、英语、政治/道德与法治、历史、地理、数学、物理、化学、生物（小学一年级到高三）。 ⚠️ 理科/文综（数物化生·地理）配图能力分级（全技能唯一锚点，v3.18.0 更新） ：本技能 make_figure.py 可生成 11 种图 ：function/geometry/number_line/bar/line/pie/scatter/vector/climate/pyramid/ svg （AI 直写 SVG 入 figure.kind="svg" 渲染）。 分级处理 ： ✅ AI 直接生成 ：函数图、几何示意（含简单受力/光路/简单装置示意）、数轴、柱/折/饼/散点图、向量图、气候柱状叠折线、人口金字塔、 简单 SVG 装置/电路/分子结构/细胞结构示意 。 ⚠️ 用户提供 ：复杂装置图、真实照片、地理等高线/卫星/地形图、复杂电路、复杂分子三维结构、文物图、历史地图—— figure.src 指向用户提供的图片。 🛑 占位 ：临时无图但确认人工补图时，留 ［图：…］ 占位（ --allow-missing-figure 降级）。 build 缺图硬门禁 ：题干写了"如图/图中"却没有 figure 块 → 拒绝出卷；仅在用户知情同意走"占位"时加 --allow-missing-figure 降级。各科具体分级见 references/subjects/<科目>.md 第 2 节。 文科里的少量图（历史地图、地理图表）同样不自动生成；处理方式同上。 全学段：结构从哪来（核心机制） 本技能可出 小学一年级到高三、上述文科科目 的卷。试卷结构按以下优先级解析（ assemble.py 自动处理）： 样卷蓝图（最优先） ：用户给一份本地真题/样卷 → 你读它（ read_material.py /识图）→ 解析出"大题/题型/分值/时长"写成结构 JSON → init --blueprint-file <结构.json> 。 中小学无统一标准卷，本地样卷最贴合,优先走这条。 内置预设 ： presets/ 下已备 17 个预设文件，按 学段_科目[_地区].json 命中即用；科目别名（政治/道法→思想政治）与地区缺省自动回退基名。 学段 科目（共17文件） 文件名（可直接核查 presets/ 目录） 九年级 思想政治 九年级_思想政治.json 九年级 历史 九年级_历史.json 九年级 地理 九年级_地理.json 九年级 英语 九年级_英语.json 九年级 数学 九年级_数学.json 九年级 物理 九年级_物理.json 九年级 化学 九年级_化学.json 九年级 生物 九年级_生物.json 高三 语文 高三_语文.json 高三 英语 高三_英语.json 高三 历史 高三_历史.json 高三 地理 高三_地理.json 高三 思想政治 高三_思想政治.json 高三 数学 高三_数学.json 高三 物理 高三_物理.json 高三 化学 高三_化学.json 高三 生物 高三_生物.json 九年级语文 内置（长沙中考 21 题/120 分） 无文件，硬编码默认 若预设文件不存在（如高中文科无 高三_历史.json ）→ 自动回退通用兜底并提示用户。 CLI 参数（ --total / --duration / --questions ）优先级高于预设默认值 ，用户给了具体数字直接覆盖预设，无需额外确认；但 题量/总分覆盖后，预设的大题骨架与 manifest 不会自动重分配 ——你须同步调整各大题题量分值，并在 Phase 1 出口把修订后的分布表展示给用户。另外预设按 学段_科目 命中、 不区分考试类型 （如"期末"会命中按中考/高考骨架写的预设），类型不同时须告知用户"结构基于 X 类型预设，建议提供本地样卷"。 内置默认 ：九年级语文 → 长沙中考标准（不传任何参数即此）。 通用兜底 ：以上都没有时，按科目给通用大题骨架（选择/填空/解答…），并提示按样卷补全。 ⚠️ 不要硬背分值 ：同一"七年级数学期末"在不同区县满分题型都不同。 有样卷一定先解析样卷 ，预设/兜底只是没有样卷时的近似。 大资料量、需增量修改时， 务必走原子化工作流 （每题一个 json 文件，最后合并），详见 references/authoring-workflow.md 。这能防止上下文丢失、让改一题不动全卷。 命题原则与特征 命题五原则（仿得像·有根·依标·适度·有据）与四特征（情境/跨学科/不确定性/素养立意） ——长沙九年级语文的完整表述见 references/exam-templates.md 「命题原则与特征」；其它学段科目对标对应样卷/课标，原则同构（结构仿真题、选材紧扣教材、考点锚课标、创新适度、考查点优先于题型表象）。 底线要求（全学段全科目通用） 原创性（操作定义：原创 = 真实选文 + 全新设问） ——这条和第一铁律的边界必须分清： 选文是抓来的 （必须真实、可溯源、忠实节选，禁编造）； 设问是新写的 （题干、设问角度、干扰项、采分点必须全新原创）。具体禁区： 禁止复用已有真题的题干句式、设问措辞、选项内容（哪怕换了选文）； 禁止"换皮改编"——把真题换个数字、换个人名、换篇选文就当新题； 真题只能用于分析命题规律与难度梯度（见"历年真题参考"），不能作为题目素材。 规范性 ：遵循课标，难度适中，无政治性和知识性错误 去AI感 ：严禁AI高频套话和模板化表述（详见 references/anti-ai-guidelines.md ） 人情味 ：题目措辞自然亲切，贴近学生真实生活，像教了10年书的教师出的 启动第一步：环境自检（每次开始前必做） 不要假设依赖齐全、不要假设有任何特定工具。 开始任何出卷工作前，先完成两层能力探测 ： Agent 工具探测 ：检查当前 AI 客户端是否暴露 Word/Document/Office/Pandoc/Markdown/Spreadsheet/PPT/OCR 相关 MCP、插件或内置工具。 本机能力探测 ：运行 setup.py ，扫描多个 Python 解释器、Python 包、Pandoc、LibreOffice/Office/WPS、OCR、macOS/Windows 系统转换工具。 MCP / 插件是当前 agent 的会话能力，Python 脚本无法可靠枚举；因此先由 agent 看自己当前有哪些工具，再用 setup.py 看本机有什么。 # 体检（只看不装）： python3 "<SKILL_DIR>/scripts/setup.py" # 机器可读体检报告（推荐）： python3 "<SKILL_DIR>/scripts/setup.py" --json # 仅当报告显示没有稳定 DOCX 后端，且用户同意时，安装最小兜底依赖： python3 "<SKILL_DIR>/scripts/setup.py" --install 处理规则： 不要把当前 python3 缺包等同于整台电脑没有能力 ： setup.py 会扫描多个 Python 解释器；agent 也可能有 Word/Pandoc/文档 MCP。 python-docx 是最小稳定兜底，不是唯一方案 ：已有可用 docx Python 后端时，优先用 make_paper.py ；没有时再看 Pandoc、Office/MCP、系统转换工具。 可选依赖 （PDF/PPT/Excel 读取、网页提取增强、图片OCR）缺哪个、只在用到对应素材类型时才需，按需安装。 外部工具 （Pandoc、LibreOffice、Word/WPS、OCR、系统转换工具）有就用、没有不强求。 git（强烈建议，且 build 有硬门禁） ： setup.py 会扫描 git。有 git 时 assemble.py init 自动把工程纳入版本管理， 每完成一题/一部分必须 assemble.py commit 存档 。🔴 build 时若 items/ 有未提交改动 → 直接拒绝出卷（ --allow-uncommitted 逃生） ，强制逐题存档可回滚。无 git 或工程嵌在父仓库内 → 该门禁自动不适用（出卷不受影响，但失去逐题回滚保护，建议提示用户装 git）。 自带脚本若缺失 → 说明 skill 文件不完整，请用户重新获取完整 skill。 命令一律按 bash 语法书写，禁止 cmd 风格的 >NUL / 2>NUL 重定向 ——Windows 上命令实际由 Git Bash 执行， NUL 不是空设备而是普通文件名，会在目录里留下一个名为 NUL 的垃圾文件。脚本输出本就必须如实转告用户，不要静默丢弃；确需丢弃用 /dev/null 。 DOCX 后端选择顺序 顺序 后端 使用条件 定位 1 python-docx + make_paper.py 任一 Python 解释器可 import docx 最稳定、离线、版式可控的主路径 2 Pandoc + build/content.md 有 Pandoc CLI 或 Pandoc MCP Markdown 中间产物转 DOCX，可配 reference.docx 3 Word/Document/Office MCP 或内置文档插件 当前 agent 暴露相关工具 后处理、局部编辑、补图片、转 PDF、复杂文档操作 4 LibreOffice / Microsoft Word / WPS 本机安装且可被 agent 调用 格式转换、渲染校验、PDF 输出 5 macOS textutil / Windows PowerShell 只有系统自带工具可用 低保真 DOCX 兜底 6 安装 python-docx 上述稳定路径都不可用 经用户确认后安装最小兜底依赖 输出仍以 assemble.py build 生成的 build/content.json 为唯一结构源； build/content.md 是给 Pandoc/MCP/Office 后端复用的中间产物。不要让不同后端各自重新组织题目内容。 启动第二步：确定工作模式与工程位置（开工前必做） 环境就绪后， 在出题前先问清两件事并写入工程 ，避免中途反复打断或自作主张： 🔴 STOP·开工前必须问清以下 1/2，模式二还须问清 3；未问清不得进入 Phase 1。 1. 工作模式（🔴必问·二选一，不得默认） 用 AskUserQuestion 问用户遇到问题时怎么处理： 模式一·全程确认 ：遇到任何不确定（选哪篇素材、某题难度、补题方向、抓不到内容如何替代等）都 停下来问用户 ，不自行决定。 模式二·全自动 ：除非触及硬门禁（如素材抓不到、依赖装不上），否则 全程自主完成 ，最后一次性交付，中途不打断。 选模式二时， 必须在开工前把可预见的决策点一次性问清并定好 （见下"决策点预填"），写入工程的 meta.json ，之后严格据此自动执行，不再逐题打扰。 2. 工程位置（🔴必问） 用 AskUserQuestion 问用户： 这份试卷的工程放在哪个文件夹？ 用户给了路径 → 在该路径下新建 <试卷名>_工程 子文件夹。 用户没指定 / 选"默认" → 自动在桌面新建子文件夹 （跨平台：脚本会自动探测真实桌面，兼容 Windows 中文"桌面"、OneDrive 重定向、Linux XDG）。 用纯工程名调用 assemble.py init "<试卷名>_工程" （不带路径）即触发桌面默认；给绝对路径则建在指定位置。 工程是一个独立子文件夹，所有素材、原子题、成卷都在里面，不污染其它位置；断点续作也回到这个文件夹。 3. 决策点预填（🔴模式二·STOP：开工前一次性问清，否则不得自动出题） 模式二的决策点 = Phase 1「参数确认总表」全部 17 项 + 对应科目文档第 5 节的科目特有参数 ，开工前一次性问清并写入 <工程>/meta.json 的 decisions 字段，之后严格据此自动执行，不再逐题打扰。 模式一则无需预填，逐项发生时再问。这些选择连同工作模式一并存入 <工程>/meta.json ，作为本卷的"作业指导书"，断点续作也据此进行。 执行流程 Phase 0：资料收集与读取 按资料类型分流处理， 不遗漏任何一份资料/链接 ： 本地文档 （.docx/.pdf/.pptx/.xlsx/.csv/.txt/.md）： python3 <SKILL_DIR>/scripts/read_material.py "文件1" "文件2" ... 脚本统一输出文本（表格转 | 分隔）。若 docx/pdf 内含图片型阅读材料，脚本会提示，需解压后按下方"图片"三级策略识别。 图片 （截图/拍照/.png/.jpg）—— 三级识别策略，兼容不同模型 ： 你（模型）本身支持多模态识图 → 直接看图识别（凡支持识图的多模态模型，用其原生识图能力即可）。 你是纯文本模型、无法识图 → 调本地 OCR 兜底： python3 <SKILL_DIR>/scripts/ocr_image.py "<图片>" --save "<工程>/materials/截图_XX.md" （脚本自动降级 RapidOCR→PaddleOCR→tesseract；都没装会提示 pip3 install rapidocr-onnxruntime ） 两者都不行 → 请用户手动誊录图中文字成 .md 放进 materials/ 。 无论哪种方式，识别结果都必须存成 markdown 落盘到 工程/materials/ ，按规律命名（见下"素材命名规范"），不要只在对话里识别完就丢。这样图片素材和网页素材一样可回看、可溯源、可被门禁校验。 在线链接 （含历年真题网页、新闻、科普文）： python3 <SKILL_DIR>/scripts/fetch_web.py "<url>" ... 多策略降级抓取，输出 Markdown 正文。小红书/B站短链自动跟随重定向。 已内置 fetch-everything 引擎（多在线服务分流 + Scrapling 浏览器降级 + 质量门）， 不要调用外部抓取技能/工具替代 ——只有 fetch_web.py --save 会写抓取凭证头，外部工具抓的内容过不了溯源门禁。 requests / scrapling 未安装时引擎自动跳过对应路线，退回 jina 直连。 联网选材来源 （文言文/现代文/作文素材的具体站点与检索方法）见 references/material-sources.md 。核心：文言文走古诗文网/ctext 公版古籍（《世说新语》《古文观止》节选）；现代文、作文素材按主题检索《意林》《读者》《作文周刊》《意林·作文素材》美文；非连文本取《科学之友》等科普+数据图表。 抓到的素材一律落盘到工程的 materials/ 目录 （命题时只读当前题相关素材，避免上下文膨胀）；抓不到一律请用户截图或提供 PDF，绝不臆造拼凑选文。 反爬站点 （学科网、组卷网、希沃白板、需登录的小红书等）： 脚本抓取失败会明确提示。此时立即告知用户："该网站有访问限制，请截图相关内容，我来识别提取。" 素材命名规范（所有落盘到 materials/ 的文件统一遵守） ： <板块>_<来源>-<简述>.md 例：非连_中新网-种子库.md 现代文_意林-补碗.md 文言_古诗文网-世说新语德行.md 截图_用户-真题第3页.md 作文素材_作文周刊-成长.md 板块前缀： 非连 / 现代文 / 文言 / 诗词 / 名著 / 作文素材 / 截图 / 真题 手工誊录/截图识别的素材文件，开头 必须写 两行元信息： 来源：<URL或出处> 和 抓取日期：<YYYY-MM-DD> ——门禁回填 source/source_file 依赖它（ fetch_web.py --save 抓取的文件已自动带凭证头，无需手写）。 资料读取后 ，提取整理： 知识点清单（按课标章节归类） 可用素材（文段、诗词、图表、数据、新闻） 对应教材单元与语文要素 可命题方向（哪些素材适合做什么题型） Phase 0 → Phase 1 依赖 ：Phase 0 读完资料后，样卷结构 JSON 和 materials/ 文件才就绪，Phase 1 的"样卷优先"解析和总表第 15 项（阅读素材逐块确认）才能做完整确认。无资料时可直接进 Phase 1，样卷/素材在 Phase 2 出题时再补。 Phase 1：参数确认（一张总表问完，写入 meta.json 后才出题） 先问一句 ：用户有没有"参考样卷/本地真题"？ 有 → 先走下方"样卷优先"路径解析定结构 ，总表中结构类参数（总分/时长/大题分值）直接取自样卷，不再重复问；没有 → 按总表确认。已明确的跳过；用户答"按默认"即用默认列。 用 AskUserQuestion 按总表 分组确认 （三组三问，不要拆成十几轮，也不要不问就动笔）： 组①定位 = 第 1-4 项 + 第 16 项科目特有参数 （确认科目的同一轮就处理听力/配图，不要等到表尾）； 组②规格 = 第 5-10 项 ； 组③工程与素材 = 第 11-15、17 项 。 参数确认总表 ： # 参数 默认值 写入 何时必问 1 学段年级 九年级 --stage 总是 2 科目 语文 --subject 总是 3 考试类型 中考模拟 --type 总是 4 地区 长沙 --region 影响满分/是否开卷/折算时 5 总分·时长·大题结构与分值分布 样卷 > 预设 > 内置默认 --total --duration --questions / --blueprint-file 无样卷且预设未命中时 6 难度系数 小学0.8 / 初中0.7 / 中考0.65-0.70 / 高考0.55-0.65 meta 用户有偏好时 7 考试范围 （单元/课次/书目） 不限（按学段全册） --scope / meta.exam_scope 总是（极易漏，直接决定考点覆盖） 8 教材版本/册次 不限 --textbook / meta.textbook 政史地必问 ，其它科也应问（不问则考点锚定无依据） 9 作答方式 卷面作答（ 不生成答题卡 ，别写"答题卡上作答"） --answer-method 总是 10 作文规格 字数下限按学段缩放（见下注） 作文题 json + essay_grid 含作文的卷 11 卷面工程项（页码/密封线·座位号） 页码开 / 密封线关 --sealing-line --page-number 用默认即可，不必专门问 12 输出格式 仅 docx build --pdf 用默认即可 13 答案解析详略 详细（含采分点） --answer-detail 用默认即可 14 素材来源方向 A·全自动联网抓真实素材（B·用户提供为主，缺口用 A 补） meta.decisions 总是；无论 A/B 选文都必须真实可溯源落盘 materials/ 15 各阅读板块·字数/题材/来源 按对应科目文档第 2 节区间表 meta.decisions（build 据此校验字数） 含阅读选文的卷： 动笔写任何阅读题前逐块确认 16 🔴 科目特有参数 无默认，必问 meta.decisions 英语 listening_plan、理科 figure_plan（确认科目时即问） ；清单见对应科目文档第 5 节 17 抓不到素材时 自动换源重试 meta.decisions 模式二必问 作文规格·字数下限默认 （不要一律写600）：小学中年级 300-400 / 小学高年级 400-500 / 初中 500-600 / 中考·高中 ≥600 / 英语作文按词（见 subjects/英语.md ）。 essay_grid 的 rows×cols 应与字数下限匹配（20列×行数≈格数）。 理科配图限制须在确认科目时即告知用户（锚点见"适用范围⚠️"）。 样卷优先（中小学无统一卷，有样卷必须先走此路径） ：用户给了样卷时——