AGENT SKILL

ask-matt-matt-p

自分の状況にどのスキルやフローが合うか尋ねてください。このリポジトリのスキルを整理するルーターです。

License 许可
MIT
最近更新
2026-11-12
Stars
★ 0
Forks
0

01 前言 Front Matter

name
ask-matt-matt-p
description
自分の状況にどのスキルやフローが合うか尋ねてください。このリポジトリのスキルを整理するルーターです。
disable-model-invocation
true

02 资源文件 2

03 SKILL.md 正文

マットに聞いてください。

すべてのスキルを覚えていないので、質問してください。

フローとは、スキルを通る経路のことです。ほとんどの経路は1つのメインフローに沿って進み、2つのオンランプがそれに合流します。それ以外はすべて独立しているか、下層で動作する語彙レイヤーです。

メインフロー: アイデア → 完成品

ほとんどの作業が通るルートです。あなたにはアイデアがあり、それを形にしたいと考えています。

  1. /grill-with-docs-matt-p はインタビューによってアイデアを研ぎ澄まします。作業ディレクトリで作業しているときは、ここから始めてください:これは状態を保持し、CONTEXT.md や ADR で学んだことを保持します。(作業ディレクトリがない場合は、代わりにスタンドアロンでカバーされる /grill-me-matt-p を使用してください。どちらも同じ /grilling-matt-p プリミティブを実行します;grill-with-docs は作業記録を残すもので、リポジトリが存在してそれを残す場合は、この二つのうちより適しています。)

  2. Branch: 会話の中のすべての質問に答えることができますか? 質問が実行可能な回答(状態、ビジネスロジック、確認が必要なUI)を必要とする場合、プロトタイプを経由し、/handoff-matt-p で双方向に橋渡しします(プロトタイプは独自のディレクトリに存在し、これはまさに /handoff-matt-p が目的とするところです;フェーズ境界を参照してください):

    • /handoff-matt-p を出力し、そのファイルに対して新しいセッションを開きます、
    • /prototype-matt-p 使い捨てコードで質問に答え、
    • /handoff-matt-p 学んだことを返し、元のアイデアスレッドから参照してください。
  3. ブランチ:これはマルチセッションビルドですか?

    • はい → /to-spec-matt-p(スレッドを仕様に変換する)、次に /to-tickets-matt-p でトレーサーバレットチケットに分割し、それぞれの 依存関係 を宣言する。ローカルトラッカーでは、.scratch/<feature>/issues/ 以下でチケットごとに1ファイル作成し、手作業でブロッカーから先にに処理する。実際のトラッカーでは、これらのエッジはネイティブのブロッキングリンクになるので、ブロッカーが完了した任意のチケットを取得可能:各チケットごとに /implement-matt-p を開始し、/clearで各チケット間のコンテキストを処理する。各チケットは自己完結型のため、最後のチケットのコンテキストは破棄可能である。
    • いいえ → /implement-matt-p ここで、同じコンテキストウィンドウ内で。

    いずれにせよ、/implement-matt-p は各課題を、内部で /tdd-matt-p を駆動して構築します(一度に赤緑のスライスを1つずつ)、その後 /code-review-matt-p を実行して終了します。これは差分の二軸レビュー(標準 + 仕様)で、コミット前に行います。完全な仕様なしで具体的な振る舞いのテストを先に作りたい場合は、単独で /tdd-matt-p を使用し、ブランチやPRを固定点に対してレビューしたい場合は、単独で /code-review-matt-p を使用します。

コンテキストの衛生

ステップ1〜3は一つの途切れないコンテキストウィンドウで保持してください(/to-tickets-matt-pの後まで圧縮やクリアをしないでください)。これにより、グリル、仕様、チケットがすべて同じ考えの上に構築されます。その後の各/implement-matt-pはチケットから新たに開始します。

これの制限は**smart zone**にあります:これは、モデルがまだ鋭く推論できるウィンドウ(最先端モデルで約150kトークン)です。セッションが/to-tickets-matt-pの前にこれに近づいた場合、劣化を押し進めないでください;/compactで最も近いフェーズ境界に移動し、続行してください(フェーズ境界を参照)。

入口ランプ

作業を生み出す初期の状況、その後メインフローに合流する。

  • バグやリクエストが積み重なる → /triage-matt-p。これは課題をトリアージの役割に流し、エージェント向けの課題を生成します。その後 /implement-matt-p がこれを引き継ぎます。

    トリアージは あなたが作成していない 課題のみに行います:バグ報告、受信した機能リクエスト、未加工で届いたものすべて。/to-tickets-matt-p が生成したチケットはすでにエージェント向けになっているため、それらはトリアージしないでください。

  • 何かが壊れている → /diagnosing-bugs-matt-p。難しいものの場合:一目見ただけでは分からないバグ、断続的に発生する不具合、既知の正常な状態の間に忍び込んだリグレッション。これらは、緊密なフィードバックループ(このバグで既に赤になるコマンド)を持つまで理論化を拒み、そしてリグレッションテストで修正する。その事後解析は、バグを確実に固定する良い手段が見つからなかった場合、実際の発見を /improve-codebase-architecture-matt-p に引き渡す。

  • 巨大で霧のかかった努力:グリーンフィールドプロジェクトや、1回のセッションでは大きすぎる大規模機能の構築 → /wayfinder-matt-p、ここで最も認知的負荷の高いフローです。ここから目的地までの道筋がまだ見えていない場合、課題トラッカー上で意思決定チケットの共有マップを作成し、それらを一つずつ解決していき、成果物ではなく意思決定を生み出します。霧が晴れて道が明確になるまで進めます。**/grill-with-docs-matt-p**が1回のセッションで保持できるアイデアを鋭くするのに対し、ウェイファインダーは保持できないアイデアのためのもので、より遅く、密度が高いため、まさにそのために使い、よく範囲が定義された機能には絶対に使わないでください。

    マップがクリアされると、それは引き渡すだけで、ビルドはしません:マップのリンクされた決定をビルド可能な計画にまとめる /to-spec-matt-p でメインフローにマージし、その後は通常通り /to-tickets-matt-p と /implement-matt-p に進みます。マップを直接 /implement-matt-p にループさせると、そのまとめをスキップしてリンクされた詳細が捨てられるので、作業が本当に小さい場合のみ /implement-matt-p に直接進んでください。

コードベースの健康

機能の作業ではなく、単なる維持です。

  • /improve-codebase-architecture-matt-p は、エージェントが作業するためのコードベースを良好に保つために、空き時間があるときに実行されます。これは モジュールを深くできる箇所 を表面化させます;1つを選ぶと アイデアが生成され、/grill-with-docs-matt-p のメインフローに取り入れることができます。これは候補者を見つけるための調査であり;/codebase-design-matt-p(下)は、選ばれたものを設計するためのベンチです。

下に語彙

他のスキルの下で動作する2つのモデル呼び出し参照。それぞれが自身の語彙の唯一の正本です。言葉自体が問題で、過程ではない場合は直接それらにアクセスしてください。あるいは、上位のスキルにそれらを取り込ませることもできます。

  • /domain-modeling-matt-p: プロジェクトのドメイン言語を研ぎ澄ます:あいまいな用語に挑戦する、過剰に意味が重なっている単語(「account」が三つの役割を果たしている)を解決する、逆にするのが難しい決定をADRとして記録する。これは/grill-with-docs-matt-pがCONTEXT.mdをきれいな用語集に保つために推進する能動的な規律です。
  • /codebase-design-matt-p はモジュールの形状を設計するためのディープモジュール用語(モジュール、インターフェース、深さ、シーム、アダプター、レバレッジ、局所性)です:クリーンなシームに小さなインターフェースで多くの振る舞いを持たせること。/tdd-matt-p と /improve-codebase-architecture-matt-p はどちらもこれを話します。

フェーズ境界

フェーズとは、セッション内の作業の塊のことです:グリル作業、実装、QA。その2つの境界では、5つの選択肢があり、どれを選ぶかはこのマップ全体で最もあいまいな決定です。

  • 続ける:そのままにする。コストも損失もなし。
  • /clear:ウィンドウを空にする。ここでのことは次に何が起こるかには関係ない場合。
  • /handoff-matt-p はポータブルなマークダウンファイルを書きます。対象は狭く:新しいハーネス、新しいディレクトリ、同僚、または 途中段階の副タスク のみです。それが得られるのはポータビリティです。
  • サブエージェント:範囲を絞ったタスクを自分のウィンドウに送り、報告を受け取ります。
  • /compact はこのコンテキストを圧縮し、それを使って新しいセッションを開始します。デフォルトは、最初に到達するのではなく、ツリーの下部にあります。

PHASE-BOUNDARIES.md を読んで、順序付きツリーについて理解してください:5つの質問、それぞれの枝の背後にある理由、そして一次情報源のコストがなぜ Continue を最初に除外すべきか。境界 で 決定を下してください;中間段階では、残りを続行するか、サブエージェントに分割してください。

スタンドアロン

メインの流れから完全に外れています。

  • /grill-me-matt-p: /grill-with-docs-matt-pと同じ容赦のないインタビューですが、ステートレスです:ローカルに何も保存せず、CONTEXT.mdも作成しません。作業ディレクトリで作業していないときに使用してください(計画、デザイン、文章など、リポジトリの下にないものを磨くとき)。作業ディレクトリ内にいる場合は、代わりに/grill-with-docs-matt-pを使用してください:同じインタビューを実行し、記録を残すので、こちらの方が明らかに優れています。
  • /grilling-matt-p はインタビュー原始そのものです:ラウンド、フロンティア、事実はエージェントの仕事で、決定はあなたのものです。/grill-me-matt-p と /grill-with-docs-matt-p は二つの名前付きの入り口であり、/triage-matt-p、/wayfinder-matt-p、/improve-codebase-architecture-matt-p はすべて内部でそれを実行します。ラッパーなしのインタビューが欲しいときだけ、直接それに手を伸ばしてください。
  • /resolving-merge-conflicts-matt-p は、進行中のマージまたはリベースのコンフリクトをハンクごとに処理し、行を選ぶのではなく各側の主要なソースに追跡された意図によって解決し、その操作を完了します。--abort を実行することはありません。スタンドアロンで、すべてのフローから外れて使用します:すでに中間のコンフリクトにあるときに、それを使ってください。
  • /prototype-matt-p は小さな使い捨てプログラムで、ひとつのデザイン上の質問に答えます:この状態モデルは適切に感じられるか、あるいはこのUIはどのように見えるべきか。使い捨てとはコードの書き方に関する制約であり、破棄を約束するものではありません:その答えは実際のコードに取り入れられ、プロトタイプ自体は main から派生した prototype/<name> ブランチ上の 一次資料 として保持され、実装課題から参照されます。これはメインのフローのステップ2における迂回路ですが、紙上でデザイン上の判断が難しいときはいつでも取り出せます。
  • /research-matt-p: 読書作業をバックグラウンドエージェントに委任する:エージェントは一次資料をもとに質問を調査し、その後リポジトリに引用付きのMarkdownファイルを残す。読みながら作業を続ける。エージェントが作成するファイルは/grill-with-docs-matt-pでメインフローに取り込むものであり、研究は思考を置き換えるのではなく、思考を支えるためのものである。
  • /to-questionnaire-matt-p は、あなたを妨げているものが自分の頭やコードベースではなく、他の誰かの中にある場合に登場し、その人に記入してもらうアンケートを書きます。これは /grill-me-matt-p の逆です:主題についてあなたにインタビューする代わりに、送信先(誰に送るか、何を返してもらう必要があるか)についてあなたにインタビューし、そのギャップに質問を向けます。戻ってくるものは /grill-with-docs-matt-p や /to-spec-matt-p のための材料となります。
  • /wizard-matt-p は、人間だけが実行できるステップのためのものです:インフラのプロビジョニング、認証情報やCIシークレットの設定、馴染みのないサードパーティのダッシュボードでのクリック操作、単発のマイグレーションやカットオーバーの実行などです。これはインタラクティブなBashスクリプトを生成し、各URLを開き、各値を取得して、.envとGitHubシークレットに書き込みます。そのため、この手順をエージェントに毎回説明する必要がなくなります。モデルが呼び出すので、エージェントは自分では通過できない壁にぶつかった瞬間にこれを使います。もしエージェント自身がそれを実行できるなら実行すべきですが、これは人間が実際に関与する必要がある場合のためのものです。
  • /wait-what-matt-p は、伝わらなかったメッセージを修正するためのものです。会話の途中、他のスキルの中でも使用でき、エージェントはあなたが欠けていた文脈を踏まえて、先ほど言ったことを平易な英語で、CONTEXT.md の語彙を使って言い直します。事後的に効果があります;/grill-with-docs-matt-p は事前の対策で、早い段階で共通の言語に合意しておくことで、専門用語が最初から伝わらないことを防ぎます。
  • /teach-matt-p: 現在のディレクトリをステートフルな作業スペースとして使用し、複数のセッションにわたって概念を学習します。
  • /writing-for-agents-matt-p: エージェントが利用するドキュメントを書くためのリファレンスです:スキル、AGENTS.md、参照されたドキュメント。

前提条件

/setup-matt-pocock-skills-matt-p: 最初のエンジニアリングフローを実行する前に、課題トラッカー、ラベルの仕分け、および他のスキルが前提とするドキュメントのレイアウトを設定します。カスタムの課題トラッカーも使用可能です。

04 同仓库更多 Skills

seiei-sogen
seiei-sogen/agent-skills

why

「なぜ X はこの動きなのか」「なぜ Y を選んだのか」、設計の根拠説明、リグレッション、ポストモーテム、データに裏付けられたしきい値に使う。利用可能な MCP を発見し、各証拠カテゴリ(ソース管理、issue トラッカー、長文ドキュメント、リアルタイムチャット、インフラ可観測性、エラートラッキング、プロダクト分析ウェアハウス)を並列で問い合わせ、決定とトレードオフについて引用付きの読み解きを返す。実行時の振る舞いには how を使う。

★ 0
seiei-sogen
seiei-sogen/agent-skills

what-did-i-get-done

ユーザーが指定した期間に自分が作成したコミットを、簡潔な状況報告に要約する

★ 0
seiei-sogen
seiei-sogen/agent-skills

unslop

あらゆる文章から AI の痕跡を削る。常に適用しなければならない。

★ 0
seiei-sogen
seiei-sogen/agent-skills

typescript-best-practices

TypeScript のベストプラクティス。.ts または .tsx ファイルを読むか編集するときに使う。

★ 0
seiei-sogen
seiei-sogen/agent-skills

thermo-nuclear-code-quality-review

抽象化の質、巨大ファイル、スパゲッティ条件分岐の増殖について、極めて厳格な保守性レビューを行う。thermo-nuclear なコード品質レビュー、thermonuclear レビュー、深いコード品質監査、または特に厳しい保守性レビューに使う。

★ 0
seiei-sogen
seiei-sogen/agent-skills

technical-writing

階層化されたテクニカルライティング標準。Diátaxis の構造、Google developer style の文、STE の指示ルール、Global English の構文。/technical-writing、またはドキュメント、RFC、readme、PR の説明、コミットメッセージを書いたりレビューしたりするときに使う。

★ 0