小学作文批改与升格

一次输入，两样产物：先在学生的原文上批改（红笔落在原稿照片上，或把原文排进方格稿纸），再在同一份原文上改出一篇语句通顺、不少于 400 字的优秀作文。

批改与升格共用一份 result.json，共用同一套单元标准，所以"病"（标出的问题）和"药"（改出的作文）能逐段对得上——这是本技能最重要的设计。

> 本技能由 g6a-unit-essay-grader（批改）与 essay-upgrade-primary（升格）合并而成，两个旧技能已归档。

何时使用

批改类：老师上传/粘贴学生作文，说"帮我批改 / 打个分 / 写评语 / 在我上传的图片上改 / 红笔批改的样子，一人一张 A4 方便打印"。

升格类：老师说"改成一篇通顺的优秀作文 / 升格 / 重写一篇，别改他的意思 / 不少于 400 字 / 每人一份放一个 Word 里"。

两样一起要（最常见）：老师说"我们班第一单元《变形记》收上来了，帮我批改一下，每人再生成一篇优秀作文"。

产出物

两条批改页路线怎么选

核心规则

批改的四条

1. 原文照录，不能顺手改好——paragraphs[].text 是学生原文（含错别字），红笔订正才有对象，它同时也是升格稿的底本。
2. 同一把尺子——四维分（内容 40 / 结构 20 / 语言 30 / 卷面 10）同一批作文同口径，分数差距要能在评语里说清依据。评语规范见 grading-rubric-6a.md。
3. 评语正面管教——先具体肯定（指出哪一句好、好在哪），再给 2～4 条可操作的改进建议，最后鼓励收尾，120～160 字。
4. 段旁建议必须可照着改——指向这一段的具体位置，不写"内容不具体""要详细点"。

升格的三条铁律（冲突时按此优先级）

① 保留原意 → ② 语句通顺 → ③ 不少于 400 字。

最常翻车的地方：为了凑字数擅自加了新人物、新事件或新结尾。唯一判断标准：加进去的每一句，都必须是原文那个场景里本来就该有的东西，只是学生没写出来。

工作流程

Step 0 · 环境准备（首次使用跑一次）

python <技能目录>/scripts/setup_env.py

自动找 Python、建虚拟环境、装 Pillow + python-docx + numpy，打印一行 VENV_PYTHON=<路径>。下文用它打印的路径作为 <venv-python>。

Step 1 · 定位学段与单元

读 references/unit-prompts-6a.md，找到本单元那一节，记住批改关注点和升格时往哪儿使劲。
其他年级：字数下限按学段调（三四年级 300、五六年级 400、初一 500），单元要求按文体套用相近单元。
单元不明时按原文内容判断文体（想象／记事／写人／应用文）。

Step 2 · 转写原文（逐字照录）

• 照片 / PDF / 文字都可以。手写照片要逐字读下来，包括学生写错的字、自己划掉的涂改痕迹。
• 必须照录，这是批改与升格的共同底本。
• 看不清的字放大局部再看；仍不确定的用 □ 占位并明确告诉老师是哪一处，不要猜。
• 分段落记录，段数就是后面升格稿的段数。

Step 3 · 打分

按 grading-rubric-6a.md 的四维量表给分（内容 40 / 结构 20 / 语言 30 / 卷面 10），总分 = 四项之和；写 total、scores 与 comment（老师总评）。

Step 4 · 标定记号（写进 paragraphs）

索引规则最容易错：从 0 开始、闭区间、每个汉字/标点/数字各计 1 位、相对本段。写完用 text[start] 自查。详见 references/data-schema.md。

Step 5 · 选批改页路线

• 老师上传了手写原稿照片 → 走原稿照片路线（默认）。先用 scripts/detect_grid.py 量出稿纸栅格（x0 / cw / rows），写 photo_spec.json。
  落笔前必做：放大 6～10 倍核对学生自己已有的涂改（划掉的字、上方补的正字），不要重复标注，否则页面会花。
• 只有文字 → 走方格稿纸路线，不需要额外准备。

Step 6—8 · 升格三步走（在原文上改）

1. 先改通 —— 逐句过原文，把批改标出的每一处（错别字、病句、标点、语序、啰嗦、笼统词）都换成正确写法。做完这一步原文不应再有任何语病，字数基本不变。
2. 再写实 —— 用 upgrade-standard.md 的10 种手法（环境衬托、动作拆解、神态显影、心理独白、对话补全、感官开闸、比喻拟人、细节聚焦、句式调节、首尾呼应）把笼统处写实。先用动作拆解和感官开闸。
3. 后润色 —— 理顺拗口句、换掉重复词、长短句交替、结尾回扣原文立意；然后做越界自查 5 问。

红线：不加人物、不加事件、不改结局立意、不打乱段落顺序、不套范文腔、不用超龄词（氤氲、岁月静好）、不为凑字数注水。

Step 9 · 字数把关

目标 ≥ 400 字（含标点、不含空白）。不够时按顺序加：1—4 号手法逐段各用一次 → 5—7 号手法写重点段 → 8 号手法放大一个物件。
加完仍不够，如实告诉老师原稿太单薄，并指出建议学生自己补写哪一处——不要硬编。
若扩写让字数涨了 2 倍以上，多半已加情节，回头查红线。

Step 10 · 写数据

按 references/data-schema.md 写 result.json：meta + 每位学生的 paragraphs（原文 + 记号）、rewrite.paragraphs（升格稿）、notes（改动说明）。
照片路线另写 photo_spec.json（见 references/photo-spec.md）。
特别注意：paragraphs 与 rewrite.paragraphs 的元素个数要一致；原卷未署名时 name 写 （姓名待填），并提醒老师补。

Step 11 · 一键出片

# 两样一起出（照片路线批改页 + 优秀作文集）
<venv-python> <技能目录>/scripts/make_all.py result.json <输出目录> \
    --photo-spec photo_spec.json --cover --compare

# 只有文字时（方格稿纸路线）
<venv-python> <技能目录>/scripts/make_all.py result.json <输出目录> --cover --compare

make_all.py 会依次跑批改页与作文集，最后列出全部产物。也可单跑某个脚本：

作文集脚本会逐篇打印字数并核对：不足 400 字给出"还差 X 字"的可执行提示；段落数与原文不一致也会告警。加 --strict 时不达标返回非 0（方便自动化重试）。

Step 12 · 交付

用 present_files 交付，并在回复里说清四件事：
1. 分数与维度（批改）；
2. 每人原文字数 → 升格字数及达标情况；
3. 每篇加了什么（要点式，对应 notes），让老师能照着给学生讲；
4. 需要老师确认的地方（未署名的姓名、看不清的字、原稿太短无法达标的）。

文件清单

常见问题处置