2.6 KiB
Raw Blame History

name description capability tools
bug 通用缺陷(Bug)概念规范——Bug 定义、通用生命周期、严重度/优先级、与用例/功能/迭代的关系、关闭门禁。agent 处理 Bug 时据此操作。产线可用同名 skill 覆盖。触发:提交/确认/修复/验证/关闭 Bug,或提到缺陷、故障、问题单。 bug_capability
report_bug
confirm_bug
start_fix
fix_bug
verify_bug
close_bug
reject_bug
reopen_bug
list_bugs
set_bug_state

Bug(通用概念)

一、概念定义

Bug = 一个软件缺陷的追踪单元,从发现到修复验证闭环。 Bug 由人工或 agent(reporter_type)提交,指派处理人(assignee_id),修复后验证关闭。

二、通用生命周期(状态)

状态 语义
open 新建
confirmed 已确认
fixing 修复中
fixed 已修复
verified 已验证
closed 已关闭
rejected 已驳回

通用流转:open → confirmed → fixing → fixed → verified → closed;open/confirmed 可 → rejected;closed/rejected 可 reopen → open。

三、与其他概念的关系

  • Bug 挂迭代(iteration_id)。
  • Bug 可关联用例(case_id,失败用例驱动)和功能(feature)。
  • 严重度(severity:critical/major/minor/trivial)与优先级(P0-P3)决定处理顺序。

四、门禁(通用)

  • close 前:Bug 已 verified(修复生效)。
  • 迭代准出:未关闭 Bug 清零(或明确豁免)。
  • fix 附修复说明(fix_description)+ 修复提交(fix_commit)。
  • fixed → verified(复测)之间必须经过部署 + QC 验证(铁律,2026-08-24 用户定):Bug 修复(fix_bug → fixed)后,修复代码必须先部署到测试环境(deploy_test 重新部署应用),QC 按 review-deploy 标准验证 /healthz 200 真实通过、新代码已生效,部署验证通过后才派发复测任务给 test(verify_bug)。禁止「fixed 直接复测」跳过部署——否则 test 对着测试环境的旧代码复测,verify_bug 结果无效。部署未通过 → 回退 develop 修部署问题,不进入复测。

五、配套能力(工具)

已固化的 bug 能力(bug_capability): report_bug / confirm_bug / start_fix / fix_bug / verify_bug / close_bug / reject_bug / reopen_bug / list_bugs / set_bug_state(CAS 兜底)。 状态迁移走能力模块(CAS 原子 + 租户隔离 + 审计);CRUD 走 xls2ui 生成的端点。

六、分层覆盖

本 skill 是通用Bug 概念规范;产线可用同名 bug skill 覆盖具体流转与角色权限。