FableCodex
为 Codex 加入证据驱动的目标、审查与完成门禁，降低复杂开发任务中的漏项风险。
按维度查看评分与理由
证据显示 CI 权限仅为 contents: read，运行状态明确写入本地 .codex-fable5/，provider bridge 被标为可选，更新命令的修改范围也有说明；安全政策禁止提交密钥及外传本地或 connector 数据。来源项目和提交均被精确署名，因此来源归属充分。扣分点是：未见强制的高影响操作确认机制，敏感数据保护主要是政策性说明而非代码级控制，GitHub Actions 仅固定到可变的主版本标签，update 会获取并切换代码但没有完整回滚流程；发布者身份仍未知，不过未据此推断风险。
README、CI 与测试在命令、Python 版本、上游固定提交和 coverage 校验流程上相互一致；测试还覆盖 PATH wrapper、版本报告、脏工作区拒绝和稳定标签选择。扣分点是未提供实际运行结果，外部上游下载、Codex 插件系统及可选 gateway 的不可用处理或离线替代说明有限；可见测试证明部分错误信息清晰，但所给材料不足以确认全部命令都有一致、可操作的故障诊断。
文档清楚区分多步骤实现、调试、迁移、安全变更等适用场景，以及短回答、小改动和头脑风暴等无需启用的场景；分析模式、严格模式、受限实现和调试模式都有精确提示词，且明确声明不改变模型权重、上下文或隐藏安全系统。扣分点是环境适配主要围绕 Codex、shell、Git 和 Python 3.11–3.13，未展示 Windows、非 Git 工作区或其他宿主的兼容性。
信息架构完整，包含快速开始、命令表、安装方式、本地状态、coverage、provider bridge、测试、来源和许可证；命名在插件、skill、wrapper 与状态目录间稳定，示例丰富，能力限制写得明确。扣分点是没有专门 FAQ 或系统化故障排除章节；README 声明 AGPL-3.0-or-later，而提供的 LICENSE 是 AGPLv3 正文，材料未展示明确的“or later”授权声明或 NOTICE 内容；版本和更新路径可见，但未提供 changelog；安全报告渠道依赖可能启用的 GitHub 私密报告，否则仅要求公开询问联系方式，维护主体和响应时限不明确。
goal ledger、findings gate、证据 checkpoint、验证命令和最终风险报告形成了可直接使用的输出结构；文档也明确指出轻量任务不值得承担 ledger 成本，体现良好的成本收益边界。扣分点是相较普通 Codex 工作流的增量价值主要由设计和示例支持，缺少静态材料中的对照研究或采用效果数据。
README 给出精确的上游仓库与提交，CI 获取同一固定来源并将其传给 coverage 校验器，测试进一步核对 README、CI pin、输出路径与验证参数的语义关联；文档明确区分工作流适配、coverage accounting 与模型能力或运行时等价性。所给静态材料在可追溯性、跨来源印证和事实/推断分离方面均有充分证据，因此未扣分；但这不代表本次进行了执行验证。
- 本评估仅基于所给静态文件，未执行测试、安装插件或验证 update、goal、finding 与 provider bridge 的实际行为。
- 安装前应审查 update 脚本和完整依赖面，并将 GitHub Actions 固定到不可变提交，而不只是 @v6 主版本标签。
- 不要把密钥写入项目文件、ledger、finding evidence 或提示词；可选 provider bridge 需要单独核验凭据存储、日志脱敏和网络去向。
- update 会改变 checkout/plugin package；操作前保留可恢复的提交或标签，并确认工作区干净，因为文档未提供完整自动回滚机制。
- 确认 AGPL-3.0-or-later 声明、LICENSE 与 NOTICE 的法律一致性，尤其是在网络服务或分发修改版本时。
这个 Agent 能做什么，适合哪些场景？
FableCodex 是一个面向 Codex 的插件，通过流程约束而非更换模型来提升复杂开发工作的可靠性。它提供 `@codex-fable5` 技能、`codex-fable5` 命令行工具，以及目标账本、审查发现和事件历史等本地状态文件。执行任务时，它要求先检查工作区和相关证据，再按需跟踪目标、登记发现，并通过测试、lint、类型检查、截图、命令输出或源码检查验证结果。目标与发现分别保存在 `.codex-fable5/goals.json` 和 `.codex-fable5/findings.json`，操作历史追加到 `ledger.jsonl`。它适合漏掉步骤代价较高的实现、调试、迁移、发布和审查任务，但不会复制 Fable 5，也不会改变模型权重、上下文长度或隐藏的安全机制。
用户在提示中调用 @codex-fable5 后，技能先对任务分类并检查工作区、文件、工具或引用来源。长任务可以通过 codex-fable5 goals create 建立多步骤账本，用 goals next 推进任务，再用 goals checkpoint 携带证据、验证命令和验证结果关闭目标。审查问题可由 findings add 写入本地账本，通过 findings next 选择最高优先级问题，并在修复和验证后使用 findings resolve 关闭；findings gate 会在仍有 open 或 blocked 项时失败。status 汇总目标和发现状态，version 显示插件版本、路径与 Git 检出状态，update 更新到最新稳定标签或指定的 main 分支。仓库还提供 fable_coverage.py，把本地 CLAUDE-FABLE-5.md 的各个标题归类为已实现、已适配、不支持或不适用。
- 需要完成多文件实现或重构的 Codex 用户，希望每个阶段都有明确目标和证据检查点。
- 排查原因不明故障的开发者，希望先复现问题、保留多个假设、收集反证，再实施和验证修复。
- 处理 CI 失败、迁移或发布工作的维护者，需要在宣布完成前执行测试并记录验证结果。
- 进行安全敏感或高风险代码审查的团队，希望未解决的发现能够阻止最终完成。
- 已有 Claude/Fable 风格提示的用户，希望将其中的工作习惯适配为 Codex 原生技能和命令。
- 拥有合法 Anthropic 访问权限的团队，希望通过 LiteLLM 等 OpenAI 兼容网关尝试可选的模型路由方案。
这个 Agent 有哪些优点和局限？
- 目标检查点必须携带证据，最终目标还能记录验证命令和输出，完成声明具有可追溯依据。
- 独立的发现账本和
findings gate能防止已接受的审查问题在收尾时被遗漏。 - 状态存储在
.codex-fable5/下，包含 JSON 账本和追加式事件历史，便于检查任务过程。 - 严格模式、分析模式、轻量审查和受限实现都可通过提示控制，流程强度能够随任务调整。
- 明确区分工作流改进与模型能力，不声称解锁 Fable 5、扩大上下文或修改模型权重。
- 核心交付形式是 Codex 插件，不能作为通用代理框架直接部署到 ChatGPT、Claude Code 或其他运行时。
- 目标和发现账本会增加操作步骤；文档也建议在短回答、微小单文件修改或纯头脑风暴中跳过。
- 本地状态默认写入项目的
.codex-fable5/，团队需要自行决定忽略还是有意提交这些任务记录。 - 可选 Anthropic 路由并不提供模型访问，采用者还需自行准备授权凭证和 LiteLLM 等兼容网关。
- 所谓 100% 覆盖只表示源文档标题都获得处置分类，并不代表与 Fable 5 的模型能力或隐藏运行时等价。
如何安装或部署这个 Agent？
稳定版安装：
codex plugin marketplace add baskduf/FableCodex --ref v0.5.1
codex plugin add codex-fable5@fablecodex安装后重启 Codex。开发版可将第一条命令的引用改为 --ref main。本地开发可运行 codex plugin marketplace add ~/Desktop/FableCodex，随后执行相同的 codex plugin add 命令。基础插件未注明需要模型 API 凭证；只有可选的 provider bridge 需要有效的 Anthropic 访问权限和 LiteLLM 等 OpenAI 兼容网关。
如何使用这个 Agent？
首次可在 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.若要直接使用辅助命令，先运行：
export PATH="$PWD/plugins/codex-fable5/bin:$PATH"然后可执行 codex-fable5 status。创建账本的示例：
codex-fable5 goals create --brief "Migration" --goal "inspect::Find current behavior and tests" --goal "change::Implement the migration" --goal "verify::Run tests and inspect output"接着运行 codex-fable5 goals next，并用 goals checkpoint 为已完成目标提交证据。最终完成前运行 codex-fable5 findings gate；项目测试命令为 python3 -m unittest discover -s tests -v。
这个 Agent 与同类方案有什么区别？
与不加载该技能的普通 Codex 工作方式相比，FableCodex 增加了目标账本、证据检查点、审查发现门禁和结构化收尾报告。它借鉴 Claude/Fable 风格的工作习惯，但只是 Codex 原生的流程适配，并非 Fable 5 模型的替代品或复刻版。
常见问题
它会让我获得 Fable 5 模型吗？
使用基础插件需要 Anthropic API 凭证吗？
未解决的审查问题会发生什么？
codex-fable5 findings gate 会在存在 open 或 blocked 发现时失败，阻止通过最终发现门禁；阻塞性发现也会使最终目标无法完成。任务记录会上传到外部服务吗？
.codex-fable5/ 目录；没有提供外部上传行为的说明。