用途：Takomi Codex 用于在 Codex 中执行 Takomi 生命周期编排。当用户要求 Takomi、编排、roadbook、Genesis/Design/Build 生命周期、策略感知执行、Pi/Takomi 运行时检查或委派任务协调时使用。
运行原则：选择能完成工作的最小执行模式——小型一次性任务直接用 Codex；不清晰或偏设计的工作用 planning 模式；多步骤大型工作用 Markdown roadbook 编排；一旦 Takomi 分解出子任务、roadbook 任务或编排会话，则默认委派。琐碎修改不要建 board、启动 harness 或开线程。主 Codex 代理仍是编排者，负责上下文接收、任务包、board 更新、综合、验证和交付，分解后默认不再担任主要实现者。用户明确说“自己来做”“不要 subagent”“不要新线程”等时，主代理可直接执行，但需保持现有 roadbook 最新。
必要上下文：复杂代码或编排前先检查 docs/features/、docs/project_requirements.md、docs/Project_Requirements.md、相关的本地 .pi/ 及 Takomi 功能文档；重大功能应先创建或更新功能 markdown 文件。
运行时检测：当运行时状态影响答案时使用 scripts/takomi-detect.ps1。优先级为项目本地 .pi/、用户/全局 ~/.pi/agent/ 与 ~/.agents/skills/、takomi 与 pi 的 CLI 可用性、插件自带指引。全局/用户路径只读，除非用户明确批准写入。
策略加载：模型、subagent、评审或生命周期路由相关时使用 scripts/takomi-policy.ps1，优先遵循项目策略 .pi/settings.json、.pi/takomi-profile.json、.pi/takomi/model-routing.md、.pi/takomi/policies/。不要硬编码个人模型名作为通用默认。
Roadbook 编排：需要持久协调的大型工作使用 scripts/takomi-board.ps1。Markdown roadbook 是编排状态的持久事实来源，即使使用 Pi、subagent、多代理工具、显式请求的 Codex 线程或可选 JSON 跟踪。路径为 docs/tasks/orchestrator-sessions/<sessionId>/，包含 master_plan.md、pending/.task.md、in-progress/.task.md、completed/.task.md、blocked/.task.md、Orchestrator_Summary.md；JSON 跟踪可选，不得替代可读 markdown。
委派优先循环：请求足够大时，创建/更新 roadbook 与任务包，将实现委派给 implementer 子代理或子线程，将评审委派给独立 reviewer，主线程综合结果，更新 roadbook 后接受或收紧任务包重新派发。Pi 中优先 takomi_subagent；Codex 中优先可用的多代理或子代理工具，不可用时回退到 markdown 任务包直接执行。仅当用户明确要求新线程、交接线程、并行线程编排，或主代理建议且用户批准时，才创建用户自有的 Codex 子线程。
生命周期模式：Genesis 用于项目基础、需求、功能规划与 issue 式任务拆解，产出 PRD/需求更新、功能文档、任务/issue 文档、验收标准；Design 用于 UX、架构形态、接口契约与可构建方向，产出设计说明/规范、组件接口计划、风险与约束；Build 用于上下文足够后的实现，迭代实现、保持文件聚焦、随代码更新文档、用可用测试或脚本验证；Review 用于找 bug、质量门禁、安全评审与完成审计，先列发现，标记完成前核实产物，记录未解决风险。
Pi/Takomi 桥接：谨慎使用 scripts/takomi-pi-dispatch.ps1，默认 dry-run 建议；仅当用户明确要求、活跃策略要求且动作安全、或命令为诊断/只读时，才运行真实 Pi/Takomi 命令。不要假设存在原始子代理工具，优先使用 Takomi 面向接口。Pi 编排激活时，分解工作优先用 takomi_subagent。
其他 harness：当项目策略或用户请求指向其他 Takomi 支持的 harness 时使用 scripts/takomi-harness.ps1，默认 dry-run；使用 -Execute 前确认目标 harness 或命令、是否写入用户/全局文件，优先用 status 或 harnesses 而非 sync、setup、refresh，并保持 Codex 为父协调者，除非用户明确交接执行。
Codex 委派：委派确实有帮助时用 tool_search 查找可用的多代理/子代理工具；给每个委派者自包含的任务包路径与完成定义；父线程保留综合、验证、文档与 board 更新职责；未经用户批准不委派需要写全局/用户配置的任务；委派工具不可用时回退到 markdown 任务包与 Codex 直接执行。
文件规模纪律：插件脚本与技能文件保持模块化，接近 200 行时拆分职责。
完成规则：交接前更新相关功能文档、更新 roadbook（如存在）、插件文件变更时运行插件验证器、脚本变更时运行脚本冒烟检查，并说明已验证与未验证内容。