create-issue

注：ローカルに mcporter がインストールされている場合は、MCP ツールを直接呼び出すのではなく、mcporter を使って呼び出してください。mcporter CLI は、より便利なインターフェースと優れたエラー処理を提供します。

Gitee MCP を使用した Issue の作成

ユーザーと要件を明確にしたうえで、Gitee に適切な構成の Issue を作成します。このスキルは、新しい要件、改善、バグ報告について、正式に Issue を作成する前に話し合うためのものです。

前提条件

• Gitee MCP サーバーが設定済みであること（ツール：create_issue、list_repo_issues、list_user_repos、search_open_source_repositories）
• ユーザーがリポジトリのオーナー名／リポジトリ名を指定すること（または、利用可能なリポジトリから検索して選択すること）
• 任意：Issue の種類（feature／bug／enhancement）、優先度、ラベル

手順

ステップ 1：対象のリポジトリを特定する

ユーザーがリポジトリを指定していない場合は、どちらのケースかを尋ねます。

シナリオ A：ユーザー自身のリポジトリまたはプライベートリポジトリ

• list_user_repos を使って、ユーザーがアクセスできるリポジトリを一覧表示します
• 一覧からユーザーに選択してもらいます

シナリオ B：オープンソースまたは公開リポジトリ

• search_open_source_repositories を使ってリポジトリを検索します
• リポジトリの URL 形式（owner/repo）を確認して検証します

ユーザーがリポジトリを直接指定した場合（形式：owner/repo）は、ユーザーに確認して存在を検証します。

ステップ 2：Issue の内容を明確にする

ユーザーと話し合い、次の情報を集めます。

バグ報告の場合：

• 期待される動作は何ですか？
• 実際の動作は何ですか？
• Issue を再現する方法（再現手順）は何ですか？
• 環境の詳細（OS、バージョン、ブラウザーなど）は何ですか？
• エラーメッセージやログはありますか？

機能リクエストの場合：

• この機能でどのような問題を解決できますか？
• 提案する解決策は何ですか？
• 参考になる、他のプロジェクトの類似機能はありますか？
• デザイン上の希望や制約はありますか？

改善の場合：

• どの点を改善する必要がありますか？
• どのような改善を提案しますか？
• 期待される結果は何ですか？

次のテンプレートを使って、話し合いの内容を整理します。

## 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. 重複する Issue が見つかった場合は、ユーザーに提示します
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 の内容を 1 行で要約する、明確で説明的なタイトルを付けてください
• 他の人が内容を理解し、再現できるよう、説明に必要な詳細をすべて含めてください
• 複雑な機能の場合は、Issue 作成後にコメントとして技術設計書を作成することを検討してください
• ユーザーがすぐに Issue に取り組みたい場合は、その後 implement-issue スキルを使うよう提案してください