用途
claude-code-academic-workflow 是一套基于 Claude Code 的生产级学术工作模板,用于辅助学术研究中的幻灯片制作、论文撰写与评审、数据分析及可复现性验证。它最初从一门博士课程中提炼而来,现由社区维护。该模板通过承包商模式,让用户描述目标,由 Claude 进行规划并协调多个专用智能体完成工作。
主要能力
- 承包商模式:描述想要的结果,Claude 负责规划与编排专用智能体。
- 18 个以上专注型智能体:包括校对、幻灯片审计、教学法评审、R 代码评审、领域审稿人、方法审稿人、编辑等。
- 质量门槛:评分范围 0-100,低于 80 分自动阻止提交。
- 对抗式 QA:批评者与修复者循环,直到通过或达到 5 轮。
- 验证层:断言核验、可复现性审计、AI 语气检测、多审稿人方差采样。
支持的产物:
- LaTeX/Beamer 幻灯片(XeLaTeX)
- 研究手稿(LaTeX)
- Quarto 文档(HTML/PDF)
- R 分析脚本
- 数据复现包
使用方式
安装
- 在 GitHub 上 Fork 后克隆:
git clone https://github.com/YOUR_USERNAME/claude-code-my-workflow.git my-project
cd my-project
- 验证前置条件:
./scripts/validate-setup.sh
最低要求: Claude Code(CLI 或 VS Code 扩展)、git、Python 3(macOS/Linux 预装,仅验证脚本使用)。
LaTeX/Beamer 演示需要: XeLaTeX(TeX Live 2020+)。
Quarto 演示需要: Quarto 1.3+。
R 分析需要: R 4.0+,所需包:tidyverse、fixest、modelsummary。
推荐: GitHub CLI(gh)、VS Code 及 Claude Code 扩展。
- 使用起始提示初始化:启动 Claude Code 并粘贴配置提示,让 Claude 读取
.claude/CLAUDE.md、.claude/rules/*.md、.claude/skills/*.md等配置文件,更新.claude/project.yaml中的项目元数据,并用/validate-setup验证后进入承包商模式。
关键命令(技能)
幻灯片创建与评审:
/create-lecture "Introduction to Panel Data"
/compile-latex HelloWorld
/slide-excellence Slides/MyLecture.tex
/qa-beamer Slides/MyLecture.tex --rounds 5
论文评审与核验:
/review-paper manuscript.tex --peer
/review-paper manuscript.tex --adversarial
/review-paper manuscript.tex --variance 10
/verify-claims manuscript.tex
/audit-reproducibility manuscript.tex
/humanize manuscript.tex
Quarto 工作流:
/deploy HelloWorld
/qa-quarto Quarto/MyDoc.qmd
R 分析评审:
/review-r analysis/main.R
/lit-review "fixest two-way fixed effects"
质量与可复现性:
/commit "Add panel data lecture" --require-score 80
/pr "Manuscript ready for review" --require-score 90
/compress-session
/promote-memory
模型与成本管理:
/effort high
/cost
/usage
/goal "all tests pass and manuscript score > 90"
配置文件
.claude/project.yaml:项目元数据与质量阈值(commit_threshold、pr_threshold、excellence_threshold)及路径设置。.claude/agents/:18 个以上智能体规格,如 r-reviewer。.claude/skills/:技能定义,前置元数据指定触发器、effort、context、hooks。.claude/rules/:包括 core-principles.md、latex-rules.md、quarto-rules.md、r-rules.md、meta-governance.md。.claude/hooks/:事件驱动工作流,如 PreCompact 钩子。
适用场景
- 制作 Beamer 教学幻灯片并进行质量与对抗式评审。
- 论文投稿前的多智能体同行评审、断言核验、可复现性审计与 AI 语气检测。
- R 分析脚本的代码质量评审与文献综述。
- 数据复现包的验证与提交。
限制
- 需要 Claude Code 及相应环境依赖,缺失依赖时相关功能无法使用。
- 质量评分、方差采样等结果由模型生成,需人工复核。
- 环境变量、版本兼容性(最低 Claude Code 1.9.0)等要求见文档。
- 收费、价格、平台等商业信息资料中暂未提供。