EvanFlow 是一個透過 Claude Code 實現的、以測試驅動開發 (TDD) 為核心的迭代回饋循環，用於軟體開發。

16 種整合技能加上 2 種自訂子代理，引導一個想法從構思、規劃、執行到迭代，並在過程中設置檢查點，讓您全程掌控。單一進入點：說「let's evanflow this」，協調器就會啟動循環。

TDD 並非執行階段之後的一個獨立階段 — 它是每次寫碼任務內部的紀律。執行是框架（任務追蹤、阻礙、品質檢查）；evanflow-tdd 則是在任何產生生產程式碼的任務中運行的部分。

這個循環是協調者，而非自動駕駛儀：在設計審批、規劃審批以及迭代之後都有實際的檢查點。代理會在每次 git 操作前停止，並等待您的指示。沒有自動提交。沒有強制性的儀式。沒有「必須調用技能」的額外成本。

推薦路徑 — Claude Code 的外掛市集：

「Let's evanflow this — 我想新增一個執行 X 功能的小功能。」

evanflow-go 會被觸發並引導您完成循環。git-guardrails hook 會隨外掛自動啟用（無需編輯 settings.json）。技能會出現在 evanflow: 命名空間下（例如 /evanflow:evanflow-go）。

請參閱下方的安裝說明，了解兩種替代路徑。

這個循環圍繞著在迭代中不斷累積的紀律而建構，而非單次生成。每個步驟都有一個檢查點來決定下一步：

對於包含 3 個以上真正獨立單元的規劃，循環會分叉成並行的程式設計師/監督者協調：每個單元一個程式設計師（使用帶有 RED 檢查點的垂直切片 TDD），每個程式設計師一個監督者（唯讀審查子代理，無法修改程式碼），再加上一個整合監督者，在每次接觸點運行命名的整合測試。整合測試是可執行的合約 — 如果雙方都必須滿足相同的通過測試，介面就不會漂移。

以下每條規則都引用了其來源。如果缺少引用，該規則是透過在真實專案中運行循環產生的意見，而非研究 — 並標記為如此。

在 agents/ — 透過 Agent 工具並指定 subagent_type: 參數調用：

hooks/block-dangerous-git.sh — PreToolUse hook，阻止破壞性的 git 操作（ git push , git reset --hard , git clean -f , git branch -D , git checkout . , git restore . ）。透過外掛安裝路徑自動啟用。

三種路徑，按優先順序排列。所有三種路徑最終都會在您的 .claude/skills/ 中獲得相同的技能集。外掛路徑額外自動連接 guardrail hook。

這是最乾淨的安裝方式。技能、代理以及 guardrail hook 都會自動啟用。

重新啟動 Claude Code（或 /reload-plugins ）。技能會以 /evanflow:evanflow-go , /evanflow:evanflow-tdd 等命名空間出現。無論命名空間如何，「let's evanflow this」的自動調用仍然有效。

若要解除安裝：/plugin uninstall evanflow@evanflow 。

適用於任何具有 SKILL.md 形狀資料夾的 GitHub 儲存庫。僅安裝技能 — 不安裝 guardrail hook 或自訂子代理（如果您想要，可以手動添加）。

這會將技能放置在 ~/.claude/skills/（全域）或 .claude/skills/（專案，自動偵測）下。

適用於希望完全控制、無 CLI 依賴的使用者。

然後在您的 .claude/settings.json 中註冊 hook：

可選地，將 examples/CLAUDE.md.snippet 貼入您專案的 CLAUDE.md 中，以向 Claude 簡介 EvanFlow 的慣例。

「Let's evanflow this — 我想新增一個執行 X 功能的小功能。」

evanflow-go 應該會被觸發並引導您完成循環。若要驗證 guardrail hook（僅限路徑 1 和 3）：嘗試從 Bash 工具運行 git reset --hard HEAD — 它應該會被「BLOCKED: ... matches dangerous pattern」的訊息阻止。

每個技能都有一個清晰的結構，包含一個 ## Hard Rules 部分。若要適應您的專案：

這些技能的設計是可編輯的。將它們視為起點，而非絕對真理。

如果您 fork 以製作特定於供應商的變體（your-name-flow），那就太好了 — 這正是精神所在。

跨領域：當上下文變得繁重時，evanflow-compact 會在乾淨的邊界運行。

特殊用途技能（ evanflow-debug , evanflow-improve-architecture , evanflow-design-interface , evanflow-glossary , evanflow-prd , evanflow-qa , evanflow-review ）會在流程中相關時被引入。

影響設計的行業研究：

歡迎提出問題和拉取請求。EvanFlow 的設計是意見導向的 — 增加儀式或自動操作的提案將被禮貌拒絕。進一步減少儀式、銳化規則或添加基於證據的改進的提案非常受歡迎。

一個以 TDD 為驅動的軟體開發迭代回饋循環。16 種整合的 Claude Code 技能，引導一個想法從構思 → 規劃 → 執行 → 迭代，並在過程中設置檢查點。