Fable Orchestrator 是一个面向 Codex/Claude Code 工作流的本地优先“路由技能”仓库,用于把复杂开发任务拆成由 Fable 负责规划与裁决、由 OpenCode Go agents 负责实现的有界执行图。仓库本身主要是 Shell 安装脚本、技能定义、Agent YAML 和轻量测试脚本,不包含代理服务、控制台、模型目录、凭据存储或 API Key 管理。其核心价值在于为 Codex Router 已配置好的 OpenCode Go 代理提供一个可安装的 skill,使开发任务可以按规划、并行实现、验证、再裁决的模式执行。
适用领域
AI 编程助手编排 / Codex/Claude Code 工作流扩展 / 本地开发自动化 / 多 Agent 任务路由 / Shell 脚本工具 / 开发者效率工具
配置难度
中等偏高。安装脚本本身简单,但真正使用需要理解 Codex skills、Codex Router、OpenCode Go agent 配置、本地 fable alias 以及多 Agent 工作流。对只熟悉普通 CLI 工具的开发者来说,上手门槛较高;对已有 Codex/Claude Code 自动化经验的用户则较容易。
商业价值
对已经投入 AI 编程工作流的团队有一定业务价值,尤其适合希望将规划、实现、验证、裁决分离,并减少单一 Agent 失控风险的场景。它可以作为轻量编排层提升复杂任务执行的结构化程度,但由于不包含完整平台能力、强依赖外部 Codex Router 配置,商业价值主要体现在内部研发效率提升和流程规范化,而不是开箱即用的企业级产品。
01
技术亮点
- 本地优先:不提供云端代理、Dashboard 或凭据存储,降低部署复杂度和凭据泄露面
- 职责分离:Fable 只做规划和最终裁决,不直接写代码或拥有工作区
- 安装简单:通过 install.sh --dry-run 和 --copy 完成安装,支持自定义目标目录
- 可重复执行:安装过程声明为幂等,适合反复更新 skill 文件
- 测试轻量:tests/test_skill.sh 覆盖 Shell 语法、文件复制、YAML 基础结构、SVG 安全约束和常见凭据字符串扫描
- 失败方式较明确:当允许的 OpenCode Go 路由不可用时,报告 blocker,而不是虚构可用模型
- MIT 许可证,便于个人和商业项目二次使用
02
目标用户
- 已经使用 Codex、Claude Code 或类似 AI 编程工作流的开发者
- 希望在本地环境中编排多个代码实现 Agent 的团队
- 需要把 AI 规划、实现、验证步骤拆分的高级用户
- 对本地优先、无凭据托管、无后台服务方案有要求的开发者
- 愿意手动配置 Codex Router 和 OpenCode Go Agent 的工程师
03
配置要求
- 需要本机已有 Codex/Claude Code 相关运行环境,且支持加载 ~/.codex/skills 下的 skill
- 需要提前在 Codex Router 中配置可调用的 OpenCode Go agents
- README 指定依赖 callable:opencode-go/ 与 opencode-go-responses/
- 需要存在本地 fable alias,ask_fable.sh 会调用 Claude Code 的本地 fable alias,且无会话持久化
- 实现节点被限制为 GPT-5.6 Luna 或 DeepSeek V4 Flash 路由;如果这些路由不可调用,流程会报告 blocker
- 安装脚本不会读取、创建或修改凭据;用户需自行在外部工具中管理 provider/API 凭据
- 运行测试不需要 PyYAML 或在线 Claude 登录;可选 xmllint 用于 XML/SVG 校验
04
适用场景
- 为 Codex 安装一个名为 fable 的本地 skill,用于将开发目标拆解为可执行任务图
- 让规划模型只负责决策与裁决,避免其直接修改工作区代码
- 将实现任务委托给预先配置好的 OpenCode Go agents
- 在复杂功能开发中并行启动多个可执行子任务
- 在任务执行后收集证据、验证结果,并根据需要再次请求 Fable 裁决
- 作为 Codex Router 多 Agent 路由配置的轻量模板或参考实现
05
部署与配置
- 克隆仓库:git clone https://github.com/codejunkie99/fable-orchestrator.git
- 进入目录:cd fable-orchestrator
- 先执行 dry-run 查看将要复制的目标路径和文件操作:./install.sh --dry-run
- 确认无误后安装到默认目录:./install.sh --copy
- 默认安装目标为 ~/.codex/skills/fable
- 如需指定自定义 skills 目录,可执行:./install.sh --copy --target "$PWD/.local/codex/skills"
- 安装或修改 provider/agent 定义后,启动新的 Codex task 或重启相关 Codex 会话
- 运行测试脚本检查仓库结构与脚本:tests/test_skill.sh
06
风险与注意事项
- README 中提到的 GPT-5.6 Luna、DeepSeek V4 Flash、Claude Fable 5.1 等名称可能依赖特定私有配置或并非通用公开模型,实际可用性需要用户自行验证
- 仓库语言主要是 Shell,功能范围很窄,本身不是完整的 Agent 平台,也不包含模型调用后端
- 强依赖 Codex Router、OpenCode Go agents 和本地 fable alias;若用户没有这些环境,安装后无法独立工作
- 缺少详细的故障排查文档、真实运行示例输出和端到端演示
- 当前 topics 为空,生态定位和兼容版本信息不够清晰
- 450 stars 和 76 forks 显示有一定关注度,但仍需检查提交历史、Issue 活跃度和维护状态
- 多 Agent 自动改代码流程天然存在误改、任务越界、验证不足等风险,需要配合代码审查和版本控制使用
- README 强调不要在 packet 中放入凭据,但实际使用中仍需团队建立提示词和上下文传递规范
2026-09-05
第10名
新收录 · github_search