---
name: bug
description: 通用缺陷(Bug)概念规范——Bug 定义、通用生命周期、严重度/优先级、与用例/功能/迭代的关系、关闭门禁。agent 处理 Bug 时据此操作。产线可用同名 skill 覆盖。触发：提交/确认/修复/验证/关闭 Bug，或提到缺陷、故障、问题单。
capability: bug_capability
tools: [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 覆盖具体流转与角色权限。