Epic 是 Apollo 工作层级中的战略层：
Project -> Epic -> Release -> Task
一个 epic 将相关的发布归集在同一个计划下。CLI 让您可以列出 epic、深入了解其发布和任务、跟踪完成进度并管理 epic 生命周期 — 全部在终端中完成。
任务通过发布与 epic 间接 关联。当您运行 apollo epic tasks 时，CLI 会获取该 epic 的所有发布，然后批量获取这些发布中的任务。
Epic 状态 状态 含义 draft规划阶段，尚未激活 active当前进行中 completed所有工作已完成 archived不再相关
列出 Epic # List epics in a project apollo epic list -p "Apollo" # Filter by status apollo epic list -p "Apollo" -s active # Limit results apollo epic list -p "Apollo" --limit 20
选项： Flag 描述 -p, --project <name>项目名称或 ID（必填） -s, --status <status>按状态筛选（draft、active、completed、archived） --limit <n>最大结果数（默认：50）
查看 Epic 详情 显示 epic 元数据、进度条、发布分布和任务统计：
apollo epic view "Authentication Overhaul"
Authentication Overhaul ──────────────────────────────────────────────────────────── Status: active Project: Apollo Quarter: Q2 2026 ID: 550e8400-... Progress ████████████░░░░░░░░ 60% 12/20 tasks done Releases: 1/3 completed In Progress: 4 | Todo: 3 | Blocked: 1 Releases (3) completed Auth v1.0 12/12 tasks in_progress Auth v1.1 0/5 tasks planned Auth v2.0 0/3 tasks
JSON 输出包含完整的 epic 对象、发布数组和计算得出的 task_stats：
apollo epic view "Authentication Overhaul" --json
{ "id" : "550e8400-..." , "title" : "Authentication Overhaul" , "status" : "active" , "releases" : [ ... ], "task_stats" : { "total" : 20 , "done" : 12 , "in_progress" : 4 , "todo" : 3 , "blocked" : 1 , "backlog" : 0 , "completed_releases" : 1 , "total_releases" : 3 , "progress_pct" : 60 } }
创建 Epic apollo epic create \ -t "Authentication Overhaul" \ -p "Apollo" \ --status active \ --quarter "Q2 2026" \ --description "Migrate from session-based to JWT auth"
选项： Flag 描述 -t, --title <title>Epic 标题（必填） -p, --project <name>项目名称或 ID（必填） -s, --status <status>初始状态（默认：draft） --description <desc>Epic 描述 --quarter <text>目标季度（如 Q2 2026） --color <hex>颜色十六进制代码（默认：#6366f1）
更新 Epic 创建后可更新任何 epic 字段：
# Change status apollo epic update "Auth Overhaul" -s active # Update quarter and description apollo epic update "Auth Overhaul" --quarter "Q3 2026" --description "Scope expanded" # Rename apollo epic update "Auth Overhaul" -t "Auth & SSO Overhaul"
选项： Flag 描述 -t, --title <title>新标题 -s, --status <status>新状态（draft、active、completed、archived） --description <desc>新描述 --quarter <text>新目标季度 --color <hex>新颜色十六进制代码
完成 Epic 将状态设置为 completed 的快捷方式：
apollo epic complete "Auth Overhaul"
归档 Epic 将状态设置为 archived 的快捷方式：
apollo epic archive "Auth Overhaul"
列出 Epic 任务 获取属于该 epic 的所有发布中的全部任务。这是递归的深入视图：
apollo epic tasks "Auth Overhaul"
ID Title Status Release Assignee ─────────┼────────────────────────────┼────────────┼────────────┼────────── 550e8400 Implement JWT middleware done Auth v1.0 Ian Soares 7a3b1c2d Add refresh token rotation in_progress Auth v1.1 Ana Lima 9e4f2a8b Fix token expiry edge case blocked Auth v1.1 Ian Soares ... 12 task(s) across 3 release(s)
JSON 输出返回完整的任务数组：
apollo epic tasks "Auth Overhaul" --json
选项： Flag 描述 --limit <n>每个发布的最大任务数（默认：200）
