SuperAPI AI 工具集

implement-issue

编程与开发

查看项目

更新于 10-16 07:44

技能介绍

用途

implement-issue 用于围绕 Gitee Issue 完成从需求到代码提交的完整开发流程。当用户提出“实现某个 issue”“基于 issue 开发”“implement issue”等请求时,该技能会引导完成:需求分析 → 编码 → 创建 PR → 回链 Issue 的闭环。

主要能力

  • 获取 Issue 详情:通过 get_repo_issue_detail 读取标题、完整描述、标签(feature / bug / enhancement 等)、优先级、里程碑以及已有评论;并通过 list_comments(resource_type: issue)查看评论,了解技术设计讨论、背景上下文,以及是否已有人正在处理。
  • 需求分析:基于 Issue 内容产出需求分析,包含类型(Feature / Bug Fix / Performance / Other)、目标、预估范围(可能涉及的模块/文件、API/数据库表)、实现计划、潜在风险与验收标准。
  • 辅助实现:提供具体代码实现思路、关键逻辑的代码示例,并指出需要修改的文件;若用户已完成编码,则进入下一步。
  • 记录进度:通过 create_comment(resource_type: issue)在 Issue 上发布进度更新,说明预期变更与实现思路,便于其他贡献者了解情况、避免重复劳动。
  • 创建关联 PR:通过 create_pull 创建 PR,PR 描述应包含变更摘要、实现思路概述、测试说明,并使用 closes #[issue 编号] 以便合并时自动关闭关联 Issue。
  • 更新 Issue:PR 创建后,通过 create_comment(resource_type: issue)在 Issue 上发布 PR 链接;如需更新 Issue 状态,使用 update_issue。

使用方式

前置条件:

  • 已配置 Gitee MCP Server,涉及工具:get_repo_issue_detail、list_repo_issues、create_pull、create_comment(resource_type: issue)、update_issue。
  • 用户需提供:仓库所有者、仓库名称、Issue 编号(或从列表中选择)。
  • 本地仓库路径:该技能必须在 Issue 所属仓库的本地检出目录中执行,或由用户提供仓库克隆的本地路径。这是 Coding Agent 读取和修改源文件所必需的。

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

执行步骤:

  1. 获取 Issue 详情:使用 get_repo_issue_detail 获取完整信息,并用 list_comments 查看评论。
  2. 需求分析:按模板输出需求分析,包含类型、目标、范围、实现计划、潜在风险、验收标准。
  3. 辅助实现:提供代码实现思路、关键逻辑示例、需修改的文件;若用户已完成编码则继续。
  4. 在 Issue 中记录进度:使用 create_comment 发布进度更新,说明预期变更与实现思路。
  5. 创建关联 PR:使用 create_pull 创建 PR,描述中包含变更摘要、实现思路、测试说明以及 closes #[issue 编号]。
  6. 更新 Issue:PR 创建后,用 create_comment 发布 PR 链接;如需更新状态,使用 update_issue。评论模板示例:PR #[PR 编号] has been created to address this issue. Please review: [PR 链接]。

适用场景

  • 需要从 Gitee Issue 出发进行功能开发、缺陷修复或性能优化。
  • 团队协作中希望将开发进度同步到 Issue,避免重复工作。
  • 希望自动创建与 Issue 关联的 PR,并在合并时自动关闭 Issue。

限制与注意事项

  • 开始前需确认 Issue 未被他人认领(检查 assignees)。
  • 对于重大设计决策,应在编码前于 Issue 评论中讨论并确认。
  • PR 描述中的 closes #N 语法会在 PR 合并时自动关闭 Issue。
  • 必须在本地仓库检出目录中执行,或提供本地克隆路径,否则无法读取和修改源码。
  • 依赖已配置的 Gitee MCP Server 及相关工具。
  • 关于收费、价格、平台支持范围等更多信息,资料中暂未提供。