github-issue

GitHub Issue作成

.github/ISSUE_TEMPLATE/のテンプレート形式に準拠したGitHub Issueを作成します。

利用可能なテンプレート

Issue作成原則

1. テンプレート準拠: 必ず既存のテンプレート形式に従う
2. 適切な粒度: Pull Requestの粒度と対応するサイズに分割
3. 分割戦略: 大きすぎる場合は複数のIssueに分割
4. 明確な受け入れ基準: 完了条件を明確に定義
5. 関連性の明示: 関連するIssueやPRをリンク

Issue粒度ガイドライン

適切な粒度

• 1つのPRで完結できる作業単位
• 1〜3日程度で完了可能なタスク
• 明確な受け入れ基準を持つ
• 単一の責任を持つ変更

分割が必要なケース

• 複数の機能を含む大規模な変更
• 異なるコンポーネントへの変更
• 段階的にリリースすべき機能
• 依存関係が複雑なタスク

分割戦略

1. 機能単位: 各機能を独立したIssueに
2. レイヤー単位: フロントエンド/バックエンドで分割
3. 段階単位: Phase 1, Phase 2として分割
4. 依存関係順: 依存関係に基づいて順序付け

テンプレート別の記載項目

Bug Report (バグレポート)

• 説明: バグの内容を明確に記述
• 再現手順: ステップバイステップで記載
• 期待される動作: 正常な動作の説明
• 実際の動作: 発生している問題
• 環境: Development/Staging/Production
• スクリーンショット: 必要に応じて添付

Feature Request (機能リクエスト)

• 問題提起: 解決したい課題
• 提案する解決策: 実装したい内容
• 検討した代替案: 他の選択肢
• 追加情報: モックアップ、参考資料

TODO (タスク)

• 説明: 実施内容の明確な記述
• 優先度: Low/Medium/High/Critical
• カテゴリ: Feature/Enhancement/Refactoring/Documentation/Testing/Infrastructure/Other
• 受け入れ基準: 完了条件のチェックリスト
• 技術的メモ: 実装の詳細や考慮事項
• 関連Issue: 関連するIssue/PRのリンク

Issue作成手順

1. 要件分析: 依頼内容の理解と分析
2. 粒度判定: 適切なサイズか評価
3. 分割判断: 必要に応じて複数Issueに分割
4. テンプレート選択: 適切なテンプレートを選択
5. 内容作成: テンプレートの全項目を埋める
6. 関連性設定: 関連IssueやPRをリンク
7. Issue作成: gh issue createコマンドで作成

出力形式

単一Issue作成時

• テンプレート種別
• タイトル
• 各フィールドの内容
• ラベル
• 作成コマンド

複数Issue作成時（分割）

• 分割理由の説明
• 各Issueの概要と関連性
• Issue間の依存関係
• 各Issueの詳細（上記と同様）
• 作成順序の推奨