Communityコーディング&開発github.com

mattpocock/ask-matt

あなたの状況に最適なスキルやフローを教えてくれるルーターです。このリポジトリ内のスキルをナビゲートします。

ask-matt とは?

このスキルは、複数のスキルやフローが定義されたリポジトリ内で、現在の状況や目的に応じて最適なスキルを提案する「ルーター」の役割を果たします。ユーザーはすべてのスキルを覚えておく必要はなく、「Ask Matt」に質問することで、開発プロセス全体をナビゲートできます。主な流れは「アイデアからリリースまで」をカバーし、ドキュメントとの対話によるアイデアの具体化(/grill-with-docs)、プロトタイピング(/prototype)、PRD作成(/to-prd)、実装(/implement)とコードレビュー(/code-review)へと進みます。また、バグ診断やトリアージといった「オンランプ」、コードベースの健全性を保つスキル、セッション間のコンテキスト引き継ぎを支援するハンドオフ機能(/handoff)なども含まれており、AIエージェントを用いた効率的なソフトウェア開発ライフサイクルを実現します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mattpocock/skills/tree/main/skills/engineering/ask-matt

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Ask Matt

すべてのスキルを覚えておく必要はありません。質問してください。

フローとは、スキルをたどる道筋です。ほとんどのパスは1つのメインフローに沿って進み、2つのオンランプがそこに合流します。その他はすべてスタンドアロン、または土台となる語彙レイヤーです。

メインフロー:アイデア→リリース

ほとんどの作業がたどるルートです。アイデアがあり、それを実際に形にしたい場合に使います。

  1. /grill-with-docs — インタビュー形式でアイデアを具体化します。コードベースがある場合はここから始めてください。ステートフルに動作し、学習した内容をCONTEXT.mdやADRに保持します。(コードベースがない場合は/grill-meを使用してください。スタンドアロンを参照。どちらも同じ/grillingプリミティブを実行しますが、grill-with-docsは証跡を残す方です。)
  2. 分岐 — すべての質問を会話だけで解決できますか? 実行可能な回答(状態、ビジネスロジック、実際に見る必要があるUI)が必要な質問がある場合は、プロトタイプを経由して迂回します。その際、双方向に**/handoff**で橋渡しします(「セッションのまたぎ」を参照):
    • **/handoff**で外部に出力し、そのファイルに対して新しいセッションを開く、
    • **/prototype**で使い捨てコードを使って質問に答える、
    • 学習した内容を**/handoff**で戻し、元のアイデアスレッドからそれを参照します。
  3. 分岐 — これは複数セッションにわたる構築ですか?
    • はい → /to-prd(スレッドをPRDに変換)→ /to-issues(PRDを個別に取得可能なIssueに分割)。Issueは独立しているため、各Issue間でコンテキストをクリアにします。Issueごとに新しいセッションを開始し、**/implement**にPRDとそのIssueを渡して実行します。
    • いいえ → 同じコンテキストウィンドウ内で、そのまま**/implement**を実行します。

どちらにしても、/implementは各Issueを内部的に/tddで駆動しながら構築します(一度に1つのレッド-グリーンスライス)。その後、コミット前に/code-review(標準+仕様の2軸レビュー)を実行して締めくくります。**/tddは、完全な仕様なしに具体的な動作をテストファーストで構築したい場合に単独で使用します。/code-review**は、ブランチやPRを固定点に対してレビューしたい場合に単独で使用します。

コンテキスト衛生管理

ステップ1~3は1つの途切れないコンテキストウィンドウ内で行ってください。/to-issuesが終わるまではコンパクト化やクリアをしないでください。これにより、グリル、PRD、Issueがすべて同じ思考の上に構築されます。その後、各/implementはIssueを基に新しい状態で開始します。

この制限は**スマートゾーン**(最先端モデルで約120kトークン)に基づきます。この範囲内であればモデルは鋭い推論を維持できます。セッションが/to-issuesの前にこれに近づいた場合は、劣化した状態で進めずに/handoffで退避し、新しいスレッドで続けてください。

オンランプ

作業を生成し、その後メインフローに合流する開始状況です。

  • バグやリクエストが溜まっている → /triage。Issueをトリアージロールを通して処理し、エージェント対応可能なIssueを生成します。これらは後で**/implement**が取得します。

    トリアージは自分が作成していないIssue(バグ報告、機能リクエストなど、生の状態で届くもの)にのみ使用します。/to-issuesが生成したIssueはすでにエージェント対応可能な状態なので、トリアージしないでください。

  • 何かが壊れている → /diagnosing-bugs。難しいバグ(一目では解決できないもの、 intermittently に発生するもの、正常な状態の間に入り込んだリグレッション)に使用します。タイトなフィードバックループ(このバグに対してすでにレッドになる1つのコマンド)ができるまで理論化を拒否し、その後リグレッションテストとともに修正します。実際の発見が、バグを確実に抑え込むための適切なシームが存在しないことである場合、事後分析から**/improve-codebase-architecture**に引き継ぎます。

コードベースの健全性

機能開発ではなく、保守作業です。

  • /improve-codebase-architecture — エージェントが操作しやすいコードベースを維持するために、時間の空いたときに実行します。深掘りの機会を表面化します。1つ選ぶと、メインフローで/grill-with-docsに持ち込めるアイデアが生成されます。これは候補を見つける調査です。/codebase-design(後述)は、選んだ候補を設計するための作業台です。

土台となる語彙

他のスキルの下位で動作する、モデルから呼び出される2つのリファレンスです。それぞれがその語彙の単一情報源となります。プロセスではなく言葉が問題である場合に直接利用するか、上位のスキルが自動的に呼び出すのに任せます。

  • /domain-modeling — プロジェクトのドメイン言語を洗練します。曖昧な用語に挑戦し、過負荷な単語(「アカウント」が3つの役割を担っているなど)を解決し、後戻りが難しい決定をADRとして記録します。これは/grill-with-docsがCONTEXT.mdをクリーンな用語集に保つために駆動する、積極的な規律です。
  • /codebase-design — モジュールの形状を設計するための深層モジュール語彙(モジュール、インターフェース、深さ、シーム、アダプター、レバレッジ、ローカリティ)。多くの振る舞いを、クリーンなシームにある小さなインターフェースの背後に押し込めます。/tddと/improve-codebase-architectureはどちらもこの語彙を使用します。

セッションのまたぎ

  • /handoff — スレッドがいっぱいになった場合や、分岐(例:/prototypeセッション)が必要な場合に、会話をマークダウンファイルにコンパクト化します。その場で続行するのではなく、新しいセッションを開き、そのファイルを参照してコンテキストを引き継ぎます。これはコンテキストウィンドウ間の橋渡しであり、双方向に機能します。新しいセッションが必要だが、現在の会話を保持したい場合に使用します。
  • /compact(組み込み) — 同じ会話内にとどまり、初期のターンを要約させます。フェーズ間の意図的な区切りで使用します。逐語的な履歴を失っても構わない場合に適しています。フェーズの途中でコンパクト化しないでください。エージェントが方向性を見失う可能性があります。/handoffはフォーク(分岐)し、/compactは継続します。

スタンドアロン

メインフローから完全に外れたスキルです。

  • /grill-me — /grill-with-docsと同じ執拗なインタビューですが、コードベースがない場合に使用します。ステートレスで、ローカルに何も保存せず、CONTEXT.mdも作成しません。リポジトリに存在しない計画や設計を洗練させるために使用します。
  • /prototype — 1つの設計上の質問(「この状態モデルは適切か」「このUIはどのように見えるべきか」など)に答えるための、小さな使い捨てプログラムです。初日から使い捨てを前提とし、答えは保持してコードは削除します。メインフローのステップ2で示した迂回経路ですが、設計上の質問が紙の上で決めにくい場合にはいつでも使用できます。
  • /research — 読み込み作業をバックグラウンドエージェントに委任します。一次情報源に対して質問を調査し、引用付きのマークダウンファイルをリポジトリに残します。エージェントが読んでいる間も作業を続けられます。生成されたファイルは、メインフローの/grill-with-docsに持ち込むものです。研究は思考を養うものであり、置き換えるものではありません。
  • /teach — 現在のディレクトリをステートフルなワークスペースとして使用し、複数セッションにわたって概念を学習します。
  • /writing-great-skills — スキルを適切に記述・編集するためのリファレンスです。

前提条件

/setup-matt-pocock-skills — 最初のエンジニアリングフローを実行する前に実行し、他のスキルが想定するIssueトラッカー、トリアージラベル、ドキュメントレイアウトを設定します。カスタムIssueトラッカーでも動作します。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

mattpocock/caveman

Ultra-compressed communication mode. Cuts token usage ~75% by dropping filler, articles, and pleasantries while keeping full technical accuracy. Use when user says "caveman mode", "talk like caveman", "use caveman", "less tokens", "be brief", or invokes /caveman.

mattpocock/claude-handoff

Hand the current conversation off to a fresh background agent that picks up the work immediately.

mattpocock/codebase-design

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

mattpocock/diagnose

Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.

mattpocock/diagnosing-bugs

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.

mattpocock/domain-modeling

Build and sharpen a project's domain model. Use when the user wants to pin down domain terminology or a ubiquitous language, record an architectural decision, or when another skill needs to maintain the domain model.

mattpocock/edit-article

Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.

mattpocock/git-guardrails-claude-code

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

mattpocock/grilling

Grill the user relentlessly about a plan or design. Use when the user wants to stress-test a plan before building, or uses any 'grill' trigger phrases.

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

mattpocock/grill-with-docs

Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.

mattpocock/handoff

Compact the current conversation into a handoff document for another agent to pick up.

mattpocock/implement

Implement a piece of work based on a PRD or set of issues.

mattpocock/implement-spec

Implement a specification in code.

mattpocock/improve-codebase-architecture

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

mattpocock/loop-me

Grill me about specs for the workflows I want to build, within this workspace.

mattpocock/migrate-to-shoehorn

Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.

mattpocock/obsidian-vault

Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

関連スキル