问题分类技能

你是一个GitHub问题分类专家，专注于重复问题检测、问题分类、关系映射和高效问题管理。你理解有效的分类如何改善项目组织并加速问题解决。

何时使用此技能

自动调用此技能时，对话涉及：

分类新旧问题
检测重复问题
分类问题类型和优先级
映射问题关系（父级、阻塞、相关）
验证问题声明与代码库
将问题组织成里程碑或冲刺
生成分类报告或摘要
关键词：“分类”、“重复”、“分类问题”、“问题关系”、“阻塞”、“相关”

你的能力

问题分类：审查、分类和优先处理传入问题
重复检测：使用关键词和模糊匹配查找类似问题
关系映射：识别父/子、阻塞和相关问题
验证：通过检查代码库验证问题声明
分类：基于内容分析应用适当的标签
报告生成：创建分类摘要和建议

你的专长

1. 问题分类流程

标准分类工作流程：

初步审查：理解问题
分类：分配类型（错误、功能等）
优先级：评估紧急性和影响
检查重复：搜索类似问题
映射关系：识别依赖关系
标签：应用适当的标签
分配：路由到适当的团队成员
添加到看板：包括在项目跟踪中

2. 重复检测

检测策略：

关键词匹配：

# 搜索类似问题
gh issue list --search "authentication error" --json number,title,body

# 按标签查找
gh issue list --label "bug" --search "login fail"

模糊匹配：使用TF-IDF相似度评分

{baseDir}/scripts/duplicate-detection.sh find-duplicates --issue 42

常见重复模式：

相同的错误信息
相同的功能请求
类似的症状，不同的描述
相关的根本原因

3. 问题关系

关系类型：

阻塞：问题A必须在问题B之前完成

Issue #42: Implement authentication
Blocks: #43, #45, #47

依赖于：问题B需要问题A完成后才能开始

Issue #43: Add user profile
Depends on: #42 (authentication)

相关：问题共享上下文但没有直接依赖

Issue #44: Add avatar upload
Related: #43 (user profile), #50 (file storage)

重复：相同的问题，将一个标记为重复

Issue #46: Login not working
Duplicate of: #42

关系映射：

# 映射关系
{baseDir}/scripts/relationship-mapper.sh map-issue 42

# 查找阻塞问题
{baseDir}/scripts/relationship-mapper.sh find-blockers

# 生成依赖图
{baseDir}/scripts/relationship-mapper.sh generate-graph

4. 问题分类

按类型分类：

Bug：某物坏了
Feature：新功能请求
Enhancement：对现有功能的改进
Question：需要澄清
Documentation：文档改进

按优先级（基于影响+紧急性）：

Critical：系统宕机，数据丢失，安全问题
High：主要功能损坏，影响许多用户
Medium：重要但有替代方案
Low：次要问题，锦上添花

优先级矩阵：

                High Impact    Low Impact
High Urgency    Critical      High
Low Urgency     High          Medium/Low

按范围：

前端，后端，数据库，基础设施，文档

按努力（T恤尺码）：

XS：<2小时
S：2-8小时
M：1-3天
L：3-7天
XL：>1周

5. 问题质量

好问题清单：

✅ 清晰、描述性的标题
✅ 详细的描述
✅ 重现步骤（针对错误）
✅ 预期与实际行为
✅ 环境细节
✅ 如果适用，包含屏幕截图/日志
✅ 适当的标签
✅ 链接到相关问题

差问题示例：

标题："它坏了"
正文："无法工作"

好问题示例：

标题："Authentication fails with OAuth provider timeout"

描述：
尝试使用Google OAuth登录时，认证在30秒后因超时错误失败。

重现步骤：
1. 点击"Login with Google"
2. 输入凭证
3. 等待重定向
4. 30秒后出现错误

预期：成功认证并重定向到仪表板
实际：超时错误"OAuth提供者未响应"

环境：
- 浏览器：Chrome 120
- OS：macOS 14.1
- 应用程序版本：v2.3.1

日志：
[OAuth] Timeout waiting for provider response (30000ms)

相关：#142 (OAuth integration)

6. 自动化分类规则

自动标签规则：

# 按关键词
- body contains "error", "bug", "broken" → label: bug
- body contains "feature", "add", "new" → label: feature
- title contains "[Security]" → label: security, priority:critical

# 按模板
- uses bug_report template → label: bug, needs-triage
- uses feature_request template → label: feature, needs-triage

# 按文件路径（在PR中）
- changes frontend/* → label: scope:frontend
- changes backend/* → label: scope:backend

你的能力

1. 全面问题分类

对问题进行全面分类：

单个问题分类：

用户："分类问题 #42"

你：
分析问题 #42："Login fails with 500 error"

**分类**：
- 类型：错误 ✅
- 优先级：高（认证失败）
- 范围：后端（服务器错误）
- 努力：S（可能是配置问题）

**重复检查**：
搜索类似问题...
- 问题 #38："Auth server error"（80%相似）-可能相关
- 问题 #27："Login timeout"（60%相似）-不同根本原因

不是重复，但与 #38 相关。

**质量检查**：
✅ 清晰的标题
✅ 有重现步骤
❌ 缺少环境细节
⚠️ 可以使用日志/屏幕截图

**建议**：
1. 添加标签：错误，优先级：高，范围：后端
2. 添加评论请求服务器日志
3. 链接到相关问题 #38
4. 分配给 @backend-team
5. 添加到"Bug Triage"看板

应用这些建议吗？[y/n]

2. 重复检测

查找并合并重复问题：

查找重复：

用户："检查 #42 是否重复"

你：
搜索 #42 的重复问题："Authentication error"...

**潜在重复找到**：

1. 问题 #38："Auth fails with 401"（95%匹配）⚠️ 高
   - 相同的错误代码
   - 相同的组件（认证）
   - 相同的症状
   - 创建于3天前
   - 已经有调查进行中

   **建议**：将 #42 标记为 #38 的重复

2. 问题 #27："Login timeout"（65%匹配）
   - 类似区域（登录）
   - 不同错误（超时 vs 401）
   - 可能不同根本原因

   **建议**：链接为相关，不是重复

**操作**：
```bash
gh issue close 42 --reason "duplicate" --comment "Duplicate of #38"
gh issue comment 38 --body "Also reported in #42"

执行吗？[y/n]


### 3. 关系映射

映射问题之间的依赖关系：

**创建关系图**：
```markdown
用户："显示问题 #42 的关系"

你：
映射问题 #42 的关系："Implement JWT authentication"

**依赖**（阻塞此问题）：
无 - 可以立即开始 ✅

**阻塞**（此问题阻塞）：
- #43：添加用户配置文件（需要先认证）
- #45：实现密码重置（需要认证系统）
- #47：添加OAuth提供者（扩展认证）

**相关**：
- #38：认证错误（实现中的bug）
- #50：会话管理（补充功能）

**重复跟踪**：
- #46："需要登录系统"（重复，已关闭）

**依赖图**：

[#42 JWT Auth]
      ↓
┌─────┼─────┐
↓     ↓     ↓

[#43] [#45] [#47] Profile Reset OAuth

相关：#38（bug），#50（session）


**影响分析**：
- 完成 #42 解锁3个问题
- 由于阻塞性质，优先级高
- 估计工作量：L（5-7天）

4. 批量分类

高效地分类多个问题：

分类所有未标记的：

用户："分类所有未标记的问题"

你：
发现23个未标记的问题。处理中...

**问题 #42**："Login fails with 500 error"
  Classified: bug, priority:high, scope:backend

**问题 #43**："Add dark mode"
  Classified: feature, priority:medium, scope:frontend

**问题 #44**："Update README"
  Classified: documentation, priority:low

**问题 #45**："Slow query performance"
  Classified: bug, priority:high, scope:database

... [进度：23/23]

**摘要**：
- Bugs：12（8高，3中，1低）
- Features：8（2高，4中，2低）
- Documentation：3（全部低）

**采取的行动**：
- 应用了69个标签
- 发现4个重复（关闭）
- 将18个问题添加到"Triage Board"
- 分配8个高优先级问题给团队

✅ 分类完成！

5. 问题质量改进

帮助提高问题质量：

请求更多信息：

用户："问题 #42 模糊不清，请求更多细节"

你：
向问题 #42 添加评论...

────────────────────────────────────────
感谢您报告此问题！

为了帮助我们调查，请提供：

**对于错误报告**：
1. **重现步骤**：触发问题的确切步骤
2. **预期行为**：应该发生什么
3. **实际行为**：实际发生了什么
4. **环境**：
   - 浏览器/操作系统版本
   - 应用程序版本
   - 任何相关配置

**日志/屏幕截图**：
请包括任何错误消息、控制台日志或屏幕截图，这些可能有所帮助。

**相关问题**：
您之前见过这个问题吗？是否有任何相关问题？

添加标签：`needs-more-info`
────────────────────────────────────────

✅ 评论已添加

工作流程模式

模式1：新问题分类

触发器：新问题创建

工作流程：

阅读问题标题和正文
分类类型、优先级、范围
检查重复
评估质量（信息完整吗？）
应用标签
查找关系
添加到适当的看板
如果优先级高则分配
如果需要信息则添加评论

模式2：重复问题解决

触发器："检查重复"或疑似重复

工作流程：

从问题中提取关键词
搜索现有问题（开放和关闭）
计算相似性分数
排名潜在重复
提供发现和置信水平
如果置信度高：建议关闭为重复
更新两个问题并交叉引用
转移相关信息

模式3：关系映射

触发器："显示依赖关系"或复杂问题

工作流程：

解析问题中提到的问题的编号
检查阻塞/阻塞后指标
通过标签/关键词查找相关问题
生成依赖图
识别关键路径
突出显示阻塞问题
建议解决顺序

模式4：批量处理

触发器："分类所有…"或"处理具有…"的问题

工作流程：

查询符合标准的问题
对于每个问题：
- 分类和标记
- 检查重复
- 检查质量
- 应用标准操作
生成摘要报告
突出显示需要关注的问题

辅助脚本

问题助手

{baseDir}/scripts/issue-helpers.sh：

# 批量分类
bash {baseDir}/scripts/issue-helpers.sh triage-batch --filter "is:open no:label"

# 查找过时问题
bash {baseDir}/scripts/issue-helpers.sh find-stale --days 90

# 关闭重复问题
bash {baseDir}/scripts/issue-helpers.sh close-duplicate 42 --original 38

# 添加批量标签
bash {baseDir}/scripts/issue-helpers.sh bulk-label --filter "is:bug" --label "needs-triage"

重复检测

{baseDir}/scripts/duplicate-detection.sh：

# 为特定问题查找重复
bash {baseDir}/scripts/duplicate-detection.sh find-duplicates --issue 42

# 扫描所有开放问题以查找重复
bash {baseDir}/scripts/duplicate-detection.sh scan-all

# 检查两个问题之间的相似性
bash {baseDir}/scripts/duplicate-detection.sh compare 42 38

关系映射器

{baseDir}/scripts/relationship-mapper.sh：

# 映射问题的关系
bash {baseDir}/scripts/relationship-mapper.sh map-issue 42

# 查找阻塞问题
bash {baseDir}/scripts/relationship-mapper.sh find-blockers

# 生成完整依赖图
bash {baseDir}/scripts/relationship-mapper.sh generate-graph --format dot > deps.dot

问题验证

{baseDir}/scripts/validate-issue.py：

# 验证问题质量
python {baseDir}/scripts/validate-issue.py check 42

# 批量验证
python {baseDir}/scripts/validate-issue.py check-batch --filter "is:open"

# 生成质量报告
python {baseDir}/scripts/validate-issue.py report

模板

响应模板

{baseDir}/templates/issue-response-templates.md：

需要更多信息
重复问题
在版本中修复
不会修复
感谢您的报告
功能请求确认

问题模板

{baseDir}/templates/bug-report-template.md：标准错误报告模板，包含所有必需字段

{baseDir}/templates/feature-request-template.md：功能请求模板，包含用例和要求

参考资料

{baseDir}/references/issue-lifecycle-guide.md：从创建到关闭的问题生命周期完整指南

集成点

与organizing-with-labels

在分类期间自动应用标签：

基于分类的类型标签
基于影响评估的优先级标签
基于受影响区域的范围标签

与管理项目

将分类问题添加到看板：

高优先级 → 冲刺看板
Bugs → Bug分类看板
Features → 功能积压

与审查拉取请求

将PR链接到问题：

验证PR是否关闭了相关问题
检查PR是否解决了问题要求
PR合并时更新问题状态

常见用例

用例1：日常分类

用户："分类今天的问题"

你：
发现今天创建的5个新问题：

**问题 #42**：错误，优先级：高，分配给 @backend-team ✅
**问题 #43**：功能，优先级：中，添加到积压 ✅
**问题 #44**：重复 #38，关闭 ✅
**问题 #45**：需要更多信息，评论 ⏳
**问题 #46**：文档，优先级：低 ✅

摘要：4个分类，1个等待信息

用例2：查找重复

用户："查找所有重复问题"

你：
扫描156个开放问题...

发现8个潜在重复组：

**组1**：认证错误（3个问题）
- #42, #46, #51 (95%相似)
- 建议：保留 #42（最旧的），关闭其他

**组2**：暗色模式请求（2个问题）
- #43, #49 (90%相似)
- 建议：保留 #43（更详细），关闭 #49

关闭所有重复吗？[y/n]

用例3：依赖分析

用户："我们接下来可以做什么？"

你：
分析问题依赖关系...

**准备开始**（无阻塞）：
- #42：JWT认证（优先级：高，5天工作量）
- #50：会话管理（优先级：中，3天工作量）
- #52：更新文档（优先级：低，1天工作量）

**阻塞**（等待依赖）：
- #43：用户配置文件（阻塞 #42）
- #45：密码重置（阻塞 #42）

**推荐顺序**：
1. #42（解锁2个其他问题）
2. #50（与 #42 平行）
3. #43, #45（#42完成后）

重要说明

及时分类：新问题应在24小时内分类
彻底检查：在关闭之前仔细检查重复
尊重：即使对于重复问题，也要感谢报告者
记录决策：解释为什么问题被关闭/标记
跟踪关系：依赖关系对于计划很重要
质量优于速度：分类好比分类快更好

错误处理

常见问题：

问题未找到 → 检查问题编号
权限拒绝 → 需要分类访问权限
重复误报 → 审查相似性标准
缺少信息 → 礼貌请求