Setup Matt Pocock Skills：プロジェクトのルールを明確にする

この Skill はインストールの問題を解決するものではありません

/setup-matt-pocock-skills は、「インストール後に実行する初期化コマンド」と誤解されがちですが、実際にはプロジェクト契約ジェネレーターのようなものです。後続のスキルに対して、このリポジトリがどのようにタスクを追跡し、issue をどのようにタグ付けし、ドメイン言語やアーキテクチャの決定事項をどこから読み取るかを伝えます。

Matt は README の Quickstart で、インストール時に /setup-matt-pocock-skills を選択し、エージェントで実行するように注意喚起しています。その理由は単純です。to-prd、to-issues、triage、diagnose、tdd、improve-codebase-architecture、zoom-out はすべて同じプロジェクトコンテキストを必要とします。各スキルが個別に問い合わせると、プロセスが断片的になってしまいます。

これは「Claude の設定」を行うのではなく、3 つのエンジニアリング上の質問に答えるものです。

なぜ重要なのか

この一連のスキルの中核的な考え方は、「小さく、組み合わせ可能」ということです。小さいことの代償は、これらのスキルがプロジェクトプロセス全体を自分で管理しようとしないため、プロジェクト内の実際の規約を知る必要があるということです。

例：/to-issues は issue を作成する必要があります。セットアップがないと、以下のいずれを行うべきかを知りません。

• gh issue create を呼び出す
• glab issue create を呼び出す
• .scratch/<feature>/ に書き込む
• それとも、Linear/Jira でコピー可能なテキストを生成する

さらに、/triage は issue を ready-for-agent に移動する必要があります。リポジトリ内の実際のタグが ai:ready で、スキルが新しいタグ ready-for-agent を自分で作成した場合、issue tracker はすぐに汚れてしまいます。

したがって、/setup-matt-pocock-skills の価値は自動化ではなく、暗黙の規約を明示化することです。

どのファイルを読むか

このスキルは、仮定するのではなく、まずリポジトリを探索することから始まります。

• git remote -v と .git/config：GitHub/GitLab プロジェクトかどうかを判断します。
• ルートディレクトリの AGENTS.md / CLAUDE.md：## Agent skills セクションが既に存在するかどうかを確認します。
• ルートディレクトリの CONTEXT.md / CONTEXT-MAP.md：ドメイン言語ドキュメントの形式を判断します。
• docs/adr/ と src/*/docs/adr/：ADR がグローバルかモジュールレベルかを判断します。
• docs/agents/：セットアップが既に実行されているかを確認します。
• .scratch/：ローカル Markdown issue の規約が既に存在するかどうかを判断します。

これは、Matt のワークフロー全体に共通するスタイルです。まずプロジェクトの実際の状態を確認し、それからルールを記述する。

3 つの決定事項

1. Issue tracker

これは後続の作業単位が実装される場所です。

デフォルトでは GitHub が優先されます。なぜなら、このスキルセットは最も初期に GitHub Issues を中心に設計されたからです。しかし、GitLab とローカル Markdown も同等に扱われます。

重要なのはどれを選ぶかではなく、チームが実際に使用しているものを選ぶことです。間違ったものを選択すると、後続のスキルが誤ったシステムでタスクを作成します。

2. Triage label vocabulary

/triage は内部で 5 つの状態役割を使用します。

セットアップでは、これらの役割に対応する実際のタグ名を尋ねられます。プロジェクトに既存のタグがない場合は、デフォルト名を使用すれば十分です。独自の命名体系がある場合は、スキルが新しいセットを作成するのではなく、ここでマッピングする必要があります。

3. Domain docs

これは Matt のスキルセットと通常のプロンプトの最大の違いです。現在の会話だけでなく、プロジェクト内のドメイン言語とアーキテクチャの決定事項も読み取ります。

最もシンプルな形式：

/
├── CONTEXT.md
└── docs/
    └── adr/

大規模なモノレポでは、複数のコンテキストを使用できます。

/
├── CONTEXT-MAP.md
├── apps/
│   └── web/
│       ├── CONTEXT.md
│       └── docs/adr/
└── services/
    └── billing/
        ├── CONTEXT.md
        └── docs/adr/

セットアップは、今すぐすべてのドキュメントを完成させることを強制するのではなく、後続のスキルに対して、どこを探すべきか、見つからなかった場合にどのように作成すべきかを伝えます。

何を記述するか

最終的に 2 種類の出力があります。

1 つ目は、AGENTS.md または CLAUDE.md 内の ## Agent skills セクションです。

## Agent skills

### Issue tracker

...

### Triage labels

...

### Domain docs

...

2 つ目は、docs/agents/ 下の 3 つの説明です。

既存の CLAUDE.md を優先的に編集し、CLAUDE.md がない場合にのみ AGENTS.md を考慮することに注意してください。これは、プロジェクト内に競合する 2 つのエージェントルールエントリポイントを作成しないという重要な抑制を示しています。

推奨される使い方

Matt のスキルセットを初めてインストールする際は、以下の順序で行ってください。

1. インストール：npx skills@latest add mattpocock/skills
2. /setup-matt-pocock-skills を選択します。
3. /setup-matt-pocock-skills を実行します。
4. 実際のプロジェクトの状態に基づいて、issue tracker、タグ、ドメインドキュメントの 3 つの質問に答えます。
5. 生成された ## Agent skills と docs/agents/*.md を確認します。
6. その後、/grill-with-docs、/to-prd、/triage を使用します。

単独で /grill-me を体験したい場合は、セットアップをスキップできます。しかし、エンジニアリングプロセスに入る場合は、まずセットアップを行うことをお勧めします。

この Skill の設計から得られるインスピレーション

/setup-matt-pocock-skills は非常にシンプルに見えますが、エージェントワークフローで最も一般的な問題の 1 つを解決します。それは、ルールが個人の頭の中に散らばっていることです。

多くのチームは、「どのタグを使うか」「どの issue を AI に渡せるか」「CONTEXT.md はどこにあるか」といった情報を口頭での約束として扱います。人間は知っていますが、AI は知りません。AI が知らないと、繰り返し質問するか、さらに悪いことに、自分で推測します。

セットアップの役割は、これらの口頭での約束を読み取り可能なファイルにすることです。後続のスキルはより賢くなる必要はなく、同じプロジェクト契約を安定して読み取るだけで済みます。

これも、私が単独で記事を書く価値があると感じた理由です。これは派手なスキルではありませんが、ワークフロー全体が長期的に機能するための基盤となります。

参考資料

次の記事：Grill Me：AI にコードを書く前に 50 の質問をさせる。