| name | github-issue |
| description | GitHub Issue作成スキル。.github/ISSUE_TEMPLATE/のテンプレート形式に準拠したIssueを作成。Use when: Issue作成、タスク管理、バグ報告、機能提案を依頼された時。 |
GitHub Issue作成
.github/ISSUE_TEMPLATE/のテンプレート形式に準拠したGitHub Issueを作成します。
利用可能なテンプレート
| テンプレート |
用途 |
ラベル |
| bug_report.yml |
バグ報告 |
bug |
| feature_request.yml |
機能リクエスト |
enhancement |
| todo.yml |
タスク・作業項目 |
todo |
Issue作成原則
- テンプレート準拠: 必ず既存のテンプレート形式に従う
- 適切な粒度: Pull Requestの粒度と対応するサイズに分割
- 分割戦略: 大きすぎる場合は複数のIssueに分割
- 明確な受け入れ基準: 完了条件を明確に定義
- 関連性の明示: 関連するIssueやPRをリンク
Issue粒度ガイドライン
適切な粒度
- 1つのPRで完結できる作業単位
- 1〜3日程度で完了可能なタスク
- 明確な受け入れ基準を持つ
- 単一の責任を持つ変更
分割が必要なケース
- 複数の機能を含む大規模な変更
- 異なるコンポーネントへの変更
- 段階的にリリースすべき機能
- 依存関係が複雑なタスク
分割戦略
- 機能単位: 各機能を独立したIssueに
- レイヤー単位: フロントエンド/バックエンドで分割
- 段階単位: Phase 1, Phase 2として分割
- 依存関係順: 依存関係に基づいて順序付け
テンプレート別の記載項目
Bug Report (バグレポート)
- 説明: バグの内容を明確に記述
- 再現手順: ステップバイステップで記載
- 期待される動作: 正常な動作の説明
- 実際の動作: 発生している問題
- 環境: Development/Staging/Production
- スクリーンショット: 必要に応じて添付
Feature Request (機能リクエスト)
- 問題提起: 解決したい課題
- 提案する解決策: 実装したい内容
- 検討した代替案: 他の選択肢
- 追加情報: モックアップ、参考資料
TODO (タスク)
- 説明: 実施内容の明確な記述
- 優先度: Low/Medium/High/Critical
- カテゴリ: Feature/Enhancement/Refactoring/Documentation/Testing/Infrastructure/Other
- 受け入れ基準: 完了条件のチェックリスト
- 技術的メモ: 実装の詳細や考慮事項
- 関連Issue: 関連するIssue/PRのリンク
Issue作成手順
- 要件分析: 依頼内容の理解と分析
- 粒度判定: 適切なサイズか評価
- 分割判断: 必要に応じて複数Issueに分割
- テンプレート選択: 適切なテンプレートを選択
- 内容作成: テンプレートの全項目を埋める
- 関連性設定: 関連IssueやPRをリンク
- Issue作成:
gh issue createコマンドで作成
出力形式
単一Issue作成時
- テンプレート種別
- タイトル
- 各フィールドの内容
- ラベル
- 作成コマンド
複数Issue作成時（分割）
- 分割理由の説明
- 各Issueの概要と関連性
- Issue間の依存関係
- 各Issueの詳細（上記と同様）
- 作成順序の推奨