القائمة
Bug 排查追踪系统。管理离散的 bug 排查会话，记录排查范围、发现和进度，避免依赖记忆追踪排查状态。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | bug-patrol |
| description | Bug 排查追踪系统。管理离散的 bug 排查会话，记录排查范围、发现和进度，避免依赖记忆追踪排查状态。 |
| user-invocable | true |
这是一个元级别的排查追踪工具，不是调试单个 bug 的方法论（那是 debug-guide 的职责）。
它解决的问题：
用户察觉到某个地方有问题，描述现象，AI 去排查定位。这是最常用的模式。
用户选择一个功能区域，AI 按检查点逐项排查。用于主动发现潜在问题。
00_bug-patrol/TRACKER.md00_bug-patrol/sessions/用户说以下类似的话时触发：
触发：用户描述一个问题现象（如"代理请求偶尔超时"、"token 刷新有时候失败"）
执行步骤：
00_bug-patrol/TRACKER.mdgit rev-parse --short HEAD 获取当前 commit SHA00_bug-patrol/sessions/ 创建会话文件排查结束时，给出结论：
情况 1：通过代码审查定位到根因
情况 2：代码审查无法确定，需要运行时验证
情况 3：未发现问题
文件命名：YYYY-MM-DD_问题关键词.md（如 2026-02-22_token刷新失败.md）
# 问题排查：[问题简述]
- 日期：YYYY-MM-DD
- 基线 commit：`SHA` (commit message)
- 问题描述：[用户原始描述]
- 涉及区域：[区域编号] [区域名]
## 排查过程
### 1. [排查的第一个文件/模块]
文件：`路径`
[排查内容和发现]
### 2. [排查的第二个文件/模块]
文件：`路径`
[排查内容和发现]
## 发现
- 🐛 [P1] [问题描述] — 已确认 / 待确认
- ⚠️ [P2] [问题描述] — 待确认
## 根因分析
[根因分析，或"需要运行时验证"的说明]
## 结论
[总结和后续建议]
触发词："开始排查"、"bug patrol"、"巡查 [区域编号]"
执行步骤：
00_bug-patrol/TRACKER.md（不存在则初始化）git rev-parse --short HEAD 获取当前 commit SHAgit diff --name-only <上次基线>..HEAD 找出变更文件，将涉及的已排查区域标记为 🔄 需复查文件命名：YYYY-MM-DD_区域编号_区域名.md（如 2026-02-22_R1.1_Token管理.md）
# 系统巡查：[区域编号] [区域名]
- 日期：YYYY-MM-DD
- 基线 commit：`SHA` (commit message)
- 排查区域：[区域编号] [区域名]
- 核心文件：（从 area-map 复制）
## 排查过程
### 检查：[检查点名称]
文件：`路径`
- ✅ [正常项描述]
- ⚠️ [P2] [问题描述] — 待确认
- 🐛 [P1] [问题描述] — 已确认
## 发现
（汇总所有问题）
## 结论
（区域质量评估）
触发词："结束排查"、"排查结束"、"收工"
执行步骤：
00_bug-patrol/TRACKER.md：
触发词："排查进度"、"排查状态"、"哪些还没查"
执行步骤：
00_bug-patrol/TRACKER.md