skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
imyuyu/zentao-cli62 installs

zentao-task

禅道(ZenTao) 任务管理 — 创建任务、查看任务列表、更新任务状态、分配负责人、开始任务、暂停任务、完成任务、关闭任务。当用户说:'查询任务'、'任务列表'、'有哪些任务'、'task 列表'、'查看任务'、'task 详情'、'创建任务'、'新建 task'、'指派任务'、'开始任务'、'完成任务'、'任务状态'、'待办任务'、'我的任务'、'禅道任务' 时触发。

How do I install this agent skill?

npx skills add https://github.com/imyuyu/zentao-cli --skill zentao-task
view source ↗

Is 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

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

字段类型说明
idu64任务 ID
namestring任务名称
projectu64所属项目 ID
executionu64所属执行/迭代 ID
assigned_tostring负责人用户名
statusstring任务状态
priu64优先级
estimatefloat预估工时(小时)
consumedfloat已消耗工时(小时)
startstring开始时间
duestring截止时间
created_bystring创建人
created_datestring创建时间

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>