productplan (v1)
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../zentao-shared/SKILL.md,其中包含认证、环境变量配置、错误处理和通用选项说明。
Commands
productplan list— 列出产品计划productplan get— 获取产品计划详情productplan create— 创建产品计划productplan update— 修改产品计划productplan delete— 删除产品计划
Core Concepts
- ProductPlan(产品计划):ZenTao 中用于规划产品发布的功能模块。
- Plan vs Roadmap:产品计划可以是发布计划(ship)或路线图(roadmap)。
- 与产品的关系:每个产品计划属于特定产品(product)。
ProductPlan Status Values
| Status | 中文 | 说明 |
|---|---|---|
wait |
未开始 | 计划还未开始 |
doing |
进行中 | 计划正在执行 |
done |
已完成 | 计划已完成 |
Common Use Cases
1. 查看产品的所有计划
# 列出产品 1 下的所有计划
zentao-cli product-plan list --product 1
2. 查看特定计划详情
# 获取计划详情
zentao-cli product-plan get 1
Examples
# 列出产品 1 下的所有计划
zentao-cli product-plan list --product 1
# 获取计划详情
zentao-cli product-plan get 1
Output Fields
| Field | Type | Description |
|---|---|---|
| id | u64 | 计划 ID |
| product | u64 | 所属产品 ID |
| name | string | 计划名称 |
| code | string | 计划代号 |
| status | string | 计划状态:wait / doing / done |
| type | string | 计划类型:ship / roadmap |
Gotchas
Product Required:
productplan list需要指定--product参数来筛选特定产品的计划。计划类型:通过
type字段区分发布计划(ship)和路线图(roadmap)。与 Release 的区别:ProductPlan 是规划层面的,Release 是实际发布的版本记录。