要用Codex安排有先后依赖的开发任务，必须先用依赖图谱识别因果链和阻塞点，再分强/弱阻塞层调度，接着通过astra-orchestrator、AGENTS.md约束或人工检查点绑定执行顺序，最后用status命令、产物删除测试和日志筛选验证依赖是否被严格尊重。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要用Codex安排有先后依赖的开发任务，必须让AI先看清任务之间的因果链和阻塞点，否则它会把本该串行推进的步骤强行并行，导致后置任务因前置产物缺失而反复报错、重试失败。
第一步：用「依赖图谱」强制Codex识别顺序
在Codex主对话中输入：“请基于当前项目结构，画出本次需求涉及的所有模块间依赖关系图。要求：① 标出每个模块的输入来源（文件/接口/环境变量）；② 标出每个模块的输出产物（生成的JSX组件、新增的API路由、修改的SQL迁移脚本）；③ 用→箭头明确标出不可逆执行顺序，例如‘auth-service → user-profile-page → notification-widget’。”
这一步不能跳过。Codex若未显式输出依赖图，说明它还没真正理解哪一步卡在哪——后续所有调度都可能崩在第二步。
第二步：按阻塞强度分层调度
根据上一步生成的依赖图，手动将任务划分为三层：
【强阻塞层】：必须100%完成才允许下游启动，例如数据库迁移脚本执行、核心API路由注册、权限中间件注入。这类任务必须由Codex单独轨道执行，禁止与其他任务共享worker进程。
【弱阻塞层】：只需产物存在即可，不要求运行时就绪，例如前端组件开发、测试用例编写、文档草稿生成。这些可与强阻塞层并行，但Codex必须在提交前校验强阻塞层产物是否已写入磁盘。
注意：若你让Codex在强阻塞任务未完成时就生成调用该API的前端代码，它会硬编码mock数据，后续真实联调时需全量替换——这种坑无法自动修复。
第三步：用astra-orchestrator绑定执行序
方法一：启用编排器强制序控
在项目根目录下运行：codex astra-orchestrator --mode=sequential --block-on=src/migrations/v20261014_add_task_deps.sql。这个命令会让Astra作为根代理全程盯住指定SQL文件是否落地，未出现则冻结所有下游子代理（包括worker和tester）。
通过 Codex CLI 生成图片，支持尺寸控制和批量模式。依赖：codex (npm)。代理默认启用。用 generate.sh 生成单张，batch_generate.sh 批量生成游戏 UI 素材，gen_size.sh 指定尺寸。所有输出保存至 ~/.codex/generated_images/。
方法二：用AGENTS.md硬约束
打开AGENTS.md，在Constraints章节追加一行：task_order: ["migrate-db", "start-api-server", "build-frontend"]。Codex每次启动新任务前都会读取该字段，并拒绝执行列表外的任意步骤。
方法三：人工插入检查点
在依赖链关键节点后，插入一句指令：“请确认 ./dist/api/routes/task.js 已存在且导出 /api/v1/tasks GET 方法，再继续下一步”。Codex会暂停执行，主动读取文件内容校验，不满足条件绝不往下走。
第四步：验证依赖是否真被尊重
第一步：执行 codex status --dependency-graph，查看实时依赖状态表，确认所有→箭头指向的上游任务状态为✅。
第二步：故意删掉一个强阻塞产物（如刚生成的D1 migration文件），再触发下游任务，观察Codex是否立即报错并中止，而不是尝试生成空壳代码。
第三步：打开Codex日志面板，筛选关键词“blocked_on”，确认每条日志都精确指向你设定的文件路径或API端点，没有模糊匹配或漏判。
