---
name: task-list
category: task
command: list
description: 列出项目任务
triggers:
  - "列出 {project} 的任务"
  - "查看 {project} 任务"
  - "{project} 有哪些任务"
  - "查看待办任务"
  - "@task/list --project {project}"
---

# @task/list - 任务列表

从 Vibe Kanban 获取项目任务列表。

## 参数

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `--project` | string | 否 | 项目名称，默认当前项目 |
| `--status` | enum | 否 | 状态过滤: `todo`, `inprogress`, `inreview`, `done` |
| `--limit` | number | 否 | 返回数量限制，默认 10 |

## 执行步骤

### 1. 获取项目 Kanban ID

从项目 `CLAUDE.md` 读取 Kanban ID：

```yaml
Vibe Kanban 项目:
| 项目 | Kanban ID |
|------|-----------|
| tg-live-game-hono | 7c6bb2ce-90a2-4e96-bc04-5facdcdb337f |
```

### 2. 调用 Vibe Kanban API

```
mcp__vibe_kanban__list_tasks
project_id: {kanban_id}
status: {status}
limit: {limit}
```

### 3. 格式化输出

## 输出格式

```
=== 任务列表: {project} ===

状态: {status} | 共 {count} 个任务

| # | 标题 | 状态 | 创建时间 |
|---|------|------|----------|
| 1 | 实现用户认证 | todo | 2026-01-05 |
| 2 | 添加视频播放 | inprogress | 2026-01-04 |
| 3 | 修复登录 bug | done | 2026-01-03 |

使用 @task/start <task-id> 开始任务
```

## 示例

```bash
# 列出项目所有任务
@task/list --project tg-live-game-hono

# 只看待办
@task/list --project tg-live-game-hono --status todo

# 限制数量
@task/list --project yshop --limit 5
```

## 自然语言等效

- "列出 tg-live-game-hono 的任务"
- "tg-live-game 有哪些待办任务"
- "查看正在进行的任务"