用途：epic-dev 是 Codex 中执行分阶段史诗开发流程的入口，与 Claude Code 的 /epic-dev 命令暴露同一套工作流。它把大型功能拆成可独立评审和测试的阶段，每阶段对应一个 PR。
主要能力：执行仓库检测、GitHub 查询、worktree 设置、测试、提交、PR 创建与清理；支持 --resume、--next-phase、--finalize 三种模式，其他文本视为新史诗描述。阶段划分建议规则为：一个阶段等于一个可独立评审和测试的 PR，约一个子系统或最多约 500 行净变更；若两个候选阶段只能一起测试，则合并为一个阶段。
使用方式：先运行 project-preflight 进行只读启动探测，校验 INTEGRATION_BRANCH、REPO_ROOT、CURRENT_BRANCH 等必需值；GitHub 操作前要求 has_gh=true。创建史诗 issue 与阶段子 issue 使用 gh issue create 和 gh sub-issue add；阶段 PR 用 gh pr create --base {epic_branch} 创建，最终 PR 用 --merge 保留各阶段历史。状态保存在 .claude/epic.local.md。
适用场景：需要把大型功能拆成多个可评审、可测试阶段并逐步合并到集成分支的仓库开发流程。
限制：仅在资料明确描述的前提下执行；缺失事实暂未提供。需注意不使用 codex/ 分支前缀，不使用 emoji，GitHub 正文每段保持单行；合并失败时不更新状态或清理 worktree，脏 worktree 清理需用户明确批准。