Fable Harness
一套隨插即用的行為協議，讓 Claude Code（Opus / Sonnet / Haiku）像個有紀律的工程師一樣工作——動手前先查證、把假設講清楚、重大結論先找人挑戰過再採信、用真正的測試證明改動有效。
English · 繁體中文 · 简体中文 · 日本語 · 한국어
這是什麼
Fable Harness 是一個小型套件——幾個 hooks、一個 skill、幾個子代理——會在每次開啟 Claude Code session 時自動注入。它不會教 Claude 新招式，而是確保 Claude 每一次都照著一套有紀律的流程走：先蒐集證據再回答、把假設講出來而不是用猜的、對自己的重大結論先自我挑戰，並且拿出真正的證據（而不是「看起來沒問題」）證明改動真的有效。
可以把它想成是「行為的底線」，不是完整的開發框架。它不會幫你排 sprint、不會幫你跑 CI 流程——它做的是在 agent 工作的過程中，讓它保持誠實、謹慎、可驗證。
為什麼會有這個 kit
本專案蒸餾自第二次的 Fable 開放版本（Anthropic 的 Fable 模型）——那種謹慎、有紀律的做事方式。與其把這份紀律鎖在單一模型裡，這個 kit 把它提煉成一套可重複使用的協議，用來強化 Opus（以及其他 Claude 模型）身邊的工作架構，讓不管是哪個模型在主導，都能維持同一套紀律。
誠實說在前面：hooks 和 skill 只能移植「程序」本身（先蒐證、講假設、交叉質疑結論、要求驗證證據），沒辦法移植一個模型天生的判斷力。但實務上，「表現得好」跟「表現得隨便」之間的落差，大多來自程序被跳過，而不是判斷力不足。這正是這個 kit 想補上的落差。
運作機制
- OODA 迴圈——回答前，Claude 先蒐集證據（實際搜尋/讀取檔案，不靠訓練記憶亂猜），把假設講出來，把任務轉成一個可驗證的目標（「讓它能動」這種說法不夠），然後小步修改、每一步都驗證。
- 多方抗辯（adversarial review）——這個 kit 最具特色的機制。在採信一個重大結論之前（架構決策、根因判定、任何可能影響上線環境的結論），Claude 會同時派出三個獨立的「反方」子代理，各自負責不同角度：skeptic 專找邏輯漏洞、red-team 專找安全與失效風險、simplifier 專找不必要的過度工程。三個鏡頭裡要過半「存活」（沒被推翻），結論才算採信。
- 模型分工——推理、架構設計、根因分析留給當下主導的模型；寫程式、重構、上網查資料交給 Sonnet；批次檔案處理、repo 內搜碼、格式轉換交給 Haiku。用剛好合適的模型做剛好合適的事。
- 省 token 是這套架構的副產品——成本的節省是同一套架構自然帶出來的，不是外掛的功能。上面那套分級路由已經讓貴模型的 token 只花在推理、把粗重工作推給便宜的模型；在這之上，抗辯三反方與 Explore 式搜尋都跑在獨立子代理裡，各自握有一份乾淨的 context、只回收一段精簡結論——過程的大量中間 token 因此被丟棄，不會滾雪球累積進主對話。而這些子代理是平行 fan-out、各自只帶少量 context，而不是在一條越拉越長的對話裡堆疊。這種「分級路由＋獨立子代理」的形狀，是業界公認能壓低 LLM token 成本的做法——Fable 自己尚未做基準量測，所以這裡講的是「為什麼會省」，不是承諾某個百分比。
- 完成定義（Definition of Done，TDD）——只要改到實際邏輯，就要有自動化測試，並且證明「改之前測試會失敗、改之後測試會通過」。單純看輸出順不順眼，或隨手一個
console.log，都不算驗證。 - 誠實回報——任何回報的第一句話就是實際結果（不是鋪陳），失敗就照實講，不美化。
裡面有什麼
| 元件 | 檔案 | 作用 |
|---|---|---|
| 行為協議 | .claude/hooks/fable_protocol.md + inject_protocol.sh | 每次 session 開始時注入 |
| 每輪微提醒 | .claude/hooks/prompt_nudge.sh | 使用者每則訊息都會被注入一行提醒 |
| 驗證關卡 | .claude/hooks/verify_gate.py | 若這輪改了程式碼卻沒跑測試，擋下收工一次（第二次會放行）。經 shell 改碼（sed -i、重導向、tee）與 Edit／Write 同樣算數 |
| 接線關卡 | .claude/hooks/wiring_gate.py + wiring_runner.sh + precommit_shell.sh（scripts/install_precommit.sh） | 各專案自行 opt-in：當 .claude/wiring-guards 裡列出的守衛永遠不會真的被執行時，擋下 commit。測試會過、卻從來不在任何執行路徑上的東西，不算完成。未 opt-in 的 repo 若已經在寫這類守衛，會在下次 session 開場提示一次（只提示，不擋） |
| 目標關卡 | .claude/hooks/goal_gate.py | 計數同一個目標連續失敗的測試執行次數：達到 2 次時要求在下一次嘗試前進行抗辯審查；達到 3 次時擱置該項目、由關卡自己寫下擱置紀錄，並在你一回來時就擺到你面前 |
| 多方抗辯 | .claude/skills/adversarial-review/ | 定義上述三反方審查流程的 skill |
| 反方子代理 | .claude/agents/{skeptic,red-team,simplifier}.md | 抗辯流程用的三個獨立子代理角色 |
| 模型分工 | CLAUDE.md | 上面提到的分工表 |
| harness 偵測器 | scripts/detect_harness.py | 只讀檢查——這個專案是不是已經有自己的開發 harness（例如 harnessmith、Superpowers），有的話 Fable 就退居底線角色 |
| 健檢 | scripts/fable_doctor.py | 回報五個 hook 各自解析到哪個直譯器、上次何時真的跑過、已複製的 skill 與 agents 是否仍與 repo 相同、記錄的版本有沒有落後 |
| 治理文件 | .claude/skills/model-dispatch-rules/、.claude/skills/cognitive-rubrics/ | 子代理派工範本、何時該慢下來的判斷準則 |
快速開始
把這個 repo clone 下來，然後跟你的 Claude Code 說：「照 INSTALL.md 安裝 Fable Harness。」 Claude 會自己讀說明並安全地完成安裝（先備份、絕不覆蓋你既有的設定）。詳細會做什麼請看 INSTALL.md。
僅在 Windows 實測。 安裝流程、五個 hook 與fable_doctor.py目前只在 Windows 跑過端到端；macOS 與 Linux 預期可用（INSTALL.md 的直譯器探測有對應分支），但尚未實跑驗證。若你在這兩個平台安裝，python scripts/fable_doctor.py --home ~ --repo會告訴你每個 hook 各自解析到哪個直譯器、是不是從這一份 clone 註冊的，以及會留下 marker 的那兩支上次何時觸發。
版本規則
本 kit 採用語意化版本（Semantic Versioning）——主版本.次版本.修訂號，自 1.0.0 起：
- 主版本（MAJOR）——協議契約的破壞性改動（移除或改名 hook／skill／agent，或改變協議注入方式、子代理派工方式且不相容），使用者需重裝或調整設定。
- 次版本（MINOR）——向後相容的新增（新的 hook、skill、agent 或治理規則），既有安裝可照常運作。
- 修訂號（PATCH）——向後相容的修正或措辭調整（hook 修 bug、規則講清楚、錯字）。