project (v2)

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

Commands

• [project list](./references/zentao-project-list.md) — 列出所有项目
• [project get](./references/zentao-project-get.md) — 获取项目详情
• [project create](./references/zentao-project-create.md) — 创建新项目
• [project update](./references/zentao-project-update.md) — 更新项目信息
• [project delete](./references/zentao-project-delete.md) — 删除项目

Core Concepts

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

Project Status Values

Project Team

使用前可先运行 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

Gotchas

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

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

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

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

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

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

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