mcpField
Z
zentao-product

zentao-product

github.com/imyuyu生产力361 次安装22 周前更新
代码仓库

关于 zentao-product

通过 `zentao-cli` 管理禅道产品的技能,支持列出、查看、创建、更新和删除产品,并说明状态、访问权限以及产品与项目和需求的关系。

主要功能

  1. 01列出可访问的产品
  2. 02查看产品详情
  3. 03创建、更新和删除产品
  4. 04说明产品状态与访问控制
  5. 05介绍产品、项目和需求的关系

适用场景

  1. 01查找账号可访问的产品
  2. 02查看产品后列出其需求

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/imyuyu/zentao-cli --skill zentao-product

安装后在 Claude Code 中输入/zentao-product确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
zentao-product-create.md
zentao-product-delete.md
zentao-product-get.md
zentao-product-list.md
zentao-product-update.md

详细介绍

来自项目 README

product (v2)

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../zentao-shared/SKILL.md,其中包含认证、环境变量配置、错误处理和通用选项说明。

Commands

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

FieldTypeDescription
idu64产品 ID
namestring产品名称
codestring产品代号(英文标识)
statusstring产品状态:normal(正常)/ closed(关闭)
descstring产品描述(可选)

Gotchas

  1. No Filtering Options:product list 命令不需要额外参数,直接列出所有有权限访问的产品。

  2. Product vs Project:区分产品和项目:

    • Product:产品视角,关注"要做什么功能"
    • Project:项目视角,关注"怎么实现这些功能"
  3. Product ID Required:创建需求(Story)时必须指定 --product 参数。

  4. Product ACL:产品有权限控制,只有被分配了产品权限的用户才能查看或操作该产品下的资源。

  5. Closed Product:已关闭的产品(status=closed)通常不再接收新的需求或 Bug。

评论

支持 Markdown