通过 zentao 命令行工具查询和操作禅道（ZenTao）数据，覆盖项目集、产品、项目、执行、需求、Bug、任务、测试用例、测试单、产品计划、版本、发布、反馈、工单、应用、用户、附件等模块的增删改查及状态流转。当用户提到禅道、zentao、查询项目进展、获取 Bug 列表、创建任务、更新需求状态等项目管理操作时使用本技能。

禅道 CLI 通过 zentao 命令行工具查询和操作禅道数据。CLI 自动处理认证、分页，支持工作区上下文和数据过滤/排序。前置准备安装如果用户没有安装，引导用户进行全局安装使用，如果系统存在 bun 或 pnpm 则优先使用 bun 或 pnpm 进行全局安装。认证首次执行任意 zentao 命令会自动提示登录。也可显式登录：环境变量（优先级低于命令行参数）：变量说明 ZENTAO URL 禅道服务地址 ZENTAO ACCOUNT 用户账号 ZENTAO PASSWORD 密码 ZENTAO TOKEN 直接指定 Token（有此变量可省略密码）登录成功后凭证缓存在 ~/.config/zentao/zentao.json ，后续无需重复登录。凭证安全用户尚未登录时，不要在对话里收集账号密码。让用户直接在终端执行 zentao login ，或执行任意 zentao 命令触发首次自动登录提示，由用户自行输入凭证。严禁读取本地凭证： ZENTAO PASSWORD / ZENTAO TOKEN 环境变量、 ~/.config/zentao/zentao.json 配置文件。所有禅道数据均通过 zentao 命令获取，凭证由 CLI 内部处理。命令格式使用简写方式（推荐）：操作命令列表 zentao <module 详情 zentao <module <id 创建 zentao <module create field=value 更新 zentao <module update <id field=value 删除 zentao <module delete <id 动作 zentao <module <action <id 帮助 zentao <module help 也支持 data='JSON' 传入 JSON 数据。模块与操作速查模块名中文支持的操作 program 项目集 CRUD product 产品 CRUD project 项目 CRUD execution 执行/迭代 CRUD story 需求 CRUD + activate / change / close epic 业务需求 CRUD + activate / change / close requirement 用户需求 CRUD + activate / change / close bug Bug CRUD + activate / close / resolve task 任务 CRUD + activate / close / finish / start testcase 测试用例 CRUD testtask 测试单 CUD（按产品/项目/执行查列表） productplan 产品计划 CUD（按产品查列表） build 版本 CUD（按项目/执行查列表） release 发布 CUD（按产品查列表） feedback 反馈 CRUD + activate / close ticket 工单 CRUD + activate / close system 应用 CU（按产品查列表） user 用户 CRUD file 附件编辑名称 + 删除 CRUD = 列表 + 详情 + 创建 + 更新 + 删除；CUD = 无独立列表接口，需指定所属范围列表范围参数部分模块的列表需要指定所属范围：设置工作区后可省略这些参数（见下方工作区章节）。 AI 使用策略输出格式展示给用户：不加 format 参数，默认输出 Markdown 表格（列表）或列表（单个对象）需要程序化处理：加 format=json ，返回结构化 JSON 交互确认 AI 场景下执行删除操作时加 yes 跳过确认提示：不知道 ID 时先查列表获取 ID，再操作具体对象：写操作前确认执行创建、更新、删除等写操作前，先向用户确认操作内容。用户明确要求不确认时可跳过。更新操作自动补全执行 update 时，CLI 会先 GET 当前对象，把用户未显式传入的字段用现值填充后再 PUT，避免禅道 PUT 覆盖未提交字段导致清空。因此只需传想改的字段即可，无需手动先查再传完整参数。数据处理摘取字段过滤支持的运算符： : 等于、 != 不等于、 < = <= 、 ~ 包含、 !~ 不包含。模糊搜索排序分页常用操作示例查看进行中的项目和执行创建需求并关联计划创建并解决 Bug 创建、启动并完成任务查看帮助意图识别用户意图 CLI 命令所有产品/项目/项目集 zentao product / zentao project / zentao program 进行中的项目 zentao project filter='status:doing' 某产品的 Bug zentao bug product=<id 某执行的任务 zentao task execution=<id 创建/新增 Bug zentao bug create ... 解决 Bug zentao bug resolve <id 关闭 Bug zentao bug close <id 激活 Bug zentao bug activate <id 创建需求 zentao story create ... 变更/关闭/激活需求 zentao story change/close/activate <id 业务需求 zentao epic ... （同 story）用户需求 zentao requirement ... （同 story）创建/启动/完成/关闭任务 zentao task create/start/finish/close ... 测试用例 zentao testcase ... 测试单 zentao testtask ... 产品计划 zentao productplan ... 版本/Build zentao build ... 发布 zentao release ... 反馈 zentao feedback ... 工单 zentao ticket ... 用户列表 zentao user 当前用户信息 zentao profile 错误处理错误码含义处理方式 E1001 未登录/凭证缺失执行 zentao login E1004 Token 失效执行 zentao login 重新登录 E2001 模块不存在执行 zentao help 查看可用模块 E2002 对象不存在检查 ID 是否正确 E2003 缺少必要参数执行 zentao <module help 或 zentao <module <action help 查看操作参数 E2006 无权限提示用户检查权限 E5001 请求超时检查网络或禅道服务状态注意事项不确定模块参数时，先执行 zentao <module help 查看帮助，不确定操作参数时，先执行 zentao <module <action help 查看帮助 browseType 常用值： all （全部）、 doing （进行中）、 closed （已关闭）多账号切换： zentao profile 查看和切换账号

zentao-cli