用途
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 提供更便捷的接口和更好的错误处理。
执行步骤:
- 获取 Issue 详情:使用 get_repo_issue_detail 获取完整信息,并用 list_comments 查看评论。
- 需求分析:按模板输出需求分析,包含类型、目标、范围、实现计划、潜在风险、验收标准。
- 辅助实现:提供代码实现思路、关键逻辑示例、需修改的文件;若用户已完成编码则继续。
- 在 Issue 中记录进度:使用 create_comment 发布进度更新,说明预期变更与实现思路。
- 创建关联 PR:使用 create_pull 创建 PR,描述中包含变更摘要、实现思路、测试说明以及 closes #[issue 编号]。
- 更新 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 及相关工具。
- 关于收费、价格、平台支持范围等更多信息,资料中暂未提供。