imyuyu project (v2)
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../zentao-shared/SKILL.md，其中包含认证、环境变量配置、错误处理和通用选项说明。
Commands
project list— 列出所有项目project get— 获取项目详情project create— 创建新项目project update— 更新项目信息project delete— 删除项目
Core Concepts
- Project（项目）：ZenTao 中组织任务和团队成员的实体，一个项目可以关联多个产品。
- Project ID：项目的唯一标识符，查看任务和团队成员时需要使用。
- Project 与 Product 的关系：项目从产品中选取需求来实施，一个项目可以对应多个产品，一个产品也可以对应多个项目。
Project Status Values
| Status | 中文 | 说明 |
|---|---|---|
wait |
等待中 | 项目未开始 |
doing |
进行中 | 项目正在进行 |
suspended |
挂起 | 项目已暂停 |
closed |
已关闭 | 项目已结束 |
Project Team
| Field | Type | Description |
|---|---|---|
| PM | u64 | 项目经理 ID |
| team | string | 团队名称 |
| users | array | 团队成员列表 |
使用前可先运行
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
| Field | Type | Description |
|---|---|---|
| id | u64 | 项目 ID |
| name | string | 项目名称 |
| code | string | 项目代号 |
| status | string | 项目状态：wait / doing / suspended / closed |
| desc | string | 项目描述 |
| acl | string | 访问控制级别 |
| opened_by | string | 创建者 |
| opened_date | string | 创建日期 |
| PM | u64 | 项目经理 ID |
| team | string | 团队名称 |
| users | array | 团队成员 |
Gotchas
Project vs Product：区分项目和产品：
- Product：产品视角，关注"要做什么功能"（需求）
- Project：项目视角，关注"怎么实现这些功能"（任务）
Status Filtering：
--status参数支持wait、doing、suspended、closed四个值，不区分大小写。Project ACL：项目有访问控制级别（acl），只有项目成员或符合权限条件的用户才能查看项目详情。
Team Members：通过
users字段返回团队成员列表，完整成员详情可能需要额外查询。Project Manager：PM 字段只返回项目经理的用户 ID，需要时可结合
zentao-cli user get <id>获取更多信息。Opened Date Format：返回的日期格式为 ZenTao API 标准格式，可能需要转换本地时区显示。