本文へ移動
cccskills
無料GitHub で公開

create-issue

GitHub Issueを作成してGitHubに投稿するスキル。「Issueを作成」「Issue作成」「Issueにして」「Issueとして投稿」「GitHubにIssue」「create issue」「open issue」「バグ報告」「機能追加をIssueに」「改善提案をIssueに」などの依頼でトリガーする。コンテキスト収集→Issue本文生成→ラベル存在確認・作成→gh issue create投稿の流れでIssueを作成する。

インストール方法を見る

含まれるファイル(2)

  • SKILL.md4.6 KB
  • references/issue-template.md1.3 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

GitHub Issue 作成スキル

ユーザーが指定した内容(機能追加・バグ修正・改善提案など)について、構造化されたGitHub Issueを作成し gh issue create コマンドで投稿する。

トリガー条件

  • 「〇〇のIssueを作成して」
  • 「〇〇をIssueにして」
  • 「〇〇をGitHubにIssue投稿して」
  • 「〇〇の改善提案をIssueにして」
  • 「〇〇のバグをIssue報告して」
  • 英語: "create issue for ○○", "open issue for ○○"

ワークフロー(5ステップ)

Step 1: コンテキスト収集

Issue の内容を充実させるため、以下を自律的に調査する。

必須調査項目:

  1. 会話コンテキスト — ユーザーとの直近の会話から、変更理由・背景・課題を抽出
  2. 関連コード — 変更対象ファイルの現状実装を確認(ファイルパス・行番号を特定)
  3. 仕様書 — docs/specs/ 配下の requirements.md, design.md(存在する場合)
  4. 設定ファイル — 関連する config.yaml のセクション

判断が必要な場合のみユーザーに確認:

  • Issue の種別が不明確な場合(feature / fix / refactor)
  • 影響範囲が曖昧な場合

Step 2: Issue 本文の生成

Issue テンプレート に従って本文を生成する。

生成ルール:

  • 言語: 日本語(コード・識別子は英語)
  • WHY / WHAT / Acceptance Criteria を必ず含める
  • 禁止語を使用しない: best / optimal / faster / always / never / perfect
  • コード参照はファイルパス・行番号を明記する
  • 疑似コードを含める場合は実装イメージが伝わる程度に簡潔に記載する
  • secrets / PII を含めない
  • 判断が必要な場合以外は確認なしで即座に実行すること

ラベル選択ルール:

Issue 種別ラベル
新機能enhancement
バグ修正bug
リファクタrefactor
ドキュメントdocumentation
テストtest
性能改善performance

Step 3: ラベルの存在確認と作成

投稿前に、使用するラベルがリポジトリに存在するか確認し、存在しない場合は作成する。

# ラベルの存在確認
$labelExists = gh label list --json name --jq ".[].name" | Select-String -Quiet "^<label>$"

if (-not $labelExists) {
    # ラベルが存在しない場合は作成
    gh label create --force "<label>" --color "<color>"
}

ラベルカラー対応表:

ラベルカラー
enhancement#a2eeef
bug#d73a4a
refactor#e4e669
documentation#0075ca
test#bfd4f2
performance#f9d0c4

Step 4: gh CLI で投稿

  1. Issue 本文を一時ファイル issue_body.md に書き出す
  2. gh issue create コマンドで投稿する
  3. 一時ファイルを削除する(2で失敗した場合も必ず実行すること)
try {
    # 投稿コマンド
    gh issue create --title "<title>" --body-file issue_body.md --label "<label>"
}
finally {
    # クリーンアップ(成功・失敗にかかわらず実行)
    Remove-Item issue_body.md -ErrorAction SilentlyContinue
}

タイトル形式: <type>(<scope>): <summary>

  • type: feat / fix / refactor / docs / test / chore / perf
  • scope: 対象モジュール/機能の短縮名
  • summary: 変更内容の要約(日本語可)

Step 5: 結果報告

  • 作成された Issue の URL を提示する
  • Issue 内容の要点(WHY / WHAT / AC の概要)を箇条書きで要約する

注意事項

  • gh CLI がインストール済みかつ認証済みであることを前提とする
  • gh コマンドが失敗した場合は、エラー内容をユーザーに報告し対処法を提示する
  • gh コマンドが失敗した場合も、issue_body.md は必ず削除すること(クリーンアップの徹底)
  • PowerShell 環境でのヒアドキュメント(@- << 'EOF')は非対応のため、一時ファイル経由で投稿する

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

cc-sdd-restack-after-merge

無料日本語概要

stacked PRの下位PRがマージされた後に上位branchをrestack(rebase/cherry-pick再構成)する際に使用。「restackして」「上位PRを更新して」「restack after merge」「PRのbaseを更新」「スタックを整理」という依頼でトリガーする。対象sliceの特定→rebase→変更ファイル確認と代表テスト実行→force-with-leaseでpush→PR base更新→auto-merge判定の順で進める。

studiogadget/skills32026年5月25日 更新

cc-sdd-review-slice-stack

無料日本語概要

cc-sdd実装用統合ブランチのコミット群(ベースブランチとの差分)をreview slice単位のstacked PRに再構成する際に使用。「review sliceに分割」「stacked PRを作成」「PRをスタックして」「レビュー用にPRを分けて」「review slice stack」という依頼でトリガーする。dry-run(既定)でslice計画を提示し、apply指示で実際にブランチ・PRを作成する。

studiogadget/skills32026年5月25日 更新

ci-stable-log-testing

無料日本語概要

CI環境で安定動作するPythonテスト(特にstructlogのログ検証)を書く際に使用。「CIで失敗する」「capture_logsが不安定」「ログアサーションがCIだけ落ちる」「caplogフォールバック」「ANSI混入」「xdistでログが取れない」という課題で起動。capture_logs→caplogフォールバック→ANSI正規化→アサーション設計の流れで堅牢なテストを書く。

studiogadget/skills32026年5月25日 更新

docker-deployment-guide

無料日本語概要

Dockerベースのアプリケーションのデプロイメント手順書(Markdown)を作成するスキル。「デプロイ手順書」「デプロイメント手順」「deployment guide」「本番環境への配置手順」「サーバーへの配置手順」などの依頼でトリガーする。Docker Composeビルド→イメージ転送→サーバー配置→設定→動作確認→cron設定の流れで手順書を生成する。

studiogadget/skills32026年5月25日 更新

hibernate-pc

無料日本語概要

タスク完了後にPCを休止状態にする。Use when: ユーザーが「休止」「hibernate」「タスク完了後に休止状態」「作業後にPCをスリープ/休止」と明示的に指示した場合のみ。正常終了時だけでなく、エラーや未解決事項が残っていても、明示指示があれば最後に休止へ移行する。Windows only.

studiogadget/skills32026年5月25日 更新

Investigate implementation failures using root-cause-first debugging. Use when an implementer is blocked, verification fails, or repeated remediation does not converge.

日本語の概要は準備中です。原文の説明を表示しています。

studiogadget/skills32026年5月25日 更新

studiogadget のスキルをすべて見る

このスキルの問題を報告する