SuperAPI AI 工具集

zentao-user

测试与质量

查看项目

更新于 10-15 22:37

技能介绍

用途:在禅道(ZenTao)中管理用户信息,包括列出用户、查看用户详情、按部门或角色筛选用户,以及创建、更新、删除用户。适用于查询团队成员、开发者、测试人员、谁负责某项工作,或获取当前登录用户信息等场景。

主要能力与命令:user list 列出用户并支持筛选;user get 按 ID 查看用户详情;user me 获取当前用户信息;user create、user update、user delete 分别用于创建、更新、删除用户。

使用方式示例:开始前 MUST 先用 Read 工具读取 ../zentao-shared/SKILL.md,其中包含认证、环境变量和错误处理。列出全部用户:zentao-cli user list;按部门查询:zentao-cli user list --dept 1;按角色查询:zentao-cli user list --role dev;组合筛选:zentao-cli user list --dept 1 --role dev;查看详情:zentao-cli user get 123。

用户标识与角色:用户通过数字 id 标识,也使用 account(账号名),API 调用时需区分两者。角色为字符串,如 dev(开发)、manager(经理)、qa(测试)、pd(产品设计)、op(运维)、admin(管理员)。输出字段含 id、account、realname、email、dept、role、phone、mobile。用户可能没有部门,dept 为 0 或空。

错误处理:常见错误码包括 ZEN_AUTH_FAILED(Token 无效或过期,检查 ZENTAO_TOKEN)、ZEN_NOT_FOUND(用户不存在,检查用户 ID)、ZEN_CONFIG_INVALID(配置无效,验证 ZENTAO_URL 和 ZENTAO_TOKEN)、ZEN_API_ERROR(API 返回错误,检查服务器状态或稍后重试)。可用 zentao-cli auth status 检查认证状态。查询不存在的用户会返回错误而非空列表。

限制:用户管理主要支持查询,不支持批量创建或更新用户,通常需由管理员在 Web 端操作。