gh-issue
GitHubのIssueを管理する。Issue作成、一覧表示、クローズ、コメント時に使用。「Issueを作りたい」「バグ報告」「タスク登録」などのキーワードで発動。
When & Why to Use This Skill
This Claude skill streamlines GitHub Issue management by automating the creation, listing, and updating of issues. It ensures project consistency by enforcing specific labels, templates, and assignees, making it an essential tool for maintaining organized development workflows and improving project tracking efficiency.
Use Cases
- Automated Bug Reporting: Quickly generate detailed bug reports using predefined templates and the 'bug' label to ensure all necessary technical details are captured and assigned correctly.
- Task Management and Tracking: Efficiently list, filter, and view the status of project tasks to stay updated on development progress without leaving the chat interface.
- Streamlined Issue Updates: Add comments, edit titles, or close completed issues with specific reasons, maintaining a clear and professional project history.
- Standardized Feature Requests: Create new feature issues with mandatory templates and appropriate labels (e.g., 'feature', 'AI') to align with project requirements and architectural guidelines.
| name | gh-issue |
|---|---|
| description | GitHubのIssueを管理する。Issue作成、一覧表示、クローズ、コメント時に使用。「Issueを作りたい」「バグ報告」「タスク登録」などのキーワードで発動。 |
GitHub Issue管理
GitHubのIssueを管理するためのスキル。
重要な制約
このスキルは sh1ma/blog リポジトリのみで使用すること。
他のリポジトリの操作は禁止。--repo フラグで他リポジトリを指定してはならない。
利用可能なラベル
Issueには必ず以下のいずれかのラベルを付けること:
| ラベル | 用途 |
|---|---|
feature |
機能開発関連 |
bug |
バグ関連 |
refactoring |
リファクタ関連 |
documentation |
ドキュメンテーション関連 |
chore |
設定ファイルなどの雑多な変更 |
AI |
AI関連 |
test |
テスト関連 |
Issue作成手順(推奨フロー)
1. 適切なラベルを選択
Issue内容に基づいて、上記のラベルから1つ以上選択する。
2. Issueテンプレートを使用して作成
重要: .github/ISSUE_TEMPLATE/default.md のテンプレートを必ず使用すること。
gh issue create \
--title "タイトル" \
--label "ラベル" \
--assignee sh1ma \
--template "default.md"
テンプレートには以下のセクションが含まれている:
- やること: このIssueで何を行うか
- 目的: なぜこのIssueを実施するのか
- 方針: どのように実現するか
- タスク: 実施するタスクのチェックリスト
複数ラベルを付ける場合
gh issue create --title "タイトル" --label "feature" --label "AI" --assignee sh1ma --template "default.md"
コマンド概要
gh issue <command> [flags]
主要コマンド
Issue一覧表示
gh issue list # オープンなIssue一覧
gh issue list --state all # すべてのIssue
gh issue list --state closed # クローズ済みIssue
gh issue list --author @me # 自分が作成したIssue
gh issue list --assignee @me # 自分にアサインされたIssue
gh issue list --label "bug" # ラベルでフィルタ
gh issue list --milestone "v1.0" # マイルストーンでフィルタ
Issue作成
gh issue create # 対話形式で作成
gh issue create --title "タイトル" --body "本文"
gh issue create --label "bug" # ラベル付与
gh issue create --label "bug,help wanted" # 複数ラベル
gh issue create --assignee @me # 自分にアサイン
gh issue create --milestone "v1.0" # マイルストーン設定
gh issue create --project "Roadmap" # プロジェクト追加
gh issue create --template "Bug Report" # テンプレート使用
gh issue create --web # ブラウザで作成
Issue表示
gh issue view 123 # Issue #123を表示
gh issue view 123 --web # ブラウザで開く
gh issue view 123 --comments # コメントも表示
gh issue status # 関連Issueの状態一覧
Issueクローズ・再オープン
gh issue close 123 # Issue #123をクローズ
gh issue close 123 -c "理由" # コメント付きでクローズ
gh issue reopen 123 # Issue #123を再オープン
gh issue delete 123 # Issue #123を削除(要確認)
Issue編集
gh issue edit 123 --title "新タイトル"
gh issue edit 123 --body "新本文"
gh issue edit 123 --add-label "enhancement"
gh issue edit 123 --remove-label "bug"
gh issue edit 123 --add-assignee user1
gh issue edit 123 --milestone "v2.0"
Issueコメント
gh issue comment 123 -b "コメント内容"
gh issue comment 123 --edit-last -b "編集後"
gh issue comment 123 --web # ブラウザでコメント
Issueピン留め
gh issue pin 123 # Issue #123をピン留め
gh issue unpin 123 # ピン留め解除
Issueロック
gh issue lock 123 # Issue #123をロック
gh issue unlock 123 # ロック解除
Issue開発ブランチ
gh issue develop 123 # Issue用ブランチ作成
gh issue develop 123 --list # 関連ブランチ一覧
実行手順
- ユーザーの要求を理解する
- Issue作成の場合、内容を確認してラベルを決定する
.github/ISSUE_TEMPLATE/default.mdのテンプレートを使用してIssueを作成する- ラベルを必ず付けてIssueを作成する
- assigneeをsh1maに設定する
- その他のコマンド(一覧表示、編集など)の場合、適切なghコマンドを実行
- 結果を日本語で報告
注意事項
- Issueは番号またはURLで指定可能
- 認証が必要な場合は
gh auth loginを案内 - プロジェクト追加には
gh auth refresh -s projectが必要な場合あり - 他リポジトリへの操作は絶対に行わない
- Issue作成時はラベルを必ず付けること
- Issue作成時はテンプレートを必ず使用すること
- Issue作成時はassigneeをsh1maに設定すること