mcpField
Z
zentao-project

zentao-project

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

关于 zentao-project

zentao-project 是用于通过 zentao-cli 管理 ZenTao 项目的技能，面向需要查看项目、团队及关联需求和任务的用户。它支持项目的查询与增删改，并提供项目状态和成员信息。

主要功能

  1. 01列出所有项目
  2. 02查看项目详情
  3. 03创建、更新或删除项目
  4. 04查看项目状态和团队信息
  5. 05结合需求与任务查看项目

适用场景

  1. 01盘点现有项目
  2. 02检查项目详情和团队成员
  3. 03维护项目资料
  4. 04查看项目关联的需求与任务

安装

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

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

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

包含的文件

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

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

详细介绍

来自项目 README

project (v2)

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

Commands

Core Concepts

  • Project（项目）：ZenTao 中组织任务和团队成员的实体，一个项目可以关联多个产品。
  • Project ID：项目的唯一标识符，查看任务和团队成员时需要使用。
  • Project 与 Product 的关系：项目从产品中选取需求来实施，一个项目可以对应多个产品，一个产品也可以对应多个项目。

Project Status Values

Status中文说明
wait等待中项目未开始
doing进行中项目正在进行
suspended挂起项目已暂停
closed已关闭项目已结束

Project Team

FieldTypeDescription
PMu64项目经理 ID
teamstring团队名称
usersarray团队成员列表

使用前可先运行 zentao-cli project --help 查看完整选项。

Common Use Cases

1. 查看所有项目
# 列出所有项目
zentao-cli project list
2. 查看特定项目详情
# 获取项目详情
zentao-cli project get 1
4. 结合 Story 和 Task 使用

项目通常与需求和任务管理结合使用：

# 查看项目详情
zentao-cli project get 1

# 查看该项目关联的需求
zentao-cli story list --product 1 --project 1

# 查看该项目的任务
zentao-cli task list --project 1

Examples

# 列出所有项目
zentao-cli project list

# 获取项目详情
zentao-cli project get 1

# 查看项目关联的需求
zentao-cli story list --product 1 --project 1

# 查看项目的任务
zentao-cli task list --project 1

Output Fields

FieldTypeDescription
idu64项目 ID
namestring项目名称
codestring项目代号
statusstring项目状态：wait / doing / suspended / closed
descstring项目描述
aclstring访问控制级别
opened_bystring创建者
opened_datestring创建日期
PMu64项目经理 ID
teamstring团队名称
usersarray团队成员

Gotchas

  1. Project vs Product：区分项目和产品：

    • Product：产品视角，关注"要做什么功能"（需求）
    • Project：项目视角，关注"怎么实现这些功能"（任务）

  2. Status Filtering：--status 参数支持 wait、doing、suspended、closed 四个值，不区分大小写。

  3. Project ACL：项目有访问控制级别（acl），只有项目成员或符合权限条件的用户才能查看项目详情。

  4. Team Members：通过 users 字段返回团队成员列表，完整成员详情可能需要额外查询。

  5. Project Manager：PM 字段只返回项目经理的用户 ID，需要时可结合 zentao-cli user get <id> 获取更多信息。

  6. Opened Date Format：返回的日期格式为 ZenTao API 标准格式，可能需要转换本地时区显示。

评论

支持 Markdown