القائمة
禅道(ZenTao) 版本/Build 管理 — 列出版本、获取版本详情、创建版本、关联 Story 和 Bug。当用户说：'查询版本'、'版本列表'、'build 列表'、'查看版本'、'版本详情'、'创建版本'、'新建 build'、'发布版本'、'版本信息'、'CI 版本'、'禅道版本' 时触发。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | zentao-build |
| version | 1.2.0 |
| description | 禅道(ZenTao) 版本/Build 管理 — 列出版本、获取版本详情、创建版本、关联 Story 和 Bug。当用户说：'查询版本'、'版本列表'、'build 列表'、'查看版本'、'版本详情'、'创建版本'、'新建 build'、'发布版本'、'版本信息'、'CI 版本'、'禅道版本' 时触发。 |
| metadata | {"requires":{"bins":["zentao-cli"]},"cliHelp":"zentao-cli build --help"} |
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../zentao-shared/SKILL.md，其中包含认证、权限处理、配置说明
版本搜索技巧：先区分用户是否特地指定使用搜索 skill，以及是否真的提供了查询关键字（例如版本名称、关键词）。如果用户特地指定使用搜索 skill，或明确给出了查询关键字，则优先使用搜索。如果用户没有特地指定使用搜索 skill，且意图里没有查询关键字，只有范围条件（例如"某产品的版本"、"某项目的版本"），应优先使用
build list。友好输出：在输出版本详情时，建议同时提取并输出命令返回结果中的相关链接字段（如果有），以便用户可以直接点击跳转查看详情。
build list — List builds/versionsbuild get — Get build detailsbuild create — Create a buildbuild update — Update a buildbuild delete — Delete a build# 列出所有版本
zentao-cli build list
# 列出某项目的版本
zentao-cli build list --project 1
# 列出某产品的版本
zentao-cli build list --product 1
# 同时按项目和产品筛选
zentao-cli build list --project 1 --product 1
# 列出某执行的版本
zentao-cli build list --execution 5
# 获取版本详情
zentao-cli build get 10
# 获取版本详情（JSON 格式）
zentao-cli build get 10 --format json
| Field | Type | Description |
|---|---|---|
| id | u64 | Build ID |
| name | string | Build 名称（例如 "v1.0.0", "Build-2024-01-15"） |
| product | u64 | 产品 ID |
| project | u64 | 项目 ID |
| branch | u64 | 分支/平台 ID |
| scm_path | string | SCM 仓库路径 |
| ci | string | CI 任务名称 |
| pkg | string | 包路径 |
| file_size | string | 文件大小（字节） |
| generated_at | string | 构建时间戳 |
| editor | string | 最后编辑者 |
| created_by | string | 创建人 |
| created_date | string | 创建时间 |
| last_edited_by | string | 最后编辑者 |
| last_edited_date | string | 最后编辑时间 |
| stories | string | 关联的需求数量 |
| bugs | string | 关联的 Bug 数量 |
| 错误码 | 说明 | 处理方式 |
|---|---|---|
ZEN_NOT_FOUND | 版本不存在 | 检查 Build ID 是否正确 |
ZEN_AUTH_FAILED | 认证失败 | 检查 ZENTAO_TOKEN 是否有效 |
ZEN_PARAM_MISSING | 缺少参数 | 查看命令帮助确认必需参数 |
# 查看认证状态
zentao-cli auth status
# 验证配置
echo $ZENTAO_URL
echo $ZENTAO_TOKEN
# 列出所有版本
zentao-cli build list
# 列出某项目的版本
zentao-cli build list --project 1
# 列出某产品的版本
zentao-cli build list --product 1
# 获取版本详情
zentao-cli build get 10
# 获取版本详情（JSON 格式）
zentao-cli build get 10 --format json
stories 和 bugs 字段| 操作 | 所需权限 |
|---|---|
build list | 项目/产品查看权限 |
build get | 项目/产品查看权限 |
禅道(ZenTao) 产品计划（ProductPlan）管理 — 列出产品计划、获取产品计划详情。当用户说：'查询产品计划'、'产品计划列表'、'有哪些计划'、'productplan 列表'、'查看产品计划'、'计划详情'、'禅道产品计划' 时触发。
禅道(ZenTao) 任务管理 — 创建任务、查看任务列表、更新任务状态、分配负责人、开始任务、暂停任务、完成任务、关闭任务。当用户说：'查询任务'、'任务列表'、'有哪些任务'、'task 列表'、'查看任务'、'task 详情'、'创建任务'、'新建 task'、'指派任务'、'开始任务'、'完成任务'、'任务状态'、'待办任务'、'我的任务'、'禅道任务' 时触发。
禅道(ZenTao) Bug (缺陷) 管理 - 查询 bug 列表、查看 bug 详情、创建 bug、更新 bug状态、解决 bug、关闭 bug。当用户说：'查询 bug'、'有哪些 bug'、'bug 列表'、'查看 bug'、'创建缺陷'、'报告 bug'、'登记 bug'、'缺陷'、'bug 数量'、'待处理 bug'、'bug 状态'、'禅道 bug' 时触发。
禅道(ZenTao) 执行/迭代（Execution）管理 — 列出执行、获取执行详情、创建执行。当用户说：'查询执行'、'执行列表'、'execution 列表'、'查看执行'、'执行详情'、'创建执行'、'新建 execution'、'迭代'、'Sprint'、'里程碑'、'禅道执行' 时触发。
禅道(ZenTao) 测试用例（Testcase）管理 — 列出用例、查看用例详情、按产品/项目查询用例、执行用例。当用户说：'查询用例'、'用例列表'、'有哪些用例'、'testcase 列表'、'查看用例'、'用例详情'、'创建用例'、'新建 testcase'、'执行用例'、'用例结果'、'测试用例'、'禅道用例' 时触发。
禅道(ZenTao) 反馈（Feedback）管理 — 列出反馈、获取反馈详情。当用户说：'查询反馈'、'反馈列表'、'有哪些反馈'、'feedback 列表'、'查看反馈'、'反馈详情'、'用户反馈'、'禅道反馈' 时触发。