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 生态系统内。