1160 Installation C9ec8bdf

安装

前置要求

在安装 Academic Writing Skills 之前，请确保您已安装：

1. Claude Code CLI：Claude Code 官方命令行界面
2. LaTeX 发行版：可用的 LaTeX 安装
   • macOS：MacTeX
   • Windows：MiKTeX 或 TeX Live
   • Linux：TeX Live（通过包管理器）
3. Python 3.8+：技能脚本所需

验证前置要求

# 检查 Claude Code
claude --version

# 检查 LaTeX
pdflatex --version
xelatex --version

# 检查 Python
python --version  # 或 python3 --version

安装方法

有两种方式安装这些技能：使用 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：手动安装

1. 克隆仓库：

   git clone https://github.com/bahayonghang/academic-writing-skills.git
   cd academic-writing-skills
   

2. 将技能复制到 Claude Code 的技能目录：

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/"

验证安装

安装后，通过检查目录验证技能是否可用：

# Linux / macOS
ls ~/.claude/skills/

# Windows (PowerShell)
Get-ChildItem "$env:USERPROFILE/.claude/skills"

# 您应该看到：
# - latex-paper-en
# - latex-thesis-zh
# - typst-paper

安装可选依赖

ChkTeX（推荐）

ChkTeX 提供 LaTeX 格式检查：

# macOS（通过 Homebrew）
brew install chktex

# Ubuntu/Debian
sudo apt-get install chktex

# Windows（通过 MiKTeX）
mpm --install=chktex

latexmk（推荐）

latexmk 自动化 LaTeX 编译并处理依赖：

# 通常包含在 TeX Live/MacTeX 中
# 如果不可用：

# macOS（通过 Homebrew）
brew install latexmk

# Ubuntu/Debian
sudo apt-get install latexmk

# Windows
# 包含在 MiKTeX 和 TeX Live 中

Biber（用于现代参考文献）

Biber 是现代 BibLaTeX 后端：

# 通常包含在 TeX Live/MacTeX 中
# 如果不可用：

# macOS（通过 Homebrew）
brew install biber

# Ubuntu/Debian
sudo apt-get install biber

# Windows
# 包含在 MiKTeX 和 TeX Live 中

配置

LaTeX 编译器优先级

技能将自动检测并按以下顺序使用可用的编译器：

对于英文论文（latex-paper-en）：

1. pdfLaTeX（推荐用于纯英文论文）
2. XeLaTeX（用于 Unicode/国际字符）
3. LuaLaTeX（XeLaTeX 的替代方案）

对于中文论文（latex-thesis-zh）：

1. XeLaTeX（推荐用于中文文档）
2. LuaLaTeX（中文的替代方案）
3. pdfLaTeX（不推荐用于中文）

自定义配置

您可以通过编辑技能文件来自定义技能行为：

# 编辑英文论文技能配置
nano ~/.claude/skills/latex-paper-en/SKILL.md

# 编辑中文论文技能配置
nano ~/.claude/skills/latex-thesis-zh/SKILL.md

更新

更新到最新版本，重新克隆仓库并再次复制 skill 文件夹：

git clone https://github.com/bahayonghang/academic-writing-skills.git
cd academic-writing-skills

# 然后使用上面对应平台的命令复制 skills

卸载

移除技能：

Linux / macOS

rm -rf ~/.claude/skills/latex-paper-en
rm -rf ~/.claude/skills/latex-thesis-zh

Windows (PowerShell)

Remove-Item -Recurse -Force "$env:USERPROFILE/.claude/skills/latex-paper-en"
Remove-Item -Recurse -Force "$env:USERPROFILE/.claude/skills/latex-thesis-zh"

故障排除

"LaTeX not found" 错误

问题：编译失败，提示 "command not found: pdflatex"

解决方案：

1. 验证 LaTeX 已安装：which pdflatex
2. 将 LaTeX 添加到 PATH：

   # macOS（MacTeX）
   export PATH="/usr/local/texlive/2024/bin/universal-darwin:$PATH"
   
   # Linux（TeX Live）
   export PATH="/usr/local/texlive/2024/bin/x86_64-linux:$PATH"
   

"Python not found" 错误

问题：技能脚本失败，提示 "python: command not found"

解决方案：

1. 安装 Python 3.8+
2. 创建符号链接：ln -s /usr/bin/python3 /usr/local/bin/python
3. 或在技能脚本中显式使用 python3

权限被拒绝错误

问题：安装失败，提示 "permission denied"

解决方案：

# 修复权限
chmod -R 755 ~/.claude/skills/

# 或使用 sudo 进行系统级安装
sudo claude skill install ...

下一步

• 快速开始指南 - 几分钟内上手
• 使用指南 - 学习如何使用技能
• 核心技能模块 - 了解可用技能及工作流

获取帮助

• 文档：浏览本站获取指南和参考
• GitHub Issues：报告错误或请求功能
• 社区：在 GitHub 上加入讨论