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

エンジニアリングスキルが想定するリポジトリごとの設定をスキャフォルドする:

• Issue tracker — issue がどこに存在するか (デフォルトは GitHub; ローカル markdown もサポート)
• Triage labels — 5 つの標準的なトリアージロール用に使用される文字列
• Domain docs — 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 issue tracker の慣例がすでに使用中の兆候

2. 見つけたものを提示して質問する

存在するものと不足しているものを要約します。次に、3 つの決定をユーザーに 1 つずつ 説明します — セクションを提示して、ユーザーの回答を取得してから次に進みます。3 つすべてを一度にダンプしないでください。

ユーザーはこれらの用語の意味を知らないと仮定します。各セクションは短い説明から始まります (それが何か、これらのスキルが必要な理由、異なる選択をした場合に何が変わるか)。次に、選択肢とデフォルトを示します。

セクション A — Issue tracker。

説明: 「issue tracker」はこのリポジトリの issue が存在する場所です。to-issues、triage、to-prd、qa などのスキルはそこから読み取りおよび書き込みを行うため、gh issue create を呼び出すか、.scratch/ の下に markdown ファイルを書き込むか、または説明する他のワークフローを実行するかどうかを知る必要があります。このリポジトリで実際に作業を追跡する場所を選択します。

デフォルト姿勢: これらのスキルは GitHub 向けに設計されました。git remote が GitHub を指している場合はそれを提案します。git remote が GitLab (gitlab.com またはセルフホストホスト) を指している場合は GitLab を提案します。それ以外の場合 (またはユーザーが選好する場合) は、以下を提供します:

• GitHub — issue はリポジトリの GitHub Issues に存在 (gh CLI を使用)
• GitLab — issue はリポジトリの GitLab Issues に存在 (glab CLI を使用)
• Local markdown — issue はこのリポジトリ の .scratch/<feature>/ の下のファイルとして存在 (ソロプロジェクトやリモートのないリポジトリに適した)
• Other (Jira, Linear など) — ユーザーに 1 段落でワークフローを説明するよう要求; スキルはそれを自由形式の散文として記録します

セクション B — Triage label 語彙。

説明: triage スキルが受信 issue を処理するとき、状態機械を通して移動します — 評価が必要、レポーターからの返答待ち、AFK エージェントが取り上げられる準備ができている、人間による処理が必要、またはアクション対象外。これを行うには、実際に構成した文字列と一致するラベル (またはお客様の issue tracker の同等物) を適用する必要があります。リポジトリがすでに異なるラベル名を使用している場合 (例: bug:triage の代わりに needs-triage)、スキルが正しい名前を適用して重複を作成しないようにここにマップします。

5 つの標準的なロール:

• needs-triage — メンテナーが評価する必要がある
• needs-info — レポーターからの返答待ち
• ready-for-agent — 完全に指定されており、AFK 対応 (エージェントが人間のコンテキストなしでそれを取り上げることができる)
• ready-for-human — 人間による実装が必要
• wontfix — アクション対象外

デフォルト: 各ロール文字列は名前と同じです。ユーザーにいずれかをオーバーライドしたいかどうかを尋ねます。issue tracker に既存のラベルがない場合、デフォルトは問題ありません。

セクション C — Domain docs。

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

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

• Single-context — リポジトリルート に 1 つの CONTEXT.md + docs/adr/。ほとんどのリポジトリはこれです。
• Multi-context — ルートの 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

[issue がどこで追跡されているかの 1 行の概要]。`docs/agents/issue-tracker.md` を参照してください。

### Triage labels

[ラベル語彙の 1 行の概要]。`docs/agents/triage-labels.md` を参照してください。

### Domain docs

[レイアウトの 1 行の概要 — 「single-context」または「multi-context」]。`docs/agents/domain.md` を参照してください。

次に、このスキルフォルダのシードテンプレートを開始点として使用して、3 つのドキュメントファイルを書き込みます:

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

「その他」の issue tracker の場合、ユーザーの説明を使用して docs/agents/issue-tracker.md をゼロから書き込みます。

5. 完了

セットアップが完了したことをユーザーに伝え、これらのファイルから読み取るエンジニアリングスキルを述べます。後でユーザーが docs/agents/*.md を直接編集できることを述べます — このスキルを再実行する必要があるのは、issue tracker を切り替えたい場合またはゼロから開始したい場合だけです。