关于 zentao-product
通过 `zentao-cli` 管理禅道产品的技能,支持列出、查看、创建、更新和删除产品,并说明状态、访问权限以及产品与项目和需求的关系。
主要功能
- 01列出可访问的产品
- 02查看产品详情
- 03创建、更新和删除产品
- 04说明产品状态与访问控制
- 05介绍产品、项目和需求的关系
适用场景
- 01查找账号可访问的产品
- 02查看产品后列出其需求
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ imyuyu/ zentao-cli --skill zentao-product安装后在 Claude Code 中输入/zentao-product确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/zentao-product-create.mdzentao-product-delete.mdzentao-product-get.mdzentao-product-list.mdzentao-product-update.md详细介绍
来自项目 READMEproduct (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。
评论
支持 Markdown