Polish-Sci
【Python 解释器探测·开工前置,一次探测全程沿用】 本文命令中的 python3 / python 仅为 macOS/Linux 的习惯写法,并非硬性要求。执行前先运行一次 python3 --version:
- 输出正常版本号 → 本次会话所有命令统一使用
python3。 - 报 command not found、无任何输出、或弹出应用商店 → 改为运行
python --version,若能输出版本号则将后续所有命令的解释器统一替换为python。注意 Windows 自带一个 0 字节的python3占位程序,python3 --version弹商店或无输出即为命中该占位程序,不视为已安装 python3,按"不可用"处理(用户亦可在 设置 → 应用 → 应用执行别名 中关闭python3.exe)。 - 反之
python无法输出版本号则换用python3(macOS 12.3 起系统不再内置python)。 - 两者均无法输出版本号 = 该机器未安装 Python,须停止并提示用户先行安装,不得强行执行。
- 探测仅执行一次,此后所有命令沿用同一解释器名称,无需每条命令重复探测。
🔁 每次进入/续写须先接续:开工或换会话续写前,须先执行
env_preflight输出的 RESUME_CMD(python <polish-sci>/scripts/session_journal.py resume --root <project_root>),将接续报告呈现给用户并完成一次接续确认(确认当前进度、已读取的历史要求、下一步操作),等待用户确认后方可继续。用户中途提出任何临时要求,须立即通过 LOG_CMD(session_journal.py log --root <project_root> --note "<原话>")追加至decisions_log.md,后续会话必须读取并遵守。
Overview
本技能仅执行一项任务:对已完稿论文进行纯语言润色。输入为完整稿件(md 或 docx),无需审稿意见。输出为逐段润色后的稿件及一份逐段改动报告。默认采用交互式逐段润色模式(每段先呈现原文、润色结果与逐处改动,经用户确认或要求调整后方写回,详见"交互式逐段润色协议"专节),便于用户边审核边对照修改原稿。
核心约束,只提升语言表达,绝不改内容、数据、结论。润色覆盖全文每一段,不是只改被点名的片段。
not_for(以下情况不要用本技能):
- 从零写新稿,用 general-sci-writing。
- 审稿意见驱动改稿(收到 reviewer comments / 退稿信),用 revise-sci。
- 写综述,用 review-writing。
工作流采用脚本闸门式架构。脚本仅负责拆分、生成润色任务包与校验红线,实际的语言改写由主 agent 依据本文 prompt 逐段执行。禁止跳步,禁止令脚本承担改写职能。
📁 references/ 参考文件地图(按需 Read,不要靠记忆复述其内容)
| 必须 Read 的时机 | 文件 |
|---|---|
| 每段改写前 | references/anti-ai-protocol.md |
| 每段改写前 | references/anti_ai_prose_rules.md(句法与节奏规则,执行其中全部条目) |
| 第 3 步逐段润色前 | references/interaction-protocol.md |
| 第 5 步委托盲检前 | references/dod-protocol.md |
| 第 7 步 merge/导出前 | references/output-contract.md |
| 用户问"AI 改坏了怎么办"时 | references/user-selfhelp.md |
🔴 Intake Gate(开工前必须确认)
🛑 STOP:拿到稿子后,先与用户确认四件事,再动工:
- 输入稿路径,md 还是 docx。docx 需要本机已装 python-docx。
- 语言,中文还是英文。决定句长上限(英文≤30词 / 中文≤50字)与去AI规则分支。
- 目标期刊 + 美式/英式拼写(US / UK English)。目标期刊决定语域与用词习惯(可留白,建议给出);英文稿必须定 US 还是 UK,它决定拼写(color/colour、analyze/analyse)、标点(引号与句号位置)、以及被动语态偏好,全稿一把尺子,不得混用。中文稿此项记"N/A"。
- 润色强度,light / standard / deep。
- light,只去AI套话、修语法、拆超长句,保留原措辞骨架。
- standard,默认,在 light 基础上做母语化、术语统一、被动语态向目标区间靠拢。
- deep,在 standard 基础上做段内句序与衔接优化,但仍不改任何论点与数据。
- 是否要 docx 导出,默认只出 md。
确认这四项 + 目标 project_root 后,先跑环境预检(软门禁):python scripts/env_preflight.py <project_root> --py docx,写 env_status.json,末行 PRECHECK: OK|ASK|BLOCKED。BLOCKED(Python 过低)→停并引导升级;ASK(缺 git/python-docx 等可选工具)→逐项问用户是否安装并给指引,用户答"已装/不装"后才继续;OK→继续。再进 Pipeline。
📋 开场监工卡(每次启动须原样输出给用户)
确认上述四项并完成预检后,每次开工均须将以下监工卡呈现给用户,供用户了解需监控的要点:
本次润色须用户监控的事项:
- AI 仅修改语言表达,绝不改动数据、结论、引用标记、专名与单位。若发现数值、结论或引用被修改,须立即叫停,此属越界行为。
- 默认逐段暂停:每段呈现「原文 → 润色后 → 改动说明」,请逐段核对语义未被改变后方放行。
- 用户可选择"连续润色不暂停",但此模式将放弃逐段核对,润色偏差只能在最终合并稿中才能发现,请谨慎选择。
- 红线由脚本进行集合比对(引用/数值/专名),但脚本仅能拦截"可从文本判定"的越界;语义是否被隐性修改,最终须由用户逐段审核。
Red Lines(一字不改)
以下内容润色时绝对不动,脚本会做集合比对拦截:
- 引用标记
[n]、DOI 字符串。 - 数值、统计量、p 值、置信区间、
n=N、百分比、单位。 - 基因、蛋白、试剂、细胞系、物种名。
- 任何改动会改变科学论断的 token。
每段 meaning_changed 必须为 false,但改写方自填的 false 不作数(标 false 即蒙混)。语义等价的唯一权威是独立 PL-G11 盲检subagent的裁决:strict_gate 交付前会读 <root>/.review_return_polish-dod.json,要求 PL-G11 verdict==pass 且证据非空;缺独立裁决即视为"未核",fail-closed 拦下(见下方 ⑥/PL-G11)。脚本的数值/引用集合比对只补语义盲区的一部分,不替代盲检。
字符级排版契约(等同红线)
行内格式标记与上方红线同级,润色时逐字保留其位置与配对,不得增删、不得错配:
- 斜体
*…*,标注物种(*E. coli*)、基因(*TP53*)、统计符号(*p*值、*t*、*F*、*r*、*n*作变量时)。原文已斜体的,润色后仍斜体且范围不变。 - 上标
<sup>…</sup>,如10<sup>6</sup>、cm<sup>2</sup>、O<sub>2</sub>的对应上标场景。 - 下标
<sub>…</sub>,如H<sub>2</sub>O、CO<sub>2</sub>、Ca<sup>2+</sup>的对应下标。 - 加粗
**…**,保留原稿强调位置,不新增、不删除。
硬约束:
- 标记成对出现,改写后开闭标签数量与配对必须守恒(每个
<sup>对一个</sup>,每个*成对)。 - 禁止裸写需要排版的字符,如
H2O必须写H<sub>2</sub>O、10^6必须写10<sup>6</sup>、基因斜体不可退化为正体。 - 标记内的字符属红线,不可改动其中的数值/专名;只可改标记外的散文。
Anti-AI 规则(检测见 common.py,分级见 strict_gate.py)
去AI检测由 find_ai_style_markers(scripts/common.py)统一执行,润色后残留即记 flag。但阻断与否分两级(分级在 strict_gate.is_soft_ai_marker),学术散文里长句、-ing 分词、修辞铺陈本是正当修辞手段,一刀切硬禁会把作者文风削平,故这些降为软提示;但 AI 套话主干与破折号硬拦。
硬拦项(strict_gate 阻断交付,exit 1):
- AI 套话禁词表(delve into、pivotal role、underscore、testament、It is worth noting that、值得注意的是、综上所述、至关重要 等,中英双语,见 common.py 的
AI_STYLE_BANNED_PATTERNS与AI_CLICHE_TERMS_EN/ZH)。这些是 AI 腔的硬指纹,润色后一律清零。 - 去AI必禁三项(修辞性破折号(
—/——/ em-dash)、scare quotes(普通短语裹双引号)、解释性冒号(概念冒号后接句子片段)),三者禁止使用,硬拦阻断交付。strict_gate 对这三项 fail-close,命中即 exit 1,不放行、不交作者取舍。
📖 软提示分级与非散文豁免 → 每段改写前先 Read references/anti-ai-protocol.md。
本 SKILL.md 文本自身也遵守上述去AI规则。
❌ 禁止动作清单(润色时绝不做)
对现有规则的集中索引,逐条对应正文已有约束,违反任一即 strict_gate 或盲检拦截:
- ❌ 改动数值/统计量/p值/n=N/百分比/单位/引用标记[n]/DOI/专名(基因蛋白细胞系物种),见 Red Lines
- ❌ 升级不确定性动词(may/suggest/可能 改成 prove/demonstrate/证实),见 Polish Prompt #5
- ❌ 凭空增加原文没有的程度词(significantly/extensively/显著 等),等同升级语气,meaning_changed 必为 false
- ❌ 为求变化做同义替换、破坏全文术语一致,见 Polish Prompt #4
- ❌ 裸写需排版字符(H2O 不写成 H2O、10^6 不写成 106、基因斜体退化为正体),见 字符级排版契约
- ❌ 润色后残留 AI 套话禁词(delve into / 值得注意的是 等)或去AI必禁三项(装饰性破折号 —/—— 、scare quotes、解释性冒号),均 Anti-AI 硬拦、命中即 exit 1;长句/-ing 拖尾为软提示(记报告不阻断),别硬删削平文风
- ❌ 只改被点名片段而非全文逐段覆盖,本技能是纯润色,覆盖每一段
- ❌ 未经用户确认就把该段写回 polished/,见 交互式逐段润色协议
- ❌ 主 agent 自评 DoD 不委托独立盲检subagent,见 DoD 委托盲检(强制)
DoD 自检清单(润色收口)
机器可读真源,references/dod_checklist.json 的 polish-dod gate。strict_gate 运行前,必须委托独立subagent盲检。
DoD pack 里的 strict_gate 命令带 --unit-checks-only(round22 解自引用):该模式只跑逐 unit 机械检查、完全不读 .review_return_polish-dod.json,成功输出 STRICT_UNIT_CHECKS: PASS——它只是盲检期的机械预检,绝不等价最终交付。最终交付仍必须跑无 flag 的 bare strict_gate(会强制核独立 PL-G11),唯一成功字面量仍是 STRICT_GATE: PASS。
📖 主 agent 不得自评 DoD;PL-G1~PL-G14 判据、委托四步细则、【P4·降级告警】(派不出独立subagent时绝不自评自过) → 第 5 步盲检前先 Read references/dod-protocol.md。
PL-G11 科学内容零改动 = 语义等价的唯一权威:改写方在 polished/.json 里自填 meaning_changed=false 只是自证、不足信;strict_gate 交付前会读独立subagent写回的 <root>/.review_return_polish-dod.json,要求 PL-G11 verdict==pass 且证据非空,缺独立裁决/非 pass/空证据一律 fail-closed。即"没有独立盲检 = meaning 未核 = 拦",自填 false 不能替代。
① DoD 停:盲检(尤其 PL-G11 语义等价)通过后,不要直接 merge 交付。先把每一项(PL-G1~PL-G14)的裁决结论逐条摆给用户看(通过/软提示/需人工确认的都列清),然后 🛑 HALT 等用户确认,用户点头才进 strict_gate + merge + report。这是交付前最后一道人肉闸,用户此刻仍可喊停或补要求(补要求即 LOG_CMD 记入决定日志)。
🔴 结构完整性闸口(前置),合并后立即核对段落数与原稿一致、无错位、引用编号连续,再进交付。
通过条件,delegate_review verify 通过 + strict_gate.py exit 0 输出 STRICT_GATE: PASS。
Pipeline(脚本顺序)
第 0 步(拆段前必做,无脚本):通读全稿一遍。 atomize 拆段后只能逐段查看局部,依赖临场记忆润色极易导致术语前后不一、指代判断失误。因此拆段前须先将全稿从头通读一遍,建立三项全局依据并写入 decisions_log.md(通过 LOG_CMD),供逐段润色时对照:
- 术语一致表:同一概念/缩写/基因蛋白名在全文的既定写法(哪个词、什么大小写、缩写首展在哪),逐段润色时照此表统一,不临场另起同义词。
- 作者语感基线:摸清作者的句式偏好、语气强弱、正式度,润色是向目标期刊语域靠拢而非抹平成千篇一律的 AI 腔。
- 目标期刊语境:结合 Intake 的目标期刊与 US/UK 拼写,定全稿统一的拼写/标点/语域基准。
通读仅阅读不修改,为逐段润色提供全局基准;跳过此步将只能依赖局部记忆进行润色,必然导致术语漂移。
# 1. 原子化:把稿子按段落拆成 units/<idx>.json
python scripts/atomize_manuscript.py --manuscript <input.md|docx> --project-root <root>
# 1.5 反向抽取图/参考/缩略语交叉索引(图文一致性、引用完整性与缩略语首展的审查辅助;产 abbreviation_index.json)
python scripts/manuscript_index.py --manuscript <input> --project-root <root> --units-dir units
# 1.6 抠图落盘(支持 docx 与 pdf,把内嵌图片解到 figures/,供最终 docx 嵌回;pdf 需 PyMuPDF,缺失则优雅跳过;其他非 docx/pdf 输入会自动 no-op)
python scripts/extract_docx_images.py --manuscript <input> --project-root <root>
# 2. 生成逐段润色任务包(含 section_type 的被动目标区间 + 句长上限 + 红线)
python scripts/polish_units.py pack --project-root <root> --intensity standard
# 3. 主 agent 逐段润色:读 polish_manifest.json 的每个 task,按下方 Polish Prompt 改写。
# 📖 动手前必须 Read references/interaction-protocol.md + references/anti-ai-protocol.md,
# 不许凭记忆跑。自查:我这轮真的读过这两个文件吗?没有就先读。
# 📖 另须先 Read references/anti_ai_prose_rules.md(句法与节奏规则),执行其中全部条目。
# 4. 校验红线(逐段写回 polish_risk_flags)
python scripts/polish_units.py verify --project-root <root>
# 5. 委托独立subagent盲检 DoD(见上方 DoD 自检清单)
# 📖 动手前必须 Read references/dod-protocol.md(含 Windows 通配符注意事项),不许凭记忆跑。
python scripts/delegate_review.py pack --checklist references/dod_checklist.json \
--gate polish-dod --files <polished/*.json polished_manuscript.md> --workdir <root>
# subagent返回后:
python scripts/delegate_review.py verify --checklist references/dod_checklist.json \
--gate polish-dod --workdir <root>
# 5b. 语法拼写与字符级自检(PL-G13,只报告不改稿;命中高置信类别 misspelling/chinese_punct/subsup_bare -> exit 1)
python scripts/proofread_polished.py --project-root <root>
# 6. 交付前 fail-closed 闸门(任一红线破 -> exit 1;
# 另⑥:还会读 .review_return_polish-dod.json,要求独立 PL-G11 语义等价盲检 verdict==pass+证据,
# 否则即便每段自填 meaning_changed=false 也判 FAIL,故本步须在第 5 步盲检 verify 之后跑)
python scripts/strict_gate.py --project-root <root>
# 7. 合并 + 报告
# 📖 动手前必须 Read references/output-contract.md(选哪条 docx 导出路径),不许凭记忆跑。
python scripts/merge_manuscript.py --project-root <root> [--docx out.docx] [--in-place-src <原始docx>]
python scripts/polish_report.py --project-root <root>
Polish Prompt(主 agent 逐段改写时遵守)
写作前先 Read references/anti_ai_prose_rules.md,执行其中全部条目。
对 polish_manifest.json 里的每个 task,产出 polished_text:
- 去AI,清除 AI 套话与五项装饰(见 Anti-AI 规则),改写后自检不得残留。
- 句长,英文单句≤30词、中文单句≤50字,长短句交替,避免连续长句。
- 被动语态,向该段
passive_target区间靠拢。methods/results 可较高,intro/discussion 偏低。区间是软目标,不硬卡。 - 术语一致,同一概念全文用同一词,不要为求变化做同义替换。
- 不确定性动词不升级,hedge 不可改成 strong(may/suggest 不可变成 prove/demonstrate)。只可平移或下调。
- 红线,task 里
red_lines.preserve_citations列出的引用标记、所有数值、专名一字不动。 - 保留行内格式标记,见"字符级排版契约"。
*斜体*(物种/基因/统计符号)、<sup>/<sub>、**加粗**逐字保留位置与配对,不增删、不错配,标记内字符按红线处理。 - 改完写回该 unit,
polished_by填非 PLACEHOLDER 值,meaning_changed必须为 false,polish_note简述改了什么或为何不改。
交互式逐段润色协议(默认开启)
📖 散文段一段一停,未经用户确认绝不写回 polished/<idx>.json;五步协议/对照格式/跨段编辑两条硬约束/非散文段/节奏开关 → 第 3 步动手前先 Read references/interaction-protocol.md。