跳转到主要内容

​
概述

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）