zentao-task
禅道(ZenTao) 任务管理 — 创建任务、查看任务列表、更新任务状态、分配负责人、开始任务、暂停任务、完成任务、关闭任务。当用户说:'查询任务'、'任务列表'、'有哪些任务'、'task 列表'、'查看任务'、'task 详情'、'创建任务'、'新建 task'、'指派任务'、'开始任务'、'完成任务'、'任务状态'、'待办任务'、'我的任务'、'禅道任务' 时触发。
How do I install this agent skill?
npx skills add https://github.com/imyuyu/zentao-cli --skill zentao-taskIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides a functional integration for managing tasks in ZenTao via the zentao-cli. It uses standard command execution patterns and includes documentation for task lifecycle management, priority handling, and error resolution. No malicious code, obfuscation, or unauthorized data exfiltration patterns were detected.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
Task (任务)
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../zentao-shared/SKILL.md,其中包含认证、权限处理、配置说明
任务搜索技巧:先区分用户是否特地指定使用搜索 skill,以及是否真的提供了查询关键字(例如任务名称、关键词、片段描述)。如果用户特地指定使用搜索 skill,或明确给出了任务查询关键字,则优先使用搜索型命令。如果用户没有特地指定使用搜索 skill,且意图里没有查询关键字,只有范围条件(例如"已完成""由我创建""指派给我"),应优先使用列表型能力(
task list)。意图区分补充:像"搜索任务"这类表达,虽然字面带有"搜索",但如果没有真正的查询关键字,且本质是在限定范围条件,应优先走
task list。用户身份识别:在用户身份场景下,如果用户提到了"我"(例如"分配给我"、"由我创建"),请获取当前登录用户的相关信息。
友好输出:在输出任务详情时,建议同时提取并输出命令返回结果中的相关链接字段(如果有),以便用户可以直接点击跳转查看详情。
Commands
task list— List taskstask get— Get task detailstask create— Create a tasktask update— Update a tasktask delete— Delete a tasktask start— Start a tasktask pause— Pause a tasktask restart— Restart a paused tasktask finish— Finish a tasktask close— Close a tasktask estimate— Add work estimate logstask 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
- 只有设置了
due(截止时间)的情况下,才能设置reminder(提醒时间) - 如果同时设置了
start(开始时间)和due(截止时间),开始时间必须小于或等于截止时间 - 任务 ID 是全局唯一标识,不是任务编号(例如
t104121) - 删除操作不可恢复,执行前请确认用户意图
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 | 创建时间 |
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/imyuyu/zentao-cli/zentao-task">View zentao-task on skillZs</a>