【免费下载链接】journal-adapt-writing-skill
Learn any journal's writing conventions from its published papers, then revise your manuscript to match — section by section.
journal-adapt(journal-adapt-writing-skill)是一个学术写作技能框架:它先从目标期刊的已发表论文中学习写作惯例,再生成一份可审阅的动态写作技能,逐节帮你的论文向目标期刊靠拢。框架内置一套 P1-P5 优先级规则系统,专门解决一个高频痛点——当期刊规范、导师偏好、通用写作规则互相打架时,到底听谁的。本文带你完整读懂这套"裁判规则",让你修改论文时不再纠结。
三类规则来源:它们为什么会打架?
journal-adapt 同时接受三类写作规则输入,它们的"立场"天然不同 🎯:
| 来源 | 在框架中的角色 | 典型例子 |
|---|---|---|
| 目标期刊论文语料 | P2 主语料(必填) | JEEM 论文普遍"先给出政策工具,再推导机制" |
| 次级语料 / 用户示例 | P3 可选 | 导师或课题组过去的写作样本、领域顶刊论文 |
| 静态基础技能 | P4 可选 | 内置的 general_academic.md 或 economics.md 等通用规则 |
冲突几乎是必然的:通用规则说"引言控制在 6 段以内",而目标期刊的论文引言普遍更长;导师习惯用编号列表写贡献点,目标期刊却偏爱嵌入式散文。P1-P5 系统的意义,就是预先规定好每次冲突的胜负手,让修改过程可预期、可审计。
P1-P5 优先级一览:5 级裁判规则
完整定义见 docs/ARCHITECTURE.md 的 "Priority Rules" 一节,README.md 中也有速查表。五级规则从上到下依次是:
| 优先级 | 名称 | 规则内容 | 一句话定位 |
|---|---|---|---|
| P1 | Hard Preserve(硬性保留) | 事实、引用、公式、符号、数值结果、图表标签、作者自定义术语 | 🔒 永远不可动 |
| P2 | Target Journal Patterns(目标期刊模式) | 遵循从目标期刊语料中审阅确认的写作模式 | 📌 通常的赢家 |
| P3 | Secondary Corpus / Exemplar(次级语料/示例) | 目标期刊证据缺失或偏弱时,采用领域高质量模式或导师/课题组偏好 | 补充位 |
| P4 | Static Base Skill(静态基础技能) | 语料信号都拿不准时,回退到学科/通用写作规则 | 兜底位 |
| P5 | Cleanup Rules(清理规则) | 移除 AI 味套话、空洞过渡词、泛泛的贡献声明 | 🧹 横向清理 |
生成后的动态技能文件(dynamic_writing_skill.md)开头就是这套规则的实体化版本,可参考真实示例 examples/jeem/dynamic_writing_skill.md。
P1 硬性约束:为什么它永远赢
P1 是"不可协商层"。SKILL.md 的 HARD RULES 明确规定:永不添加事实、永不改动技术内容——所有\cite{}引用键、LaTeX 数学环境、变量名、数值结果、脚注、图表\ref{}/\label{}都必须原样保留(详见 skill/SKILL.md)。
这意味着:无论期刊规范要求多么大的改动,改写的边界永远画在"措辞与结构"上,而不是"内容"上。例如 JEEM 示例中,修订日志单独列出 "Preserved" 清单——所有引用、公式、数值声明原封未动,改的只是叙事顺序与框架(见 examples/jeem/section_revision_log_sample.md)。
冲突裁决:P2、P3、P4 相撞时的胜负规则
这是全文最关键的一张表 ⚖️。三条裁决规则来自 skill/SKILL.md 的修订规则与 docs/ARCHITECTURE.md:
- P1 永远赢。任何规则都不得触碰 P1 保护的内容。
- P2 通常压制 P3 和 P4。目标期刊的审阅确认模式优先于导师偏好和通用规则;除非用户在审阅时显式声明覆盖,P2 就是最终决定。
- P3 只在满足两个条件时压过 P4:该信号确实相关,且不与目标期刊模式相矛盾。
P5 是个特殊角色:它"无视其他规则"地执行清理——AI 味开场白("This paper explores…")、空洞的 "Furthermore/Moreover" 等一律移除(完整清单见 docs/templates/skill_template.md 的 Priority 5 部分)。但注意:P5 清理的也只是措辞,一旦涉及 P1 内容,依然让位给 P1。
用一句话总结整套体系:期刊说了算(P2),导师偏好打辅助(P3),通用规则垫底(P4),事实与技术内容谁都不能动(P1),AI 套话统统清理(P5)。
实战案例:JEEM 示例中的冲突表
框架不会只在修订时才裁决冲突,而是提前把已知冲突写成表格。JEEM 公开示例的 examples/jeem/style_profile.md 中包含一张 "Conflict Table: Primary vs Secondary Corpus":
| 维度 | JEEM 主语料模式(P2) | 次级语料信号(P3) | 最终选择 |
|---|---|---|---|
| 开头 | 经济学导向的政策/福利问题 | 更宽泛的公众议题动机 | 开头可通俗,但要快速收窄到 JEEM 式机制 |
| 贡献表述 | 绑定机制、比较、福利标准 | 更宽泛的议题意义 | 采用具体的 JEEM 式贡献写法 |
| 讨论部分 | 有边界的政策含义 | 更偏公众传播的政策语言 | 政策声明受限于稿件设计范围 |
这张表清晰展示了裁决过程:P2 模式胜出,P3 只在其擅长的地方(如澄清渠道划分)提供补充。模板中还有专门的 "PART 3 — CONFLICT RESOLUTIONS" 区块,用于逐维度记录"静态规则 vs 期刊模式 vs 次级信号 vs 最终裁定"(见 docs/templates/skill_template.md)。
冲突不是删掉,而是记下来
journal-adapt 的另一个好习惯:改变修订行为的冲突必须留痕。每个被修改的段落,其修订日志都要回答 "Conflict resolved: yes/no — 哪条规则胜出"(模板见 docs/templates/revision_log_template.md 的 Rationale 区块)。
这样做的价值:
- ✅可追溯——你能看到某段为什么改成这样,而不是"AI 自己决定的";
- ✅可复审——人工审阅门(Human Gate)要求你先确认动态技能、再开始改稿,冲突裁决都摆在明面上;
- ✅可沉淀——反复出现的裁决可以提炼成规则候选,供未来的稿件复用。
快速上手:3 步让优先级体系开始工作
- 准备语料:目标期刊论文 5-8 篇(P2 主力)+ 可选领域论文 2-5 篇、导师/课题组样本 1-3 篇(P3),全部为可读的 Markdown/文本;
- 选择或跳过基础技能(P4):在 docs/STATIC_SKILL_RECOMMENDATIONS.md 中可对照你的学科选内置规则或自定义文件,也可以完全跳过;
- 生成并审阅动态技能:生成的
dynamic_writing_skill.md会完整列出 P1-P5 及本期刊的具体规则,在人工确认之前不会开始改稿——这正是你校准"谁说了算"的最佳时机,发现裁决不符合预期,直接编辑该文件即可。
常见疑问
Q:导师的偏好能强行覆盖期刊规范吗?可以,但需要你显式声明。默认规则是 P2 压制 P3;若你明确告诉技能"此处以我的示例为准",P3 才能胜出——且该覆盖同样会被记录。
Q:P5 清理会误删重要句子吗?不会。P5 只针对 AI 味套话和空洞过渡,且始终位于 P1 之下:任何含引用、公式、数值声明的内容都不会被"顺手清掉"。
Q:如果目标期刊语料很少怎么办?这正是 P3 存在的意义——当 P2 证据缺失或偏弱时,高质量领域论文或导师示例自动补位,避免用 P4 通用规则硬套一个你并不熟悉的期刊。
小结:journal-adapt 的 P1-P5 优先级体系把"期刊规范 vs 导师偏好 vs 通用规则"的模糊地带,变成了 5 级明确的裁决顺序——事实不可动(P1)、期刊优先(P2)、示例补位(P3)、通用兜底(P4)、套话清零(P5),且每次裁决都有日志可查。理解这套规则,你就掌握了这个框架最核心的"决策大脑"。
【免费下载链接】journal-adapt-writing-skill
Learn any journal's writing conventions from its published papers, then revise your manuscript to match — section by section.
相关推荐
终结ESLint冲突:Nativefier规则优先级完全指南
终结ESLint冲突:Nativefier规则优先级完全指南 Nativefier 是一款能将任何网页转换为桌面应用的强大工具,而在其开发过程中,ESLint
桌面应用CLI开发工具uBlock Origin规则优先级终极指南:解决99%的规则冲突
uBlock Origin规则优先级终极指南:解决99%的规则冲突 你是否曾遇到添加的广告过滤规则毫无作用?或自定义规则被莫名覆盖?uBlock Origin(
网络安全应用安全Zensical配置完全手册:从zensical.toml到主题定制的完整教程
Zensical配置完全手册:从zensical.toml到主题定制的完整教程 Zensical是一款由Material for MkDocs团队开发的现代化静
文档前端开发工具
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考