zentao-task

Task (任务)

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../zentao-shared/SKILL.md，其中包含认证、权限处理、配置说明

任务搜索技巧：先区分用户是否特地指定使用搜索 skill，以及是否真的提供了查询关键字（例如任务名称、关键词、片段描述）。如果用户特地指定使用搜索 skill，或明确给出了任务查询关键字，则优先使用搜索型命令。如果用户没有特地指定使用搜索 skill，且意图里没有查询关键字，只有范围条件（例如"已完成""由我创建""指派给我"），应优先使用列表型能力（task list）。

意图区分补充：像"搜索任务"这类表达，虽然字面带有"搜索"，但如果没有真正的查询关键字，且本质是在限定范围条件，应优先走 task list。

用户身份识别：在用户身份场景下，如果用户提到了"我"（例如"分配给我"、"由我创建"），请获取当前登录用户的相关信息。

友好输出：在输出任务详情时，建议同时提取并输出命令返回结果中的相关链接字段（如果有），以便用户可以直接点击跳转查看详情。

Commands

• task list — List tasks
• task get — Get task details
• task create — Create a task
• task update — Update a task
• task delete — Delete a task
• task start — Start a task
• task pause — Pause a task
• task restart — Restart a paused task
• task finish — Finish a task
• task close — Close a task
• task estimate — Add work estimate logs
• task get-estimate — Get estimate logs

Common Use Cases

列出项目任务

# 列出项目所有任务
zentao-cli task list --project 1

# 只看我被指派的任务
zentao-cli task list --project 1 --assigned-to me

获取任务详情

zentao-cli task get 456

创建任务

# 创建简单任务
zentao-cli task create --name "实现登录功能" --project 1 --pri 3

# 创建任务并指定负责人、预估工时
zentao-cli task create --name "代码评审" --project 1 --pri 2 --assigned-to developer-name --estimate 4

更新任务

# 更新任务状态
zentao-cli task update 456 --status done

# 更新任务负责人
zentao-cli task update 456 --assigned-to another-user

# 更新任务状态为进行中
zentao-cli task update 456 --status doing

任务状态值

状态	说明
wait	等待中
doing	进行中
done	已完成
closed	已关闭

优先级

级别	说明
1	最高
2	高
3	中
4	低

Error Handling

常见错误

错误码	说明	处理方式
ZEN_NOT_FOUND	任务不存在	检查任务 ID 是否正确
ZEN_AUTH_FAILED	认证失败	检查 ZENTAO_TOKEN 是否有效
ZEN_PARAM_MISSING	缺少参数	查看命令帮助确认必需参数

错误处理示例

# 查看认证状态
zentao-cli auth status

# 验证配置
echo $ZENTAO_URL
echo $ZENTAO_TOKEN

Gotchas

1. 只有设置了 due（截止时间）的情况下，才能设置 reminder（提醒时间）
2. 如果同时设置了 start（开始时间）和 due（截止时间），开始时间必须小于或等于截止时间
3. 任务 ID 是全局唯一标识，不是任务编号（例如 t104121）
4. 删除操作不可恢复，执行前请确认用户意图

Examples

# 列出项目所有任务
zentao-cli task list --project 1

# 只看我被指派的任务
zentao-cli task list --project 1 --assigned-to me

# 获取任务详情
zentao-cli task get 456

# 创建任务
zentao-cli task create --name "实现登录功能" --project 1 --pri 3

# 更新任务状态
zentao-cli task update 456 --status done

Field Reference

字段	类型	说明
id	u64	任务 ID
name	string	任务名称
project	u64	所属项目 ID
execution	u64	所属执行/迭代 ID
assigned_to	string	负责人用户名
status	string	任务状态
pri	u64	优先级
estimate	float	预估工时（小时）
consumed	float	已消耗工时（小时）
start	string	开始时间
due	string	截止时间
created_by	string	创建人
created_date	string	创建时间