Claude Code 學術工作流：多代理審閱與品質門禁的可分叉模板
專案速覽：為學術界使用 LaTeX/Beamer + R 準備的 Claude 程式碼範本。多代理審查、品質門、對抗性 QA 和複製協議。
秒懂
- 它是什麼？
- 一個即取即用的可分叉基礎，用於在講座、論文、資料分析和複現套件上使用 Claude Code，配備專業代理、對抗性 QA 和強制品質閾值。
- 適合誰用？
- 該模板的價值在於它如何形式化審閱：專業代理、共享發現模式、幻覺門禁，以及使品質檢查難以繞過的預提交鉤子。README 記錄了設計與局限，但並未建立獨立的基準測試或生產效能。
- 可以商用嗎？
- 可以。MIT 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
- 還在維護嗎？
- 有在維護。儲存庫最近一次提交在 22 天前。
- 用什麼語言寫的？
- 主要是 HTML（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月15日）與我們的分析，不構成法律意見。
開源專案深度解析
模板包含的內容
該倉庫是一個可分叉的起點，用於在學術工作中使用 Claude Code。根據 README，它涵蓋講座幻燈片、研究論文、資料分析和複現套件。你描述一個目標，Claude 規劃方法、運行專業代理、修復問題、驗證品質並呈現結果。該專案提取自一門實際博士課程（艾默理大學的 Econ 730：因果面板資料），並由分叉使用者社群擴展。README 列出了 18 個代理、52 項技能、32 條規則和 7 個鉤子作為目前清單，但這些數字以可展開詳情的形式呈現。
./scripts/validate-setup.sh 會列出缺少的工具 這個細節把專案用途與一般同類工具區分開來，也界定了讀者可以合理期待的範圍。
claude-code-my-workflow 第 1 節的實際判斷，必須回到 pedrohcgs/claude-code-my-workflow README 的具體入口。可先記下這一節提到的命令、檔案、資料格式或外部服務，再觀察產出是否與文件相符。這一步也能分開作者自報的能力和素材沒有交代的部分，避免把一次成功執行理解成所有環境都能得到相同結果。
第 1 節若要把 claude-code-my-workflow 放進日常工作，還要看它對網路、桌面系統、模型、帳號或特定版本的依賴。以本節內容為檢查表，逐項保留輸入與輸出，才能知道問題來自專案本身還是環境差異。README 沒有說明的相容性，不在本文替它補上結論。
在第 1 節所涉及的情境中，最有價值的觀察不是介面是否漂亮，而是 claude-code-my-workflow 是否確實完成 README 所說的那個動作。把成功、失敗和未提供資料三種結果分開記錄，後續才有足夠依據決定是否繼續使用。
目標優先且帶強制門禁的工作流
README 描述的 v2.0 轉變是從精心設計提示詞轉向陳述目標，並讓工作迴圈在門禁下逼近目標。專業代理負責勞動，強制門禁決定工作何時足夠好，使用者則裁決它們提出的分歧。三個機制使這一點具體化：一個版本控制的預提交鉤子，在每次提交時運行表面同步和品質檢查；一個編排執行時，將工作分發給分叉代理，並透過共享發現模式歸約結果，同時帶有幻覺門禁；以及一個過程，將可辯護的替代解釋記錄為 EXPLAINED，而真正的錯誤保持故障關閉。README 指出這不是一個自主守護程式；迴圈始終由使用者或技能發起。
./scripts/install-hooks.sh、SKIP_QUALITY_GATE=1 與品質分數門檻構成具體流程 這個細節把專案用途與一般同類工具區分開來，也界定了讀者可以合理期待的範圍。
claude-code-my-workflow 第 2 節的實際判斷，必須回到 pedrohcgs/claude-code-my-workflow README 的具體入口。可先記下這一節提到的命令、檔案、資料格式或外部服務，再觀察產出是否與文件相符。這一步也能分開作者自報的能力和素材沒有交代的部分，避免把一次成功執行理解成所有環境都能得到相同結果。
第 2 節若要把 claude-code-my-workflow 放進日常工作，還要看它對網路、桌面系統、模型、帳號或特定版本的依賴。以本節內容為檢查表，逐項保留輸入與輸出，才能知道問題來自專案本身還是環境差異。README 沒有說明的相容性，不在本文替它補上結論。
在第 2 節所涉及的情境中，最有價值的觀察不是介面是否漂亮，而是 claude-code-my-workflow 是否確實完成 README 所說的那個動作。把成功、失敗和未提供資料三種結果分開記錄，後續才有足夠依據決定是否繼續使用。
代理、技能和規則清單
README 列舉了 18 個專業代理，每個檢查一個維度：proofreader 負責文法，slide-auditor 負責視覺佈局，pedagogy-reviewer 負責教學品質，r-reviewer 負責 R 程式碼，domain-reviewer 作為領域特定模板，還有包含 domain-referee、methods-referee 和 editor 的同行評審流水線。它還列出了 52 項技能，包括 /compile-latex、/deploy、/qa-quarto、/review-paper、/data-analysis、/verify-claims、/humanize、/simulation-study 和 /r-package-check 等。規則分為每次工作階段載入的始終開啟規則和基於匹配檔案類型觸發的路徑限定規則，例如針對 .tex 和 .qmd 檔案的 verification-protocol，以及針對 .R 檔案的 r-code-conventions。README 強調路徑限定使始終開啟的載入量保持在約 100 行。
Preambles/header.tex、Quarto/theme-template.scss、passport.yaml 是適配與審閱時要看的檔案 這個細節把專案用途與一般同類工具區分開來，也界定了讀者可以合理期待的範圍。
claude-code-my-workflow 第 3 節的實際判斷，必須回到 pedrohcgs/claude-code-my-workflow README 的具體入口。可先記下這一節提到的命令、檔案、資料格式或外部服務，再觀察產出是否與文件相符。這一步也能分開作者自報的能力和素材沒有交代的部分，避免把一次成功執行理解成所有環境都能得到相同結果。
第 3 節若要把 claude-code-my-workflow 放進日常工作，還要看它對網路、桌面系統、模型、帳號或特定版本的依賴。以本節內容為檢查表，逐項保留輸入與輸出，才能知道問題來自專案本身還是環境差異。README 沒有說明的相容性，不在本文替它補上結論。
在第 3 節所涉及的情境中，最有價值的觀察不是介面是否漂亮，而是 claude-code-my-workflow 是否確實完成 README 所說的那個動作。把成功、失敗和未提供資料三種結果分開記錄，後續才有足夠依據決定是否繼續使用。
驗證與品質閾值
品質以 0-100 分制評分，有三個文件化的閾值：80 用於提交，90 用於拉取請求，95 作為理想的卓越水準。README 描述了多個驗證層：/verify-claims 使用一個從未見過草稿的分叉驗證器，具有嚴重性分級和 HIGH-WARN 門禁，該門禁會阻止 /commit 以應對偽造引用；/audit-reproducibility 將數字聲明與指令碼輸出交叉核對，並維護 passport.yaml 狀態檔案；/humanize 以唯讀方式檢測 AI 語音痕跡；/review-paper --variance N 報告決策分佈而非單一結果。透過 ./scripts/install-hooks.sh 安裝的預提交鉤子在每次提交時運行表面同步和品質（>=80）檢查，並可透過 SKIP_QUALITY_GATE=1 或 git commit --no-verify 進行單次提交跳過。
./scripts/validate-setup.sh 會列出缺少的工具 這個細節把專案用途與一般同類工具區分開來，也界定了讀者可以合理期待的範圍。 第3節補充
claude-code-my-workflow 第 4 節的實際判斷，必須回到 pedrohcgs/claude-code-my-workflow README 的具體入口。可先記下這一節提到的命令、檔案、資料格式或外部服務，再觀察產出是否與文件相符。這一步也能分開作者自報的能力和素材沒有交代的部分，避免把一次成功執行理解成所有環境都能得到相同結果。
第 4 節若要把 claude-code-my-workflow 放進日常工作，還要看它對網路、桌面系統、模型、帳號或特定版本的依賴。以本節內容為檢查表，逐項保留輸入與輸出，才能知道問題來自專案本身還是環境差異。README 沒有說明的相容性，不在本文替它補上結論。
在第 4 節所涉及的情境中，最有價值的觀察不是介面是否漂亮，而是 claude-code-my-workflow 是否確實完成 README 所說的那個動作。把成功、失敗和未提供資料三種結果分開記錄，後續才有足夠依據決定是否繼續使用。
先決條件與快速開始
分叉該模板的最低要求是 Claude Code、git 和 Python 3（macOS 和 Linux 預裝）。要端到端執行包含的 HelloWorld 演示，你還需要 XeLaTeX（用於 Beamer 示例）和 Quarto（用於 Quarto 示例）。推薦使用 R 和 GitHub CLI，並且 TikZ 轉 SVG 需要 pdf2svg。快速開始涉及分叉倉庫、克隆它，然後執行 ./scripts/validate-setup.sh，該指令碼報告缺失的工具並提供安裝連結。然後啟動 Claude Code 並貼上一個起始提示詞，要求它讀取設定檔並根據你的專案進行調整。README 指出，如果只需要 Python、R 或 markdown，可以跳過 LaTeX 和 Quarto 演示，因為代理、規則和技能適用於任何文字或程式碼工件。
./scripts/install-hooks.sh、SKIP_QUALITY_GATE=1 與品質分數門檻構成具體流程 這個細節把專案用途與一般同類工具區分開來，也界定了讀者可以合理期待的範圍。 第4節補充
claude-code-my-workflow 第 5 節的實際判斷，必須回到 pedrohcgs/claude-code-my-workflow README 的具體入口。可先記下這一節提到的命令、檔案、資料格式或外部服務，再觀察產出是否與文件相符。這一步也能分開作者自報的能力和素材沒有交代的部分，避免把一次成功執行理解成所有環境都能得到相同結果。
第 5 節若要把 claude-code-my-workflow 放進日常工作，還要看它對網路、桌面系統、模型、帳號或特定版本的依賴。以本節內容為檢查表，逐項保留輸入與輸出，才能知道問題來自專案本身還是環境差異。README 沒有說明的相容性，不在本文替它補上結論。
在第 5 節所涉及的情境中，最有價值的觀察不是介面是否漂亮，而是 claude-code-my-workflow 是否確實完成 README 所說的那個動作。把成功、失敗和未提供資料三種結果分開記錄，後續才有足夠依據決定是否繼續使用。
將模板適配到新領域
README 列出了七個自訂步驟：用你的記號和應用填寫知識庫模板；使用領域特定視角自訂 domain-reviewer 代理；更新 Preambles/header.tex 和 Quarto/theme-template.scss 中的顏色調色盤，並執行 check-palette-sync.sh 驗證一致性；將領域特定的 R 陷阱新增到 r-code-conventions.md；填寫 beamer-quarto-sync.md 中的講座對映；自訂工作流快速參考；以及設定 explorations/ 資料夾用於實驗性工作。調色盤同步被描述為雙表面契約，因為忘記一個表面會導致 Beamer 和 Quarto 渲染不匹配。
Preambles/header.tex、Quarto/theme-template.scss、passport.yaml 是適配與審閱時要看的檔案 這個細節把專案用途與一般同類工具區分開來，也界定了讀者可以合理期待的範圍。 第5節補充
claude-code-my-workflow 第 6 節的實際判斷，必須回到 pedrohcgs/claude-code-my-workflow README 的具體入口。可先記下這一節提到的命令、檔案、資料格式或外部服務，再觀察產出是否與文件相符。這一步也能分開作者自報的能力和素材沒有交代的部分，避免把一次成功執行理解成所有環境都能得到相同結果。
第 6 節若要把 claude-code-my-workflow 放進日常工作，還要看它對網路、桌面系統、模型、帳號或特定版本的依賴。以本節內容為檢查表，逐項保留輸入與輸出，才能知道問題來自專案本身還是環境差異。README 沒有說明的相容性，不在本文替它補上結論。
在第 6 節所涉及的情境中，最有價值的觀察不是介面是否漂亮，而是 claude-code-my-workflow 是否確實完成 README 所說的那個動作。把成功、失敗和未提供資料三種結果分開記錄，後續才有足夠依據決定是否繼續使用。
起源、社群與版本管理
該基礎設施提取自艾默理大學的 Econ 730：因果面板資料，由 Pedro Sant'Anna 在六次或更多 Claude Code 工作階段中開發。該課程產生了六個博士講座系列，包含超過 800 張幻燈片，帶有 plotly 圖表的互動式 Quarto 版本，以及完整的 R 複現套件。截至 2026 年 3 月，README 稱已有 15 多個研究小組（涵蓋經濟學、能源、政治學和工程學）分叉了該模板，並列出了擴充套件工作流，如 Hugo Sant'Anna 的 clo-author、Chris Blattman 的 claudeblattman、Scott Cunningham 的 MixtapeTools、Andrej Karpathy 的 autoresearch 和 ClaudeCodeTools。README 還記錄了寬鬆的語義化版本策略，並指向 CHANGELOG.md 和 CONTRIBUTING.md。許可證為 MIT，授予使用、複製、修改、合併、發布、分發、再授權和出售副本的權利，並明確宣告不提供任何保證；README 本身並未聲稱任何特定的安全性或生產就緒性。
./scripts/validate-setup.sh 會列出缺少的工具 這個細節把專案用途與一般同類工具區分開來，也界定了讀者可以合理期待的範圍。 第6節補充
claude-code-my-workflow 第 7 節的實際判斷，必須回到 pedrohcgs/claude-code-my-workflow README 的具體入口。可先記下這一節提到的命令、檔案、資料格式或外部服務，再觀察產出是否與文件相符。這一步也能分開作者自報的能力和素材沒有交代的部分，避免把一次成功執行理解成所有環境都能得到相同結果。
第 7 節若要把 claude-code-my-workflow 放進日常工作，還要看它對網路、桌面系統、模型、帳號或特定版本的依賴。以本節內容為檢查表，逐項保留輸入與輸出，才能知道問題來自專案本身還是環境差異。README 沒有說明的相容性，不在本文替它補上結論。
在第 7 節所涉及的情境中，最有價值的觀察不是介面是否漂亮，而是 claude-code-my-workflow 是否確實完成 README 所說的那個動作。把成功、失敗和未提供資料三種結果分開記錄，後續才有足夠依據決定是否繼續使用。
編輯結論
該模板的價值在於它如何形式化審閱：專業代理、共享發現模式、幻覺門禁，以及使品質檢查難以繞過的預提交鉤子。README 記錄了設計與局限，但並未建立獨立的基準測試或生產效能。
社群筆記