setup-issue-tracker について
setup-issue-trackerは、リポジトリの課題・意図管理バックエンドと、項目の読み取りや完了作業との関連付け方法を記録するスキルです。ローカルファイルのみを設定し、承認を得て既存のAGENTS.mdに接続できます。
主な機能
- 01管理バックエンドと場所を記録
- 02読み取り・関連付け方法を記載
- 03既存AGENTS.mdへの任意の追記
- 04変更を確認して結果を報告
活用シーン
- 01リポジトリのGitHub課題管理を設定
- 02ローカルMarkdownの意図管理を設定
- 03後続エージェント向けに管理ルールを記録
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/setup-issue-trackerを入力して読み込まれたか確認します。
同梱ファイルassets/AGENTS-sections.md
詳細
Issue Tracker の設定
リポジトリの issue と intent のバックエンド、および後続のスキルが issue をどのように読み取り、完了した作業をどのように紐付けるかを、docs/agents/issue-tracker.md に記録します。任意で、その設定を既存の AGENTS.md に関連付けることもできますが、ファイルのほかの部分の管理権限は引き受けません。
このスキルが設定するのはローカルファイルのみです。リモートリポジトリ、issue、ラベルは作成せず、AGENTS.md や CLAUDE.md を作成したり置き換えたりもしません。
まず調査する
- 既存の
docs/agents/issue-tracker.mdがあれば、最初から最後まで読みます。 - ルートレベルの
AGENTS.mdがあれば読み、トラッカー設定をすでに参照しているか、intent から PR へのワークフローを説明しているかを確認します。 git remote -vを実行します。一般的な GitHub の HTTPS URL と SSH URL は、末尾の.gitを除いてowner/repoに正規化します。fetch URL と push URL が一致しない場合、複数のリモートが候補になる場合、またはリモートがフォークの可能性がある場合は、1つを選ばず候補を提示します。推測した場所はすべて提案であり、ユーザーが意図するトラッカーの確定ではありません。git statusを確認し、変更前に現在の状態を要約します。
バックエンドを確認する
issue と intent をどこに置くかを尋ねます。
| バックエンド | 確認する設定 |
|---|---|
| GitHub | リモートから推測した owner/repo を確認します。リモート間で一致しない場合、または GitHub を示すリモートがない場合は、推測せずに尋ねます。ラベルとして intent を提案しますが、必ず確認します。このバックエンドでは brainstorm-to-issue がラベルを使用するため、ラベルが必要です。 |
| ローカル Markdown | .scratch/<feature>/ またはユーザーが指定する別の場所を確認します。 |
| その他 | バックエンド名、場所、ほかのエージェントが利用できるだけの自由形式のワークフローに関するメモを尋ねます。 |
設定の一環として、リモートラベルを調査、作成、更新してはいけません。後続の issue 作成ワークフローでは、必要な認可を得たうえでラベルを操作する場合があります。
読み取りと紐付けを確認する
後続のスキルがこのファイルから必要とする情報は、issue の読み取り方法と、完了した作業を issue に紐付ける方法の2つです。GitHub 以外のトラッカーに GitHub の構文を使わないよう、両方を記録します。
| バックエンド | 確認する提案 |
|---|---|
| GitHub | GitHub 独自の慣習を提案します。参照には #<number> を使い、読み取りには gh issue list と gh issue view を使います。PR 本文の Closes #<number> はマージ時に issue を閉じ、Relates to #<number> は部分的な作業を示します。手動で閉じるには gh issue close を使います。これらをデフォルトとして提案します。 |
| ローカル Markdown | intent ファイルのパスを参照として使い、読み取り時にはファイルを開きます。マージによって閉じることはないため、完了した intent のマーク方法（たとえばファイル内のステータス行）を尋ねます。これにより、どのファイルを未完了とみなすかも確認します。 |
| その他 | 各項目について尋ねます。参照形式、issue の一覧表示と読み取り方法（CLI、MCP サーバー、URL など）、issue を閉じたり参照したりするために PR に記載する内容、手動で閉じる方法です。Jira の場合、ブランチ、コミット、PR のタイトルには通常、issue キー（PROJ-123 など）を使います。マージによってチケットが閉じるかどうかは、チームの Jira–GitHub 連携によって異なるため、決めつけずに尋ねます。 |
設定を書く
必要に応じて docs/agents/ を作成し、既存のファイルはすべて保持します。次の形式で docs/agents/issue-tracker.md を作成します。
# Issue tracker
## Backend
<GitHub, Local markdown, or the named backend>
## Location
<confirmed owner/repo, local path, or tracker location>
## Labels
<confirmed labels, or None>
## Reading
- Issue reference: <e.g. `#<number>`, `PROJ-<number>`, or the intent file's path>
- List open issues: <command, tool, or rule for which files are open>
- Read one issue: <command, tool, or path>
## Linking
- Finishing PR: <what a PR writes to close the issue on merge, or None>
- Partial PR: <what a PR writes to reference the issue without closing it>
- Close by hand: <command or step, for when no PR carries the link>
## Notes
<user-provided details, or None>
GitHub の場合は、intent ラベルを - <label> — applied to issues created by brainstorm-to-issue として記録します。既存の設定がある場合は、実際の値を置き換える前に、変更案を示して確認を得ます。Reading セクションと Linking セクションが追加される前に書かれた設定は、値が誤っているのではなく、未記載です。2つのセクションを追加として提案し、ほかの変更と同様に確認を得ます。同じ値で再実行する場合は何も変更しません。
既存の AGENTS.md を連携する
ルートレベルに AGENTS.md が存在しない場合は、作成せずそのままにします。トラッカーの設定は引き続き使用できます。リポジトリ全体で共有する指示をユーザーが希望する場合は、setup-agent-md をおすすめします。
AGENTS.md が存在する場合は、assets/AGENTS-sections.md を読み込み、不足している項目またはセクションを正確にユーザーに示します。トラッカーの選択によって、この任意の編集が暗黙のうちに承認されたことにはなりません。パッチを提示して承認を得てください。バックエンドの確認と合わせて、1つの質問で確認してもかまいません。
- 既存の
Agent configurationセクションがある場合は、トラッカーの項目をそのセクションに統合し、見出しを重複させないでください。 - 既存の
Workflowセクションは保持してください。PR を作成する意図を伝える手順が不足している場合は、不足している手順のみを統合するパッチを提示してください。既存の手順が提示されたワークフローと矛盾する場合は、矛盾点を示し、どちらの文面を残すか確認してください。 - 関係のないプロジェクトの指示は、並べ替え、書き換え、再フォーマットしないでください。
完了
トラッカーの設定を読み返し、最終差分を確認します。AGENTS.md に変更を加えた場合は、承認された項目またはセクションのみが変更されていることを確認してください。バックエンド、保存場所、ラベル、読み取りとリンクの規約、意図的に変更しなかったファイルを報告します。任意の AGENTS.md 連携が拒否または保留されても、トラッカーの設定ファイルは有効です。その状態を明確に報告してください。イシューを作成したり、別のスキルを呼び出したりせずに終了します。
やってはいけないこと
- トラッカー、GitHub リポジトリ、ローカルパス、ラベルを推測しないでください。
- GitHub 以外のトラッカーがイシューをどのように読み取り、リンクし、クローズするかを推測しないでください。また、そのようなトラッカーに GitHub の
#<number>やClosesの構文を記録しないでください。 - ローカル設定の際に、GitHub やその他のリモートサービスを変更しないでください。
- 差分を提示して承認を得ることなく、既存の設定が記入済みのトラッカー設定を上書きしないでください。
AGENTS.mdやCLAUDE.mdを作成しないでください。それらはsetup-agent-mdの担当です。- 既存の
AGENTS.mdをテンプレートで置き換えたり、関係のない指針を書き換えたりしないでください。 - セットアップの一環として、意図を記録するイシュー、仕様書、計画書、プルリクエストを作成しないでください。