create-issue

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

通过 Gitee MCP 创建 Issue

与用户澄清需求后，在 Gitee 上创建结构清晰的 Issue。此技能适用于在正式创建 Issue 之前，讨论新需求、改进建议或错误报告。

前提条件

• 已配置 Gitee MCP Server（工具：create_issue、list_repo_issues、list_user_repos、search_open_source_repositories）
• 用户必须提供：仓库所有者/名称（或从可用仓库中搜索并选择）
• 可选：Issue 类型（功能/错误/改进）、优先级、标签

步骤

步骤 1：确定目标仓库

如果用户尚未指定仓库，询问属于以下哪种情况：

情况 A：用户自己的/私有仓库

• 使用 list_user_repos 列出用户有权访问的仓库
• 让用户从列表中选择

情况 B：开源/公开仓库

• 使用 search_open_source_repositories 搜索仓库
• 检查仓库 URL 格式（owner/repo）以确认仓库

如果用户直接提供仓库（格式：owner/repo），请与用户确认其存在。

步骤 2：澄清 Issue 内容

与用户讨论并收集以下信息：

对于错误报告：

• 预期行为是什么？
• 实际行为是什么？
• 如何重现此问题（重现步骤）？
• 环境详情（操作系统、版本、浏览器等）？
• 是否有错误消息或日志？

对于功能请求：

• 此功能要解决什么问题？
• 建议的解决方案是什么？
• 其他项目中是否有类似功能可供参考？
• 是否有设计偏好或限制？

对于改进建议：

• 哪方面需要改进？
• 有哪些改进建议？
• 预期结果是什么？

使用以下模板整理讨论内容：

## Issue Information

**Type:** [Bug / Feature / Enhancement / Question / Other]

**Title:** [Brief description - keep it under 50 characters]

**Description:**
[Detailed description of the issue]

**Reproduction Steps (for bugs):**
1. Step 1
2. Step 2
3. Step 3

**Expected Behavior:**
[What should happen]

**Actual Behavior:**
[What actually happens]

**Environment:**
- OS:
- Version:
- Browser (if applicable):

**Additional Context:**
[Any other relevant information, screenshots, logs, etc.]

步骤 3：验证并完善

创建 Issue 之前：

1. 使用 list_repo_issues 检查是否已有类似 Issue
2. 如果发现重复项，将其展示给用户
3. 根据讨论完善标题和描述
4. 创建之前征求用户确认

步骤 4：创建 Issue

使用 create_issue 创建 Issue，并设置以下参数：

• owner：仓库所有者
• repo：仓库名称
• title：Issue 标题（简洁且描述清晰）
• body：Issue 描述（详细且结构清晰）
• labels：（可选）以逗号分隔的标签列表，例如 bug、feature、enhancement

标签建议：

类型	标签
错误	bug
功能	feature
改进	enhancement
问题	question
文档	docs

步骤 5：确认并总结

成功创建后：

1. 向用户显示 Issue URL
2. 总结创建的内容
3. 询问用户是否想要：
   • 开始实施（使用 implement-issue 技能）

对话示例

示例 1：错误报告

User: I found a bug in the login page - it doesn't show error message when password is wrong.

You: Let me help you create a bug report. Could you please clarify:
1. What is the expected behavior? (e.g., "Show 'Invalid credentials' message")
2. What is the actual behavior? (e.g., "Nothing happens, page just reloads")
3. How to reproduce? (e.g., "Enter wrong password and click login")
4. What browser and OS are you using?

User: [Provides details...]

You: Here's the Issue I've prepared:
Title: Login page doesn't show error message for invalid credentials
...
Should I create this Issue?

示例 2：功能请求

User: I want to add dark mode to the app.

You: Great idea! Let me understand more about this feature:
1. What problem does dark mode solve? (e.g., "Reduce eye strain at night")
2. Should it follow system preference or be user-toggleable?
3. Any reference implementations you have in mind?

User: [Provides details...]

You: Here's the Issue I've prepared:
Title: Add dark mode support
...
Should I create this Issue?

注意事项

• 创建之前，务必与用户确认 Issue 详情
• 先搜索现有 Issue，以避免重复
• 使用清晰、具体的标题，用一行概括问题
• 在描述中包含所有必要详情，以便他人理解和重现问题
• 对于复杂功能，可考虑在创建 Issue 后通过评论附上技术设计文档
• 如果用户想立即着手处理 Issue，建议之后使用 implement-issue 技能