跳转到主要内容

​
概述

burn 命令汇总项目中的任务工时，并按所选维度分组。它回答诸如”有多少工时正在进行中？”、“每个发布还剩多少？“和”谁有空闲产能？“等问题 — 全部在终端中完成。

​
燃尽报告

​
基本用法

# Summary + breakdown by release (default dimension)
apollo burn -p "Delfin One"

# Group by specialty
apollo burn -p "Delfin One" --by specialty

# Group by assignee (shows capacity)
apollo burn -p "Delfin One" --by assignee

# Group by priority
apollo burn -p "Delfin One" --by priority
选项：
Flag描述
-p, --project <name>项目名称或 ID（必填）
--by <dimension>分组依据：release（默认）、specialty、assignee、priority
--release <name>限定到单个发布
-s, --status <status>筛选状态（逗号分隔，或 all）

​
限定到单个发布

深入分析单个发布，查看工时分布： 
# Show specialty breakdown within a release
apollo burn -p "Delfin One" --release "P3.1" --by specialty

# Show who's working on what in a release
apollo burn -p "Delfin One" --release "P3 — Credit Memo System" --by assignee

┌─ Burn: Delfin One ────────────────────────────────────────┐
│ 382 tasks · 3995h total                                    │
│ Done: 300 (2626h) · WIP: 14 (556h) · Todo: 68 (813h)     │
└────────────────────────────────────────────────────────────┘

By Release                       Done    WIP    Todo   Total  Progress
Platform V1.0.0 - Phase 1 (De…  1689h   -      -      1689h  ██████████ 100%
Platform V1.0.0 - Phase 2 (Ja…  872h    -      -      872h   ██████████ 100%
P3 — Multi-Tenant / White-Lab…  -       250h   170h   420h   ░░░░░░░░░░ 0%
P3 — Credit Memo System         -       140h   50h    190h   ░░░░░░░░░░ 0%
P3 — AI Data Accuracy & Pipel…  57h     56h    16h    129h   ████░░░░░░ 44%
...

​
增强的任务筛选器

task list 命令现在支持额外的筛选器，可按发布、专业领域等维度切分数据： 
# Tasks in a specific release
apollo task list -p "Delfin One" --release "P3.1"

# Tasks by specialty
apollo task list -p "Delfin One" --specialty "frontend"

# Tasks by type
apollo task list -p "Delfin One" --task-type "feature"

# Unassigned tasks only
apollo task list -p "Delfin One" --unassigned

# Tasks due before a date
apollo task list -p "Delfin One" --due-before 2026-03-01

# Combine filters
apollo task list -p "Delfin One" --release "P3.1" --unassigned --specialty "back-end"
新增筛选选项：
Flag描述
--release <name>按发布名称筛选（模糊匹配）
--specialty <name>按专业领域筛选（如 frontend、back-end、ai）
--task-type <name>按任务类型筛选（如 feature、bug、chore）
--unassigned仅显示未分配的任务
--due-before <date>显示截止日期在指定日期之前的任务（YYYY-MM-DD）
任务列表表格现在除了原有列之外，还包含 Hours 和 Release 列。

​
JSON 输出

两个命令都支持 --json 以获得结构化输出，使其可以与 jq 和其他工具组合使用。

​
Burn JSON

apollo burn -p "Delfin One" --json

{
  "summary": {
    "tasks": 382,
    "total_hours": 3995,
    "done_hours": 2626,
    "wip_hours": 556,
    "todo_hours": 813,
    "blocked_hours": 0,
    "done_tasks": 300,
    "wip_tasks": 14,
    "todo_tasks": 68,
    "blocked_tasks": 0
  },
  "dimension": "release",
  "groups": [
    {
      "name": "Platform V1.0.0 - Phase 1 (December)",
      "task_count": 186,
      "total_hours": 1689,
      "done_hours": 1689,
      "wip_hours": 0,
      "todo_hours": 0,
      "blocked_hours": 0,
      "progress_pct": 100
    }
  ]
}

​
管道示例

# Find releases with the most remaining work
apollo burn -p "Delfin One" --json | jq '.groups | sort_by(-.todo_hours) | .[0:5] | .[] | "\(.name): \(.todo_hours)h todo"'

# Get total WIP hours by assignee
apollo burn -p "Delfin One" --by assignee --json | jq '.groups[] | select(.wip_hours > 0) | "\(.name): \(.wip_hours)h"'

# Count unassigned tasks per specialty
apollo task list -p "Delfin One" --unassigned --json | jq 'group_by(.specialty) | map({specialty: .[0].specialty, count: length})'