create-issue Skill

概要

GitHub Issueを作成する際は、必ず gh コマンドを使い、neko3cs/.github リポジトリで管理されている2つのIssueテンプレート（バグ報告 / 機能要望）のいずれかに従って作成します。blank_issues_enabled: false のため、テンプレートを使わない空のIssueは作成しません。

実行手順

1. テンプレートを選ぶ

• ユーザーの依頼内容が「バグ報告」か「機能要望」かを判断する。
• 判断が難しい場合は、ユーザーにどちらか確認する。

2. テンプレートの最新定義を取得する

テンプレートは neko3cs/.github 側で更新される可能性があるため、スナップショットを流用せず、作成のたびに最新のYAMLを取得する。

gh api repos/neko3cs/.github/contents/.github/ISSUE_TEMPLATE/bug_report.yml --jq '.content' | base64 -d
gh api repos/neko3cs/.github/contents/.github/ISSUE_TEMPLATE/feature_request.yml --jq '.content' | base64 -d

取得したYAMLから次を読み取る。

• title: タイトルに付与するプレフィックス（例: [Bug]: ）
• labels: 付与するラベル（例: bug、enhancement）
• body: 各フィールドの id / label / required / placeholder

3. 各フィールドの内容を埋める

• required: true のフィールドは必ず内容を埋める。会話やコードから判断できない場合は、推測で埋めずユーザーに質問する。
• 任意フィールドは、書く内容がなければそのセクション自体を省略する（空見出しを作らない）。
• placeholder は記入例（プレースホルダー）であり、そのまま転記しない。
• 受け入れ条件（acceptance_criteria）は次のように書く。
  • 計算・変換・入力チェックなど、入力から結果が決まる条件は、入力と期待結果の表で書く。決まらない行（境界値、欠けたデータ、異常系）は推測で埋めず、期待結果を ？ のまま残す。
  • 見た目・操作感など表にできない条件は、チェックボックスの箇条書きで書く。
  • 「テストを書く」など、プロダクトの振る舞いではない条件は書かない。
• type: dropdown（例: 影響度）は選択肢の中から該当するものを1つ選ぶ。判断がつかない場合は推測せずユーザーに確認する。
• type: checkboxes（例: 確認事項の「機密情報を含めていません」）は、実際に確認したうえでチェックを入れる。特に機密情報チェックは注意事項の確認と直結するため、内容を精査せずに機械的にチェックしない。

4. Issue本文を組み立てる

GitHub Issue Formsは送信時に各フィールドを ### {label} の見出し＋内容に変換してIssue本文を生成する。gh issue create --template は対話入力前提のため、非対話で確実に全フィールドを反映させるには、この見出し形式の本文を自分で組み立て、--body / --body-file で渡す。

### 説明

...

### 再現手順

1. ...
2. ...

フィールドの順序はYAMLの body の順序に揃える。

5. gh issue create を実行する

gh issue create -R <owner>/<repo> \
  --title "[Bug]: ログイン画面でクラッシュする" \
  --body-file <一時ファイル> \
  --label bug

• 対象リポジトリは特に指定がなければ作業中のリポジトリ（origin）を使う。別リポジトリ向けの場合は -R owner/repo を明示する。
• ラベルはテンプレートYAMLの labels をそのまま使う（バグ報告→bug、機能要望→enhancement）。
• 本文は改行・見出しを含むため、シェルのクォート崩れを避けるためスクラッチディレクトリに一時ファイルを作成し --body-file で渡す。作成後は一時ファイルを削除する。
• 必須項目が会話やコードから判断できずユーザーへの質問が必要な場合を除き、内容が揃い次第このステップまで確認なしで進めて作成する。作成後にIssue URLを提示する。

注意事項

• blank_issues_enabled: false のため、テンプレートを使わない空のIssueは作成しない。
• テンプレートのフィールド構成は変更される可能性があるため、スナップショットを過信せず、作成の都度ステップ2で最新定義を取得する。
• ユーザー提供内容に個人情報・社外秘情報が含まれていないかを確認したうえで本文に反映する。

参考文献

• ISSUE_TEMPLATE一覧: https://github.com/neko3cs/.github/tree/main/.github/ISSUE_TEMPLATE
• バグ報告: https://github.com/neko3cs/.github/blob/main/.github/ISSUE_TEMPLATE/bug_report.yml
• 機能要望: https://github.com/neko3cs/.github/blob/main/.github/ISSUE_TEMPLATE/feature_request.yml

サンプル対話

User: ログイン画面がクラッシュするのでIssueを作ってください。

Agent: バグ報告として作成します。最新のテンプレート定義を取得し、再現手順・期待する動作・実際の動作・バージョン・影響度・受け入れ条件などの必須項目を会話内容から埋め、そのまま作成します。[gh issue create を実行] Issueを作成しました。URL: ...

User: ○○機能を追加してほしいです。

Agent: 機能要望として作成します。動機/ユースケースと提案する解決策が必須項目なので、その内容を伺ってもよいですか？

User: （動機とユースケースを回答）

Agent: [gh issue create を実行] Issueを作成しました。URL: ...