setup-matt-pocock-skills

Matt Pocock のスキルをセットアップする

エンジニアリングスキルが前提とする、リポジトリごとの設定をひな形として作成します。

• イシュートラッカー — イシューの保存場所です（デフォルトは 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つずつ進めます。セクションを提示し、ユーザーの回答を得てから、次のセクションに進みます。3つすべてを一度に提示しないでください。

ユーザーがこれらの用語を知らないことを前提にします。各セクションの冒頭では、短い説明（何か、これらのスキルに必要な理由、選択によって何が変わるか）を記載します。その後、選択肢とデフォルトを示します。

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

説明：「イシュートラッカー」とは、このリポジトリのイシューを管理する場所です。to-issues、triage、to-prd、qa などのスキルは、ここから情報を読み書きします。gh issue create を呼び出すのか、.scratch/ 以下に Markdown ファイルを書き込むのか、あるいは説明された別のワークフローに従うのかを把握する必要があります。このリポジトリの作業を実際に追跡している場所を選んでください。

デフォルトの方針：これらのスキルは GitHub 向けに設計されています。git remote が GitHub を指している場合は、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つあるのか、複数あるのか（例：フロントエンドとバックエンドで個別のコンテキストを持つモノレポ）を把握する必要があります。

構成を確認します。

• 単一コンテキスト — リポジトリのルートに CONTEXT.md と docs/adr/ が1つずつあります。ほとんどのリポジトリがこの構成です。
• 複数コンテキスト — ルートに 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

[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`.

次に、このスキルフォルダー内のひな形をベースに、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 を直接編集できること、イシュートラッカーを切り替える場合や最初からやり直す場合にのみ、このスキルを再実行すればよいことも伝えます。