product (v2)
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../zentao-shared/SKILL.md,其中包含认证、环境变量配置、错误处理和通用选项说明。
Commands
product list— 列出所有可访问的产品product get— 获取产品详情product create— 创建新产品product update— 更新产品信息product delete— 删除产品
Core Concepts
- Product(产品):ZenTao 中的顶层实体,一个产品包含多个需求(Story)和缺陷(Bug)。
- Product ID:产品的唯一标识符,创建需求时需要指定所属产品 ID。
- Product 与 Project 的关系:产品定义"做什么",项目定义"怎么做"。一个产品可以关联多个项目。
Product Status Values
| Status | 中文 | 说明 |
|---|---|---|
normal |
正常 | 产品处于正常可用状态 |
closed |
关闭 | 产品已关闭,不再接收新需求 |
使用前可先运行
zentao-cli product --help查看完整选项。
Common Use Cases
1. 查看所有可访问的产品
# 列出所有产品
zentao-cli product list
2. 查看特定产品详情
# 获取产品详情
zentao-cli product get 1
3. 结合 Story 使用
产品通常与需求管理结合使用:
# 先获取产品列表,了解有哪些产品
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 | 产品 ID |
| name | string | 产品名称 |
| code | string | 产品代号(英文标识) |
| status | string | 产品状态:normal(正常)/ closed(关闭) |
| desc | string | 产品描述(可选) |
Gotchas
No Filtering Options:
product list命令不需要额外参数,直接列出所有有权限访问的产品。Product vs Project:区分产品和项目:
- Product:产品视角,关注"要做什么功能"
- Project:项目视角,关注"怎么实现这些功能"
Product ID Required:创建需求(Story)时必须指定
--product参数。Product ACL:产品有权限控制,只有被分配了产品权限的用户才能查看或操作该产品下的资源。
Closed Product:已关闭的产品(status=closed)通常不再接收新的需求或 Bug。