用途:在禅道中管理需求(Story),覆盖列出、查看、创建、更新、变更、删除、关闭等操作,适用于查询需求列表、查看详情、新建需求、需求变更与状态调整等场景。
主要能力:支持按产品、项目、状态筛选需求;获取需求详情(描述、预估工时、阶段等);创建需求并指定标题、产品、优先级、类型、预估工时;更新状态、优先级与指派人;变更、删除和关闭需求。
使用方式:开始前必须先用 Read 工具读取 ../zentao-shared/SKILL.md,其中包含认证、环境变量配置、错误处理和状态值定义。可先运行 zentao-cli story --help 查看完整选项。常用命令示例: zentao-cli story list --product 1 zentao-cli story list --product 1 --status active zentao-cli story get 123 zentao-cli story create --title "用户登录功能" --product 1 --pri 1 zentao-cli story update 123 --status closed
状态与字段:需求生命周期为 draft → active → changed → closed,closed 可重新激活为 active;合法转换包括 draft→active、active→changed/closed、changed→active/closed、closed→active。状态值有 draft(草稿)、active(活跃)、changed(已变更)、closed(已关闭)。优先级 1 最高至 4 低,0 通常表示未设置。类型包括 feature、enhance、bugfix、task、story。阶段包括 wait、plan、developed、testing、released、closed。输出字段含 id、title、product、status、pri、category、stage、module、assigned_to、opened_by、estimate、version。
限制与注意:创建需求后返回的是数字 ID,后续操作需使用 ID;只有符合状态转换规则的变更才会被接受,错误转换会返回错误;更新时建议提供 version 字段实现乐观锁;--estimate 单位为小时;创建需求时 --product 为必需参数,需求必须归属某个产品。其他未在资料中说明的细节暂未提供。