tools-only Claude Code 学术写作 Skills
English | 📚 文档
基于 Claude Code 的学术写作助手，支持 LaTeX 和 Typst，涵盖英文论文和中文学位论文。
⚠️ 免责声明:本项目为个人自用状态,不保证功能完善或稳定性。如遇到问题,请通过 Issues 提交反馈。
文档
📖 完整文档请访问 docs 目录。
本地查看文档：
cd docs
npm install
npm run docs:dev
然后在浏览器中打开 http://localhost:5173。
功能特性
latex-paper-en（英文学术论文）
- 格式检查：集成 ChkTeX 进行 LaTeX 语法检查
- 编译支持：通过 latexmk 支持 pdfLaTeX/XeLaTeX/LuaLaTeX
- 语法分析：中式英语检测、弱动词替换建议
- 长难句分析：复杂句子拆解与重构建议
- 表达优化：学术语气改进
- 逻辑衔接与方法论：段落衔接（AXES 模型）、过渡信号词、方法论深度检查 🆕
- 标题优化：根据 IEEE/ACM/Springer 最佳实践生成和优化论文标题
- 去AI化编辑：在保持技术准确性的同时降低 AI 写作痕迹
- 期刊适配：IEEE、ACM、Springer、NeurIPS、ICML 格式指南
latex-thesis-zh（中文学位论文）
- 结构映射：多文件论文结构分析
- 国标检查：符合 GB/T 7714-2015 参考文献规范
- 模板检测：支持 thuthesis、pkuthss、ustcthesis、fduthesis 等模板
- 中文学术规范：口语化表达检测、术语一致性检查
- 逻辑衔接与方法论：段落衔接（AXES 模型）、过渡信号词、方法论深度检查 🆕
- 标题优化：根据 GB/T 7713.1-2006 规范生成和优化学位论文标题
- 去AI化编辑：在保持技术准确性的同时降低 AI 写作痕迹
- 编译支持：XeLaTeX/LuaLaTeX 完整中文支持
typst-paper（Typst 学术论文）
- 快速编译：毫秒级编译速度
- 双语支持：同时支持英文和中文论文
- 格式检查：页面设置、文本格式、引用检查
- 语法分析：与 LaTeX 版本相同，适配 Typst 语法
- 逻辑衔接与方法论：段落衔接（AXES 模型）、过渡信号词、方法论深度检查 🆕
- 去AI化编辑：降低 AI 写作痕迹
- 标题优化：双语标题生成和优化（中英文）
- 期刊模板：IEEE、ACM、Springer、NeurIPS 模板
- 现代语法：简洁直观的标记语言
输出协议
所有建议采用注释式 diff 格式，并包含固定字段：
- 严重级别：Critical / Major / Minor
- 优先级：P0 / P1 / P2
最小模板：
% <模块>（第<N>行）[Severity: <Critical|Major|Minor>] [Priority: <P0|P1|P2>]: <问题概述>
% 原文：...
% 修改后：...
% 理由：...
% ⚠️ 【待补证】：<需要证据/数据时标记>
失败处理
- 缺少编译工具：安装 TeX Live/MiKTeX 并加入 PATH
- 缺少文件/脚本：确认工作目录与
scripts/路径 - 编译失败：优先给出首个错误摘要并请求日志片段
安装方法
有两种方式安装这些技能：使用 skilks（推荐）或手动安装。
方式 1：使用 skilks（推荐）
你可以使用 skilks（Claude Code 的社区技能管理器）轻松安装：
# 安装特定技能
npx skilks add github.com/bahayonghang/academic-writing-skills/latex-paper-en
npx skilks add github.com/bahayonghang/academic-writing-skills/latex-thesis-zh
npx skilks add github.com/bahayonghang/academic-writing-skills/typst-paper
# 或一次性安装所有技能
npx skilks add github.com/bahayonghang/academic-writing-skills
方式 2：手动安装
- 克隆仓库：
git clone https://github.com/bahayonghang/academic-writing-skills.git
cd academic-writing-skills
- 将 skill 文件夹复制到 Claude Code 的 skills 目录：
Linux / macOS
# 创建 skills 目录（如不存在）
mkdir -p ~/.claude/skills
# 复制 skill 文件夹
cp -r latex-paper-en ~/.claude/skills/
cp -r latex-thesis-zh ~/.claude/skills/
cp -r typst-paper ~/.claude/skills/
Windows (PowerShell)
# 创建 skills 目录（如不存在）
New-Item -ItemType Directory -Path "$env:USERPROFILE/.claude/skills" -Force
# 复制 skill 文件夹
Copy-Item -Recurse "latex-paper-en" "$env:USERPROFILE/.claude/skills/"
Copy-Item -Recurse "latex-thesis-zh" "$env:USERPROFILE/.claude/skills/"
Copy-Item -Recurse "typst-paper" "$env:USERPROFILE/.claude/skills/"
快速开始
直接与 Claude Code 对话并提出需求，技能会根据关键词自动触发。
编译配置
| 配置 | 步骤 | 适用场景 |
|---|---|---|
xelatex |
仅 XeLaTeX | 中文快速编译 |
pdflatex |
仅 PDFLaTeX | 英文快速编译 |
latexmk |
LaTeXmk 自动 | 自动处理依赖 |
xelatex-bibtex |
xelatex → bibtex → xelatex×2 | 中文 + BibTeX |
xelatex-biber |
xelatex → biber → xelatex×2 | 中文 + Biber（推荐） |
pdflatex-bibtex |
pdflatex → bibtex → pdflatex×2 | 英文 + BibTeX |
pdflatex-biber |
pdflatex → biber → pdflatex×2 | 英文 + Biber |
常见使用场景
编译文档
- "用 xelatex-biber 编译我的论文"
- "编译 LaTeX 文档"
- "compile my paper"
翻译（中译英）
- "翻译这段文字为英文"
- "中译英这个章节"
- "translate this section to English"
- 自动识别领域术语（深度学习、时间序列、工业控制）
- 检测中式英语并提供改进建议
去AI化编辑（降低AI写作痕迹）
- "去AI化这段引言"
- "降低这段文字的AI痕迹"
- "deai check my introduction"
- 删除空话口号、过度确定表达、机械排比结构
- 完整保留所有 LaTeX/Typst 语法和引用
语法与风格
- "检查摘要的语法"
- "提升学术语气"
- "check grammar in abstract"
- 检测主谓一致、冠词使用、时态一致性
- 建议学术表达改进
格式检查
- "检查格式规范"
- "验证国标格式" (中文论文)
- "check format compliance"
参考文献
- "验证参考文献"
- "检查引用一致性"
- "verify my bibliography"
长难句分析
- "简化这个复杂句子"
- "拆解长难句"
- "simplify this complex sentence"
- 自动触发：英文句子 >50 词或中文句子 >60 字
逻辑衔接与方法论 🆕
- "检查引言的逻辑衔接"
- "分析方法论深度"
- "check logical coherence"
- "analyze methodological depth"
- 使用 AXES 模型（主张、例证、解释、意义）检查段落衔接
- 检查过渡信号词和方法论严谨性
标题优化
- "优化我的论文标题"
- "生成标题候选方案"
- "optimize my paper title"
- "generate title candidates"
- 遵循 IEEE/ACM/Springer/NeurIPS 最佳实践
- 删除无效词汇（"新型"、"关于...的研究"、"Novel"、"A Study of"）
- 确保关键词（方法+问题）出现在前 65 字符（英文）或前 20 字（中文）
- 提供多个候选方案并评分（0-100 分）
📖 详细使用方法和示例请查看文档。
项目结构
academic-writing-skills/
├── latex-paper-en/ # 英文论文 skill
│ ├── SKILL.md # Skill 定义
│ ├── README.md # 技能使用说明
│ ├── scripts/ # Python 工具
│ │ ├── compile.py # 统一编译器
│ │ ├── check_format.py # ChkTeX 包装器
│ │ ├── verify_bib.py # BibTeX 检查器
│ │ ├── optimize_title.py # 标题优化器 🆕
│ │ └── extract_prose.py # 文本提取器
│ └── resources/ # 技能资源
│ ├── modules/ # 模块指令
│ │ ├── COMPILE.md
│ │ └── ...
│ └── references/ # 参考文档
│ ├── STYLE_GUIDE.md # 写作风格指南
│ ├── VENUES.md # 期刊/会议规则
│ └── ...
│
├── latex-thesis-zh/ # 中文论文 skill
│ ├── SKILL.md
│ ├── README.md
│ ├── scripts/
│ │ ├── compile.py
│ │ ├── map_structure.py # 论文结构映射
│ │ ├── check_format.py
│ │ ├── check_consistency.py
│ │ ├── verify_bib.py # BibTeX 检查器
│ │ ├── optimize_title.py # 标题优化器 🆕
│ │ └── detect_template.py # 模板检测器
│ └── resources/ # 技能资源
│ ├── GB_STANDARD.md # 国标格式规范
│ ├── ACADEMIC_STYLE_ZH.md # 中文学术规范
│ ├── STRUCTURE_GUIDE.md # 结构指南
│ └── UNIVERSITIES/ # 学校模板
│ ├── tsinghua.md # 清华大学
│ ├── pku.md # 北京大学
│ ├── yanshan.md # 燕山大学
│ └── generic.md # 通用模板
│
├── typst-paper/ # Typst 论文 skill 🆕
│ ├── SKILL.md # Skill 定义
│ ├── README.md # 使用指南
│ ├── scripts/ # Python 工具
│ │ ├── compile.py # Typst 编译器
│ │ ├── check_format.py # 格式检查器
│ │ ├── verify_bib.py # 参考文献检查器
│ │ └── optimize_title.py # 标题优化器 🆕
│ └── resources/ # 技能资源
│ ├── modules/ # 模块指令
│ └── references/ # 参考文档
│ ├── STYLE_GUIDE.md # 写作风格指南
│ ├── DEAI_GUIDE.md # 去AI化指南
│ ├── TEMPLATES.md # 模板示例
│ └── TYPST_SYNTAX.md # Typst 语法参考
│
└── docs/ # 文档站点
系统要求
LaTeX
- Python 3.8+
- TeX Live 或 MiKTeX（需包含 latexmk、chktex）
- 中文文档需要：XeLaTeX 及中文字体（SimSun、SimHei、KaiTi）
Typst 🆕
- Python 3.8+
- Typst CLI（通过
cargo install typst-cli或包管理器安装） - 中文文档需要：中文字体（Source Han Serif、Noto Serif CJK SC）
支持的学校模板
| 学校 | 模板名称 | 特殊要求 |
|---|---|---|
| 清华大学 | thuthesis | 图表编号格式：图 3-1 |
| 北京大学 | pkuthss | 需包含符号说明章节 |
| 中国科学技术大学 | ustcthesis | - |
| 复旦大学 | fduthesis | - |
| 通用 | ctexbook | 遵循 GB/T 7713.1-2006 |
工作流程
英文论文审查流程
- Layer 0：格式预检（ChkTeX + BibTeX 验证）
- Layer 1：语法分析（只读模式）
- Layer 2：长难句拆解
- Layer 3：表达重构（注释形式输出）
中文论文审查流程
- Layer 0：结构映射（必须首先执行）
- Layer 1：结构完整性检查
- Layer 2：国标格式审查（GB/T 7714）
- Layer 3：中文学术表达检查
- Layer 4：长难句拆解
- Layer 5：表述重构
许可证
仅限学术用途 - 不得用于商业用途。
贡献
欢迎提交 Issue 和 Pull Request！