baskduf/FableCodex

什麼是 FableCodex？

FableCodex 是一個 Codex 插件，為任何您要求 Codex（程式碼生成模型）執行的任務添加嚴謹且基於證據的工作流程。它不會讓模型無限制地編輯檔案，而是讓 Codex：

分類行動前的請求。
檢視目前的工作區與任何參考來源。
使用適當的 Codex 原生工具（例如檔案編輯、測試執行器），而非依賴記憶。
追蹤多階段目標清單，記錄每個檢查點的證據。
收集審查發現，並在明確解決前保持開放狀態。
驗證結果，使用測試、linter、型別檢查、截圖、命令輸出等。
報告哪些變更、哪些已驗證，以及剩餘的風險。

此插件 不修改 底層模型、其權重或其安全系統——僅添加程序性指導與本地記帳。

哪些人可能需要使用它？

適合情境	不適合情境
多階段實作、重構或遷移	一行修復或微小編輯
難以重現的錯誤除錯	簡單的腦力激盪或想法產生
CI 失敗、發行工作、安全敏感變更	頂額外開銷超過效益的任務
發現必須阻擋完成的審查	快速「看一眼就說完成」的回答
已有 Codex 模型存取權限並希望更嚴格流程的團隊	無 Codex 結合的使用者

使用者如何控制工作流程？

控制完全透過您傳送給 Codex 的 提示（prompt） 實現，使用 @codex-fable5 標籤。範例：

嚴格模式 – 完成前需完整目標清單、發現門禁與驗證：

@codex-fable5 Run this strictly.
Use a goal ledger, record any review findings, and do not finish until tests and findings gate pass.

僅分析 – 不編輯檔案，僅報告發現：

@codex-fable5 Analyze only.
Do not edit files. Give findings with file and line references.

有限實作 – 可編輯但不提交、推送或刪除分支：

@codex-fable5 Implement the fix.
Do not commit, push, or delete branches.
Run unit tests and report any residual risk.

除錯 – 先重現，保持多個假設，收集反證，再修復：

@codex-fable5 Debug this failure.
Reproduce it first, keep multiple hypotheses, gather disconfirming evidence, then fix and verify.

核心概念

目標清單（Goal Ledger）

本地儲存在 .codex-fable5/goals.json。
使用 codex-fable5 goals create … 建立，指定簡要描述與子目標清單。
每個子目標透過 codex-fable5 goals checkpoint … 標記為完成/失敗，需提供證據（例如「讀取檔案 X，更新測試」），並可選附驗證命令及其輸出。

發現門禁（Findings Gate）

透過 codex-fable5 findings add … 將審查問題記錄於 .codex-fable5/findings.json 中。
問題需透過 codex-fable5 findings resolve … 明確解決，且需提供驗證證據，否則保持開放狀態。
codex-fable5 findings gate 在存在高嚴重性或阻塞問題時中止最終完成。

快速開始（來自 README）

# 安裝最新穩定版
codex plugin marketplace add baskduf/FableCodex --ref v0.5.1
codex plugin add codex-fable5@fablecodex

# 重新啟動 Codex，然後在提示中呼叫該技能
@codex-fable5 Use this skill to implement the change.
Create a goal ledger if the work has multiple steps.
Track findings before final completion.
Run the project tests before saying it is done.

輕量版本跳過清單：

@codex-fable5 Review this quickly.
Do not create a goal ledger. Check the key evidence and report only actionable findings.

命令參考（摘要）

命令	功能
`codex-fable5 status`	顯示目前目標與發現
`codex-fable5 goals create …`	啟動新的多階段清單
`codex-fable5 goals next`	顯示下一個待處理目標
`codex-fable5 goals checkpoint …`	用證據標記目標為完成/失敗
`codex-fable5 findings add …`	記錄審查發現
`codex-fable5 findings resolve …`	用驗證證據關閉發現
`codex-fable5 findings gate`	若存在開放/阻塞發現則失敗
`codex-fable5 update`	拉取插件最新穩定標籤

其他功能

覆蓋率計算 – 若擁有原始 CLAUDE-FABLE-5.md 源文件，輔助腳本可驗證每個來源標題是否都有對應決策（已實作、已適應、不支援或 N/A）。
可選提供者橋接 – 提供透過 Anthropic 或 OpenAI 相容閘道（如 LiteLLM）路由請求的文件。插件本身 不包含 任何模型憑證。
本地狀態 – 所有清單與事件日誌均位於 .codex-fable5/ 下，設計為 暫時性；僅在有意保留永久記錄時才提交。

許可與社群

採用 AGPL-3.0-or-later 許可。
被社群技能清單如 antigravity-awesome-skills 和 awesome-agent-skills 所收錄。
歡迎貢獻；README 中顯示貢獻者徽章。

TL;DR

FableCodex 是 Codex 程式碼生成模型的 流程導向封裝器。透過讓模型遵循檢查清單式工作流程（目標清單、證據檢查點、發現門禁、自動驗證），它幫助團隊在大型或安全敏感的程式碼變更中避免遺漏步驟，同時完全保持在 Codex 生態系統內。