# Bug Analyze

> Bug Analyze is an Agent Skill for testing & quality published in the CTeX-org/ctex-kit repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

分析 Bug 类型 Issue, 定位根因, 并对简单 Bug 自动创建修复 PR。

- Skill name: `bug-analyze`
- Category: [Testing & Quality](https://www.openparable.com/skill/testing-quality/1)
- Source: https://github.com/CTeX-org/ctex-kit/blob/HEAD/.claude/skills/bug-analyze/SKILL.md
- Repository: CTeX-org/ctex-kit (1,044 GitHub stars when collected)

## SKILL.md

# bug-analyze

分析 `bug` 标签的 Issue，定位根因。简单 Bug 尝试自动修复。

> 遵循 `github-comment` 规范。

## 严重程度标准

| 级别 | 定义 | 示例 |
|------|------|------|
| **critical** | 系统崩溃、数据丢失、安全漏洞 | 生产环境宕机、用户数据泄露 |
| **high** | 核心功能不可用、无 workaround | 登录失败、支付无法完成 |
| **medium** | 功能受损但有 workaround | 导出功能异常但可手动处理 |
| **low** | 体验问题、边缘场景 | 样式错位、罕见输入报错 |

## 可自动修复判断

**可以自动修复**：
- 改动 ≤ 20 行
- 改动范围明确（单文件或紧密相关文件）
- 修复逻辑清晰，无歧义
- 不涉及架构变更

**不自动修复**：
- 需要澄清需求
- 涉及多个模块协调
- 可能有多种修复方案
- 影响范围不确定

## 特殊规则

- 自动修复分支: `fix/vast-github-bot/{short-description}`
- 简单 Bug 可直接创建 PR 修复
- PR body 包含 `Closes #issue_number`

## 模板

```markdown
## 🐛 Bug 分析 #${issue_number}

| 项目 | 结果 |
|------|------|
| **根因** | {一句话概括} |
| **严重程度** | 🔴 critical / 🟠 high / 🟡 medium / 🟢 low |
| **可自动修复** | ✅ 是 / ❌ 否 |

<details>
<summary><h3>📋 详细分析</h3></summary>

**复现路径**:
1. {步骤}

**代码定位**: [{文件}:{行号}]({github_link})

**问题原因**: {技术分析}

</details>

{如已创建修复 PR}
---
✅ **修复 PR**: #{pr_number}
```

---

Source: https://www.openparable.com/skill/testing-quality/bug-analyze (OpenParable). Cite the canonical URL above.
