zentao-productplan

productplan (v1)

CRITICAL — Before starting, you MUST first use the Read tool to read ../zentao-shared/SKILL.md, which contains authentication, environment variable configuration, error handling, and general options descriptions.

Commands

productplan list — List product plans
productplan get — Get product plan details
productplan create — Create a product plan
productplan update — Modify a product plan
productplan delete — Delete a product plan

Core Concepts

ProductPlan: A functional module in ZenTao used for planning product releases.
Plan vs Roadmap: A product plan can be a release plan (ship) or a roadmap (roadmap).
Relationship with products: Each product plan belongs to a specific product (product).

ProductPlan Status Values

Status	Chinese	Description
`wait`	Not started	The plan has not started yet
`doing`	In progress	The plan is being executed
`done`	Completed	The plan has been completed

Common Use Cases

1. View all plans of a product

# 列出产品 1 下的所有计划
zentao-cli product-plan list --product 1

2. View details of a specific plan

# 获取计划详情
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	Plan ID
product	u64	Owning product ID
name	string	Plan name
code	string	Plan code name
status	string	Plan status: wait / doing / done
type	string	Plan type: ship / roadmap

Gotchas

Product Required：productplan list requires specifying the --product parameter to filter plans for a specific product.
Plan type: Distinguish release plans (ship) from roadmaps (roadmap) via the type field.
Difference from Release: ProductPlan is at the planning level, while Release is the actual release version record.