雨课堂 AI 批改指令生成器

用途

把教师口述或粘贴的评分标准，转换成一段可直接粘进雨课堂「批改测试 → 指令内容」的纯文本提示词。产出必须同时满足两个条件：

人能读：无 Markdown 语法残留。雨课堂输入框不解析 **、#、>、|，会原样显示，看起来就是"乱码"。
机器能解析：结尾的输出契约严格固定为 ```json 围栏包裹的 {"score": …, "comment": "…"}，两个键、无多余字段。

雨课堂只认 score 与 comment 两个键。字段名一改，分数或评语就会丢。

触发场景

「帮我把这个评分标准填进雨课堂」「雨课堂批改规则怎么写」
「AI 批改只出分数没有评语」「提示返回内容格式有误」
「雨课堂里评分标准粘贴进去是乱码」
用户给出题目与分值维度，要求生成批改提示词

执行流程

第一步：收集必填信息

先要齐以下五项，缺失项按默认值补齐，并在交付时说明假设：

| 项 | 说明 | 缺失时 | | --- | --- | --- | | 科目与题型 | 如英语记叙文、语文议论文、高数计算题 | 必须问，不能猜 | | 题目原文与要求 | 含字数、格式、是否需标题 | 必须问 | | 维度与分值 | 各维度名称与满分，合计 100 | 按题型给一套通用五维 | | 各维判据与档位 | 命中什么得分、什么情况记 0 | 按维度名生成可核查的判据 | | 平台满分 | 雨课堂「分值」框里的数字 | 100；非 100 时加折算条款 |

一次性问完，不要逐条追问。若用户只想沿用英语记叙文那套标准，直接复用 references/example-narrative-rubric.md。

第二步：按模板填充

以 assets/prompt-template.txt 为骨架，替换 〈〉 占位符。模板中【输出格式】整段一字不改，包括代码块标记。

填充原则：

判据必须可核查：写"命中什么算得分"，不写"表达流畅"这类无法验证的描述。
每维度给出档位区间，并要求模型"先定档再取分"，减少同卷多次打分的漂移。
涉及字数的，写"逐个单词计数，不得估算"。
涉及多类错误的，写明"同一错误只扣一次"。

第三步：清洗

保存为 UTF-8 文本后执行：

python scripts/clean_prompt.py <输入文件>

生成 <输入文件>-清洗版.txt。必须看到输出末行为「残留风险: 无」才能交付；出现残留项就继续修文本。

清洗脚本对 ``` 围栏内的内容原样跳过，不会破坏输出契约示例。

第四步：交付

给出清洗版文件路径，附三步使用说明：

整段粘贴进「指令内容」框，覆盖原内容。
「输出要求」框先不要动。平台默认模板被改坏会导致解析失败。
点「批改测试」，确认右侧同时出现智能评分与智能评语。

输出契约（不可修改）

{"score": 55, "comment": "D1 内容 15/25；D2 结构 12/20；D3 情节 14/25；D4 语言 16/25；D5 规范 3.5/5。……"}

硬性约束：

必须有 ```json 围栏。没有围栏，平台报「返回内容格式有误」。
恰好两个键 score、comment。缺 comment 会导致评语为空。
禁止输出 total_score、score_breakdown、annotations、overall_comment 等结构化学段字段。
comment 开头固定写分项串，让五项之和不被肉眼核对时也能自证。
comment 内引用原文只能用中文引号，出现英文半角双引号会直接破坏 JSON。

故障对照

| 现象 | 原因 | 处置 | | --- | --- | --- | | 有分数、评语空白 | 输出里没有 comment 键，常见于模型给了 overall_comment | 在指令里加禁止字段清单 | | 提示「返回内容格式有误」 | 缺 ```json 围栏，或围栏被清洗脚本改坏 | 恢复围栏；确认清洗版示例行仍是英文引号 | | 粘贴后满屏 ** # > 竖线 | Markdown 语法未清洗，不是编码问题 | 跑 scripts/clean_prompt.py | | 分数与人工判分差 5 分以上 | 无锚点卷，模型每次重新理解档位 | 追加 3 篇已人工定分的锚点卷 | | 某维度得分超过该维满分 | 模型未做加总校验 | 加自检三条：可解析、和等于 score、每项不超满分 |

更多排查细节见 references/known-issues.md。

注意事项

不要向用户承诺"100% 不乱码"。字符集可控，平台侧存储与渲染不可控。
不要把 Markdown 版评分标准直接投喂，先转纯文本。
「生成批注」开关需要另一套字段，与 score、comment 不能混在一个对象里；未经实测不要替用户开启。