setup-matt-pocock-skills

Matt Pocock の Skills を設定する

engineering skills が前提とする、リポジトリごとの設定を行います。

• Issue tracker - issues の保存場所（デフォルトは GitHub、local markdown もネイティブにサポート）
• Triage labels - 5 つの canonical triage roles に使用する文字列
• Domain docs - GLOSSARY.md と ADRs の場所、およびそれらを読み取る consumer rules

これは prompt-driven skill であり、決定論的なスクリプトではありません。まず探索し、発見した内容を示し、ユーザーに確認してから書き込みます。

フロー

1. 探索

現在の repo を確認し、初期状態を把握します。既存の内容を読み取り、決めつけないでください。

• git remote -v と .git/config - これは GitHub repo ですか？どの repo ですか？
• repo root の AGENTS.md と CLAUDE.md - 存在しますか？すでに ## Agent skills section がありますか？
• repo root の GLOSSARY.md と GLOSSARY-MAP.md
• docs/adr/ と、src/*/docs/adr/ directories
• docs/agents/ - この skill が以前に何かを出力したことがありますか？
• .scratch/ - local-markdown issue tracker の規約がすでに使われていることを示していますか？
• triage skill がインストールされていますか（この skill の隣に triage folder があるか、available skills に triage があるか）？これによって Section B を実行するかどうかが決まります。
• Monorepo signals：pnpm-workspace.yaml、package.json の workspaces field、または既存の内容を含み、それぞれに src/ がある packages/*。本当に大規模な multi-package repo のみ該当します。これらの signal がなければ single-context で、ほぼすべての repo がこちらです。

2. 発見した内容を示して質問する

存在する内容と不足している内容をまとめます。sections は順番に処理します。1 回につき 1 つの section と 1 つの回答を扱ってから、次に進みます。

各 section では、まず recommended answer を提示し、ユーザーが 1 語で受け入れられるようにします。選択肢によって実際に分岐する場合に限り、説明を 1 行添えます。探索によって回答がすでに決まっている場合は、その section 全体を省略します（triage がインストールされていない場合は Section B を省略し、monorepo でない場合は Section C を省略します）。

Section A - Issue tracker.

説明："issue tracker" は、この repo で issues を保存する場所です。to-tickets、triage、to-spec などの skills はそこから読み取り、そこに書き込むため、gh issue create を呼び出すのか、.scratch/ の下に markdown ファイルを書き込むのか、あるいは説明された別のワークフローに従うのかを知る必要があります。この repo の作業を追跡するために実際に使用している場所を選んでください。

デフォルトの方針：これらの skills は GitHub 向けに設計されています。git remote が GitHub を指している場合は、GitHub を推奨します。git remote が GitLab（gitlab.com または self-hosted host）を指している場合は、GitLab を推奨します。それ以外の場合（またはユーザーが希望する場合）は、次を提示します。

• GitHub - issues は repo の GitHub Issues にあります（gh CLI を使用）
• GitLab - issues は repo の GitLab Issues にあります（glab CLI を使用）
• Local markdown - issues は本 repo の .scratch/<feature>/ にあるファイルとして保存します（個人プロジェクトや remote のない repos に適しています）
• Other（Jira、Linear など）- ユーザーにワークフローを 1 段落で説明してもらいます。skill はその内容を自由記述の prose として記録します

選択内容は docs/agents/issue-tracker.md に記録します。GitHub と GitLab の templates には “PRs as a request surface” flag があり、デフォルトは off です。オフのままにし、質問しないでください。external PRs を triage queue に入れたいユーザーは、後からファイルを直接編集できます。

Section B - Triage label vocabulary. triage がインストールされていない場合は、この section 全体を省略します。インストールされていない skill に labels は必要ありません。

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

デフォルトの triage labels を使いますか？（recommended: yes）

デフォルト値は 5 つの canonical roles で、label string は role name と同じです：needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix。yes と回答された場合は、そのまま書き込みます。ユーザーが no と回答した場合（通常は tracker ですでに別の名称が使われており、たとえば needs-triage に bug:triage を使っている場合）に限り、triage が重複した labels を作成しないよう、上書き値を確認します。

Section C - Domain docs. デフォルトは single-context で、repo root の GLOSSARY.md 1 つと docs/adr/ を使います。これはほぼすべての repo に適しているため、質問せずにそのまま書き込みます。

探索で monorepo signals が見つかった場合に限り、multi-context（root の GLOSSARY-MAP.md が各 context の GLOSSARY.md files を参照する構成）を提示し、どちらの layout にするかユーザーに確認します。

3. 確認して編集する

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

• CLAUDE.md / AGENTS.md に追加する ## Agent skills block（選択ルールは step 4 を参照）
• docs/agents/issue-tracker.md、docs/agents/domain.md、および triage がインストールされている場合に限り docs/agents/triage-labels.md の内容

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

4. 書き込む

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

• CLAUDE.md が存在する場合は、それを編集します。
• それ以外で AGENTS.md が存在する場合は、それを編集します。
• どちらも存在しない場合は、どちらを作成するかユーザーに尋ねます。代わりに選択しないでください。

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

選択したファイルに ## Agent skills block がすでにある場合は、重複した block を追加するのではなく、その内容を既存の場所で更新します。周囲の sections に対するユーザーの編集を上書きしないでください。

Block：

## 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 がインストールされていて、Section B を実際に実行した場合に限り、### Triage labels sub-block を含め、docs/agents/triage-labels.md に書き込みます。それ以外の場合は、どちらも省略します。

次に、この skill folder にある seed templates を元に docs files を作成します。

• issue-tracker-github.md - GitHub issue tracker
• issue-tracker-gitlab.md - GitLab issue tracker
• issue-tracker-local.md - local-markdown issue tracker
• triage-labels.md - label mapping（triage がインストールされている場合のみ）
• domain.md - domain doc consumer rules + layout

"other" issue trackers の場合は、ユーザーの説明に基づいて docs/agents/issue-tracker.md を一から作成します。

5. 完了

セットアップが完了したことと、これらのファイルを読み取るようになった engineering skills をユーザーに伝えます。以後は docs/agents/*.md を直接編集できることを説明します。issue tracker を切り替える場合、または最初からやり直す場合に限り、この skill を再実行する必要があります。