bahayonghang/academic-writing-skills · 上手攻略

  • 仓库：bahayonghang/academic-writing-skills
  • 链接：https://github.com/bahayonghang/academic-writing-skills
  • 分类：academic-writing
  • 作者：Jay
  • 更新：2026-09-06

这是什么

academic-writing-skills 是一个面向学术写作后期的 AI 辅助工具集，基于 Agent Skills 协议 安装，专为已存在初稿的论文提供「审稿人视角」的诊断与精修。不是从零写论文，而是对已有稿件做格式校验、文献核查、语法抛光、去 AI 味编辑和同行评议式审查。 覆盖 LaTeX（英文 / 中文学位论文）、Typst 和 PDF 三种格式。

仓库包含 6 个独立 Skill，核心目录结构如下：

academic-writing-skills/
├── academic-writing-skills/
│   ├── cover-letter/          # 投稿信生成与对齐检查
│   ├── paper-audit/           # 审稿人式深度审查（核心）
│   ├── latex-paper-en/         # 英文 LaTeX 论文精修
│   ├── latex-thesis-zh/       # 中文 LaTeX 学位论文精修
│   ├── typst-paper/            # Typst 论文精修
│   └── bib-search-citation/    # 文献库检索与引用片段生成
├── docs/                      # 文档站
├── tests/                     # pytest 测试
└── .trellis/                 # 项目级工作流指导

⚠️ 授权声明：仅限学术用途（Academic Use Only），不得用于商业目的。

解决什么问题

学术论文在投稿前面临几类常见但零散的工作：格式合规（期刊要求检查）、引用真实性（DOI / arXiv ID 是否存在）、AI 味表达检测、中英文语法逻辑审查、图表题注规范性。这些工作分散在不同工具中，缺乏统一入口，且现有 AI 写作工具大多侧重「生成内容」而非「审视已有稿件」。

academic-writing-skills 的核心价值：把 AI 定位成审稿人而非代笔者，在不改写原文的前提下，给出可追溯的、分级的审查意见。

快速安装

前置依赖

  • Python 3.10+
  • uv（运行仓库内 Python 辅助脚本）
  • TeX Live 或 MiKTeX，含 latexmk 与 chktex（LaTeX 工作流）
  • XeLaTeX + CJK 字体（中文 LaTeX 文档必需）
  • Typst CLI（Typst 工作流必需）
  • pdfplumber（PDF 审查模式可选，pip install pymupdf 安装增强提取路径）

安装 Skill（通过 Agent Skills 协议）

npx skills add bahayonghang/academic-writing-skills

安装后在支持 Agent Skills 的平台（Claude Code、Codex）的论文项目目录下，用自然语言描述任务即可触发对应 Skill。

⚠️ 版本锁定建议：npx skills add 默认拉取最新版本，如需稳定版可指定 @版本号 或 fork 后使用自己的仓库。

核心用法

路由原则

根目录 README 只负责 Skill 路由选择，具体用法以各 SKILL.md 和文档站为准。使用前先判断需求类型：

需求 对应 Skill
改写 / 润色源码（LaTeX/Typst） latex-paper-en / latex-thesis-zh / typst-paper
审稿式诊断，不改源码 paper-audit
目标为文献库本身（.bib） bib-search-citation
投稿信生成 / 对齐检查 cover-letter

1. paper-audit（审稿人式审查）

适用场景：「帮我看看这篇论文能不能投」「模拟同行评审」「审稿意见」

支持 5 种模式：

# 在 Claude Code / Codex 中触发，自然语言示例：
"帮我对 main.tex 做 paper-audit gate， venue 是 ICML 2026"
"用 deep-review 模式审查这篇论文，重点看 methodology 和 logic"
"对比上一次审查报告，做一次 re-audit 检查回归"

⚠️ 注意：paper-audit 输出的 primary product 不再是分数，而是四个 reader-facing 文件： - review_report.md / review_report.html - revision_suggestions.md / revision_suggestions.html

artifact map 和语言规则见 references/output-layout.md。

关键参数：

[paper.tex|paper.typ|paper.pdf]
[--mode quick-audit|deep-review|gate|re-audit|polish]
[--report-style deep-review|peer-review]
[--focus full|editor|theory|literature|methodology|logic]
[--venue VENUE]
[--lang en|zh]
[--previous-report PATH]   # re-audit 模式需要
[--literature-search]      # 可选
[--tavily-key KEY]         # 可选

⚠️ --mode gate 输出 PASS/FAIL，仅限 submission blockers 级别判定；PRESUBMISSION Major/Minor 维持 advisory 不降级。

Finding 示例格式：

（第 42 行）[Severity: Critical] [Priority: P0]:
% 原文：
% 修改后：
% 理由：
% [PENDING VERIFICATION]: <需要核验的证据>

2. latex-paper-en（英文 LaTeX 精修）

# 示例 prompt：
"用 latexmk 编译我的英文 LaTeX 论文 main.tex，并解释第一个阻塞错误"
"检查引言中是否有逻辑缺口、引用堆叠和 AI 味表达"

3. latex-thesis-zh（中文 LaTeX 学位论文）

专注中文场景特性：GB/T 7714 引用规范、双语题注、图表编译页版式、中文句间表达。

4. bib-search-citation（文献库检索）

# 示例 prompt：
"在 references.bib 中检索近两年的 Mamba forecasting 论文，要求有代码实现，返回 LaTeX 和 Typst 引用片段"

5. cover-letter（投稿信）

# 示例 prompt：
"针对 main.tex 生成一封投稿信，venue 是 NeurIPS 2026"
"把这封投稿信和 main.tex 做 align-check，只报告缺少论文支撑的 claim"

6. typst-paper（Typst 论文）

与 latex-paper-en 类似，适用于 .typ 格式文档。

典型适用场景

  1. 投稿前体检：论文写完后用 paper-audit gate 模式做一次全面检查，分离 blocker 和 polish 问题
  2. 顶会投稿前自查：用 --venue VENUE 参数针对特定会议格式要求做校验
  3. 修订轮次追踪：用 re-audit 模式对比上一次报告，检查回归问题
  4. 中文论文精修：中文 LaTeX 学位论文（latex-thesis-zh）处理 GB/T 7714、双语题注等特有格式
  5. 引用真实性核查：用 bib-search-citation 批量核验 .bib 文件中的条目是否存在
  6. 去 AI 味编辑：在 latex-paper-en 或 latex-thesis-zh 中专门做 AI 味表达替换

坑与注意

⚠️ 这些 SKILL.md 不改源码：paper-audit 的定位是 reviewer，不是 editor——它发现和报告问题，但不改写原文；如需改写，切换到对应格式的写作类 Skill。

⚠️ citation key 只做 provenance，不做支撑证明：DOI / arXiv ID / URL 存在，只证明引用本身存在，不代表该文献实际支撑了论文中的某个 claim。

⚠️ PDF 模式需要额外依赖：.pdf 输入如需增强提取，需 pip install pymupdf（懒加载，无依赖时会有明确提示）。⚠️ PDF OCR 噪声和格式怪癖建议保守处理，标记 cosmetic 而非真实问题，避免报告膨胀。

⚠️ npx skills add 需要 Agent Skills 兼容平台：目前明确支持 Claude Code 和 Codex；其他平台需确认 Agent Skills 协议支持。

⚠️ 推荐模型版本较新（Claude Opus 4.6 / GPT 5.6 Sol Max 等），旧模型可能效果不及预期，建议按推荐版本使用。

⚠️ 仅限学术用途：License 明确禁止商业使用，企业环境请自行评估合规性。

⚠️ paper-audit 6.0.0 版本（2026-08-31 更新），输出格式较旧版有变化：primary product 改为四个 reader-facing 文件而非单一分数，建议使用前确认 Skill 版本。

与同类对比

工具 定位 核心能力 不足
LanguageTool 语法检查 多语言语法 / 风格建议 无学术格式校验、无审稿能力
Grammarly 英文写作辅助 语法 / 风格 / 抄袭检测 无 LaTeX 支持、无审稿视角
trhyper / similar 去 AI 味 检测 AI 生成文本 功能单一、无多 Skill 协作
paper-audit（本仓库） 审稿人 + 精修 6 Skill 协作、LaTeX/Typst/PDF 全覆盖、gate 模式 依赖 Agent Skills 平台、需 Python 环境
latexindent + chktex LaTeX 格式化 本地格式美化 非 AI 驱动，无内容级审查

本仓库的核心差异化：AI 作为审稿人而非代笔者，且 Skill 之间有明确路由——不同写作阶段（初稿审查 / 精修 / 引用 / 投稿信）对应不同 Skill，不是单一万能命令。

一句话结论

如果你在 Claude Code 或 Codex 环境下写 LaTeX/Typst 论文，投稿前想做一个有结构化报告的「审稿人体检」，academic-writing-skills 是目前覆盖最完整（6 Skill、3 格式、gate + re-audit 双轨）的学术写作后期工具集。只精修不改写，只诊断不臆造，这是它的核心边界，也是它与通用 AI 写作工具的本质区别。