Nov 1, 2026
fork 整套学术流水线:18 个代理、10 道门禁、一条入门提示
pedrohcgs 的 2k 星模板把一套博士生课程在生产中打磨出的 Claude Code 配置打包开源——课程幻灯、论文、R 分析、复现包,配 18 个评审代理、十道回测门禁和对抗式批评-修复循环。
学术产出是多制品、重评审的活儿:幻灯不能溢出、论文不能写错数字、复现包必须真能跑起来。claude-code-my-workflow 是一个 2k 星、MIT 许可的模板,把一位经济学教授在生产中使用的配置(从一门博士生课程中提炼)整体导出——你直接 fork 整条流水线,不必逐个攒技能。
为什么这个 Skill 重要
模板的清单是具体的:18 个代理、61 个技能、37 条规则、11 个 hook(README 的 What's Included 一节自己给出的数目)。代理按评审维度分工——proofreader 管语法、slide-auditor 管版式、pedagogy-reviewer 管教学质量、r-reviewer 管 R 代码,另有 domain-reviewer/domain-referee/methods-referee/editor 组成的论文评审流水线。学科配置预装了经济学与政治学;其余领域由 fork 者通过期刊画像和学科卡片扩展。
信任机制才是它的差异点。一条命令——./scripts/backtest.sh——运行十道门禁,README 逐一列出:surface-sync、技能完整性、模型与唯一事实源的一致性、链接与锚点解析、Agent Skills 规范符合性、过期检查、仓库卫生、派生计数、台账覆盖,以及一组预置失败样例的 hook 测试,它会把每个现役守卫 hook 针对的失败场景重新触发一遍。安装一次 pre-commit hook 后,每次提交都会跑全套门禁加质量检查(分数 ≥ 80),绕过技能就绕不过评审。每个制品都会拿到 0–100 的质量分,阈值是:80 可提交、90 可开 PR、95 属于卓越。
安装
README 的快速开始假定已有 Claude Code、git 和 Python 3;XeLaTeX 与 Quarto 用于自带示例,R 和 GitHub CLI 属于推荐:
git clone https://github.com/YOUR_USERNAME/claude-code-my-workflow.git my-project
cd my-project
./scripts/validate-setup.sh
validate-setup.sh 会精确报告缺什么,并附安装链接。然后启动 Claude Code,粘贴完整指南里的 starter prompt,填上项目名和两三句描述。Claude 会读取全部配置文件、适配你的项目,然后进入 contractor 模式——复杂请求会先起草一份带 MUST/SHOULD/MAY 优先级和明确性状态(CLEAR/ASSUMED/BLOCKED)的需求规格书供你批准。用两个示例调用验证环境:/compile-latex HelloWorld 编译 Beamer 样例,/deploy HelloWorld 渲染 Quarto 样例。两个都成功后,删掉示例、开始真正的活儿。
实战:对论文做同行评审
评审流水线是这些代理的主场。/review-paper --peer <journal> 让论文走完审稿流水线——加上 --variance N 会以不同抽样倾向运行 N 个审稿人并报告决策分布而非点估计,README 把这一设计追溯到一项 AgentReview 发现:37% 的审稿决策差异纯粹来自倾向抽样。
对抗式 QA 在背后兜底:critic 同时读 Beamer 和 Quarto 制品并给出严厉的发现,fixer 严格按 critic 的发现逐条实现修复,两方循环直到连续两轮不再有新发现(5 轮上限只是兜底,不是主要停止条件)。投稿前还有三个验证技能各司其职——/verify-claims 用从未见过草稿的全新上下文验证器复核(编造的引用和数值矛盾一律判定为失败)、/audit-reproducibility 把论文中每个数字断言与其来源脚本的输出交叉核对并在 passport.yaml 里记录逐条状态、/humanize 标记 AI 腔调——按设计只读不改。
技巧
- 先 fork 再克隆——快速开始假定你用的是自己的 fork,因为模板本来就该被改出差异。
- 只用 Python/R/Markdown?README 说可以完全跳过 XeLaTeX 与 Quarto,直接用
/data-analysis、/review-paper、/lit-review或/review-r。 - 门禁对自己的边界很诚实:README 把 git-guardrails 与 root-of-trust hook 描述为尽力而为的文本绊线,出错时放行(fail open)——把它们理解为「换了一条通道」,而不是一把锁。
/compress-session和/promote-memory管理跨会话上下文;提交进仓库的MEMORY.md收录对每个 fork 者都有用的经验,机器相关的笔记留在本地。- 完整指南在 psantanna.com/claude-code-my-workflow,仓库的
guide/目录存放其源文件。
何时不用这个 Skill
预装的学科画像是经济学与政治学——README 只点名这两个,其余靠 fork 者扩展。实验室科学或人文背景的读者可以用这套机制,但期刊规范要先自行适配。而如果你的产出是代码库而非文档——没有幻灯、没有论文——一套带代码评审的通用 CI 流水线用更少的配置给你同等的保护;这里的门禁审计的正是学术产出实际交付的那些制品(幻灯、论文等)。
查看 排行榜 了解更多 skill。