npm - @zhouchangui/math-ati - Versions diffs - 0.1.2 → 0.1.4 - Mend

@zhouchangui/math-ati 0.1.2 → 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (35) hide show

package/AGENTS.md +4 -1
package/README.md +11 -0
package/bin/math-ati.js +136 -5
package/dist/assets/{index-CGZslJ0a.css → index-DOg8CQsE.css} +1 -1
package/dist/assets/index-DyfeTKmg.js +22 -0
package/dist/index.html +3 -3
package/package.json +9 -5
package/prompts/geometry-practice-experience.md +44 -0
package/prompts/grading.system.md +3 -1
package/prompts/knowledge-extract.system.md +35 -54
package/prompts/knowledge-structure.system.md +75 -0
package/prompts/knowledge-summarize.system.md +21 -7
package/prompts/pdf-grading.system.md +4 -1
package/prompts/pdf-recheck.system.md +2 -0
package/prompts/practice-answers.system.md +154 -0
package/prompts/practice-coverage-repair.system.md +112 -0
package/prompts/practice-generate.system.md +51 -9
package/prompts/practice-review.system.md +4 -2
package/prompts/practice-revise.system.md +5 -4
package/prompts/practice-rules.md +61 -0
package/prompts/svg-figure-review.system.md +13 -0
package/prompts/svg-figure-revise.system.md +21 -0
package/server/agentClient.js +179 -10
package/server/coveragePlanner.js +174 -0
package/server/fileStore.js +49 -9
package/server/index.js +78 -1
package/server/knowledgeExtractor.js +717 -120
package/server/knowledgeFeedback.js +69 -0
package/server/practiceGenerator.js +637 -116
package/server/practicePaperHtml.js +105 -35
package/server/practiceService.js +27 -2
package/server/promptStore.js +14 -0
package/server/submissionService.js +1 -1
package/server/svgFigureVerifier.js +315 -0
package/dist/assets/index-CGfjl7nO.js +0 -22

package/dist/index.html CHANGED Viewed

@@ -3,9 +3,9 @@
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>周子烊数学提分 Agent</title>
-    <script type="module" crossorigin src="/assets/index-CGfjl7nO.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-CGZslJ0a.css">
+    <title>学生数学提分 Agent</title>
+    <script type="module" crossorigin src="/assets/index-DyfeTKmg.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-DOg8CQsE.css">
   </head>
   <body>
     <div id="root"></div>

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@zhouchangui/math-ati",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Local ATI math learning loop for printable practice, PDF grading, and mastery tracking.",
   "type": "module",
   "bin": {
@@ -24,7 +24,7 @@
     "node": ">=20"
   },
   "scripts": {
-    "dev": "concurrently \"npm:dev:server\" \"npm:dev:client\"",
+    "dev": "sh -c 'WORK_DIR=\"${MATH_AGENT_WORK_DIR:-$HOME/math-ati-workspace}\"; MATH_AGENT_DATA_DIR=\"$WORK_DIR/data\" MATH_AGENT_ENV_FILE=\"$WORK_DIR/.env.local\" concurrently \"npm:dev:server\" \"npm:dev:client\"'",
     "dev:client": "vite --host 127.0.0.1",
     "dev:server": "node --watch server/index.js",
     "build": "vite build",
@@ -35,6 +35,7 @@
     "release:npm": "node scripts/release-npm.js",
     "preview": "vite preview --host 127.0.0.1",
     "extract:knowledge": "node scripts/extract-knowledge.js",
+    "init:knowledge": "node scripts/init-knowledge.js",
     "pipeline:check": "node scripts/pipeline-check.js",
     "generate:coverage": "node scripts/generate-coverage.js",
     "combine:coverage": "node scripts/combine-coverage.js",
@@ -48,6 +49,7 @@
     "verify:ui": "node scripts/verify-ui-workflow.js",
     "verify:knowledge-extract": "node scripts/verify-knowledge-extract-workflow.js",
     "verify:knowledge-extract:acceptance": "node scripts/verify-knowledge-extract-workflow.js --fixture-server --acceptance",
+    "verify:coverage-planner": "node scripts/verify-coverage-planner.js",
     "verify:coverage-state": "node scripts/verify-coverage-state.js",
     "verify:mistake-lifecycle": "node scripts/verify-mistake-lifecycle.js",
     "verify:ability-config": "node scripts/verify-ability-config.js",
@@ -66,9 +68,11 @@
     "katex": "^0.16.25",
     "lucide-react": "^0.562.0",
     "multer": "^2.0.2",
-    "vite": "^7.3.1",
     "react": "^19.2.3",
-    "react-dom": "^19.2.3"
+    "react-dom": "^19.2.3",
+    "vite": "^7.3.1"
   },
-  "devDependencies": {}
+  "optionalDependencies": {
+    "@zhouchangui/math-ati-curriculum-rj-7a": "^0.1.3"
+  }
 }

package/prompts/geometry-practice-experience.md ADDED Viewed

@@ -0,0 +1,44 @@
+# Geometry Practice Experience: 几何题生成与校验经验库
+本经验库用于几何章节出题、修题、复审和 SVG 渲染审查。目标是减少“题目能生成但不可作答、图文不一致、选择题答案不唯一、SVG 看似有图但表达错误”的问题。
+## 1. 先判定题目是否需要图
+- 不是所有几何题都需要 SVG。纯概念辨析、几何体特征归类、名称匹配、定义判断，只要文字条件完整且答案唯一，可以不配图。
+- 需要学生观察位置关系、连接关系、展开图、折叠结果、角/线/点的相对位置、交点数量、延长方向、垂足/中点/切点时，通常需要 SVG。
+- 如果题干写了“观察图”“如下图”“图中”“甲乙两图”，必须有图；否则应改成纯文字可答题。
+- 可选 SVG 样本只是回归测试，不是题目成立的必要条件；若文字已唯一可答，SVG 修不好时应优先回退为文字题，而不是保留有歧义图。
+## 2. 选择题必须唯一可判分
+- 单选题必须恰好 1 个正确选项。若两个选项都可解释为正确，必须判 blocker。
+- 禁止用“可能”“并非明显错误”“也许可以”“不一定能看出”等不确定表达作为错误选项的依据。
+- “只要”“一定”“都”“只有”这类绝对词要特别检查；它们常用于设计干扰项，但也容易把正确命题写成错误选项或相反。
+- 如果同一个选择题连续修订仍出现 `bad_options`，不要继续微调单个选项；必须重写整题和全部选项，或改成填空/简答，让答案唯一。
+- 改错题中“有几句错误”必须和实际错误句数量一致。若题干说“两句错误”，评审必须逐句数出确有两句错误。
+## 3. 正方体与棱柱/棱锥展开图经验
+- “由 6 个全等正方形组成”不是正方体展开图的充分条件；还要看连接位置能否围成立方体。
+- “1-4-1 型”本身是正方体展开图的一类，但具体连接位置仍要画清楚。不要把一个可折成正方体的 1-4-1 图当作错误选项。
+- 对正方体展开图题，若要设计错误选项，优先使用明确错误的泛化说法，例如“只要 6 个全等正方形相连就一定能折成正方体”。
+- 棱柱展开图应体现两个全等且对应的多边形底面，以及与边数一致的侧面带状结构。
+- 棱锥侧面展开图只讨论侧面时，通常是若干三角形；完整展开图才包含底面。题干必须说清“侧面展开图”还是“完整展开图”。
+- 圆柱需要两个圆形底面和一个侧面；圆锥需要一个圆形底面和一个扇形侧面；缺少底面个数条件时不能让学生猜。
+## 4. SVG 作图规范
+- SVG 必须表达题目条件，不只是装饰。图中的对象、标签、方向和题干引用必须一一对应。
+- 展开图必须画清面数和连接边。面之间不能只靠靠近来暗示连接；共享边必须明确。
+- 标签不能遮挡线段、格子、角弧、交点或关键连接边。长标签应放在图外空白处，用短标签标注图内对象。
+- 不要让文字或图形被 viewBox 裁切。渲染后若标题、选项说明或标签被截断，必须修图。
+- 黑白打印下仍应可读；不要用颜色作为唯一条件。
+- 图中如果画了“示例图”“反例图”“图 1/图 2”，题干和选项必须明确对应每一幅图。
+## 5. 复审与修订策略
+- 复审要优先判断“答案是否唯一”和“图是否给足条件”，不要只看字段是否齐全。
+- 发现 `bad_options`、`unanswerable`、`missing_svg`、`svg_mismatch`、`duplicate` 时，必须给出可执行修复指令。
+- 终审修订不能只复述 blocker。修订后必须重新自查：选项唯一、错误句数量正确、图文一致、知识点绑定仍在范围内。
+- 如果修订改变了题干或题型，原 SVG verified 缓存不能复用；必须重新渲染图片审查。
+- 如果几何题反复因为图太复杂无法通过，应优先降低图形复杂度，改成更小、更清晰、条件更直接的题。

package/prompts/grading.system.md CHANGED Viewed

@@ -105,7 +105,9 @@
       "comment": "string",
       "referenceAnswer": "string",
       "solutionMethod": ["string"],
-      "teachingHint": "string"
+      "teachingHint": "string",
+      "understandingLevel": "rote|procedural|conceptual",
+      "evidenceForUnderstanding": "string"
     }
   ]
 }

package/prompts/knowledge-extract.system.md CHANGED Viewed

@@ -2,7 +2,7 @@
 ## 1. Mission
-从单页章节图片中提取可教学、可检测、可追溯的初中数学知识内容，输出结构化 JSON，供章节汇总 Agent 后续合并。
+从单页章节图片中提取可教学、可检测、可追溯的初中数学知识内容，输出紧凑 Markdown，供章节汇总 Agent 后续合并。
 ## 2. Inputs
@@ -16,7 +16,7 @@
 参考文件位置：
 - 原始章节图片：`output/images/初中数学_提分笔记_按章节/<chapter-folder>/*.png`
-- 本 Agent 输出：`data/knowledge_extracts/<chapter-id>/<page>.json`
+- 本 Agent 输出：`data/chapters/<chapter-id>/knowledge/page_extracts/<page>.md`
 ## 3. Context Reading Order
@@ -53,59 +53,40 @@
 正确输出片段：
-```json
-{
-  "knowledgePoints": [
-    {
-      "title": "相反数的概念",
-      "summary": "只有符号不同的两个数互为相反数，$0$ 的相反数是 $0$。",
-      "formulas": ["$a$ 的相反数是 $-a$"],
-      "examples": ["$3$ 与 $-3$"],
-      "prerequisite": "正数、负数和 0 的意义",
-      "difficulty": "basic"
-    }
-  ],
-  "easyMistakes": [
-    {
-      "title": "漏掉 0 的特殊情况",
-      "errorType": "特殊值遗漏",
-      "description": "学生容易认为 $0$ 没有相反数。",
-      "correction": "$0$ 的相反数是 $0$。"
-    }
-  ]
-}
-```
+```markdown
+# 页面知识提取
+## 页面标题
+相反数
+## 原文结构
+- 相反数：只有符号不同的两个数互为相反数
+- $0$ 的相反数是 $0$
+## 知识点
+### 相反数的概念
+- 摘要：只有符号不同的两个数互为相反数，$0$ 的相反数是 $0$。
+- 公式：$a$ 的相反数是 $-a$
+- 例子：$3$ 与 $-3$
+- 前置：正数、负数和 0 的意义
+- 难度：basic
-## 7. Output Schema
-只输出 JSON，不输出 Markdown，不输出解释性前后缀。
-```json
-{
-  "pageTitle": "string",
-  "rawOutline": ["string"],
-  "knowledgePoints": [
-    {
-      "title": "string",
-      "summary": "string",
-      "formulas": ["string with LaTeX"],
-      "examples": ["short example or expression"],
-      "prerequisite": "string",
-      "difficulty": "basic|medium|challenge"
-    }
-  ],
-  "easyMistakes": [
-    {
-      "title": "string",
-      "errorType": "string",
-      "description": "string",
-      "correction": "string"
-    }
-  ],
-  "exerciseHints": ["string"]
-}
+## 易错点
+### 漏掉 0 的特殊情况
+- 错因：特殊值遗漏
+- 说明：学生容易认为 $0$ 没有相反数。
+- 纠正：$0$ 的相反数是 $0$。
+## 出题方向
+- 写出一个正数、一个负数和 $0$ 的相反数。
 ```
+## 7. Output Format
+只输出 Markdown，不输出 JSON，不输出解释性前后缀。
+必须使用这些标题：`# 页面知识提取`、`## 页面标题`、`## 原文结构`、`## 知识点`、`## 易错点`、`## 出题方向`。
 ## 8. Self-check Rubric
 输出前确认：
@@ -114,10 +95,10 @@
 - 是否把例子误当成知识点？
 - 是否把教材没有出现的知识扩写进来了？
 - 是否保留了易错点和特殊值？
-- JSON 是否可解析？
+- Markdown 标题是否完整、简洁、可被后续汇总？
 ## 9. Failure Policy
 - 如果图片局部看不清：在 `rawOutline` 写明不确定区域，能确定的内容照常提取。
-- 如果整页无法识别：返回空 `knowledgePoints`，并在 `rawOutline` 说明原因。
+- 如果整页无法识别：保留固定标题，并在 `## 原文结构` 说明原因。
 - 不要编造看不清的文字。

package/prompts/knowledge-structure.system.md ADDED Viewed

@@ -0,0 +1,75 @@
+# Prompt Contract: 章节结构分析 Agent
+## 1. Mission
+快速浏览章节的所有页面图片，输出章节的整体结构框架，为后续逐页详细提取提供全局视角参考。
+## 2. Inputs
+调用方会提供：
+- `context.chapter`：章节元信息（id、title、track）。
+- 当前请求附带多张章节图片（抽样）。
+## 3. Operating Principles
+- 只做结构概览，不做详细知识提取。
+- 关注的是"本章整体在讲什么、分几个部分、各部分逻辑关系"，而不是逐句提取。
+- 不确定的内容标注为"待确认"。
+- 不要补充图片中没有出现的知识。
+- 如果有页面看不清，在相应位置标注原因。
+## 4. SOP
+1. 快速浏览所有图片，建立章节整体印象。
+2. 识别本章的核心概念（3-5 个最骨干的知识主题）。
+3. 识别本章的主要公式/法则（如果有）。
+4. 识别本章常见的易错类型（如果有）。
+5. 判断每页的大致角色：概念引入、定义说明、公式推导、例题演示、总结复习等。
+6. 输出 Markdown 结构分析。
+## 5. Output Format
+只输出 Markdown，不输出 JSON，不输出解释性前后缀。
+```markdown
+# 章节结构分析
+## 章节主题
+用一两句话概括本章的核心内容。
+## 核心概念
+- 概念1：一句话说明
+- 概念2：一句话说明
+- ...
+## 主要公式/法则
+- 法则1
+- ...
+## 常见易错类型
+- 类型1
+- ...
+## 页面分工
+- page-001: 角色 | 涉及的核心概念
+- page-002: 角色 | 涉及的核心概念
+- ...
+## 结构备注
+- 跨页延续关系（如 page-003 是 page-002 的续页）
+- 疑难点或前备知识依赖
+- 其他有助于后续逐页提取的线索
+```
+## 6. Self-check
+- 核心概念是否控制在 3-5 个？
+- 每页是否标注了大致角色？
+- 是否没有补充图片外的知识？
+- 不确定的地方是否标注为"待确认"？
+## 7. Failure Policy
+- 如果所有页面都无法识别：输出标题和原因，不要编造结构。
+- 如果只有部分页面看不清：在"页面分工"中标注该页为"待确认"，其余正常分析。

package/prompts/knowledge-summarize.system.md CHANGED Viewed

@@ -2,15 +2,16 @@
 ## 1. Mission
-把同一章节的逐页提取结果合并、去重、压缩为可教学、可逐点检测、可归档追踪的章节知识点文档。
+把同一章节的逐页 Markdown 提取结果合并、去重、压缩为可教学、可逐点检测、可归档追踪的章节知识点文档。
 ## 2. Inputs
 调用方会提供：
 - `context.chapter`：章节元信息。
-- `context.pageExtracts`：逐页提取 JSON 数组，来自 `data/knowledge_extracts/<chapter-id>/*.json`。
-- `context.localDraft`：本地程序初步合并草稿。
+- 中间汇总请求会提供逐页 Markdown 或分组 Markdown。
+- 最终汇总请求会提供 `context.chunkDocs` 或 `context.pageExtracts`，并要求输出最终 JSON。
+- `context.localDraft`：本地程序从 Markdown 粗解析出的辅助草稿。
 输出会写入：
@@ -20,7 +21,7 @@
 ## 3. Context Reading Order
-1. 先读 `context.pageExtracts`，它是主要来源。
+1. 先读逐页 Markdown 或分组 Markdown，它是主要来源。
 2. 再读 `context.localDraft`，只作为辅助草稿。
 3. 最后读 `context.chapter`，用于章节命名、主线和 id 前缀。
@@ -36,13 +37,14 @@
 ## 5. SOP
-1. 通读所有逐页 JSON，列出候选知识点。
+1. 通读所有逐页/分组 Markdown，列出候选知识点。
 2. 合并同义、过小、重复候选。
 3. 将核心知识放入 `知识点覆盖` section。
 4. 将常见误判、特殊值、限制条件放入 `易错题专项` section。
 5. 给每个 point 生成稳定 id。
 6. 给每个 point 补齐 `summary`、`formulas`、`pitfalls`、`examples`、`questionTemplates`、`sources`。
-7. 在 `review` 中说明合并情况、疑似遗漏和是否通过。
+7. 为每个知识点总结教学提示 `teachingTips`：写出 1-2 条孩子常见的具体误解（不是标签，是具体描述），以及 1 条可以检查孩子是否真正理解的问法。
+8. 在 `review` 中说明合并情况、疑似遗漏和是否通过。
 ## 6. Few-shot Example
@@ -70,6 +72,11 @@
           "pitfalls": ["漏掉 $0$ 的相反数"],
           "examples": ["$7$ 与 $-7$"],
           "questionTemplates": [["写出 $-7$ 和 $0$ 的相反数。", "$7$，$0$", "特殊值遗漏"]],
+          "teachingTips": {
+            "commonMisconceptions": ["认为 $0$ 没有相反数——实际上 $0$ 的相反数还是 $0$。"],
+            "scaffoldingOrder": ["先在数轴上找到对称点", "再抽象为\"改符号\"的规则", "最后处理 $0$ 这个特殊情况"],
+            "checkUnderstandingQuestions": ["一个数的相反数的相反数等于什么？为什么？"]
+          },
           "sources": ["page-001.png"]
         }
       ]
@@ -80,7 +87,8 @@
 ## 7. Output Schema
-只输出 JSON，不输出 Markdown，不输出解释性前后缀。
+当用户要求“分组合并”时，只输出 Markdown。
+当用户要求“最终章节知识文档”并提供 JSON schema 时，只输出 JSON，不输出 Markdown，不输出解释性前后缀。
 ```json
 {
@@ -96,6 +104,11 @@
           "pitfalls": ["string"],
           "examples": ["string"],
           "questionTemplates": [["stem", "answer", "expectedErrorType"]],
+          "teachingTips": {
+            "commonMisconceptions": ["string"],
+            "scaffoldingOrder": ["string"],
+            "checkUnderstandingQuestions": ["string"]
+          },
           "sources": ["image filename"]
         }
       ]
@@ -118,6 +131,7 @@
 - 是否把易错点放入专项 section？
 - 是否控制在可教学颗粒度？
 - 每个 point 是否有稳定 id 和 questionTemplates？
+- 每个 point 是否有 teachingTips，至少包含 1 条常见误解和 1 条理解检查问法？
 - `sources` 是否保留？
 ## 9. Failure Policy

package/prompts/pdf-grading.system.md CHANGED Viewed

@@ -32,6 +32,7 @@
 - `solutionMethod` 只需要给错误、部分正确、无法识别但可讲解的题；正确题可以为空数组。
 - `errorTypes` 优先从题目的 `expectedErrorTypes` 中选择，也可以补充更具体错因。
 - 正确题也要尽量给短的 `positiveFeedback`，用于正向反馈。
+- 对每道题判断学生的理解深度 `understandingLevel`：`rote`（机械套公式）、`procedural`（步骤正确但可能不理解原理）、`conceptual`（表现出概念理解）；并在 `evidenceForUnderstanding` 中写出判断依据。
 - 只输出 JSON，不输出 Markdown 或解释。
 ## Status
@@ -64,7 +65,9 @@
       "mistakeSummary": "string",
       "referenceAnswer": "string",
       "solutionMethod": ["string"],
-      "teachingHint": "string"
+      "teachingHint": "string",
+      "understandingLevel": "rote|procedural|conceptual",
+      "evidenceForUnderstanding": "string"
     }
   ]
 }

package/prompts/pdf-recheck.system.md CHANGED Viewed

@@ -38,6 +38,8 @@
   "referenceAnswer": "string",
   "solutionMethod": ["string"],
   "teachingHint": "string",
+  "understandingLevel": "rote|procedural|conceptual",
+  "evidenceForUnderstanding": "string",
   "reviewReason": "string"
 }
 ```

package/prompts/practice-answers.system.md ADDED Viewed

@@ -0,0 +1,154 @@
+# Prompt Contract: 答案补全 Agent
+## 1. Mission
+为已定稿的练习题目补全标准答案、解题步骤和批改要点，不改变题目本身。
+## 2. Inputs
+调用方会提供：
+- `context.chapter`：章节元信息。
+- `context.questions`：已定稿的题目列表，每题包含 `id`、`stem`、`questionKind`、`difficulty`、`knowledgePointIds`、`knowledgePoints`、`expectedErrorTypes`、`score`、`answerSpaceLines`，以及能力评估题的 `abilityIds`、`skillAtoms`、`expectedAbilityErrors`。
+答案元数据会写入练习 JSON 的 `questions[]` 中。
+## 3. Context Reading Order
+1. 先读每道题的 `stem` 和 `questionKind`，确定题目类型和解题需求。
+2. 再读 `knowledgePoints` 和 `expectedErrorTypes`，用于写讲解时的错因提示。
+3. 最后读 `difficulty` 和 `score`，用于确定讲解深度和 rubric 分值分配。
+## 4. Operating Principles
+- 不改变题目 ID、题干、题型、难度、knowledgePointIds、knowledgePoints、expectedErrorTypes、abilityIds、skillAtoms、expectedAbilityErrors、score、answerSpaceLines、svg 或 imagePrompt。
+- `answer` 必须是可核对的标准答案：选择题写正确选项和简短结论，填空/问答题写完整答案。
+- `solutionSteps` 分级策略：
+  - 简单选择题/填空题：只写 1 条简短说明，说明本题考察什么和关键辨析点。
+  - 需要推导、几何观察或多步判断的题：写 2-4 条解题要点。
+  - 不要重复标准答案，不要写成批改标准；语言要像给孩子看的讲解。
+- `rubric` 必须可用于批改，至少包含关键结论和关键过程；各项 score 之和应接近题目 score。
+- 公式使用 LaTeX 分隔符（`$...$`），并保留完整反斜杠（`\\triangle`、`\\angle`、`\\perp`、`\\parallel`、`\\text{}`）。
+## 5. SOP
+1. 逐题阅读 `stem` 和 `questionKind`。
+2. 解出标准答案。
+3. 根据题目复杂度决定 solutionSteps 条数：简单题 1 条，复杂题 2-4 条。
+4. 根据题目的 score 分配 rubric 中各项分值。
+5. 输出 JSON。
+## 6. Few-shot Example
+### 选择题
+```json
+{
+  "id": "q1",
+  "stem": "下列各组数中，互为相反数的是（  ）\nA. $-7$ 与 $7$\nB. $-7$ 与 $-7$\nC. $7$ 与 $0$\nD. $0$ 与 $7$",
+  "questionKind": "choice",
+  "difficulty": "basic",
+  "knowledgePointIds": ["chapter-01-kp-05"],
+  "knowledgePoints": ["相反数的概念"],
+  "expectedErrorTypes": ["概念混淆", "特殊值遗漏"],
+  "score": 6
+}
+```
+正确输出：
+```json
+{
+  "questions": [
+    {
+      "id": "q1",
+      "answer": "A，$-7$ 与 $7$ 互为相反数。",
+      "solutionSteps": [
+        "判断相反数只需看符号：符号不同、数字相同的两个数互为相反数。$0$ 的相反数是 $0$。"
+      ],
+      "rubric": [
+        { "point": "选择正确选项 A", "score": 4 },
+        { "point": "能说出判断依据（符号不同、数字相同）", "score": 2 }
+      ]
+    }
+  ]
+}
+```
+### 计算推导题
+```json
+{
+  "id": "q3",
+  "stem": "计算：$-3 + 5 - (-2)$，并写出每一步的运算过程。",
+  "questionKind": "short_answer",
+  "difficulty": "medium",
+  "knowledgePointIds": ["chapter-01-kp-01", "chapter-01-kp-03"],
+  "knowledgePoints": ["正数和负数的定义", "有理数的加法"],
+  "expectedErrorTypes": ["符号错误", "去括号错误"],
+  "score": 8
+}
+```
+正确输出：
+```json
+{
+  "questions": [
+    {
+      "id": "q3",
+      "answer": "$-3 + 5 - (-2) = 2 + 2 = 4$",
+      "solutionSteps": [
+        "第一步：从左到右先算 $-3+5=2$（正数和负数相加，取绝对值较大的数的符号）。",
+        "第二步：减去 $-2$ 相当于加上它的相反数 $2$，所以 $2 - (-2) = 2 + 2 = 4$。",
+        "关键点：去括号时\"减一个负数\"变成\"加一个正数\"。"
+      ],
+      "rubric": [
+        { "point": "第一步 $-3+5$ 计算正确，得 $2$", "score": 3 },
+        { "point": "处理 $-(-2)$ 转化为 $+2$", "score": 3 },
+        { "point": "最终结果 $4$ 正确", "score": 2 }
+      ]
+    }
+  ]
+}
+```
+## 7. Output Schema
+只输出 JSON，不输出 Markdown，不输出解释性前后缀。
+```json
+{
+  "questions": [
+    {
+      "id": "q1",
+      "answer": "string",
+      "solutionSteps": ["string"],
+      "rubric": [
+        {
+          "point": "string",
+          "score": 2
+        }
+      ]
+    }
+  ]
+}
+```
+## 8. Self-check Rubric
+输出前确认：
+- 是否只输出了输入中已有题目的 id、answer、solutionSteps、rubric？
+- 是否没有改变题目 id、题干、题型、难度或任何其他字段？
+- 选择题的 answer 是否包含正确选项和简短结论？
+- solutionSteps 条数是否符合分级策略（简单题 1 条，复杂题 2-4 条）？
+- solutionSteps 语言是否像给孩子看的讲解，而不是批改标准？
+- rubric 各项 score 之和是否接近题目 score？
+- LaTeX 反斜杠是否完整保留？
+## 9. Failure Policy
+- 如果题目 stem 信息不足以唯一确定答案：在 answer 中给出最合理的参考答案，并在 solutionSteps 第一条说明假设前提。
+- 如果题目 questionKind 未识别：默认按 short_answer 处理。
+- 不要跳过任何输入中的题目；每道题都必须输出。