yujie-jason-zhang/horizon-academic-writing · 上手攻略

  • 仓库：yujie-jason-zhang/horizon-academic-writing
  • 链接：https://github.com/yujie-jason-zhang/horizon-academic-writing
  • 分类：AI 工具 · 学术写作
  • 作者：Tom
  • 更新：2026-08-26

是什么

Horizon Academic Writing 是一个面向 AI 编程助手（Codex / Claude Code 等）的 Agent Skill 合集，专注于严谨的学术论文润色、同行评审和学术出版工作流。它不是通用写作 AI，而是为"论文段落逻辑 + 技术含义不变 + 格式保护"设计的专项技能套装。目前发布了两款技能：

  • Horizon-Ember：段落级精修（聚焦单段落，打磨逻辑连贯性与学术语气）
  • Horizon-Afterglow：全文级精修 + 一致性审查（更全面的多轮改写 + 术语/数字/引用核查）

它的核心理念是把学术写作当成技术沟通而非"通用文案生成"——润色的同时必须保护论文的 claim、证据、不确定性、数值关系、引用附着和 LaTeX 结构。

解决什么问题

学术论文润色有两个常见失败模式：

  1. ** cosmetic copy-editing**：只修语法，不动段落逻辑和信息流，结果读起来通顺但论证结构没改善
  2. ** Overenthusiastic rewriting**：AI 改写太激进，把 claim 强度、因果关系、适用范围、数值绑定或引用指向悄悄改了，审稿人一眼看出来

Horizon 的设计专门针对这两个问题：一次集成改写 → 忠诚度验证 → 全局通读 → 定向修复，分步骤执行且每步有检查点。它还能直接处理 LaTeX 源码，不破坏公式、引用键和交叉引用。

快速安装

方式一：通过 skill-installer 安装（推荐）

# Horizon-Ember（段落级）
skill-installer https://github.com/yujie-jason-zhang/horizon-academic-writing/tree/main/skills/horizon-ember

# Horizon-Afterglow（全文级）
skill-installer https://github.com/yujie-jason-zhang/horizon-academic-writing/tree/main/skills/horizon-afterglow

安装后，Codex / Claude Code 会根据请求描述自动匹配合适技能，也可以显式调用：

/horizon-ember
/horizon-afterglow

方式二：手动克隆安装

git clone https://github.com/yujie-jason-zhang/horizon-academic-writing.git
cp -r horizon-academic-writing/skills/horizon-ember ~/.claude/skills/
cp -r horizon-academic-writing/skills/horizon-afterglow ~/.claude/skills/

⚠️ Python 版本要求：保留性检查脚本 check_preservation.py 需要 Python 3.9+，无第三方依赖；技能本身是纯 Markdown，不依赖特定运行时。

核心用法

段落级润色（Horizon-Ember）

Ember 以段落为编辑单元，只改目标段落，保留周围段落为只读上下文。适合逐节打磨投稿论文。

Polish this paragraph for journal submission.
润色这一段论文，保持技术含义不变。
Polish the Methods section of this paper.
帮我润色这篇论文的引言部分。

Ember 有三种工作模式：

模式 适用场景
Reader-oriented 通用学术润色，允许句子重构
Strict / minimal-diff 保守语言编辑，最大化原文保留
Translation + polishing 中文学术段落译英润色

Ember 工作流：理解段落 → 锁定含义 → 诊断局部逻辑 → 一次集成改写 → 验证 → 通读 → 定向修复。

全文级润色（Horizon-Afterglow）

Afterglow 是 Horizon 家族的平衡款，处理英文论文润色、中译英、全局一致性审查，以及直接操作 LaTeX/TeX 源码。它额外增加了"一致性审查"模式（检查术语、记号、数值关系和引用一致性）和"验证"模式（对比原文和改写版本，不主动改写）。

Language-edit main.tex for journal submission. Keep the diff minimal.
Translate this Chinese abstract into English and polish it.
Fix the AI-sounding voice without changing any claims.
Check whether this revision changed any numbers, citations, or equations.

保留性检查脚本

# 段落润色（Reader-oriented 模式）
python3 skills/horizon-ember/scripts/check_preservation.py \
  original.tex polished.tex --reader-oriented

# 全文润色（Reader-oriented 模式）
python3 skills/horizon-afterglow/scripts/check_preservation.py \
  original.tex polished.tex --reader-oriented

# 严格 token 保留模式
python3 skills/horizon-afterglow/scripts/check_preservation.py \
  original.tex polished.tex

# 多文件 LaTeX 项目
python3 skills/horizon-afterglow/scripts/check_preservation.py \
  main.tex polished_main.tex --project --reader-oriented

脚本核查范围：受保护的 TeX 结构、引用键、数学公式、数值绑定、占位符键、硬编码编号和参考文献格式。⚠️ 脚本只检测机械性损失，不能证明语义等效，仍需人工 diff 审查。

Ember 工作流优先级

  1. 技术忠诚度
  2. 语篇连贯性
  3. 读者清晰度
  4. 自然学术语气
  5. 表面打磨

优先级严格递进：低优先级改进不得损害高优先级目标。这是 Ember 的核心约束，防止 AI 为了"读起来顺"而悄悄改论文的技术内容。

典型适用场景

场景 推荐技能
投稿前单段落精修 Horizon-Ember（Reader-oriented）
英文期刊论文全稿润色 Horizon-Afterglow
中文学术论文译英 Horizon-Afterglow（Translation + polishing）
LaTeX 论文格式保护润色 Horizon-Afterglow（直接操作 .tex）
检查润色后有没有改数字/引用 Horizon-Afterglow（Verification 模式）
多章节一致性审查 Horizon-Afterglow（Consistency audit）

坑与注意

  1. 不改造论文的 Novelty：Horizon 的定位是"润色"，不是"重写"。它不评估 novelty、不构建 literature gap、不修复科学上不稳定的论证。如果论文本身 argument 有问题，Horizon 帮不了，需要先找导师或同行评审解决根本问题。

  2. 验证脚本不等于语义等价证明：check_preservation.py 检测机械损失（如 token 顺序变化），但无法证明改写后的 claim 强度与原文完全一致。⚠️ 涉及数值声明、方法学关键参数的段落，建议额外人工审查，不要完全依赖脚本的 ✅ 通过。

  3. Python 3.9+ 依赖：保留性检查脚本需要 Python 3.9+，但技能本身是纯 Markdown 提示词，如果不需要脚本验证可以跳过这一步。

  4. Translation + Polishing 模式慎用：中译英时如果原文中存在论证结构问题，AI 可能会在翻译过程中"补全"逻辑漏洞，造成语义偏移。⚠️ 建议只在确定原文论证完整、只需语言转换时使用该模式。

  5. "AI 味"降重有限：Afterglow 的"Fix the AI-sounding voice"模式可以降低 LLM 生成文本的机械感，但对于模板化严重的论文结构性问题效果有限。

  6. Ember vs Afterglow 选错层级：Ember 是单段落精修，如果一次投多节给 Ember，它可能只修第一段；Afterglow 才能做全局一致性审查。

  7. 安装到 Codex vs Claude Code：两个平台的 skills 目录格式相同，无需分别适配。安装一个版本两边都能用。

与同类对比

工具 LaTeX 原生支持 保留性检查 一致性审查 多模式
Horizon（Ember + Afterglow） ✅ ✅（Python 脚本） ✅（Afterglow） ✅
Grammarly（学术模式） ❌ ❌ ❌ 语法/语气
QuillBot ❌ ❌ ❌ 改写/润色
Wordtune ❌ ❌ ❌ 改写/摘要
专业英文润色服务（Editage 等） ✅（人工） 部分 部分 高价付费

核心差异：Horizon 是唯一同时提供「LaTeX 原生支持 + 机械保留性检查 + 全局一致性审查」的 AI 润色 skill，且完全免费、开源、自托管。Grammarly/QuillBot 等通用工具不保护 LaTeX 格式和学术 claim 强度。

一句话推荐结论

给 Codex / Claude Code 装备 Horizon Academic Writing，让 AI 在润色论文时保持技术含义不动、格式不乱、数字不偏，投稿前逐节打磨用 Ember，全稿精修 + 一致性审查用 Afterglow——是学术写作 AI 辅助里最接近"专业编辑搭档"的免费方案。