zentao-product について
`zentao-cli` で ZenTao の製品を管理するスキルです。製品の一覧表示、参照、作成、更新、削除に加え、ステータスや権限、プロジェクトやストーリーとの関係も説明します。
主な機能
- 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詳細
プロジェクトの README より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。
コメント
Markdown 対応