pstack 入門 ~potetoさんのスキル集で、AIエージェントに「深く、検証してから」書かせる~
pstack AIAgent ClaudeCode Cursor
poteto(Lauren Tan)さんが公開しているAIコーディングエージェント向けスキル集「pstack」について、何が嬉しいのか、主要な構成要素、導入と使い方の流れを図解つきで簡潔に紹介します。
AIコーディングエージェントに作業を任せると、速いけれど「余計なコードが多い」「動作確認が甘い」と感じることはないでしょうか。この記事では、その悩みに正面から向き合ったスキル集 pstack を、要点に絞って紹介します。
:::message
本記事は 2026年11月1日(JST)時点の cursor/plugins リポジトリの pstack(plugin.json 上のバージョン 0.15.36)の README とガイドをもとにしています。pstack は更新が活発なので、最新の内容は一次情報をご確認ください。
:::
pstack とは(一言で)
pstack は、poteto(Lauren Tan)さんが自分の仕事の進め方をそのままパッケージにした、AIコーディングエージェント向けのスキル集です。 Cursor のプラグインとして公開されており、Claude Code にもインストールできます(MIT ライセンス)。
README の自己紹介によると、potetoさんは Meta・Netflix・Cursor で大規模なコードに携わってきたエンジニアで、React コアチームの一員として React Compiler の開発・メンテナンスにも関わっておられるようです。pstack は cursor/plugins リポジトリに PR #73(2026年5月24日 06:20 JST マージ)で追加され、その後スキルや原則が増え続けています。
README の冒頭にある言葉が、pstack の考え方をよく表しています。
if you want to go fast, go deep first. (速く進みたいなら、まず深く)
目的はコードの行数を増やすことではなく、その逆で、「少なく、質の高いコード」を書かせることです。

ちなみに、私はXでpotetoさんがpstackについて発信しているのを見かけて使うようになりました。タイミングとしてはちょうどGrokbotを本格活用したあたりで、彼女の活動がよく目にはいるようになったという背景もあります!
何が嬉しいのか
README とガイドから読み取れるメリットは、大きく3つです。
- エージェントが「検証してから完了と言う」ようになる
原則
prove-it-worksは「ビルドが通った」「本人がそう言った」ではなく、実際に動かして本物の成果物で確かめることを求めます。ガイドでも、エージェントが自分で動作を確認できる状態を作ることが最も効果が大きいと説明されています。 - 安心して並列化できる
README は pstack の価値を「fearless parallelism」と表現しています。1つのエージェントに質の高い、検証可能な作業を任せられるなら、複数のエージェントを
/poteto-modeで同時に走らせても信頼できる、という考え方です。 - 細かい指示を書かなくてよい
/poteto-modeがタスクに合う手順(プレイブック)を選び、必要なスキルを呼び出します。利用者は「ゴール」と「完了の判定方法」を伝えるだけで済みます。
一方で、サブエージェントやレビューパネルを使う分、トークン消費は増えます。ガイドにも「それが厳密さの対価」と明記されており、小さく自明な修正には /poteto-mode を使わないことも勧められています。
主要な構成要素
pstack には多くのスキルがありますが、まず押さえるべきものは次の4つです。
1. /poteto-mode(入口)
pstack の中心です。README では「重要な作業なら何でもこれ」という位置づけになっています。呼び出すと次のように動きます。
- 依頼内容を 23 のプレイブック(bug fix、feature、perf、investigation、refactoring、autonomous run、babysit など)のどれかに当てはめる
- プレイブックの手順をそのまま ToDo リストに書き写す(飛ばした手順も
skip: <理由>として残る) - 手順に応じて他のスキルや原則を呼び出す
- 最初の返信で、ユーザーのゴールと解決したい問題を自分の言葉で言い直す
Cursor では / メニューから /poteto-mode を選び、Enter の代わりに option+enter(Mac)/ alt+enter(Windows)で送ると「カスタムモード」になり、チャットの間ずっと有効になります。
2. 24 の原則(principle-*)
1つの原則が1つの短いスキルになっていて、/poteto-mode がタスク開始時にその索引を読みます。利用者が直接呼び出すものではなく、原則の名前を使って軌道修正するのが使い方です。

たとえばエージェントが「ビルドが通ったので完了です」と言ってきたら、ガイドの例のように次のように返します。
apply prove it works. run the real import flow and show me the written records.
原則名が完全なルールを指しているので、長い説明を書くより正確に方向を変えられます。また /poteto-mode は、返信の中でどの原則がどの判断を変えたかを明記することになっています。
3. 代表的なワークフロースキル
/poteto-mode が必要に応じて自動で呼び出しますが、直接使うこともできます。代表的なものだけ挙げます。
| スキル | 使いどころ(README の説明より) |
|---|---|
/how / /why |
サブシステムの仕組みを知りたい/なぜそう作られたかを知りたい |
/architect |
関数の境界をまたぐコードを書く前に、呼び出し側の使い方・型・モジュール構成を決めたい |
/arena |
同じ課題に N 個の試行を並列で走らせ、それぞれの良い部分を取りたい |
/swarm |
異なる担当範囲に N 個のワーカーを並列で走らせ、1つのレポートにまとめたい |
/interrogate |
差分を複数のモデルに壊させ、実行で証明された指摘だけを残したい |
/tdd |
安く回せるローカルテストがあるバグ修正で、先に失敗するテストを書きたい |
/reflect |
長いタスクを終えて、その手順をスキルの改善として残したい |
4. /setup-pstack と /poteto-help
/setup-pstack は、使えるモデルを検出し、推論予算(small / medium / large / unlimited)と役割ごと(コード担当、判断担当、レビューパネルなど)のモデルを設定するスキルです。迷ったときは /poteto-help に聞けば、どのスキルを使うべきかを答え、送るべきプロンプトを渡してくれます。
導入と使い方の流れ

インストール
Cursor のチャットで次を実行します。
/add-plugin pstack
Claude Code の場合は次の2つです。
/plugin marketplace add cursor/plugins
/plugin install pstack@cursor-plugins
Claude Code ではプラグインのコマンドに接頭辞が付くため、/poteto-mode は /pstack:poteto-mode になります。また、サードパーティのマーケットプレイスは自動更新がオフなので、更新したい場合は /plugin の marketplaces タブで自動更新を有効にするか、claude plugin update pstack@cursor-plugins を実行します。Bugbot や automations など Cursor 専用の機能が必要な手順は、Claude Code ではスキップされます。
モデルの設定
/setup-pstack
設定は Cursor では ~/.cursor/rules/pstack-models.mdc、Claude Code では ~/.claude/rules/pstack-models.md に書き込まれます。変えたい役割だけ上書きすればよく、書かなかった役割は既定値のままです。設定の最後には、アプリの動作を検証するプロジェクト専用スキルを /create-verification-skill で作るかどうかを一度だけ聞かれます。ガイドは、初めてなら「yes」を勧めています。設定後は新しいチャットを開始します(モデル設定は新しいセッションから反映されるため)。
/poteto-mode で依頼する
あとはタスクの最初に /poteto-mode を付けて、同僚に話すように依頼するだけです。
/poteto-mode add a --json flag to this command. text output stays byte-identical. verify both.
ガイドでは、良いプロンプトに入れるとよい5つの要素が整理されています。

ポイントは**「やり方」ではなく「ゴールと完了条件」を書く**ことです。原因の仮説も、最初は伝えないほうが探索の幅を狭めずに済むとされています。会話の文脈がそろっていれば、continue や keep going until done のような短い続きの指示でも十分です。
どんな場面で効くか
README の例から、効果が大きそうな場面を挙げます。
- 再現が難しいバグ修正:「repro first, then fix and verify」と書けば、bug fix プレイブックに沿って再現 → 根本原因 → 修正 → 検証の順で進みます。
- 性能問題:perf プレイブックで、ベースラインと比べながら計測にもとづいて改善します。
- PR の面倒を見る:
/poteto-mode check on pr 123. anything outstanding?で、コンフリクト・レビューコメント・CI を merge-ready まで進める babysit プレイブックが動きます。 - 寝ている間の長時間作業:Cursor の
/loopと組み合わせ、完了条件・作業用の worktree・判断ログ(/show-me-your-work)を指定して任せます。翌朝はログで判断の過程を確認できます。 - 設計の比較:新しい設計で前例がないときは、
/arenaや prototype プレイブックで複数案を作って比べます。
なお、README には「計画用のスキルはない」と明記されています。potetoさん自身は「最良の仕様はコード」と考えていて、計画が必要なら /poteto-mode の multi-phase plan プレイブックで対応できるものの、既定の使い方ではないそうです。
自分仕様にする
poteto-mode はあくまで potetoさんのスタイルです。/automate-me を使うと、自分の最近のやり取りから <自分の名前>-mode スキルの下書きを作り、pstack を土台にした自分専用の入口を用意できます。
まとめ
- pstack は「速く進みたいなら、まず深く」という考えのもと、AIエージェントに少なく、質の高い、検証済みのコードを書かせるスキル集
- 入口は
/poteto-modeの1つだけ。タスクに合うプレイブックを選び、スキルと原則を自動で使い分ける - 24 の原則は、名前を出すだけでエージェントの軌道修正に使える
- 導入は
/add-plugin pstack→/setup-pstack→ 新しいチャットで/poteto-mode - トークン消費は増えるので、厳密さが必要な作業に絞って使うのがよい
特にトークン消費については、使わない場合と比べてかなり消費量は増えました。本当に簡単なタスクにまでpstackを全て適用するとおそらくあっという間に週間制限などに引っかかっちゃうので、難易度が高いタスクやタスク難易度が見積もりづらいものを対象にまずは使ってみるといいかなと思います。
全スキルを覚える必要はありません。まずは「ゴール」と「完了条件」を添えて /poteto-mode を使ってみるところから始めるのがおすすめです。
Thanks to poteto
いつも pstack にお世話になっているので、作者の potetoさんへ感謝を込めて。
Thank you, poteto, for building pstack and sharing it with everyone. I rely on it in my day-to-day work, and it has changed how I think about working with coding agents: go deep first, and prove it works. I'm especially grateful that you made it open, so anyone can learn from your way of working and make it their own. Thank you for such a thoughtful and generous tool.