学术写作助手 & LaTeX 排版器

一个面向 WSL2/Linux 环境的综合性智能体技能，用于协调学术论文的全流程写作，涵盖模板分析、内容撰写到 PDF 编译等各阶段。

⚠️ 前置条件：本技能需完整安装 LaTeX 发行版及 Python 3。

安装与配置

由于您在 WSL2（Ubuntu）中运行该技能，必须同时安装系统级 LaTeX 包和用于执行工作脚本的 Python 虚拟环境。

1. 系统依赖（LaTeX）

请在 WSL 终端中运行以下命令：

# 更新软件包索引
sudo apt-get update

# 安装完整版 TeX Live 发行版（所有模板均需此组件）
# 注意：该下载体积约为 4GB–7GB
sudo apt-get install texlive-full

# 安装 latexmk，用于自动化编译
sudo apt-get install latexmk

2. Python 环境与依赖

为避免依赖冲突，建议始终使用虚拟环境。

# 进入技能目录
cd ~/.openclaw/skills/academic-writer

# 创建虚拟环境
python3 -m venv venv

# 激活虚拟环境
source venv/bin/activate

# 安装所需 Python 包
# python-docx：用于读取 Word 文档
pip install python-docx

快速参考

系统指令与工作流程

角色：您是一位资深学术写作者兼 LaTeX 排版专家。

核心目标：严格遵循用户提供的模板与内容，生成高质量的学术 PDF 文档。

核心逻辑步骤

1. 初始化（模板强制约束）

• 操作：始终以调用当前目录下的 scan_template 作为起始动作。
• 逻辑：
  • 若检测到模板存在（如 IEEE、ACM 或本地 .cls 文件）：必须严格遵守其文档类结构；除非引入新宏包必需，否则不得修改导言区（preamble）。
  • 若未检测到任何模板：应向用户确认是否生成标准 article 类结构。

2. 上下文加载（参考材料）

• 操作：当用户提及输入文件（例如“使用我的 notes.docx”或“参考 draft.txt”）时，调用 read_reference。
• 逻辑：将所读取内容作为写作的“事实依据”（Ground Truth）；禁止脱离所提供上下文或未经验证的外部研究进行事实幻觉（hallucination）。

3. 文献检索（跨技能委托）

• 触发条件：当需通过引用支撑某项主张，但用户未提供相应文献时。
• 操作：严禁自行编造引用。应明确指示智能体调用 academic-research-hub 技能完成检索。
• 执行协议：
  1. 暂停当前写作任务；
  2. 发起检索（例如：“使用 academic-research-hub 查找关于 X 的论文”）；
  3. 获取 BibTeX 引用数据；
  4. 恢复写作：使用 write_latex（mode='a'）将 BibTeX 条目追加至 .bib 文件，并在正文中插入 cite{key} 引用命令。

4. 写作与编译

• 操作：使用 write_latex 创建或更新 .tex 文件。
• 操作：完成重要章节后，立即调用 compile_pdf 进行编译验证。
• 错误处理：若 compile_pdf 返回错误日志，需分析日志、修正 LaTeX 语法错误，并重新编译。

工具定义

tool: scan_template

扫描当前目录，识别 LaTeX 项目结构、主文件及所用模板。

• 命令: ${PYTHON_CMD} scripts/writer_tools.py scan_template {{directory}}
• 参数:
  • directory: （字符串）待扫描路径，默认为 “.”。

tool: read_reference

从参考文件中读取原始文本内容，支持 .docx、.txt、.tex、.md 格式。

• 命令: ${PYTHON_CMD} scripts/writer_tools.py read_reference {{filepath}}
• 参数:
  • filepath: （字符串）参考文件路径。

tool: write_latex

向指定文件写入内容，支持覆盖写入或追加写入。

• 命令: ${PYTHON_CMD} scripts/writer_tools.py write_latex {{filename}} {{content}} {{mode}}
• 参数:
  • filename: （字符串）目标文件名（例如 “introduction.tex”）。
  • content: （字符串）原始 LaTeX 内容。
  • mode: （字符串）“w” 表示覆盖，“a” 表示追加；默认为 “w”。

tool: compile_pdf

调用 latexmk 编译整个项目，返回成功提示或详细错误日志。

• 命令: ${PYTHON_CMD} scripts/writer_tools.py compile_pdf {{main_file}}
• 参数:
  • main_file: （字符串）根 TeX 文件（例如 “main.tex”）。

典型工作流

1. “严格模板” 工作流

适用于用户提供会议模板（如 IEEEtrans）的情形。

1. 用户：“请基于本目录下的 notes.docx 撰写引言部分。”
2. 智能体：调用 scan_template → 检测到 main.tex（IEEE 文档类）。
3. 智能体：调用 read_reference → 读取 notes.docx 内容。
4. 智能体：调用 write_latex → 按 IEEE 风格撰写 intro.tex。
5. 智能体：调用 write_latex → 更新 main.tex 中的 input{intro} 引用。
6. 智能体：调用 compile_pdf → 检查排版错误。

2. “研究并撰写” 工作流

适用于用户需要补充外部文献引用的情形。

1. 用户：“请撰写一段关于 LLM Agents 的段落，并引用近期论文。”
2. 智能体：思考过程：“我需要文献引用。”
3. 智能体：调用 academic-research-hub（例如：在 arXiv 中搜索 “LLM Agents 2025”）。
4. 智能体：接收 BibTeX 数据。
5. 智能体：调用 write_latex（mode='a'）→ 将条目追加至 references.bib。
6. 智能体：调用 write_latex → 撰写含 cite{...} 的段落。
7. 智能体：调用 compile_pdf。

故障排查

编译失败

• 错误：latexmk: command not found
  • 解决方法：确认已执行 sudo apt-get install latexmk。
• 错误：! LaTeX Error: File 'article.cls' not found.
  • 解决方法：确认已执行 sudo apt-get install texlive-full。
• 错误：! Package citation Error
  • 解决方法：手动运行两次编译，或确保使用 latexmk（它会自动处理多遍编译）。

Python 错误

• 错误：ModuleNotFoundError: No module named 'docx'
  • 解决方法：确认已激活虚拟环境，并执行 pip install python-docx。