Claude Code 学术工作流模板
为学者打造的 Claude Code 模板,内置多智能体审查、质量门禁和对抗性 QA,适用于 LaTeX/Beamer、Quarto 和 R 的研究工作流。
- Star 数
- ★ 1.7k
- 最近更新
- 9 天前
- License
- MIT
- 主语言
- HTML
- FA 评分
- 71/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用Claude Code
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 经济学或政治学教授需要为博士课程制作 LaTeX/Beamer 幻灯片,可使用 /create-lecture 技能,该技能会规划结构、生成内容,并通过 slide-excellence 进行多代理审查。
- 不适合
- 不使用 Claude Code 或不愿订阅 Anthropic 模型的用户
- 只处理纯文本、不想安装 XeLaTeX/Quarto/R/Python 的用户
- 希望开箱即用、不愿阅读 50+ 技能与 30+ 规则文档的新手
- 官网
- psantanna.com/claude-code-my-workflow ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-07最新版本 v2.9.2(2026-11-07)近 7 天每天 +3.6 ★
- 源码审查
- 71/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
这是一个可直接复刻的 Claude Code 配置模板,专为使用 LaTeX/Beamer、Quarto 和 R 进行学术工作的研究者设计。它提供了一套完整的承包商模式工作流:用户描述目标,Claude 规划方案、调用专业代理执行、修复问题、验证质量并呈现结果。包含 18 个专业代理(如 proofreader、slide-auditor、pedagogy-reviewer、r-reviewer、domain-reviewer 等)、52 个技能(如 /create-lecture、/review-paper、/data-analysis、/qa-quarto 等)、32 条规则和 7 个钩子,实现了目标优先、门禁强制的工作方式。该模板支持多代理审查、对抗性 QA(批评者-修复者循环)、质量评分(0-100,提交门槛 80 分)、上下文持久化(MEMORY.md、会话日志)和验证纪律(/verify-claims、/audit-reproducibility、/humanize)。它源自 Emory 大学经济学博士课程,支持经济学和政治学等领域的预配置,并可通过知识库和领域审查员扩展到其他学科。
该仓库通过 Claude Code 实现自动化学术工作流。用户通过 CLI 启动 Claude,提供一个起始提示,Claude 读取 .claude/ 目录下的配置文件(CLAUDE.md、规则、技能、代理),进入计划模式,然后执行技能(如 /create-lecture)来生成幻灯片、论文、数据分析或复制包。它运行 18 个专业代理,每个代理负责一项审查任务(例如 proofreader 检查语法,slide-auditor 检查视觉布局,r-reviewer 检查 R 代码质量),通过编排运行时(orchestrator-protocol)进行扇出-汇总-判断循环,直至没有新问题。质量门禁(80/90/95 分)由 /commit 技能和预提交钩子强制执行。对抗性 QA(/qa-quarto)让批评者和修复者循环直到没有新发现。技能还包括 /review-paper(带裁判分歧报告的模拟同行评审)、/audit-reproducibility(检查手稿中的数值声明与脚本输出)、/verify-claims(事实核查)和 /humanize(检测 AI 风格)。它支持 R 和 Stata 管道,并包含蒙特卡洛模拟(/simulation-study)和 R 包发布门禁(/r-package-check)。输出包括编译后的 PDF(通过 /compile-latex)、HTML 幻灯片(通过 /deploy)和发布就绪的复制包。
- 经济学或政治学教授需要为博士课程制作 LaTeX/Beamer 幻灯片,可使用 /create-lecture 技能,该技能会规划结构、生成内容,并通过 slide-excellence 进行多代理审查。
- 研究生正在撰写研究论文,可使用 /lit-review 查找文献,使用 /review-paper --peer 运行模拟同行评审,并使用 /verify-claims 在提交前验证所有引用。
- 应用计量经济学家进行数据分析,使用 /data-analysis 运行端到端 R 管道,生成出版级输出,并通过 /audit-reproducibility 验证数值声明。
- 研究员准备复制包,使用 /replication-package 组装一个符合 AEA 标准的数据集、环境快照(/capture-environment)和声明溯源护照。
- 助理教授向期刊提交论文,使用 7-pass-review 进行对抗性审查,并使用 /humanize 检测 AI 风格痕迹,然后再进行投稿。
- 研究员设计蒙特卡洛研究,使用 /simulation-study 创建参数化 DGP、估计器网格和蒙特卡洛 SE,并由 sim-reviewer 进行审查。
如何安装或部署这个 Agent?
- 在 GitHub 上 Fork 仓库 pedrohcgs/claude-code-my-workflow。2. 克隆你的 fork:
git clone https://github.com/YOUR_USERNAME/claude-code-my-workflow.git my-project && cd my-project。3. 运行 ./scripts/validate-setup.sh 检查所需工具(Claude Code、git、Python 3;XeLaTeX、Quarto、R 可选)。4. 运行 ./scripts/install-hooks.sh 安装预提交钩子,用于质量门禁和 git 防护。
如何使用这个 Agent?
- 在项目目录中启动 Claude Code:claude。2. 粘贴指南中的起始提示(https://psantanna.com/claude-code-my-workflow/workflow-guide.html),填写你的项目名称和描述。3. Claude 读取配置,进入计划模式,并规划方法。4. 批准计划并调用一个技能,例如 /create-lecture、/data-analysis 或 /review-paper。5. 技能运行实施-验证-审查-修复-重新验证-评分循环,返回摘要。6. 使用 /commit 提交更改,预提交钩子运行质量门禁。对于完全自主运行,可使用 --permission-mode acceptEdits 或 Bypass 模式。
这个 Agent 有哪些优点和局限?
- 内置 18 个专业代理,每个代理针对一个特定的审查维度(如 proofreader、slide-auditor、r-reviewer),比通用审查更深入。
- 通过预言钩子和预提交钩子强制执行质量门禁,确保即使绕过技能,审查也不会被跳过。
- 对抗性 QA(批评者-修复者循环)和模拟同行评审(带裁判分歧报告的 --variance N)可发现单遍审查遗漏的错误。
- 包含验证纪律层(/verify-claims、/audit-reproducibility),可防止虚构引用和数值不一致。
- 平台特定于 Claude Code,要求用户拥有 Claude 订阅或 API 访问权限,并依赖 Anthropic 模型。
- 学习曲线陡峭:超过 50 个技能和 30 条规则需要时间熟悉;新用户可能被配置压倒。
- 需要 XeLaTeX、Quarto、R 和 Python 等外部依赖,对于仅处理文本的用户可能显得繁重。
- 文档庞大(指南、CHANGELOG、生态),必须花费时间阅读才能有效使用。
这个 Agent 与同类方案有什么区别?
该模板从由 Pedro Sant'Anna 开发的 Emory 大学课程中提取,其生态包括类似工具:clo-author(用于论文导向的研究工作流)、claudeblattman(针对非技术型学者)、MixtapeTools(关于演示修辞)、autoresearch(自主研究)、ClaudeCodeTools(顺序审查协议)。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Claude Code 学术工作流模板 当前 | 71 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 1.7k | 9 天前 | HTML | Claude Code |
| FAROS 自动研究运行时 | 51 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 3k | 27 天前 | Python | — |
| nWave | 80 · 表现良好 | Agent 插件 / 技能免费 + 模型费 | ★ 636 | 今天 | Python | Codex · Claude Code |
| AI求职助手 | 84 · 表现良好 | 命令行工具免费 + 模型费 | ★ 72k | 1 天前 | Python | Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
AGENTS.md 明确禁止破坏性 Git 操作、要求检查重复 issue,并要求敏感数据留在本机;README 说明 Claude Code 对凭证文件和部分危险命令的拒绝规则。但 README 也披露广泛的 Edit/Write/Bash allow 规则,且这些限制不是安全边界、部分绕过写法可行,Codex 等环境不会自动执行 Claude 的拒绝规则,因此最小权限仅部分落实。用户批准计划、显式 /commit 和 PR 门槛提供确认机制;例外是质量门可由 SKIP_QUALITY_GATE 或 --no-verify 绕过。文件说明 hooks、门禁、定时任务及其读写范围;许可证与只读 CI 工作流显示外部影响有界,但提交、GitHub issue/PR 和计划任务可能产生外部效果。README 明确无恢复未提交或未跟踪内容的机制,故回滚偏弱。依赖安全检查有门禁和 CI,但材料未展示依赖漏洞扫描或已知风险缓解。许可证、文档来源和提交信息规则有说明,发布者身份仍未知。
README、AGENTS.md 和 CI 配置共同描述门禁与提交检查,且对哪些未限定的检查不应作为证据有所说明;但这些材料只是静态样本,不能证明当前运行结果。安装说明列出 Python、XeLaTeX、Quarto 等要求和缺失项检查脚本。工具不可用时的处理有具体例子,如 issue-guard 在 Python 缺失时拒绝 gh 命令,其他 hooks 的失败开放边界也有披露;仍未覆盖所有故障情形。
材料具体面向学术研究,覆盖讲课、论文、R/Stata/Python 分析、复现和教学,并标出预置学科及扩展方向。它清楚说明不是自主守护进程、部分技能仅适用于 Claude Code,Codex/Antigravity 通过生成包装器使用技能,且 Claude 专属防护不适用。触发说明包括明确命令、场景与触发条件,但代表性技能样本有限。环境要求和不同平台的限制写得较细,同时不少能力依赖 Claude Code、Quarto、XeLaTeX、Python 或其他外部工具。
README、CLAUDE.md、AGENTS.md、技能、规则、脚本、指南和质量报告职责清晰,信息架构充分。快速开始、安装验证、示例项目及命令提供了可操作说明。技能命名整体稳定且有生成同步机制,但本次只提供少量包装器,无法核对全量命名一致性。指南、示例、社区扩展和故障排查有覆盖,但所给材料中 FAQ 与完整示例有限。README 对防护盲区、绕过方式、不可恢复内容、未验证检查、非自治边界和工具需求作了明确披露。MIT 许可证文本完整。README 提及多个版本和 changelog,但未提供 changelog 本身,版本历史只能部分核对。文档把维护与 PR 入口指向发布者及协作者规则,但具体维护责任和更新承诺有限;发布者身份未知,不据此扣分。
工作流描述了可交付的学术产物、质量检查、复现审计和多角色评审,适合直接作为研究项目模板。相对单一通用提示词,专业技能、共享发现格式、门禁和复现协议提供明显增量价值。部署需要多种工具和较复杂配置,质量分数与门槛又被说明为部分咨询性且可绕过,日常成本收益仍取决于项目规模和环境。
README 将主要机制指向具体规则、脚本、技能、质量账本及模型版本单一来源,AGENTS.md 也要求报告真实运行内容;但这些文件未全部包含在样本中,故无法逐项追溯。README、AGENTS.md、CLAUDE.md、CI 配置和测试样本在门禁、范围和边界上相互印证,但部分只在 README 中概述,且无完整运行记录。文档区分目标、示例、咨询性阈值和已限定的事实,并明确说门禁不能判断事实真伪;这支持事实与推断的区分,但本评估仍是静态审阅。
- Claude Code 的广泛命令许可和已披露的绕过路径不构成安全边界;其他 Agent 也不会自动继承 Claude 的拒绝规则。处理受限数据前应核对实际运行环境及规则。
- 门禁和质量分数不能证明研究结论真实;材料明确指出即使通过回测也可能包含虚构姓名、来源或版本。关键事实需独立核验。
- 缺少 Python 等工具时,部分 hook 行为会拒绝操作,其他 guard 也有失败开放或覆盖盲区;README 还说明未提交及未跟踪内容没有恢复保障。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
Small fixes found during and after the v2.9.1 work, in compaction, in /commit and /verify, and in the git pre-commit hook. Nothing to migrate. Fixed - pre-compact.py read log-reminder.py's notes as decisions (#189). - The newest session log is usually that hook's own YYYY-MM-DD_auto.md. Its Slides/X.tex → no fresh .pdf lines matched the → decision pattern, so a compaction could carry "no fresh .pdf" into the summary and the restored context as a recent decision. …在 GitHub 查看 ↗ -
v2.9.1 v2.9.1 — a lighter hook layer
发布说明摘录
A lighter hook layer. The two guard hooks that ran before every Bash call, and a third that ran after it, slowed everyday work and refused ordinary commands too often. They are gone. Claude Code's own permission deny rules now refuse destructive git, and one small hook, started only for a merge, pull or rebase, refuses those while tracked files have uncommitted changes. The template also stops setting the block that kept Claude from editing its own settings files. Upgrading — read this before you pull into a fork …在 GitHub 查看 ↗ -
v2.9.0 v2.9.0 — adoption release
发布说明摘录
An adoption release carrying what the 2026-11-06 audit found worth building or linking. Everything in it is additive: a new skill, new scripts and a template, guidance, and links to outside work, each listed below. Added - The ledger-coverage gate understands an inline hook launcher. scripts/check-ledger-coverage.py reads sh -c '<code>' <name> <script> as running <script>, so a settings file that starts its hooks through the launcher drafted for #179 and #180 is still checked hook by hook. A typo in the launcher's script path is still caught, and a launcher with no script f …在 GitHub 查看 ↗
常见问题
这个模板是否只适用于经济学?
它的运行成本是多少?
它是否在每次提交时自动运行?
如果我没有 LaTeX 或 Quarto,可以使用它吗?
它如何处理会话之间的上下文?
Claude Code 学术工作流模板 官网是什么?
Claude Code 学术工作流模板 免费吗?
Claude Code 学术工作流模板 开源吗?
Claude Code 学术工作流模板 安全吗?
Claude Code 学术工作流模板 还在维护吗?
Claude Code 学术工作流模板 是谁开发的?
谢谢反馈,我们会据此改进页面。