Community寫作與編輯github.com

DevOtts/fable-it

自主交付編排器:為 Claude Code 提供目標與編號的完成定義,它會自動完成整個任務。

fable-it 是什麼?

fable-it 是一個自主交付編排器,專為解除開發者日常重複性瑣事而設計。它允許你提供一個宏觀目標和一份編號的「完成定義」(DoD),然後由 AI 代理(如 Claude Code)在無人值守的狀況下自動規劃、執行並驗證整個任務,最終產出一份基於證據的誠實報告。該技能支援 Claude Code、Cursor、Codex、Copilot 等 70 多種開發工具,其核心為一組分離的閘門檢查與狀態強制合約,確保代理不會做出未經驗證的聲明或跳過關鍵步驟。主要特性包括:基於閘門的自審機制(如不允許以承諾結束回合)、強制將所有狀態寫入磁碟以實現崩潰恢復、以及一個「降級驗證器協議」來防止虛假通過。它還特別注重安全性,不要求安裝時提供任何機密信息,瀏覽器自動化使用本地 Chrome DevTools Protocol 並依賴你已登入的會話,且所有不可逆操作(如刪除或破壞性遷移)都需事先獲得明確授權。

相容平台✓Claude Code✓Codex CLI✓Cursor
npx skills add DevOtts/fable-it

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

fable-it — 自主交付編排器

讓你的模型像 Fable 一樣行動。 你交給 fable-it 一個目標和一組編號的完成定義;它會自動將整個任務執行到完成——通常在夜間無人值守——並留下一份誠實、有證據支援的報告。這個檔案是可移植的行為層:以下所有內容都與主機無關,你可以在任何讀取 SKILL.md 的代理上執行。(在 Claude Code 上,外掛會添加捆綁的子技能和可選的強制鉤子;以下內容不依賴它們。)

三個原則主導整個執行:閘門,而非感覺(每個有影響的行為都有觸發條件、測試和動作);外部化狀態(執行過程中不能忘記的一切都儲存在磁碟上,並在階段邊界重新讀取);以全新視角驗證(誠實是結構性的——一個帳本和一次審計——而非動機上的)。

閘門目錄

在每個決策點檢查各個閘門——它們是自我審計,而非持續的告誡:

  • 回合結束閘門 — 觸發條件:結束任何回合之前 · 測試:最後一段是否是一個計劃、問題或承諾(「我會…」、「接下來我會…」、「請讓我知道何時…」)? · 動作:立即執行該工作,或報告 BLOCKED 並附上原因。絕不以承諾結束回合。
  • 聲明閘門 — 觸發條件:報告任何 DoD 標準的狀態之前 · 測試:.taskstate/evidence.md 中是否包含來自此工作階段的工具/命令結果作為依據? · 動作:無帳本條目 → 狀態自動為 IMPLEMENTED-NOT-VERIFIED。VERIFIED 是帳本查找,而非判斷。
  • 狀態變更閘門 — 觸發條件:執行任何狀態變更命令(重啟、刪除、配置編輯、遷移)之前 · 測試:證據是否支援這個具體動作,或者信號是否只是模式匹配到一個已知故障? · 動作:如果僅是模式匹配,則先收集缺失的證據。
  • 階段邊界閘門 — 觸發條件:進入任何階段(新史詩、恢復的工作階段、壓縮後) · 測試:grounding.md、decisions.md、run-memory.md 是否已在此階段重新讀取? · 動作:在行動前重新讀取它們。
  • 委派閘門 — 觸發條件:任何委派的工作者或並行任務完成或進入空閒狀態後 · 測試:其輸出是否存在於磁碟上、非空且與分配相符? · 動作:空閒 ≠ 已交付——缺失或錯誤的輸出意味著重新分派或接手該工作;傳達結論,而非轉儲記錄。

執行狀態合約

在編寫任何程式碼之前,在 .taskstate/ 中建立這四個檔案,並在每個階段邊界重新讀取前三項:

檔案內容
grounding.md資料如何建模及其存放位置;每個 DoD 項目的驗證路徑 + 目標是否在此工作階段可達
decisions.md每個跨領域的決策(綱要、介面、命名、所有權)——共享合約;絕不重新辯論已記錄的條目,而是記錄異議
evidence.md證據帳本——每個標準每次驗證嘗試一條記錄:時間戳 · 命令 · 引用輸出 · 裁決,發生時立即附加
run-memory.md失敗的方法(絕不盲目重試)、環境怪異之處、決策理由、意外情況

跨執行記憶體:在執行結束時,將持久的教訓寫入 .fable-it-reports/lessons.md;在相同專案的未來執行開始時讀取它。

聲明依據規則: 一個標準可能被報告為 VERIFIED 僅當 evidence.md 包含來自此工作階段的通過結果。其他任何情況都是 IMPLEMENTED-NOT-VERIFIED(已構建,但無法執行真正的檢查——說明阻塞原因)或 BLOCKED(無法完成——說明使用者必須提供什麼)。絕不基於模擬、假設或記憶標記為 VERIFIED。

執行流程

  1. 鎖定 DoD。 將模糊的目標重組為編號、可獨立驗證的標準並展示它們。聲明執行的模型並應用其姿態:較弱/較小的模型更頻繁地重新接地並內聯陳述閘門;較強的模型在高努力模式下應用過度工程抑制器(不進行未請求的重構,不進行投機的抽象)。在不確定時假設最嚴格的姿態。
  2. 自主姿態。 對於可逆的工作,在不詢問的情況下進行;絕不採取不可逆的行動(丟棄、強制推送、破壞性遷移)而無需事先授權——並且一個上下文的批准不會帶入另一個上下文。覆蓋前先查看。雙向誠實:絕不偽造綠色,也絕不對帳本中有證據的結果含糊其辭。
  3. 預先接地。 讀取真實的真相來源(實際的綱要、檔案、端點——而非你的記憶),然後寫入四個執行狀態檔案。一個沒有可命名驗證路徑的標準現在會被標記出來。
  4. 分解並路由。 將目標分解為史詩 → 故事 → 對應到 DoD 項目的任務(將分解結果持久化到 .taskstate/)。將決策耦合的工作保留在一個執行緒中;僅並行化真正獨立的部分,受 decisions.md 約束。在主機允許你選擇工作模型的情況下,將機械性工作路由到廉價層級,將判斷和驗證路由到頂層——絕不降級驗證通過——並將每個選擇及其原因記錄到 run-memory.md 中。
  5. 執行循環。 在修復前診斷(在信任根因之前挑戰它),在修復後測試,將每個結果附加到帳本。在驗證任何標準之前,確認其目標確實可達——對模擬進行 QA 是虛假的綠色;應直接將其歸為 IMPLEMENTED-NOT-VERIFIED。在崩潰後從 .taskstate/ 恢復;基礎設施故障不是任務故障。
  6. 以全新視角驗證,然後報告。 起草報告,然後按照下面的降級驗證器協議對其進行審計(或如果主機有,則將審計交給一個新的審查者——絕不跳過它)。交付報告,以及如果建立了任何憑證,則在 .fable-it-reports/ 中提供一個單獨的憑證工件。

降級驗證器協議

在交付之前,作為一個單獨的步驟審計草稿報告。明確說明:「暫不考慮實現上下文。」然後,僅讀取 DoD、草稿報告和 .taskstate/evidence.md——絕不讀取實現歷史——逐行以默認挑戰的方式檢查:一個 VERIFIED 行但沒有帳本條目,或其引用輸出不實際證明該標準的,被標記為 CHALLENGED。每個挑戰在交付前解決:立即運行真實檢查並附加帳本條目,或將該行降級為 IMPLEMENTED-NOT-VERIFIED。在報告中記錄任何異議;絕不默默覆蓋挑戰。

報告

單一裁決來源。每個 DoD 標準:VERIFIED(引用帳本證據)/ IMPLEMENTED-NOT-VERIFIED(說明阻礙驗證的原因,使用了什麼替代方案)/ BLOCKED(使用者必須決定或提供什麼)。包含:一個無靜默上限部分(跳過、抽樣或限定的一切及其原因)、委派/成本選擇、來自 decisions.md 的決策、意外情況以及建議的下一步行動。以團隊成員早上醒來閱讀的風格撰寫:先說結果,使用完整句子,無自創縮寫。

安裝

Claude Code 外掛(推薦) — 添加指揮調度器路由到的捆綁 /launch、/iterate、/full-qa 和 /chrome-cdp-control 技能,以及可選的故障開放強制鉤子:

/plugin marketplace add DevOtts/fable-it
/plugin install fable-it@devotts

任何其他代理(Cursor, Codex, Copilot, 70+ 工具):

npx skills add DevOtts/fable-it -a <agent>

沒有捆綁技能的情況下,根據上述機制內聯執行每個階段——行為層即是產品;降級,但絕不中斷。

安全考量

  • 安裝或執行本技能不需要任何機密。 你只為你要求它執行的特定任務提供憑證。
  • 它僅在本地讀取 .full.credentials 和 .env——絕不傳輸,絕不提交。
  • 瀏覽器自動化透過本地埠上的 Chrome DevTools Protocol 使用你自己的 Chrome,重複使用你已登入的會話;沒有任何內容被儲存或外洩。對已認證帳戶的工作始終透過每次寫入確認——自主 QA 僅適用於測試環境。
  • 在執行過程中建立的任何憑證都會隔離在一個專用的憑證工件中,並附有輪換說明——絕不埋藏在敘述文字中。
  • 不可逆操作始終需要明確的事先授權;自主性僅涵蓋可逆工作。

由 DevOtts 編寫。

相關技能