zentao-product

product (v2)

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

• product list — List all accessible products
• product get — Get product details
• product create — Create a new product
• product update — Update product information
• product delete — Delete a product

Core Concepts

• Product: The top-level entity in ZenTao; a product contains multiple requirements (Story) and bugs (Bug).
• Product ID: The unique identifier of the product; when creating a requirement, the ID of the product it belongs to must be specified.
• Relationship between Product and Project: A product defines "what to do", and a project defines "how to do it". One product can be associated with multiple projects.

Product Status Values

Status	Chinese	Description
normal	Normal	The product is in a normal, usable state
closed	Closed	The product has been closed and no longer accepts new requirements

Before use, you can first run zentao-cli product --help to view the complete options.

Common Use Cases

1. View all accessible products

# 列出所有产品
zentao-cli product list

2. View details of a specific product

# 获取产品详情
zentao-cli product get 1

3. Use in combination with Story

Products are usually used in combination with requirement management:

# 先获取产品列表，了解有哪些产品
zentao-cli product list

# 再查看某个产品下的需求
zentao-cli story list --product 1

Examples

# 列出所有产品
zentao-cli product list

# 获取产品详情
zentao-cli product get 1

# 查看某产品下的需求
zentao-cli story list --product 1

Output Fields

Field	Type	Description
id	u64	Product ID
name	string	Product name
code	string	Product code (English identifier)
status	string	Product status: normal / closed
desc	string	Product description (optional)

Gotchas

1. No Filtering Options：product list The command requires no additional parameters and directly lists all products you have permission to access.

2. Product vs Project: Distinguish between products and projects:

   • Product: Product perspective, focusing on "what features to build"
   • Project: Project perspective, focusing on "how to implement these features"

3. Product ID Required: When creating a requirement (Story), you must specify the --product parameter.

4. Product ACL: Products have permission control; only users who have been assigned product permissions can view or operate resources under that product.

5. Closed Product: Closed products (status=closed) usually no longer accept new requirements or bugs.