spec-kitty-status

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Status Board

状态看板

Show the current status of all work packages in the active feature. This displays:
  • Kanban board with WPs organized by lane
  • Progress bar showing completion percentage
  • Parallelization opportunities (which WPs can run concurrently)
  • Next steps recommendations
展示当前活跃特性中所有工作包的当前状态,它会显示:
  • 按泳道归类工作包的看板
  • 展示完成百分比的进度条
  • 并行化机会(哪些工作包可以同时运行)
  • 下一步建议

When to Use

适用场景

  • Before starting work (see what's ready to implement)
  • During implementation (track overall progress)
  • After completing a WP (see what's next)
  • When planning parallelization (identify independent WPs)
  • 开始工作前(查看哪些内容已就绪可实施)
  • 实施过程中(追踪整体进度)
  • 完成一个工作包后(查看接下来要做什么)
  • 规划并行任务时(识别独立的工作包)

Implementation

使用方式

Run the CLI command to display the status board:
bash
spec-kitty agent tasks status
To specify a feature explicitly:
bash
spec-kitty agent tasks status --feature 012-documentation-mission
The command displays a rich kanban board with:
  • Progress bar showing completion percentage
  • Work packages organized by lane (planned/doing/for_review/done)
  • Summary metrics
运行CLI命令显示状态看板:
bash
spec-kitty agent tasks status
若要显式指定特性:
bash
spec-kitty agent tasks status --feature 012-documentation-mission
该命令会展示内容丰富的看板,包含:
  • 显示完成百分比的进度条
  • 按泳道(规划中/进行中/待审核/已完成)归类的工作包
  • 汇总指标

Alternative: Python API

替代方案:Python API

For programmatic access (e.g., in Jupyter notebooks or scripts), use the Python function:
python
from specify_cli.agent_utils.status import show_kanban_status
如果需要编程式访问(例如在Jupyter notebooks或者脚本中),可以使用如下Python函数:
python
from specify_cli.agent_utils.status import show_kanban_status

Auto-detect feature from current directory/branch

Auto-detect feature from current directory/branch

result = show_kanban_status()
result = show_kanban_status()

Or specify feature explicitly:

Or specify feature explicitly:

result = show_kanban_status("012-documentation-mission")

result = show_kanban_status("012-documentation-mission")


Returns structured data:

```python
{
    'feature_slug': '012-documentation-mission',
    'progress_percentage': 80.0,
    'done_count': 8,
    'total_wps': 10,
    'by_lane': {
        'planned': ['WP09'],
        'doing': ['WP10'],
        'for_review': [],
        'done': ['WP01', 'WP02', ...]
    },
    'parallelization': {
        'ready_wps': [...],
        'can_parallelize': True/False,
        'parallel_groups': [...]
    }
}

返回结构化数据:

```python
{
    'feature_slug': '012-documentation-mission',
    'progress_percentage': 80.0,
    'done_count': 8,
    'total_wps': 10,
    'by_lane': {
        'planned': ['WP09'],
        'doing': ['WP10'],
        'for_review': [],
        'done': ['WP01', 'WP02', ...]
    },
    'parallelization': {
        'ready_wps': [...],
        'can_parallelize': True/False,
        'parallel_groups': [...]
    }
}

Output Example

输出示例

╭─────────────────────────────────────────────────────────────────────╮
│                    012-documentation-mission                        │
│                     Progress: 80% [████████░░]                      │
╰─────────────────────────────────────────────────────────────────────╯

┌─────────────┬─────────────┬─────────────┬─────────────┐
│   PLANNED   │    DOING    │ FOR_REVIEW  │    DONE     │
├─────────────┼─────────────┼─────────────┼─────────────┤
│ WP09        │ WP10        │             │ WP01        │
│             │             │             │ WP02        │
│             │             │             │ WP03        │
│             │             │             │ ...         │
└─────────────┴─────────────┴─────────────┴─────────────┘

🔀 Parallelization: WP09 can start (no dependencies)
╭─────────────────────────────────────────────────────────────────────╮
│                    012-documentation-mission                        │
│                     Progress: 80% [████████░░]                      │
╰─────────────────────────────────────────────────────────────────────╯

┌─────────────┬─────────────┬─────────────┬─────────────┐
│   PLANNED   │    DOING    │ FOR_REVIEW  │    DONE     │
├─────────────┼─────────────┼─────────────┼─────────────┤
│ WP09        │ WP10        │             │ WP01        │
│             │             │             │ WP02        │
│             │             │             │ WP03        │
│             │             │             │ ...         │
└─────────────┴─────────────┴─────────────┴─────────────┘

🔀 Parallelization: WP09 can start (no dependencies)