用途:通过 zentao-cli 在禅道中管理缺陷(Bug),包括查询列表、查看详情、创建、更新状态、解决、确认、关闭、激活和删除 Bug。
主要能力:bug 命令集含 list、get、create、update、resolve、confirm、close、activate、delete。严重程度 severity 分 1-5 级:1 最严重(系统崩溃、数据丢失),5 为功能建议;优先级 pri 分 1-4,两者概念不同,需分别设置。Bug 主状态为 active(激活)/resolved(已解决)/closed(已关闭),resolved 需指定 resolution(fixed/duplicate/notrepro/wonfix/bysdesign)。状态流转:active 可转 resolved 或 closed;resolved 可转 active 或 closed;closed 可重新激活。closed 不能从 active 直接进入,须先 resolved 再 closed(wonfix/bysdesign 等情况例外)。
使用方式:开始前必须先用 Read 工具读取 ../zentao-shared/SKILL.md,其中包含认证、环境变量、错误处理和状态值定义。常用示例:zen-tao-cli bug list --product 1 --status active;zen-tao-cli bug create --title "用户登录页面崩溃" --product 1 --severity 1 --pri 1;zen-tao-cli bug update 123 --status resolved --resolution fixed;zen-tao-cli bug list --product 1 --assigned-to developer-name。创建时可用 --story 和 --project 关联需求或项目,--steps 建议用 \n 分隔多行。
错误处理:常见错误码含 ZEN_AUTH_FAILED、ZEN_NOT_FOUND、ZEN_CONFIG_INVALID、ZEN_API_ERROR、ZEN_PARAM_MISSING,需检查 ZENTAO_URL、ZENTAO_TOKEN 等配置。输出 Bug 详情时建议同时给出 web UI 链接。
限制:仅覆盖缺陷管理相关操作,其他功能、价格、平台支持范围资料暂未提供。