triage-issues

注意：如果本地已安装 mcporter，应使用 mcporter 调用 MCP 工具，而不是直接调用 MCP 工具。mcporter CLI 提供了更便捷的接口和更完善的错误处理。

通过 Gitee MCP 整理 Issues

批量处理仓库的 Issues：按优先级分类、添加标签、识别重复项，并生成清晰的行动清单。

前提条件

• 已配置 Gitee MCP Server（工具：list_repo_issues、get_repo_issue_detail、update_issue、create_comment（resource_type: issue））
• 用户必须提供：仓库所有者、仓库名称
• 可选：筛选条件（仅 Bug / 仅未分配 / 指定里程碑等）

步骤

步骤 1：获取 Issue 列表

使用 list_repo_issues 获取未关闭的 Issues：

• state：open（仅未关闭的 Issues）
• 如果 Issues 较多，请分页获取（每页 20 条）

步骤 2：批量分析

快速评估每个 Issue：

类型分类（使用标签）

类型	标签	描述
Bug	bug	功能损坏、报错或崩溃
功能	feature	请求新增功能
增强	enhancement	改进现有功能
问题	question	使用问题
文档	docs	与文档相关
重复	duplicate	与现有 Issue 相同

常见附加标签

标签	使用场景
help wanted	需要外部贡献
wontfix	不会处理
invalid	无效或垃圾内容
security	与安全相关
performance	与性能相关
ui/ux	用户界面改进
backend	与后端相关
frontend	与前端相关

优先级评估

• P0 - Critical：影响核心功能、生产环境 Bug、安全漏洞
• P1 - High：重大功能缺陷，影响许多用户
• P2 - Medium：一般改进，存在替代方案
• P3 - Low：锦上添花、外观改进

状态评估

• 是否提供了充分的复现步骤（针对 Bug）
• 是否需要更多信息
• 是否已有 PR 在处理此问题

步骤 3：生成整理报告

输出结构化报告：

## Issue Triage Report
Repository: [owner/repo]
Date: [date]
Total open issues: [N]

---

### 🔴 P0 Critical (needs immediate attention)
| # | Title | Type | Labels | Note |
|---|-------|------|--------|------|
| #N | [title] | bug | bug, security | [one sentence explaining urgency] |

### 🟠 P1 High Priority
| # | Title | Type | Labels | Note |
|---|-------|------|--------|------|

### 🟡 P2 Medium Priority
| # | Title | Type | Labels | Note |
|---|-------|------|--------|------|

### 🟢 P3 Low Priority
| # | Title | Type | Labels | Note |
|---|-------|------|--------|------|

---

### Needs More Information
- #N [title]: [what information is missing]

### Possible Duplicates
- #N may be a duplicate of #M: [explanation]

### Recommended for Closure
- #N [title]: [reason, e.g., long inactive / already resolved another way]

步骤 4：更新 Issue 标签（需用户确认）

询问用户是否要自动更新标签和优先级。

确认后，使用 update_issue 来：

• 添加类型标签（bug、feature、enhancement、question、docs、duplicate）
• 根据上下文添加附加标签（help wanted、security 等）
• 添加优先级标记（如果仓库支持）

标签分配示例：

• Bug 报告 → 添加 bug 标签
• 描述完善的功能请求 → 添加 feature 标签
• 增强建议 → 添加 enhancement 标签
• 简单问题 → 添加 question 标签
• 需要外部协助 → 添加 help wanted

对于需要更多信息的 Issues，使用 create_comment（resource_type: issue）提问：

Thanks for submitting this issue!

To help us address it more effectively, could you please provide:
- [Missing reproduction steps]
- [Environment and version info]
- [Expected behavior vs. actual behavior]

Thank you!

注意事项

• 整理侧重于分类和组织，无需深入研究每个 Issue 的技术细节
• 批量更新前务必先征得用户确认，避免造成意外更改
• 如果 Issues 超过 50 条，可考虑分批处理或按特定标签筛选
• 使用一致的标签，帮助贡献者找到符合其兴趣的 Issues
• 先检查仓库中现有的标签——有些项目可能使用自定义标签名称