quick-fix-suggestion

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

通过 Gitee MCP 快速提出修复建议

分析 Gitee Issue 并生成智能修复建议，包括：

• 确定需要修改的文件
• 提供代码位置提示（行号、函数名）
• 提供实现代码片段草稿
• 制定分步实施计划

前提条件

• 已配置 Gitee MCP 服务（工具：get_repo_issue_detail、list_comments（resource_type: issue）、search_files_by_content、get_file_content）
• 必须在仓库的本地克隆中执行
• 用户必须提供：仓库所有者、仓库名称、Issue 编号

本地优先搜索策略

为什么优先搜索本地？

此技能优先使用本地文件操作进行代码搜索，而不是调用 Gitee API：

• 速度：本地搜索只需几毫秒，API 调用则需要几秒
• 无速率限制：不受每分钟 100 次请求的限制
• 实时性：搜索结果包含尚未提交的本地更改
• 成本：无需支付 API 使用费用

工具选择优先级

优先级	工具	可用性
第 1 优先	glob、grep（内置）	100%
第 2 优先	ast_grep_search、lsp_find_references	100%
第 3 优先	Git 命令（通过 bash）	约 90%
最后	Gitee API（search_files_by_content）	仅用作备用方案

步骤

步骤 1：获取 Issue 详情

使用 get_repo_issue_detail 获取完整的 Issue 信息：

• 标题和描述
• 标签（bug/feature/enhancement）
• 现有评论

步骤 2：分析 Issue 内容

识别 Issue 类型：

• bug：error、crash、broken、not working、错误、失败
• feature：add、support、implement、new、新增、添加
• enhancement：improve、optimize、改进、优化

提取代码实体：

• 函数名（位于反引号中或符合特定模式）
• 类名
• 文件名
• 错误消息 / 堆栈跟踪

步骤 3：搜索代码（本地优先）

按优先级顺序使用内置工具：

// 1. File name search (fastest)
glob(`**/*${keyword}*.{js,ts,py,go}`, { cwd: localRepoPath })

// 2. Content search
grep({
  pattern: `function\\s+${funcName}`,
  path: localRepoPath,
  output_mode: "content"
})

// 3. AST search (semantic)
ast_grep_search({
  pattern: "function $NAME($$$) { $$$ }",
  lang: "javascript",
  paths: [localRepoPath]
})

// 4. Fallback: Remote search (max 3 calls)
if (localResults.length < 3) {
  search_files_by_content({ owner, repo, query: keyword, limit: 10 })
}

步骤 4：读取并分析关键文件

读取每个候选文件，以便：

• 找出相关函数 / 类
• 了解代码结构
• 评估 Issue 与该文件的关联

步骤 5：生成修复建议

按以下格式呈现结果：

## Issue #{number}: {title}

**Type**: {bug/feature} | **Confidence**: {score}% | **Complexity**: {low/medium/high}

### Primary Files (Must Modify)

**1. `{file_path}`** [Confidence: XX%]
- **Change**: {modify/add/delete}
- **Location**: Around line {X}

<details>
<summary>Code Draft</summary>

```{language}
// Current:
{existing_code}

// Suggested:
{suggested_code}

可能需要更改的次要文件

• {file_path}：{reason}

实施计划

1. {step 1} - 文件：`{file}``，约 {time}
2. {step 2} - 文件：`{file}``，约 {time}

测试建议

• {test suggestion}

需要向你确认的问题

1. {uncertainty_question}

### Step 6: Handle User Response

- **Approve**: Summarize and transition to `implement-issue` skill
- **Adjust**: Re-analyze with new information
- **Search More**: Expand search scope
- **Cancel**: Offer other help

## Notes

- Always indicate confidence level - ask for clarification when uncertain
- Follow existing code patterns when suggesting changes
- Warn immediately if Issue mentions credentials/secrets
- If unable to locate relevant code, ask for more context rather than guessing

## References

- [Tool Reference Guide](references/TOOL_REFERENCE.md) - Detailed search patterns and tool usage