Factor	3 (High)	2 (Medium)	1 (Low)
Reproducibility	Clear repro steps, stack trace	Partial description	Vague "doesn't work"
Scope

Issue Hunter — 议题分析与选择

概述

系统性地分析目标仓库中的开放议题，根据可修复性进行评分，并选择最佳候选议题进行处理。生成包含根本原因假设和修复方案的结构化分析文档。

适用场景：开源贡献目标锁定、冲刺规划、待办事项整理、缺陷分类。

前置条件

必须完成GitHub CLI的身份认证——议题获取依赖于gh API调用：

bash
gh auth status # 必须显示Logged in

如果未配置，请要求用户提供：

1. GitHub用户名
GitHub令牌 — 运行gh auth login或设置export GH_TOKEN=

未完成认证时，API速率限制将阻止批量议题获取。

工作流程

步骤1：获取议题

针对每个目标仓库，获取开放议题：

bash

获取带有bug标签的议题

gh issue list --repo {owner}/{repo} --label bug --state open --limit 30 \
--json number,title,body,labels,comments,createdAt,updatedAt

同时检查以下标签

gh issue list --repo {owner}/{repo} --label good first issue --state open --limit 10 \ --json number,title,body,labels,comments,createdAt

gh issue list --repo {owner}/{repo} --label help wanted --state open --limit 10 \
--json number,title,body,labels,comments,createdAt

如果标签筛选无效，获取最近的开放议题：
bash
gh issue list --repo {owner}/{repo} --state open --limit 50 \
--json number,title,body,labels,comments,createdAt

步骤2：为每个议题评分

根据以下因素对每个议题进行评分：

因素	3分（高）	2分（中）	1分（低）
可复现性	清晰的复现步骤、堆栈跟踪	部分描述	模糊的无法运行
影响范围

总分 = 所有因素之和（最高18分）。

步骤3：选择候选议题

选择标准（按优先级排序）：

1. 明确是缺陷（而非伪装的功能请求）
独立性强（无需深入领域知识即可修复）
可测试（可编写自动化测试进行验证）
无现有PR处理该议题
评分 ≥ 12/18

红旗警告 — 跳过以下议题：

- 已有开放的PR（使用gh pr list --repo owner/repo --search fixes #{number}检查）
需要访问专有服务/API
涉及无法测试的原生/平台特定代码
维护者已声明不会修复或设计如此

步骤4：深入分析选定的议题

针对每个选定的议题：

1. 阅读完整讨论串 — 评论中常包含根本原因线索或部分修复方案
识别相关源文件 — 在代码库中搜索议题中的关键词
起草根本原因假设 — 我认为X发生是因为Y
起草修复方案 — 我将修改Z以处理W情况
评估工作量 — 低（< 1小时）、中（1-4小时）、高（4小时以上）

步骤5：生成分析文档

编写{workspace}/issue-analysis.md：

markdown

议题分析 — {仓库/活动名称}

生成日期：{date}

摘要

#	仓库	议题	标题	评分	工作量	状态
1	owner/repo	#123	缺陷标题	16/18	低	已选定
2

owner/repo | #456 | 缺陷标题 | 12/18 | 中 | 已选定 | | 3 | owner/repo | #789 | 缺陷标题 | 8/18 | 高 | 已跳过 |

详细分析

owner/repo — 已选定： #123 — 缺陷标题

- 评分：16/18（可复现性：3，影响范围：3，复杂度：3，信号：2，时效性：3，可测试性：2）
根本原因：{假设}
修复方案：{描述}
需修改的文件：path/to/file.py、tests/test_file.py
工作量评估：低（< 1小时）
风险：低 — 直接的空值检查
依赖项：无

owner/repo — 已跳过： #789 — 缺陷标题

- 原因：需要架构重新设计，评分8/18

输出

- {workspace}/issue-analysis.md — 按仓库划分的议题分析及选择结果

提示

- 与repo-scout（上游）和repo-setup / dev-test（下游）自然搭配使用。
用于冲刺规划：将评分系统应用于自己项目的议题以确定优先级。
用于待办事项整理：定期运行以根据新信息重新评分。
分析单个仓库时，跳过摘要表格，直接进入详细分析。

issue-hunter议题猎手

issue-hunter

Issue Hunter — Issue Analysis & Selection

Overview

Prerequisites

Workflow

Step 1: Fetch Issues

Step 2: Score Each Issue

Step 3: Select Candidates

Step 4: Deep-Dive Selected Issues

Step 5: Produce Analysis Document

Output

Tips

Issue Hunter — 议题分析与选择

概述

前置条件