plans

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

/plans - List All Plans

/plans - 列出所有计划

Usage

使用方法

/plans                    # All non-archived plans (excludes implemented + superseded)
/plans all                # All plans regardless of status
/plans --status=draft     # Filter by status
/plans --type=migration   # Filter by plan type

/plans                    # All non-archived plans (excludes implemented + superseded)
/plans all                # All plans regardless of status
/plans --status=draft     # Filter by status
/plans --type=migration   # Filter by plan type

Execution

执行流程

Step 1 — Parse Arguments

步骤1 — 解析参数

Parse the user's input for optional filters:

Argument	Maps To	Values
`all`	no filter	show everything
`--status=X`	`status` filter	draft, accepted, stories-created, in-progress, implemented, superseded, archived
`--type=X`	`plan_type` filter	feature, refactor, migration, infra, tooling, workflow, audit, spike
`--prefix=X`	`story_prefix` filter	e.g., APIP, SKCR, DASH
(no args)	default	exclude `implemented` and `superseded`

解析用户输入的可选过滤器：

参数	映射到	取值
`all`	无过滤器	展示所有内容
`--status=X`	`status` 过滤器	draft, accepted, stories-created, in-progress, implemented, superseded, archived
`--type=X`	`plan_type` 过滤器	feature, refactor, migration, infra, tooling, workflow, audit, spike
`--prefix=X`	`story_prefix` 过滤器	e.g., APIP, SKCR, DASH
(无参数)	默认	排除 `implemented` 和 `superseded`

Step 2 — Query KB

步骤2 — 查询KB

Call

kb_list_plans

with the appropriate filters and

limit: 100

If the default filter (no args), make TWO calls and combine:

kb_list_plans({ status: 'draft', limit: 100 })

kb_list_plans({ status: 'in-progress', limit: 100 })

Also include
```
stories-created
```
and
```
accepted
```
if any exist

Simpler approach: Call

kb_list_plans({ limit: 100 })

once, then filter client-side to exclude

implemented

and

superseded

when no explicit filter is given.

传入合适的过滤器和

limit: 100

参数调用

kb_list_plans

。

如果使用默认过滤器（无参数），执行两次调用并合并结果：

kb_list_plans({ status: 'draft', limit: 100 })

kb_list_plans({ status: 'in-progress', limit: 100 })

如果存在
```
stories-created
```
和
```
accepted
```
状态的计划也一并包含

更简单的实现方案： 单次调用

kb_list_plans({ limit: 100 })

，如果没有指定显式过滤器，就在客户端侧过滤掉

implemented

和

superseded

状态的计划。

Step 3 — Format Output

步骤3 — 格式化输出

Display results as a markdown table with these columns:

| Plan Slug | Title | Status | Type | Prefix | Priority | Stories | Tags | Updated |

Column formatting:

Plan Slug: backtick-wrapped slug
Title: truncate to 50 chars if needed
Status: as-is
Type: as-is
Prefix: story_prefix or
```
—
```
Priority: P1-P5
Stories: estimated_stories or
```
—
```
Tags: first 3 tags comma-separated,
```
+N
```
if more
Updated: relative date (e.g., "2h ago", "3d ago")

Sort order: status (draft/in-progress first), then priority (P1 first), then slug.

将结果展示为包含以下列的markdown表格：

| Plan Slug | Title | Status | Type | Prefix | Priority | Stories | Tags | Updated |

列格式化规则：

Plan Slug：用反引号包裹的slug
Title：必要时截断为50个字符
Status：原样展示
Type：原样展示
Prefix：story_prefix 或
```
—
```
Priority：P1-P5
Stories：estimated_stories 或
```
—
```
Tags：前3个标签用逗号分隔，超过3个则显示
```
+N
```
Updated：相对日期（例如 "2h ago", "3d ago"）

排序规则：先按状态（draft/in-progress 优先），再按优先级（P1优先），最后按slug排序。

Step 4 — Summary Line

步骤4 — 摘要行

After the table, output a one-line summary:

N plans total: X draft, Y in-progress, Z implemented, W superseded

表格之后输出一行摘要：

N plans total: X draft, Y in-progress, Z implemented, W superseded