setup-matt-pocock-skills

Setup Matt Pocock's Skills

エンジニアリング系スキルが前提とする、リポジトリごとの設定を足場づくりします:

• イシュートラッカー — イシューがどこに存在するか（デフォルトはGitHub。ローカルmarkdownも標準でサポート）
• トリアージラベル — 5つの正規トリアージロールに使われる文字列
• ドメインドキュメント — CONTEXT.md とADRがどこにあるか、およびそれらを読むためのコンシューマールール

これはプロンプト駆動のスキルであり、決定論的なスクリプトではありません。探索し、見つけたものを提示し、ユーザーと確認し、それから書き込みます。

プロセス

1. 探索する

現在のリポジトリを見て出発点の状態を理解します。存在するものは何でも読み、決めつけないこと:

• git remote -v と .git/config — これはGitHubリポジトリか? どれか?
• リポジトリルートの AGENTS.md と CLAUDE.md — どちらか存在するか? どちらかに既に ## Agent skills セクションがあるか?
• リポジトリルートの CONTEXT.md と CONTEXT-MAP.md
• docs/adr/ と任意の src/*/docs/adr/ ディレクトリ
• docs/agents/ — このスキルの過去の出力が既に存在するか?
• .scratch/ — ローカルmarkdownのイシュートラッカー規約が既に使われているサイン

2. 見つけたものを提示して尋ねる

存在するものと欠けているものを要約します。それから3つの決定を 1つずつ ユーザーと進めます — 1セクションを提示し、ユーザーの回答を得て、次に移ります。3つを一度に投げないこと。

ユーザーはこれらの用語の意味を知らないと想定します。各セクションは短い説明から始めます（それが何か、なぜこれらのスキルがそれを必要とするか、別の選択をすると何が変わるか）。それから選択肢とデフォルトを示します。

セクションA — イシュートラッカー。

説明: 「イシュートラッカー」はこのリポジトリのイシューが存在する場所です。to-issues、triage、to-prd、qa のようなスキルがそこから読み書きします — gh issue create を呼ぶのか、.scratch/ 下にmarkdownファイルを書くのか、ここで指定する別のワークフローに従うのかを知る必要があります。このリポジトリで実際に作業を追跡している場所を選んでください。

デフォルトの姿勢: これらのスキルはGitHub向けに設計されました。git remote がGitHubを指していれば、それを提案します。git remote がGitLab（gitlab.com または自己ホストのホスト）を指していれば、GitLabを提案します。それ以外（またはユーザーが好む場合）は次を提示します:

• GitHub — イシューはリポジトリのGitHub Issuesに存在（gh CLIを使う）
• GitLab — イシューはリポジトリのGitLab Issuesに存在（glab CLIを使う）
• ローカルmarkdown — イシューはこのリポジトリの .scratch/<feature>/ 下のファイルとして存在（ソロプロジェクトやリモートのないリポジトリに適する）
• その他（Jira、Linearなど）— ユーザーにワークフローを1段落で説明してもらう。スキルはそれを自由形式の散文として記録します

セクションB — トリアージラベルの語彙。

説明: triage スキルが受信イシューを処理するとき、それを状態機械を通して動かします — 評価が必要、報告者待ち、AFKエージェントが拾える状態、人間向け、対応しない。そのためには、実際に設定した 文字列に一致するラベル（またはイシュートラッカーでの同等物）を適用する必要があります。リポジトリが既に別のラベル名（例: needs-triage ではなく bug:triage）を使っているなら、ここでマッピングして、スキルが重複を作るのではなく正しいラベルを適用するようにします。

5つの正規ロール:

• needs-triage — メンテナが評価する必要がある
• needs-info — 報告者待ち
• ready-for-agent — 完全に仕様化され、AFK対応可能（エージェントが人間のコンテキストなしで拾える）
• ready-for-human — 人間による実装が必要
• wontfix — 対応しない

デフォルト: 各ロールの文字列はその名前と等しい。いずれかを上書きしたいかユーザーに尋ねます。イシュートラッカーに既存ラベルがなければ、デフォルトで問題ありません。

セクションC — ドメインドキュメント。

説明: 一部のスキル（improve-codebase-architecture、diagnose、tdd）はプロジェクトのドメイン言語を学ぶために CONTEXT.md ファイルを読み、過去のアーキテクチャ決定のために docs/adr/ を読みます。正しい場所を見るために、リポジトリがグローバルなコンテキストを1つ持つのか複数持つのか（例: フロントエンド/バックエンドで別々のコンテキストを持つモノレポ）を知る必要があります。

レイアウトを確認します:

• シングルコンテキスト — リポジトリルートに1つの CONTEXT.md + docs/adr/。ほとんどのリポジトリがこれです。
• マルチコンテキスト — ルートの CONTEXT-MAP.md がコンテキストごとの CONTEXT.md ファイルを指す（典型的にはモノレポ）。

3. 確認して編集する

ユーザーに次の草案を見せます:

• 編集対象の CLAUDE.md / AGENTS.md のいずれかに追加する ## Agent skills ブロック（選択ルールはステップ4を参照）
• docs/agents/issue-tracker.md、docs/agents/triage-labels.md、docs/agents/domain.md の内容

書き込む前に編集させます。

4. 書き込む

編集するファイルを選ぶ:

• CLAUDE.md が存在すれば、それを編集します。
• そうでなく AGENTS.md が存在すれば、それを編集します。
• どちらも存在しなければ、どちらを作成するかユーザーに尋ねます — 勝手に選ばないこと。

CLAUDE.md が既に存在するときに AGENTS.md を作成する（またはその逆）ことは決してしないこと — 常に既にある方を編集します。

選んだファイルに ## Agent skills ブロックが既に存在する場合は、重複を追記するのではなく、その内容をその場で更新します。周辺セクションへのユーザーの編集を上書きしないこと。

ブロック:

## Agent skills

### Issue tracker

[イシューが追跡される場所の1行サマリー]. See `docs/agents/issue-tracker.md`.

### Triage labels

[ラベル語彙の1行サマリー]. See `docs/agents/triage-labels.md`.

### Domain docs

[レイアウトの1行サマリー — "single-context" または "multi-context"]. See `docs/agents/domain.md`.

それから、このスキルフォルダのシードテンプレートを出発点に、3つのドキュメントファイルを書きます:

• issue-tracker-github.md — GitHub イシュートラッカー
• issue-tracker-gitlab.md — GitLab イシュートラッカー
• issue-tracker-local.md — ローカルmarkdown イシュートラッカー
• triage-labels.md — ラベルマッピング
• domain.md — ドメインドキュメントのコンシューマールール + レイアウト

「その他」のイシュートラッカーについては、ユーザーの説明を使って docs/agents/issue-tracker.md を一から書きます。

5. 完了

ユーザーにセットアップが完了したことと、どのエンジニアリング系スキルが今後これらのファイルから読み取るかを伝えます。後で docs/agents/*.md を直接編集できることも伝えます — このスキルの再実行が必要なのは、イシュートラッカーを切り替えたい、または一から作り直したい場合だけです。