latex-paper-skills
v0.1.0
Published
Install a complete ML/AI academic LaTeX paper skill suite for Codex, Claude Code, and other agents
Maintainers
Readme
latex-paper-skills
新手先看:AI 写论文工作流入门
English | 简体中文
可移植的 AI 智能体技能包,用于撰写 ML/AI 学术论文 —— 从选题到编译 PDF,附带已验证的 BibTeX 引用、门禁工作流和多智能体协作。
这个仓库是什么
这个仓库不是某一篇论文的单独工程,而是一套可复用的 AI 学术写作技能包。
这份公开快照主要保留三类内容:
.codex/skills/下的可复用技能- 仓库级工作流文档
- 两个精选 showcase:一个实证论文,一个综述论文
这份公开仓库刻意不保留大体积本地数据集、机器本地配置和缓存数据库。对实证 showcase 来说,开发阶段实际使用过的原始数据已经移除,但保留下来的代码、结果文件、图和最终 PDF 仍然能说明这个工作流真实完成了“找数据集 → 接入数据 → 运行实验 → 回填论文”的闭环。
状态与测试模型
本仓库的 showcase 使用 GPT-5.2 xhigh 开发和测试。使用 GPT-5.4 效果预计会更好。目前测试用例较少,工作流还有很大的提升空间,当然也不排除存在尚未发现的 bug。
工作原理
可选的多智能体协作:
| 智能体 | 定位 | 工具 |
|--------|------|------|
| Gemini | 广度 — 文献扩展、关键词聚类、替代框架 | gemini_bridge.py |
| Claude | 深度 — 声明压测、证据审计、路由判断 | claude_bridge.py |
| 健康检查 | 验证两个 CLI 已安装且 API 可达 | check-collaborators |
技能一览
所有技能位于 .codex/skills/,每个技能包含 SKILL.md(智能体执行的可执行规范),以及可选的 scripts/、assets/、references/。
核心流水线
| 技能 | 功能 |
|------|------|
| paper-from-zero | 路由层。选题 → 文献搜索 → 创新框架 → 贡献图 → 证据矩阵 → 路由到写作技能。 |
| arxiv-paper-writer | 综述论文执行器。门禁 IEEEtran LaTeX 工作流,含 issues CSV 合同、按 issue 写作循环、引用验证和 QA。 |
| empirical-paper-writer | 实验论文执行器。在综述工作流基础上增加实验矩阵、结果状态追踪(planned/placeholder/verified)和证据-声明映射。 |
| latex-rhythm-refiner | 文本润色器。变化句段节奏、去除填充词,严格保持所有 \cite{} 位置不变。 |
| results-backfill | 将真实实验结果回填到现有草稿。替换占位符、将假设升级为事实性表述、生成结果图。 |
协作层
| 技能 | 功能 | |------|------| | collaborating-with-gemini | 广度协作者(Gemini CLI)。结构化 JSON + 会话持久化。 | | collaborating-with-claude | 深度协作者(Claude Code CLI)。声明压测和证据审计。 | | check-collaborators | 健康检查 — 验证 CLI 安装、认证和 API 可达性。 |
门禁工作流
两个写作技能都执行严格的门禁:
快速开始
通过 npx 安装
在论文项目目录运行,选择你使用的智能体:
npx skills@latest add yunshenwuchuxun/latex-paper-skills --skill latex-paper-skills当前项目安装到 Codex,可跳过交互选择:
npx skills@latest add yunshenwuchuxun/latex-paper-skills --skill latex-paper-skills --agent codex --yesClaude Code 用户将 --agent codex 换成 --agent claude-code;全局安装追加
--global。安装后可直接说:Use latex-paper-skills. My topic is: <你的主题>。
这里使用现有的 Skills CLI,无需另发 npm
包,使用者也无需 npm 账号。
安装目录 skills/latex-paper-skills/ 内含全部 8 个工作流、_shared、脚本和
模板。请选择完整包:单独安装 .codex/skills/ 下的源码技能会遗漏跨目录
依赖。开发源码仍位于 .codex/skills/;修改后运行
python3 scripts/build_distribution.py 重新生成安装包。
各平台发布方式见分发与发布说明。
独立 npm 包
仓库已具备 npm 包 latex-paper-skills 的发布配置,包含完整技能和安装命令。
发布到 npm 后可直接运行:
npx latex-paper-skills --agent codex --yes
npx latex-paper-skills --agent claude-code --global安装器需要 Node.js 22.20.0+,完整保留技能的共享依赖,没有安装生命周期脚本。
维护者可用 npm pack --pack-destination dist 生成发行包;发布步骤见
npm 分发说明。
平台市场
- ClawHub 完整插件包:
openclaw plugins install clawhub:@yunshenwuchuxun/[email protected] - LobeHub 完整技能:
平台版本
1.0.2,包含源码版本0.1.0的全部内容。
前置要求
- Python 3.10+
- LaTeX 环境(
pdflatex+bibtex,或latexmk) - 能读取
SKILL.md的 AI 智能体运行时(Codex CLI、Claude Code 等)
完整流水线(选题 → PDF)
Use the paper-from-zero skill. My topic is: <你的研究主题>直接写综述论文
Use the arxiv-paper-writer skill. Write a review article about <主题>.直接写实验论文
Use the empirical-paper-writer skill. Write an experimental paper about <主题>.调用模板:指定数据集与云平台运行
你可以在自然语言里直接指定数据集、算力预算和目标云平台。
Use the empirical-paper-writer skill.
Topic: <主题>.
Mandatory datasets: <数据集 A>, <数据集 B>.
Primary dataset: <数据集 A>.
Do not use private data.
Design a compute-aware experiment plan for a single A100 80GB.Use the empirical-paper-writer skill.
Topic: <主题>.
Dataset: <数据集名称> from local path <路径>.
Target runtime: cloud A100 x1, max 8 hours.
Need a local smoke run first, then a full cloud run.
Keep the claims bounded by this compute budget.Use the empirical-paper-writer skill.
Topic: <主题>.
Mandatory datasets: <数据集名称>.
Target platform: AutoDL / Lambda / Slurm cluster.
Generate experiments/, configs/default.yaml, and an experiments README for cloud execution.
Assume I will run the jobs myself and then use results-backfill after real CSVs are available.说明:
- 这个 skill 可以按你的数据集和算力预算来设计实验。
- 这个 skill 不会自动替你开云主机或提交云端任务。
- 真实结果仍然需要在 AI 会话外跑出,并写入
paper/results/。
共享脚本引擎
.codex/skills/arxiv-paper-writer/scripts/ 包含两个写作技能共用的核心脚本:
| 脚本 | 用途 |
|------|------|
| arxiv_registry.py | arXiv 元数据/BibTeX 缓存(SQLite) |
| compile_paper.py | LaTeX 编译(latexmk 或 pdflatex+bibtex) |
| citation_policy.py | 引用审计(bib/tex 一致性、lint) |
| source_ranker.py | 来源质量评分 |
| style_profile.py | 目标期刊/会议风格检查 |
| issue_workflow.py | Issue 执行辅助 |
| bootstrap_ieee_review_paper.py | 搭建 IEEEtran 项目骨架 |
| create_paper_plan.py | 从大纲生成论文计划 |
| validate_paper_issues.py | 校验 issues CSV 完整性 |
跨技能共享工具(paper_utils.py、source_policy_utils.py)位于 .codex/skills/_shared/。
不可违反的规则
- 审批前不写正文 —
main.tex在计划获批且 issues CSV 存在前只保留骨架。 - Issues CSV 是合同 — 按 issue 更新状态;仅在满足验收标准时标记
DONE。 - 引用必须验证 — 每条引用在写入
ref.bib前都要通过在线来源核实。 - 严禁捏造 引用、结果或显著性声明。
公开 Showcase
这份公开仓库只保留两个精选项目:
| 项目 | 类型 | 它展示了什么 | 建议先看 |
|------|------|--------------|----------|
| projects/rt-inflow-forecast-closed-loop | 实证论文 | 选题框架、实验设计工件、本地数据集接入、已验证结果文件、结果图,以及回填后的论文 | README.md、paper/main.pdf、paper/results/、experiments/README.md |
| projects/peft-survey-2022-2026 | 综述论文 | 选题框架、plan 审批、issues 驱动写作、文献组织、引用核验后的综述草稿与最终论文 | README.md、main.pdf、plan/、issues/ |
如果你只想最快看明白:
- 先看
projects/rt-inflow-forecast-closed-loop/README.md,理解实证路线。 - 再看
projects/peft-survey-2022-2026/README.md,理解综述路线。 - 想看完整工作流解释,再读
BEGINNER_WORKFLOW.zh-CN.md。
项目结构
latex-paper-skills/
├── .codex/skills/
│ ├── paper-from-zero/ # 路由层:选题 → 写作技能
│ ├── arxiv-paper-writer/ # 综述论文执行器 + 共享脚本
│ ├── empirical-paper-writer/ # 实验论文执行器
│ ├── results-backfill/ # 将真实结果回填到草稿
│ ├── latex-rhythm-refiner/ # 文本润色器
│ ├── collaborating-with-claude/ # Claude Code 桥接
│ ├── collaborating-with-gemini/ # Gemini CLI 桥接
│ ├── check-collaborators/ # CLI 健康检查
│ ├── _shared/ # 跨技能共享工具
│ └── _orchestration/ # 工作流编排配置
├── projects/
│ ├── rt-inflow-forecast-closed-loop/ # 实证论文 showcase
│ └── peft-survey-2022-2026/ # 综述论文 showcase
├── picture/ # README 用 SVG 图表
├── ARCHITECTURE.md # 详细架构分析
├── BEGINNER_WORKFLOW.zh-CN.md # 工作流入门指南
├── README.md
└── README.zh-CN.md相关
- 基于 renocrypt/latex-arxiv-SKILL 修改而来
- 工作流受 appautomaton/agent-designer 启发(issue-driven development)
- 使用 IEEEtran LaTeX 文档类
Star History
License
本仓库采用 MIT License。
