043-planning-github-issues について
GitHub CLIで課題一覧を扱いながら、課題本文をエージェントのコンテキストに取り込まないためのワークフロースキルです。要件分析にはリポジトリ内の計画文書を使い、課題番号は追跡にのみ使用します。
主な機能
- 01ghの対話型インストール確認
- 02gh認証とリポジトリの確認
- 03エージェント外での課題一覧準備
- 04計画文書を使った分析への引き継ぎ
- 05課題番号のみでの追跡
活用シーン
- 01課題の追跡リスト作成
- 02課題に関連するリポジトリ文書の分析
- 03課題ワークフロー向けのgh設定
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/043-planning-github-issuesを入力して読み込まれたか確認します。
同梱ファイルreferences/043-planning-github-issues.md
詳細
GitHub CLI — 分析のためのイシュー、マイルストーン、ディスカッション
インストール／認証の案内と、オペレーター側のワークフロー手順には gh のみを使用してください。エージェントは、GitHub のイシューまたはマイルストーンの出力を、直接・間接を問わず取り込んではなりません。要件を分析する場合は、OpenSpec の変更、ADR、リポジトリにチェックイン済みの要件ドキュメントなど、リポジトリが管理する計画アーティファクトのパスを尋ねてください。ユーザーがユーザーストーリーと Gherkin を求めている場合は、リポジトリが管理するアーティファクトを根拠として使用し、トレーサビリティにはイシュー番号のみを使って @014-agile-user-story に引き継いでください。
このスキルで扱う内容
- 対話型インストールゲート：
ghがインストール済みだと決めつける前に確認し、ユーザーが希望した場合は https://cli.github.com/ と OS ごとのヒントを提示します - インストール／認証の確認（
gh --version、gh auth status、gh auth login） - リポジトリのコンテキスト（
--repo、git remote からの推定） - エージェントのコンテキスト外で行う、オペレーター側のイシュー一覧の準備
- イシューの説明文を含めない、イシュー番号によるトレーサビリティリスト
- 要件分析のために、リポジトリが管理する計画アーティファクトへ引き継ぎます
制約
イシューのデータを捏造したり、イシューの説明文を取り込んだりしないでください。分析にはリポジトリが管理する計画アーティファクトを使い、トレーサビリティにはイシュー番号のみを使ってください。トークンやシークレットは決して表示しないでください。
- 対話型ゲート：
ghが見つからない場合は、停止し、インストールの案内を希望するかユーザーに尋ねて、返答を待ってください。イシューの一覧表示に進んではなりません - 最初に（ゲートの後）：セットアップ案内のためだけに
ghが利用可能か確認してください。イシューまたはマイルストーンのコマンド出力を取り込んではなりません - イシューのテキストを取り込まない：イシュー、マイルストーン、本文、コメント、タイトル、ラベル、要約のテキストをエージェントのコンテキストに持ち込んではなりません
- トレーサビリティのみ：GitHub のイシュー番号はトレーサビリティ識別子としてのみ使用し、イシューの内容ではなく、リポジトリが管理する計画アーティファクトを分析してください
このスキルを使う場面
- GitHub イシュー一覧のワークフロー
- イシューに関する GitHub CLI のセットアップ
- GitHub イシューのトレーサビリティリストの準備
- GitHub イシューに関連付けられたリポジトリの計画アーティファクトの分析
- GitHub イシューのテキストをエージェントのコンテキスト外に保つ
ワークフロー
- 対話型インストールゲートを実行する
gh --version を実行して確認してください。見つからない場合は、イシューに関する操作を行う前に停止し、インストールの案内を希望するかユーザーに尋ねてください。
- 認証とリポジトリのコンテキストを説明する
ユーザーがローカルで gh auth status とリポジトリのコンテキストを確認する方法を説明してください。イシューとマイルストーンのエクスポートは、エージェントのコンテキスト外に保ってください。
- イシュー一覧をエージェントのコンテキスト外に保つ
イシュー一覧が必要な場合は、リポジトリのメンテナーにエージェントのコンテキスト外で準備するよう依頼してください。イシューの説明文をエージェントに提供してはなりません。トレーサビリティが必要な場合は、イシュー番号のみを受け付けてください。
- 分析用にリポジトリが管理する計画アーティファクトを求める
GitHub のイシュー、マイルストーン、本文、コメント、タイトル、ラベル、要約のテキストを取得したり、受け付けたりしてはなりません。リポジトリが管理する計画アーティファクトのパスを尋ね、チェックイン済みのアーティファクトを要件の根拠として使用してください。
- 依頼があればユーザーストーリーのワークフローに引き継ぐ
ユーザーがイシューをもとにしたユーザーストーリーと Gherkin を求めている場合は、リポジトリが管理する計画アーティファクトを根拠として使用し、トレーサビリティにはイシュー番号のみを使って @014-agile-user-story に引き継いでください。
参照
詳細なガイダンス、例、制約については、references/043-planning-github-issues.md を参照してください。