GitHub Issue Creator

このスキルは、リポジトリの標準に準拠し、適切なテンプレートを使用する高品質な GitHub issue の作成をガイドします。

ワークフロー

GitHub issue を作成するには、以下のステップに従ってください:

1. Issue タイプを特定する: リクエストがバグレポート、機能リクエスト、またはその他のカテゴリであるかを判断します。

2. テンプレートを検索する: .github/ISSUE_TEMPLATE/ で issue テンプレートを検索します。

   • bug_report.yml
   • feature_request.yml
   • website_issue.yml
   • 関連する YAML テンプレートが見つからない場合は、同じディレクトリの .md テンプレートを探します。

3. テンプレートを読む: 特定されたテンプレートファイルの内容を読んで、必須フィールドを理解します。

4. コンテンツを下書きする: issue のタイトルと本文/フィールドを下書きします。

   • YAML テンプレート(フォーム)を使用する場合は、テンプレートで定義された各 id の値を準備します。
   • Markdown テンプレートを使用する場合は、その構造に正確に従います。
   • デフォルトラベル: ユーザーが明示的に別の指定をしない限り、常に 🔒 maintainer only ラベルを含めます。

5. Issue を作成する: gh CLI を使用して issue を作成します。

   • 重要: 複数行の Markdown または複雑なテキストでのシェルエスケープおよびフォーマットの問題を避けるため、必ず説明/本文を一時ファイルに最初に書き込みます。

   Markdown テンプレートまたはシンプルな本文の場合:

   # 1. 下書きされたコンテンツを一時ファイルに書き込む
   # 2. --body-file フラグを使用して issue を作成する
   gh issue create --title "簡潔なタイトル" --body-file <temp_file_path> --label "🔒 maintainer only"
   # 3. 一時ファイルを削除する
   rm <temp_file_path>
   

   YAML テンプレート(フォーム)の場合: gh issue create は --body-file をサポートしていますが、YAML フォームは通常、インタラクティブプロンプトをバイパスしたい場合、フラグ経由でキー・バリューペアを期待します。 ただし、長いテキストフィールドのフォーマットが確実に保持される最も信頼性の高い非インタラクティブな方法は、フォームが標準の本文に変換されている場合は --body または --body-file を使用するか、YAML フォームの場合は --field フラグを使用することです。

   注: YAML フォームを使用する gemini-cli リポジトリの場合、フォーム固有のフィールドベースの送信が自動化によって要求されていない場合、コンテンツを単一の本文として送信できることがよくあります。

6. 確認する: issue が正常に作成されたことを確認し、ユーザーにリンクを提供します。

原則

• 明確性: タイトルは説明的であり、プロジェクトの慣例に従う必要があります。
• 防御的なフォーマット: 常に --body-file で一時ファイルを使用して、改行と特殊文字の問題を防ぎます。
• メンテナ優先: バックログを整理するため、内部/メンテナラベルをデフォルトにします。
• 完全性: すべての要求情報(バージョン情報、再現手順など)を提供します。