分离编排与执行引擎
Claude Code 和 Codex 通过统一 CLI 适配契约接入。任务分派与会话管理面向引擎标识工作，避免到处嵌入特定提供方的执行逻辑。
为 Claude Code 与 Codex 提供持久化编排层，通过飞书协调 Agent、工作区、审批与定时任务。
- 方向
- Agent 系统
- 实现重点
- 引擎适配、工作区路由、持久化会话、人工审批与定时执行。
- 可查看的内容
- 84 秒录屏展示任务分派、审批、执行，以及同一原生会话中的追问。
Agent OS 实际演示
84 秒实际执行：任务分派、人工审批、Claude Code 实现，以及同一原生会话中的后续修改。
使用合成演示仓库 · 等待时间已压缩 · 英文合成旁白 · 私有对话侧栏已裁去。
文字说明与验证
飞书收到任务：实现 POST /sum 并添加回归测试。负责人分派给产品 Agent 形成方案，经过人工审批后，本地 Spec/Tickets 指导开发 Agent 使用 Claude Code 实现，初始版本通过 9 项测试。
后续要求将输入限制为 100 个数字：100 个接受，101 个拒绝。全部 11 项测试通过。对比修改前后的原生会话标识，确认其保持不变。以上结果属于这次演示，不代表生产指标。
要解决的问题
单个编码 Agent 可以执行任务；当多个 Agent 跨时间协作时，还需要选择引擎、保留上下文、定位正确的仓库，并在等待人工决策时保持任务状态。
模块如何协作
Agent 任务编排
飞书 / 用户
分派 · 会话 · 审批
工作区与引擎适配
Claude Code / Codex
持久化会话 · 明确审批
图中展示与源码模块对应的编排职责。工作区用于选择工作目录，不等同于操作系统级安全沙箱。
关键工程决策
持久化会话边界
会话通过机器人、聊天和线程标识定位，并单独保存原生 CLI 会话 ID。切换工作区会清除原生 ID，防止上下文被静默复用到另一个仓库。
让人工审批成为明确状态
产品文档审阅与任务执行具有不同边界。审批记录和可恢复会话让流程能够等待决策，然后继续已授权的工作。
可靠性与失败处理
状态保存失败时回滚
会话变化需要持久化。保存失败会恢复内存状态，避免报告实际上没有保存的状态转换。
保留被中断任务的事实
启动时，将仍处于运行状态的历史定时任务标记为失败并记录中断原因。进程重启不会被静默当作执行成功。
明确执行边界
工作区、引擎标识与审批范围都可查看。CLI 使用宿主账号权限，部署时仍需合适的宿主隔离措施。
证据与范围
源码链接固定到已阅读版本，便于逐项查看实现依据。
会话生命周期
会话键、合法状态转换、原生 ID 与持久化回滚。
src/core/session-manager.tsAgent 任务分派
协作任务与已配置 Agent 之间的路由。
src/app/collaboration-service.ts调度恢复
定时执行及被中断任务的恢复处理。
src/app/scheduler.ts人工审批
审批状态与决策处理。
src/core/approval.tsCLI 引擎适配
Claude Code 与 Codex 引擎的共享注册入口。
src/cli/registry.ts本案例的依据范围
已阅读对应版本的编排源码；演示结果不代表生产可用性或客户部署情况。