SuperAPI AI 工具集

close-issue-flow

编程与开发

查看项目

更新于 10-16 07:44

技能介绍

用途

close-issue-flow 用于执行完整的 Gitee Issue 关闭工作流:验证修复已合并 → 发布关闭评论 → 更新 Issue 状态。它通常在同名 PR 已合并或问题已解决之后运行,属于修复合并后的收尾环节。当用户要求关闭 Issue、收尾 Issue 或在修复合并后完成收尾时使用该技能。资料提示:PR 描述中使用 closes #N 会在合并时自动关闭 Issue,本技能适用于需要手动关闭或需要补充解释性评论的场景。

主要能力

该技能通过 Gitee MCP 完成以下步骤:

  1. 获取 Issue 详情:使用 get_repo_issue_detail 获取标题、描述、标签、当前状态(检查是否已关闭)以及已有评论(了解解决过程)。若 Issue 已关闭,会通知用户并停止。
  2. 确认关联 PR 状态:使用 list_repo_pulls 查询仓库 PR,筛选状态为 merged、描述包含 closes #[issue number] 或 fixes #[issue number] 的 PR。若找到已合并的关联 PR,则确认修复已生效;若相关 PR 仍处于开启状态,则通知用户 PR 尚未合并;若不存在关联 PR,则询问用户该 Issue 是如何解决的。
  3. 发布关闭评论:使用 create_comment(resource_type: issue)发布关闭说明,并按情况选择模板——关联 PR 已合并时、直接解决(无 PR)时、无法复现或请求被拒绝时。
  4. 关闭 Issue:使用 update_issue 将 state 更新为 closed,可选地更新标签(如添加 fixed 或 resolved)以及将 Issue 分配到已完成的里程碑。
  5. 输出摘要:输出包含 Issue 编号与标题、关闭原因(Fixed / Cannot reproduce / Declined)、关联 PR 编号(如有)、关闭评论已发布、Issue 状态已更新为 closed 的摘要。

使用方式

前置条件:已配置 Gitee MCP Server(工具包括 get_repo_issue_detail、list_repo_pulls、create_comment(resource_type: issue)、update_issue)。用户必须提供:仓库所有者、仓库名称、Issue 编号。

资料提示:如果本地安装了 mcporter,应使用 mcporter 调用 MCP 工具,而不是直接调用 MCP 工具;mcporter CLI 提供更便捷的接口和更好的错误处理。

适用场景

  • 关联 PR 已合并后,需要手动关闭 Issue 并留下说明。
  • Issue 被直接解决(无 PR)时的收尾。
  • 无法复现或功能请求被拒绝时的礼貌关闭。

限制与注意事项

  • 关闭前应始终确认 Issue 确实已解决,避免过早关闭。
  • 关闭用户报告的 bug 时应感谢其报告。
  • 拒绝功能请求时应解释原因并礼貌关闭。
  • 需要用户提供仓库所有者、仓库名称与 Issue 编号。
  • 具体工具参数、配置细节、错误码与收费信息暂未提供。