命令行工具
pedrohcgs/claude-code-my-workflow avatar
pedrohcgs/claude-code-my-workflow

claude-code-my-workflow:给学术工作流的 Claude Code 模板,用门禁而不是提醒来保证质量

项目速览:为学术界使用 LaTeX/Beamer + R 准备的 Claude 代码模板。多代理审查、质量门、对抗性 QA 和复制协议。

1,584 个 Star3,033 个 ForkHTMLMIT

秒懂

它是什么?
这是一个为学者设计的 Claude Code 模板,把 LaTeX/Beamer、R 和 Quarto 的日常工作流打包成可复制的仓库。它的核心不是提示词,而是一套用脚本强制执行的检查门禁。
适合谁用?
这个模板适合那些已经在用 LaTeX 或 Quarto 写论文、做幻灯片,并且愿意花时间学习一套固定工作流的学者。它不适合只用 Markdown 写简单文档的人,也不适合想要完全自由控制 AI 行为的用户。
能商用吗?
可以。MIT 是宽松许可证:你可以使用、修改并销售基于它的软件,只需保留版权和许可证声明。
还在维护吗?
在维护。仓库最近一次提交在 22 天前。
用什么语言写的?
主要是 HTML(依据 GitHub 的语言统计)。

以上回答依据项目的 GitHub 数据(最近同步于 2026年9月15日)和我们的分析,不构成法律意见。

开源项目深度解析

它解决的是学术写作中的“最后一公里”问题

学术写作的痛点不是生成初稿,而是反复修改后的质量失控。幻灯片里引用了过期的数据,论文的链接失效,R 代码重新运行结果不一致,这些细节在人工审查时容易被忽略。claude-code-my-workflow 把这些问题变成可自动检查的门禁。它面向的是使用 LaTeX/Beamer 做幻灯片、用 R 做数据分析、用 Quarto 写文档的学者,以及需要复现性研究的科研人员。作者从一门生产环境的博士课程中提取了这个模板,所以它带有一线教学场景的痕迹,而不是一个玩具示例。

目标优先,门禁强制:v2.0 的设计转变

模板的设计思路在 v2.0 版本发生了改变。作者不再要求用户写一个完美的提示词,而是让用户陈述目标,然后由工作循环在门禁的约束下逐步逼近。专门的智能体负责执行,强制性的门禁决定何时算完成,用户只裁决它们之间的分歧。关键点在于“真正的门禁,而不是提醒”。一个命令 ./scripts/backtest.sh 会运行十项检查,包括表面同步、技能完整性、模型时效性、链接和锚点解析、Agent Skills 规范符合性、过时性检查、仓库卫生、派生计数、账本覆盖,以及一个种子钩子电池。最后一项意味着每个启用的守卫钩子都会针对它要防止的故障重新触发,同时运行干净对照。这比单纯让 AI 自我检查要可靠得多。

安装与首次运行:克隆、验证、粘贴提示词

安装过程是标准的 fork 流程。先克隆仓库到本地,然后运行 ./scripts/validate-setup.sh 检查缺失的工具,它会报告缺少什么并给出安装链接。之后启动 Claude Code,粘贴一个起始提示词,描述你的项目。模板默认的 .claude/settings.json 设置了 bypassPermissions 模式,包含 7 条通配规则,几乎不会弹出任何确认。这是刻意的电源用户默认值,但如果你觉得不安全,可以改成 default 模式或删除覆盖。验证环境的方式是运行 /compile-latex HelloWorld 和 /deploy HelloWorld,分别编译 Beamer 示例和 Quarto 示例。如果成功,就可以删除示例文件开始真实工作。整个过程大约 5 到 10 分钟,首次安装依赖可能需要额外 30 分钟。

记忆机制:提交的 MEMORY.md 与本地记忆的区分

模板有一个值得注意的记忆分层。MEMORY.md 是提交到仓库的文件,收集通用的 [LEARN] 条目,这些条目对所有 fork 该仓库的人都有用。而机器特定的笔记则存储在 Claude Code 的原生自动记忆中,路径是 ~/.claude/projects/<project>/memory/,这部分永远不会提交。这个区分有实际意义:如果你在多台机器上工作,通用知识可以共享,但本地路径、特定环境变量这些敏感信息不会进入版本库。规则文件 .claude/rules/meta-governance.md 明确解释了这个区别。对于研究团队,这种分离可以避免把个人配置意外推送到公共仓库。

一个真实的失败模式:默认权限模式的风险

模板默认开启 bypassPermissions,这意味着几乎所有的 Bash 命令、文件编辑和写入操作都不会询问。作者明确说这是故意的,但这也意味着如果你在一个不受信任的仓库上运行,或者提示词被恶意构造,AI 可以执行破坏性命令。仓库提供了一个 git-guardrails 钩子来阻止危险的 git 操作,比如 reset --hard、clean -f、push --force 和 add -A,并且会拒绝在树不干净时进行合并、rebase 或 pull。但这个钩子只保护 git 操作,不能防止其他类型的破坏。如果你不信任自己的提示词或输入数据,这个默认设置就是错误的选择。另一个限制是:模板的检查脚本依赖 Python 3,虽然 macOS 和 Linux 预装,但 Windows 用户可能需要额外配置。

替代方案:Anthropic 的 /init 命令与自定义工作流

如果你不想采用这套模板,最直接的替代是 Anthropic 内置的 /init 命令。它会从你的代码库重新推导一个 CLAUDE.md 作为起点。区别在于:/init 是自底向上的,从现有代码生成规则,而 claude-code-my-workflow 是自顶向下的,预设了一套学术工作流规则。如果你的项目是 Python 或机器学习项目,不使用 LaTeX 或 Quarto,那么 /init 可能更合适,因为模板自带的规则会显得多余。另一个选择是手动编写自己的 CLAUDE.md 和钩子脚本,但这样你失去了十项门禁检查的集成。模板的价值在于这些检查是经过实战测试的,而不是临时拼凑的。

维护与许可:活跃更新,但需要跟上节奏

仓库的最近发布记录显示维护活跃,v2.5.1 在 2026 年 8 月 24 日发布,距离 v2.5.0 仅一天,说明修复节奏很快。CHANGELOG.md 记录了每次变更,社区贡献者也在扩展功能。如果你 fork 了这个仓库,长期维护的代价是:每次上游更新,你可能需要合并冲突,尤其是如果你修改了规则文件或脚本。MIT 许可允许你自由使用和修改,甚至闭源,但注意许可不提供任何担保。如果你是独立学者,可能没有精力持续跟进每个版本,那么最好定期查看 CHANGELOG.md,只合并你认为重要的更新。

编辑结论

这个模板适合那些已经在用 LaTeX 或 Quarto 写论文、做幻灯片,并且愿意花时间学习一套固定工作流的学者。它不适合只用 Markdown 写简单文档的人,也不适合想要完全自由控制 AI 行为的用户。在采用之前,先运行 ./scripts/validate-setup.sh 确认你的环境是否满足要求,然后阅读 .claude/rules/meta-governance.md 理解 MEMORY.md 与本地记忆的区别。如果你接受默认的 bypassPermissions 模式,请明确知道这意味着几乎所有操作都不会询问,你需要自己评估风险。模板的维护依赖社区更新,MIT 许可允许你随意修改,但如果你长期偏离主线,未来的更新可能需要手动合并。最终判断:这是一套有明确质量标准的模板,但它的价值取决于你是否愿意遵守它的门禁规则,而不是绕过它们。

官方来源

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
社区笔记

社区笔记