setup-matt-pocock-skills

Matt Pocock スキルの設定

エンジニアリングスキルが依存する、リポジトリ単位の設定を行います。

• Issue トラッカー — issue をどこに保存するか（デフォルトは GitHub。ローカルの Markdown もすぐに使えます）
• 分類ラベル — 5 つの標準的な分類ロールに使うラベル文字列
• ドメイン文書 — GLOSSARY.md と ADR の配置場所、およびそれらを参照する際のルール

これはプロンプト駆動のスキルであり、決定論的なスクリプトではありません。調査し、見つかった内容を提示し、ユーザーに確認してから書き込みます。

プロセス

1. 調査

現在のリポジトリを確認し、初期状態を把握します。存在するものはすべて読み込み、決めつけないでください。

• git remote -v と .git/config — GitHub リポジトリですか？どのリポジトリですか？
• リポジトリのルートにある AGENTS.md と CLAUDE.md — 存在しますか？すでに ## Agent skills セクションがありますか？
• リポジトリのルートにある GLOSSARY.md と GLOSSARY-MAP.md、および旧版の CONTEXT.md / CONTEXT-MAP.md。旧版のファイルが見つかった場合は、git mv で対応する GLOSSARY 名に変更し、docs/agents/domain.md の名称も更新するかどうかを尋ねます。
• docs/adr/ および src/*/docs/adr/ ディレクトリ
• docs/agents/ — このスキルが以前に作成したファイルはありますか？
• .scratch/ — ローカル Markdown の issue トラッカー規約がすでに使われている形跡はありますか？
• triage スキルはインストールされていますか？（このスキルのフォルダーと並列にある triage スキルのフォルダー、または利用可能なスキルに triage があるかどうか。）これにより、B 節を実行するかどうかが決まります。
• モノレポの兆候 — pnpm-workspace.yaml、package.json の workspaces フィールド、または独自の src/ を持つ packages/* があるかどうか。これらは本当に大規模なマルチパッケージリポジトリにのみ見られます。これらがなければ単一コンテキストであり、ほとんどすべてのリポジトリが該当します。

2. 調査結果を提示して質問する

存在するものと不足しているものをまとめます。その後、各節を順番に進めます。一度に一節ずつ回答を得てから、次の節に進みます。

各節は、ユーザーが一言で受け入れられるよう、おすすめの回答から始めます。選択肢によって実際に結果が分かれる場合に限り、1 行で説明します。調査ですでに決着がついている節は丸ごとスキップします（triage がインストールされていない場合は B 節を、モノレポでない場合は C 節をスキップします）。

A 節 — Issue トラッカー。

説明：このリポジトリの「issue トラッカー」とは、issue を保存する場所です。to-tickets、triage、to-spec などのスキルはそこを読み書きするため、gh issue create を呼び出すのか、.scratch/ に Markdown ファイルを書き込むのか、あるいは説明された別のワークフローに従うのかを知る必要があります。このリポジトリで実際に作業を追跡している場所を選んでください。

デフォルトの方針：これらのスキルは GitHub 向けに設計されています。git remote が GitHub を指している場合は、GitHub を提案します。git remote が GitLab（gitlab.com またはセルフホストのホスト）を指している場合は、GitLab を提案します。それ以外の場合（またはユーザーの希望に応じて）は、次を提示します。

• GitHub — issue はリポジトリの GitHub Issues にあります（gh CLI を使用）
• GitLab — issue はリポジトリの GitLab Issues にあります（glab CLI を使用）
• ローカル Markdown — issue はこのリポジトリの .scratch/<feature>/ にファイルとして保存されます（個人プロジェクトや remote のないリポジトリに適しています）
• その他（Jira、Linear など）— ユーザーにワークフローを 1 段落で説明してもらいます。スキルはそれを自由記述として記録します。

選択内容は docs/agents/issue-tracker.md に記録します。GitHub および GitLab のテンプレートには「PR をリクエストの窓口とする」フラグが含まれていますが、デフォルトではオフです。オフのままにし、話題にしないでください。外部の PR を分類キューに入れたいユーザーは、後からファイル内でこのフラグを有効にできます。

GitHub または GitLab トラッカーを選ぶ場合は、アクセス可能なリポジトリに対応していなければなりません。ユーザーがいずれかを選んだにもかかわらず、現在の git remote がそのホストを指していない場合は、先にリポジトリ URL を尋ねてから remote を設定します（必要に応じて先に git init を実行し、その後 git remote add origin <url> を実行します）。その後でなければ続行できません。現在のディレクトリで gh repo view / glab repo view を使ってプロジェクトを表示できる必要があります。表示できない場合は停止し、何が不足しているのかを伝えてください。

B 節 — 分類ラベルの用語。 triage スキルがインストールされていない場合（調査で判明しています）は、この節全体をスキップします。インストールされていないスキルにはラベルが不要です。

インストールされている場合は、質問は 1 つだけです。

デフォルトの分類ラベルを使用しますか？（おすすめ：はい）

デフォルトは 5 つの標準的なロールで、各ラベル文字列はロール名と同じです：needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix。はいを選んだ場合は、そのまま書き込みます。ユーザーが「いいえ」と答えた場合に限り、上書きするラベルを尋ねます。通常は、トラッカーですでに別の名前（たとえば needs-triage に bug:triage）が使われているケースです。これにより、triage はラベルを重複して作成せず、既存のラベルを適用します。

C 節 — ドメイン文書。 デフォルトは単一コンテキストで、リポジトリのルートに GLOSSARY.md を 1 つ置き、docs/adr/ を使います。これはほとんどすべてのリポジトリに適しているため、質問せずに書き込みます。

調査でモノレポの兆候が見つかった場合に限り、複数コンテキストを提示します。これは、各コンテキストの GLOSSARY.md ファイルを指すルートレベルの GLOSSARY-MAP.md を置く構成です。次に、希望するレイアウトを確認します。

3. 確認して編集する

次の草案をユーザーに提示します。

• 編集する CLAUDE.md / AGENTS.md ファイルに追加する ## Agent skills ブロック（選択ルールはステップ 4 を参照）
• docs/agents/issue-tracker.md、docs/agents/domain.md、および docs/agents/triage-labels.md の内容（最後のファイルは triage がインストールされている場合のみ）

書き込む前に、ユーザーが編集できるようにします。

4. 書き込む

編集するファイルを選択します。

• CLAUDE.md が存在する場合は、それを編集します。
• それ以外で AGENTS.md が存在する場合は、それを編集します。
• どちらも存在しない場合は、どちらを作成するかユーザーに尋ねます。こちらで選んではいけません。

CLAUDE.md がすでに存在する場合は、AGENTS.md を決して作成しません（逆の場合も同様です）。常に、すでに存在するファイルを編集します。

選択したファイルに ## Agent skills ブロックがすでにある場合は、重複したブロックを追加せず、その場で内容を更新します。周囲のセクションに対するユーザーの編集は上書きしないでください。

このブロックは次のとおりです。

## Agent skills

### Issue tracker

[one-line summary of where issues are tracked]. See `docs/agents/issue-tracker.md`.

### Triage labels

[one-line summary of the label vocabulary]. See `docs/agents/triage-labels.md`.

### Domain docs

[one-line summary of layout — "single-context" or "multi-context"]. See `docs/agents/domain.md`.

triage がインストールされており、B 節を実行した場合に限り、### Triage labels サブブロックを含め、docs/agents/triage-labels.md を書き込みます。それ以外の場合は、どちらも省略します。

B 節を GitHub または GitLab で実行した場合は、設定済みのラベルのうち、トラッカーにまだ存在しないものを作成します（gh label create / glab label create）。

次に、このスキルのフォルダーにあるシードテンプレートをもとに、文書ファイルを書き込みます。

• issue-tracker-github.md — GitHub issue トラッカー
• issue-tracker-gitlab.md — GitLab issue トラッカー
• issue-tracker-local.md — ローカル Markdown の issue トラッカー
• triage-labels.md — ラベルの対応付け（triage がインストールされている場合のみ）
• domain.md — ドメイン文書の参照ルールとレイアウト

「その他」の issue トラッカーの場合は、ユーザーの説明を使って docs/agents/issue-tracker.md を一から作成します。

5. 完了

設定が完了したことと、どのエンジニアリングスキルがこれらのファイルを参照するようになったかをユーザーに伝えます。後から docs/agents/*.md を直接編集できることにも触れます。issue トラッカーを切り替える場合や、最初からやり直す場合に限り、このスキルを再実行する必要があります。