Bug 管理命令

命令	描述
/chandao bug list [--product <id>] [--project <id>] [--execution <id>] [--limit N] [--page N]	列出 Bug（支持按产品/项目/执行筛选）
/chandao bug get <id>	Bug 详情
/chandao bug create --product <id> --title <title> [--assigned <user>] [--pri 1-4] [--severity 1-4] [--type <type>] [--opened-build <build>] [--desc <desc>] [--module <id>] [--execution <id>] [--task <id>] [--story <id>] [--os <os>] [--browser <browser>]	创建 Bug
/chandao bug update <id> [--title <title>] [--assigned <user>] [--pri 1-4] [--severity 1-4] [--type <type>] [--opened-build <build>] [--steps <desc>] [--project <id>] [--execution <id>] [--story <id>]	编辑 Bug
/chandao bug resolve <id> --resolution fixed|bydesign|external|postponed|willnotfix|duplicate|notrepro [--assigned-to <user>] [--resolved-build <build>] [--comment <text>]	解决 Bug
/chandao bug close <id> [--comment <text>]	关闭 Bug
/chandao bug activate <id> [--opened-build <build>] [--assigned-to <user>] [--comment <text>]	激活 Bug
/chandao bug delete <id>	删除 Bug

关键注意事项

• 状态流转必须用专用端点：bug resolve/close/activate，bug update --status 无效
• 解决建议传 --assigned-to：否则会清空指派人
• 解决建议传 --resolved-build：禅道可能要求「解决版本」不能为空
• 按执行查 Bug：bug list --execution <id>
• 关联需求：bug update 支持 --story，可关联需求 ID
• 只关联一个主需求：禅道 Bug 的 story 字段是单值
• bug list 没有 --pri 参数：优先级过滤需在禅道 Web UI 操作

字段枚举值

字段	枚举值	说明
--type	codeerror 代码错误 · config 配置相关 · install 安装部署 · security 安全相关 · performance 性能问题 · standard 标准规范 · automation 测试脚本 · designdefect 设计缺陷 · others 其他	Bug 类型（默认 codeerror）
--severity	1 致命 · 2 严重 · 3 一般 · 4 建议	严重程度（默认 3）
--pri	1 紧急 · 2 高 · 3 中 · 4 低	优先级（默认 3）
--resolution	fixed 已修复 · notrepro 无法重现 · bydesign 设计如此 · duplicate 重复 Bug · external 外部原因 · postponed 延期处理 · willnotfix 不予解决 · tostory 转为需求	解决方案（resolve 时必填）

⚠️ 更新操作前必须先获取当前值

问题：禅道 API 的 PUT 请求会将未包含的字段重置为默认值。

正确流程：

1. 先执行 <module> get <id> 获取当前值
2. 保留需要保持不变的字段值
3. 只修改需要更新的字段
4. 将所有字段一起发送更新请求

详见：references/pitfalls.md 第 23 条