Ask Matt
すべてのスキルを覚えておく必要はありません。質問してください。
フローとは、スキルをたどる道筋です。ほとんどのパスは1つのメインフローに沿って進み、2つのオンランプがそこに合流します。その他はすべてスタンドアロン、または土台となる語彙レイヤーです。
メインフロー:アイデア→リリース
ほとんどの作業がたどるルートです。アイデアがあり、それを実際に形にしたい場合に使います。
/grill-with-docs— インタビュー形式でアイデアを具体化します。コードベースがある場合はここから始めてください。ステートフルに動作し、学習した内容をCONTEXT.mdやADRに保持します。(コードベースがない場合は/grill-meを使用してください。スタンドアロンを参照。どちらも同じ/grillingプリミティブを実行しますが、grill-with-docsは証跡を残す方です。)- 分岐 — すべての質問を会話だけで解決できますか? 実行可能な回答(状態、ビジネスロジック、実際に見る必要があるUI)が必要な質問がある場合は、プロトタイプを経由して迂回します。その際、双方向に**
/handoff**で橋渡しします(「セッションのまたぎ」を参照):- **
/handoff**で外部に出力し、そのファイルに対して新しいセッションを開く、 - **
/prototype**で使い捨てコードを使って質問に答える、 - 学習した内容を**
/handoff**で戻し、元のアイデアスレッドからそれを参照します。
- **
- 分岐 — これは複数セッションにわたる構築ですか?
- はい →
/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トラッカーでも動作します。