academic-writer

核心用法

academic-writer 是一款专为 WSL2/Linux 环境设计的学术写作 Agent Skill，完整覆盖从模板分析到 PDF 编译的论文生命周期。其核心工作流包括：首先通过 scan_template 扫描并识别当前目录的 LaTeX 模板结构（如 IEEE、ACM 等会议模板），确保后续写作严格遵循格式规范；其次利用 read_reference 读取用户提供的 Word、文本或 Markdown 参考资料作为写作依据；然后通过 write_latex 起草各章节内容，支持追加或覆盖模式；最后调用 compile_pdf 使用 latexmk 自动编译生成 PDF。对于需要外部引用的场景，该 Skill 支持与 academic-research-hub 联动，实现文献检索、BibTeX 获取与引文插入的闭环。

显著优点

1. 模板强制遵循：自动识别 .cls 文件和主文档结构，避免用户因不熟悉 LaTeX 宏包而破坏格式，特别适合需要投稿特定期刊/会议的研究者。
2. 多格式输入支持：原生支持 .docx、.txt、.tex、.md 等多种参考格式，降低已有素材的迁移成本。
3. 编译自动化：集成 latexmk 实现多轮编译与错误检测，自动处理交叉引用和参考文献，减少手动调试时间。
4. 跨 Skill 协作：明确设计了与 academic-research-hub 的调用协议，避免虚构引用，确保学术诚信。
5. 错误恢复机制：编译失败时返回详细日志，支持定位修复后重新编译，提升迭代效率。

潜在缺点与局限性

1. 环境依赖沉重：需要完整安装 texlive-full（4-7GB）和 Python 虚拟环境，首次部署成本高，对存储空间有限的用户不友好。
2. 平台限制：明确针对 WSL2/Ubuntu 设计，Windows 原生或 macOS 环境需要额外适配。
3. 无实时预览：缺乏类似 Overleaf 的所见即所得编辑体验，用户需反复编译查看效果。
4. 模板覆盖风险：write_latex 的覆盖模式若误操作可能导致已有内容丢失，虽可通过版本控制缓解，但 Skill 本身无内置备份机制。
5. 中文支持未明确：文档未提及 CJK 处理方案，中文论文可能需要额外配置 ctex 等宏包。

适合的目标群体

• 高校科研人员：需要频繁撰写符合特定期刊格式要求的学术论文，尤其是计算机、数学、物理等 LaTeX 主流学科。
• 研究生与博士生：导师提供模板后，可快速上手完成毕业论文或投稿论文的排版工作。
• 技术写作团队：企业内部需要维护标准化技术白皮书或文档的工程师团队。
• LaTeX 初学者：希望通过自然语言交互降低 LaTeX 学习曲线，同时保证输出质量的用户。

使用风险

1. 性能风险：texlive-full 编译大型文档时内存占用较高，低配设备可能出现卡顿；首次编译需加载大量宏包，耗时较长。
2. 依赖项风险：latexmk 和 texlive 的版本差异可能导致模板兼容性问题，建议锁定 Ubuntu LTS 官方仓库版本。
3. 文件系统风险：Skill 具备任意路径读写能力，若运行环境未做沙箱隔离，存在误删或覆盖系统文件的理论可能。
4. Python 环境风险：虚拟环境未激活或依赖未安装将导致功能失效，需确保 python-docx 正确部署。
5. 协作冲突：多人同时编辑同一 .tex 文件时缺乏锁机制，需配合 Git 等版本控制工具使用。