pstackの使い方|Cursor・Claude Codeへの入れ方と頼み方

CursorやClaude CodeでAIにコードの修正を頼むと、AIが「直しました」と返してきても、本当に直ったかは自分で動かすまで分かりません。pstackは、原因の再現から実物での確認までの手順をAIに組み込む、Cursorが配布する公式のプラグインです。
一方で、pstackには58個のスキルが入っていて、どれから使えばよいかが最初は分かりにくくなっています。作業の一部を受け持つ別のAI(サブエージェント)や複数のモデルによる点検を使うため、トークンの消費も多めです。
この記事では、pstackの入れ方と最初の設定・/poteto-modeでの頼み方・目的別のスキル・使う前の注意点を解説します。
この記事を読めば、pstackにコードの作業を任せる準備が今日から整います。最初に覚えるコマンドは/setup-pstackと/poteto-modeの2つで、頼むときは目標と「終わったことの確かめ方」を書くのがコツです。
目次
- pstackとは?確かめながら進める手順をAIに渡すCursorの公式プラグイン
- pstackの入れ方と最初の設定
- /poteto-modeでpstackに作業を頼む方法
- 目的別に直接使えるpstackのスキル
- pstackを使う前に知っておきたい注意点
- pstackの使い方に関するよくある質問
- まとめ
- 参考リンク
pstackとは?確かめながら進める手順をAIに渡すCursorの公式プラグイン
pstackは、AIのエージェントに、エンジニアのチームと同じ仕事の進め方をさせるためのプラグインです。作者はCursorのエンジニアのLauren Tan(poteto)で、普段の開発で使っているスキルと原則をまとめて公開しています。
pstackが目指すのは、書くコードの量を増やすことではなく、量は少なくても質の高いコードをAIに書かせることです。AIに問題を理解させてから作業させ、終わったあとは実際の動作で確かめさせます。
pstackに入っている主な部品は、以下の4つです。
- /poteto-mode:依頼を読み、合う手順書を選んで作業を進める入口のスキル
- 手順書(プレイブック):調査・バグの修正・新しい機能など23種類の作業の進め方
- スキル:コードの説明・点検・文章の手直しなど、目的ごとに直接呼び出せる機能
- 原則:「小さな変更を選ぶ」「実物で確かめる」など24個の仕事の決まり
pstackの基本情報は、以下の表にまとめました。
| 項目 | 内容 |
|---|---|
| 作者 | Lauren Tan(poteto) |
| 公式の入れ方があるツール | Cursor・Claude Code |
| 入っているもの | スキル58個(原則24個を含む)・サブエージェント2個 |
| 料金 | プラグインは無料(MITライセンス)。動かすAIのモデルの分はトークンを使う |
| 版 | 0.15.36(2026年11月10日に確認) |
Cursorのマーケットプレイスのpstackのページには、Cursorが作り、Cursorが確かめたプラグインであることを示す「Created by Cursor」「Verified by Cursor」の表示があります。
pstackの入れ方と最初の設定
pstackは、CursorでもClaude Codeでも、チャットにコマンドを入力すれば入れられます。入れただけでは普段の依頼の動きは変わらず、スキルは主に、名前を入力したときか/poteto-modeが呼んだときに動きます。pstackを使い始めるまでの手順は、以下の5つです。
- Cursorに入れる
- Claude Codeに入れる
- /setup-pstackでモデルと推論の予算を選ぶ
- 動作を確かめるスキルを作るかを選ぶ
- 新しいチャットで最初の作業を頼む
1と2は、使うツールに合わせてどちらかを行います。
Cursorに入れる
Cursorでは、エージェントのチャットの入力欄に次のコマンドを入力して送ります。
/add-plugin pstack
コマンドを送ると、Cursorからpstackを入れたことの確認が返ってきます。サイドバーの「Customize」も、pstackを入れられる場所です。
Cursorのインストールと基本の操作は、以下の記事で解説しました。
Cursorの使い方を解説!インストールから基本の操作・便利な機能まで
Claude Codeに入れる
Claude Codeでは、Cursorのプラグインの一覧(マーケットプレイス)を先に追加してから、pstackを入れます。Claude Codeを起動し、入力欄で次の手順のとおりに進めてください。
/plugin marketplace add cursor/pluginsでCursorのマーケットプレイスを追加する/plugin install pstack@cursor-pluginsでpstackの詳細の画面を開く- 入れる範囲を「自分だけ」「このリポジトリの全員」「このリポジトリの自分だけ」から選ぶ
Claude Codeでは、プラグインのコマンドの頭に「pstack:」が付き、/poteto-modeは「/pstack:poteto-mode」と入力します。
Claude Codeの初期設定では、cursor-pluginsのような外部のマーケットプレイスの自動更新はオフです。自動で更新したいときは、/pluginの「Marketplaces」のタブでcursor-pluginsを選んでから「Enable auto-update」を選びます。
Claude Codeのプラグインの探し方・入れ方・外し方は、以下の記事で実際の画面とともに解説しました。
Claude Codeのプラグインの使い方|入れ方・管理・外し方を画面で解説
/setup-pstackでモデルと推論の予算を選ぶ
/setup-pstackは、pstackが役割ごとに使うAIのモデルと、考える深さ(推論の予算)を決めるコマンドです。
/setup-pstackを実行すると、使えるモデルを調べたあとに、推論の予算を聞かれます。選べる4つの項目と推論の深さは、以下の表のとおりです。
| 選ぶ項目 | 推論の深さ |
|---|---|
| unlimited — max reasoning | 各モデルで最も深い段階(最大でmax) |
| large — xhigh reasoning | xhigh(pstackの初期設定と同じ) |
| medium — high reasoning | high |
| small — medium reasoning | medium |
mediumとsmallは、推論を浅くする分、使うトークンを減らせる設定です。
予算を選ぶと、コードを書く役・判断と文章の役・点検の役などに割り当てるモデルの一覧が出ます。一覧のままでよいか、変える役はどれかを答えると設定が決まります。初期設定では、コードの作業はGrok、最も難しい変更と文章と判断はOpus 5.5の担当です。
役のモデルを「auto」か「inherit-parent」にすると、該当する役は予算に関係なく、チャットのモデルと考える深さで動きます。Claude Codeでは、Grokなどを割り当てた役も会話のモデルで動きます。
選んだ設定の保存先は、Cursorでは~/.cursor/rules/pstack-models.mdc、Claude Codeでは~/.claude/rules/pstack-models.mdです。どちらも新しい会話に毎回読み込まれるファイルで、設定を変えたいときは/setup-pstackをもう一度実行します。
Claude Codeで会話のモデルと考える深さ(effort)を切り替える方法は、以下の記事にまとめました。
Claude Codeのモデルの切り替え方!/modelとeffortの使い方
動作を確かめるスキルを作るかを選ぶ
/setup-pstackの最後に、AIがアプリを実際に動かして確かめるためのスキル(検証スキル)を作るかを聞かれます。プロジェクトに検証の仕組みがないときだけ出る提案で、断っても後から/create-verification-skillで作れます。
検証スキルの保存先は、Cursorではプロジェクトの「.cursor/skills/verify-アプリ名/」、Claude Codeでは「.claude/skills/verify-アプリ名/」です。
pstackを初めて使う方は、検証スキルを作っておきましょう。確かめる手段のないAIは結果の確認をすべて人に返しますが、自分で結果を確かめられるAIは確認が通るまで作業を続けられるからです。
形式検証のスキルを作るかも聞かれます。形式検証は「同じ処理が2回同時に動かない」のような性質を、決めた範囲のすべての場合で確かめる方法です。並行処理・再試行・状態の切り替え・構文の解析のどれも含まないコードなら「いいえ」で十分です。
新しいチャットで最初の作業を頼む
モデルの設定は新しく始めた会話から使われるため、設定が終わったら新しいチャットを開き、小さな作業を1つ頼んで動きを見ましょう。最初に試す依頼の例は、以下のとおりです。
/poteto-mode add a --json flag to this command. text output stays byte-identical. verify both.
依頼文の意味は「このコマンドに--jsonのオプションを足し、今のテキストの出力は1バイトも変えず、両方を確かめる」です。Claude Codeでは、依頼の頭を「/pstack:poteto-mode」にします。画面は、練習用のコマンドwordstatで試した例です。
Cursorでは、依頼を送ると、やることリストの先頭に、選ばれた手順書の手順が写されます。Claude Codeでは、やることリストが出ないまま作業が進むこともあります。
/poteto-modeでpstackに作業を頼む方法
/poteto-modeは、依頼を読んで23種類の手順書から合うものを選び、手順に沿ってほかのスキルを呼び出しながら作業を進める入口のスキルです。依頼の種類と、/poteto-modeが選ぶ主な手順書は、以下の表のとおりです。
| 依頼の種類 | 選ばれる手順書 | 主な進め方 |
|---|---|---|
| 読むだけの質問 | Investigation(調査) | コードを変えずに根拠を付けて答える |
| 不具合 | Bug fix(バグの修正) | 再現して原因を突き止めてから直す |
| 新しい動き・動きの変更 | Feature(機能) | 扱うデータの形を決めてから作る |
| 動きを変えない構造の変更 | Refactoring(構造の整理) | 動作を保ったまま構造を直す |
手順書は依頼の書き方から自動で選ばれるため、手順書の名前を依頼に書く必要はありません。/poteto-modeに作業を頼むときに知っておきたい使い方は、以下の4つです。
- 目標と完了の確かめ方を書いて頼む
- やることリストで進み方を確かめる
- カスタムモードにして続けて使う
- 別の作業に移るときは「new task」と書く
目標と完了の確かめ方を書いて頼む
/poteto-modeへの依頼には、手順や使うスキルではなく、目標と「終わったと判断できる確かめ方」を書きます。役に立つ依頼に入れる要素は最大で以下の5つで、すべてをそろえる必要はありません。
- 目標:何がおかしいか、何をしたいか
- 完了の確かめ方:合格か不合格かを判定できる条件
- 見せてほしい証拠:コマンドの実際の出力・操作の動画・前後の数値
- 分かっていること:症状・再現の手順・ログの1行・リンク
- 守ってほしい条件:「先に再現する」「まだコードを変えない」など
5つの要素をすべて入れた依頼の例は、以下のとおりです。
/poteto-mode the csv export drops its last row since yesterday's deploy. failing job id is 4812. repro first, then fix. done means the 60k-row fixture exports every row. show me the row counts before and after.
依頼文の守ってほしい条件は「repro first」で、完了の確かめ方は6万行のテスト用のデータを全行書き出せることです。証拠には、直す前と後の行数を求めています。
「もっと良くして」や「1時間作業して」は、合格か不合格かを決められないため、完了の確かめ方になりません。直し方と、原因についての自分の推測も、最初の依頼には書かないほうが無難です。推測を先に書くと、AIは指定された場所ばかりを調べるようになります。
やることリストで進み方を確かめる
やることリスト(todo)が出たときは、先頭の手順を見れば、AIがどの手順書を選び、いまどの手順にいるかが分かります。AIが省いた手順も消えずに「skip: 理由」の形で残るため、何をしなかったかまで分かる仕組みです。
/poteto-modeは最初の返事で、依頼の目標と解こうとしている問題を、AI自身の言葉で書き直します。変更を加える作業では、目標を満たす最小の変更の見込みも書きます。
AIは確認を待たずに作業を進めるため、読み違いが心配なときは、依頼に「restate it in your own words. don't change any code yet.」と書いて書き直しを先にさせましょう。読み違いは、コードができる前なら1回のメッセージで直せます。
カスタムモードにして続けて使う
/poteto-modeをEnterキーで送ると、スキルが効くのは送った1回の依頼だけで、会話が進むと効き目が薄れます。会話の間ずっと/poteto-modeを効かせたいときは、Cursorのカスタムモードを使います。カスタムモードを使えるのは、CursorのAgents WindowとCLIです。
/poteto-modeをカスタムモードにする手順は、以下のとおりです。
- Agents WindowかCLIの入力欄に「/」を入力する
- 候補の「poteto-mode」を選んだ状態にする(Enterキーはまだ押さない)
- Enterキーの代わりに、MacはOptionキーとEnterキー、WindowsはAltキーとEnterキーを押す
カスタムモードになると、チャットの入力欄にバッジが表示され、モードを抜けるまで毎回の依頼に/poteto-modeが効きます。ほかの画面やClaude Codeでは、作業ごとに依頼の頭へ/poteto-modeを付けてください。
別の作業に移るときは「new task」と書く
同じ会話で話題を変えるときは、依頼の頭に「new task」と書きます。「new task」がないと、/poteto-modeは新しい依頼を前の作業の続きとして扱いがちです。話題を変えるときの依頼は、次のように書きます。
/poteto-mode new task. figure out why the cache entry survives logout. don't change any code yet.
依頼文の意味は「新しい作業として、ログアウトしてもキャッシュが残る理由を調べ、まだコードは変えない」です。「don't change any code yet」を付けると、作業はコードを変えない調査の手順書に固定されます。
目的別に直接使えるpstackのスキル
手順書を通さずに1つのことだけ頼みたいときは、pstackのスキルの名前を直接入力して使えます。
目的別に直接使える主なスキルは、以下の表のとおりです。
| スキル | 使う場面 |
|---|---|
| /poteto-help | どのスキルを使えばよいか分からないとき |
| /how | コードの仕組みや処理の流れを知りたいとき |
| /why | なぜ今の作りになったのかを、変更の履歴などから知りたいとき |
| /bro | 直前の返事を、専門用語なしの普通の言葉で言い直してほしいとき |
| /ketchup | 作業したチャットで、前回の自分の発言から変わったことと判断が要る項目を知りたいとき |
| /interrogate | 複数のモデルに変更の弱点を探させ、動かして確かめられた指摘だけを残したいとき |
| /unslop | 文章からAIらしい書き癖を取りたいとき |
/poteto-helpは、使い方の質問には答えと次に送る依頼文の例を返すだけで、作業は始めません。
/broと/ketchupは、コードを読まずにAIの報告を確かめたいときに使えるスキルです。/ketchupは、マージ・承認・選択肢の選び方など判断が要る項目を、AIの推す案・根拠・リスクと一緒に並べます。
スキルの仕組みと、自分でスキルを作る方法は、以下の記事で解説しました。
Claude Codeのスキル(Skills)とは?使い方・作り方も徹底解説!
pstackを使う前に知っておきたい注意点
会社のプロジェクトでpstackを使う前に、費用の目安と、AIが確認なしに進める操作を知っておきましょう。pstackを使う前に知っておきたい注意点は、以下の4つです。
- サブエージェントと点検の分だけトークンを使う
- 元に戻せない操作の前に確認を求める
- Claude Codeでは省かれる手順がある
- 複数のAIを並行して動かすときは作業場所を分ける
サブエージェントと点検の分だけトークンを使う
pstackは、作業の一部をサブエージェントに任せたり、複数のモデルで点検したりします。サブエージェントと点検の分だけ、普通に頼むときより多くのトークンを使う仕組みです。トークンの使いすぎを抑える方法は、以下の4つです。
- /setup-pstackをやり直し、推論の予算を小さくするか安いモデルを選ぶ
- チャットをAutoか安いモデルで使っているときは、/setup-pstackで役のモデルをautoかinherit-parentにする
- /setup-pstackで、点検に使うモデルの一覧を短くする
- 小さく明らかな修正には/poteto-modeを使わない
Cursorのプランごとの料金と、費用を抑える方法は、以下の記事で解説しました。
Cursorの料金プランを解説!無料版との違いと選び方・費用の抑え方
元に戻せない操作の前に確認を求める
/poteto-modeは、元に戻せる作業と外部への操作を、人に確認せずに進める決まりで動きます。外部への操作には、チームのチャットへの投稿・チケットの更新・AIの性能を測る評価の開始が含まれ、つないであるMCPのツールも確認なしに使います。
反対に、/poteto-modeが止まって人の判断を待つ操作は、以下の4つです。
- 共有のブランチへの強制プッシュ(ほかの人の変更を上書きする操作)
- デプロイ(本番への反映)
- データの削除
- 顧客へのメッセージ
マージ(本流への取り込み)は4つに入っておらず、依頼に「merge」や「land」と書くと、AIはマージまで進めます。止まる操作の一覧はスキルに書かれた決まりで、ツールの権限で止める仕組みではありません。
依頼に英語で「going to bed」や「run until done」と書くと、AIは確認を求めずに作業を続けます。止まる場所を足したいときは、依頼に「let me review before proceeding」と書きましょう。
AIエージェントに仕事を任せるときのリスクと会社での対策は、以下の記事で詳しく解説しました。
AIエージェントのセキュリティを徹底解説!10のリスクと企業の対策も紹介
Claude Codeでは省かれる手順がある
pstackのスキルはCursorの機能の名前で書かれていて、Claude CodeではClaude Code用の対応表に沿って読み替えて動きます。クラウドで動かす作業は作業ツリー(worktree)に置き換わり、Automationsのように置き換えのきかない機能が要る手順だけが飛ばされる仕組みです。
AIが飛ばした手順は、返事に「Skipped in Claude Code」で始まる1行として残るため、何が行われなかったかが分かります。
複数のAIを並行して動かすときは作業場所を分ける
1台のパソコンで1つのリポジトリに複数のAIを動かすと、AIどうしが同じファイルや作業の結果を取り合います。並行して動かすときは、AIごとにCursorのクラウドのサブエージェントを使うか、作業ツリーで作業場所を分けましょう。
作業ツリーはディスクを使うため、ノートパソコンで同時に動かせるのは数個までです。Git worktreeの仕組みと使い方は、以下の記事で解説しました。
git worktreeとは?使い方とAIエージェントを並列で動かす方法
pstackの使い方に関するよくある質問
pstackを使い始めるときによくある質問をまとめました。
pstackは無料で使えますか?
pstackはMITライセンスで公開されていて、プラグインは無料で使えます。動かすAIのモデルの分は、CursorやClaude Codeの使用量になります。
エンジニアでなくてもpstackを使えますか?
コードを書かない方も、/broや/ketchupを使えば、AIの報告を読む場面でpstackを役立てられます。コードを使わない毎日の用事をAIエージェントに任せる方法は、以下の記事で解説しました。
Museの使い方|Meta Museの始め方・初期設定・料金を解説
pstackはCodexでも使えますか?
pstackのREADMEに書かれている入れ方は、CursorとClaude Codeの2つだけです(2026年11月10日時点)。pstackのスキルは共通の形式(Agent Skills)で書かれていてほかのツールでも読めますが、/poteto-modeなどはCursorのサブエージェントを使うため、一部が動かない場合があります。
pstackを外すにはどうすればよいですか?
Claude Codeでは、/pluginの「Installed」のタブでpstackを選ぶと、無効にする・外す操作を選べます。Cursorでは、サイドバーの「Customize」で入っているプラグインを管理します。
pstackを使わなくなったら、~/.cursor/rules/か~/.claude/rules/にあるpstack-modelsのファイルだけを消してください。
UNIX系のOSのpstackコマンドとは違うものですか?
CursorのプラグインのpstackとUNIX系のOSのpstackコマンドは、別のものです。
pstackコマンドは、動いているプログラムが今どの処理を呼び出している途中かの記録(スタックトレース)を表示します。Oracle Solarisでは「/usr/bin/pstack」として入っているコマンドで、使い方はOracle Solarisのマニュアルに載っています。
まとめ
pstackは、AIに問題を理解させて実物で確かめさせながら、コードの作業を進めさせるCursorの公式プラグインです。
pstackを使い始めるときに覚えておく手順は、以下の3つです。
- /setup-pstackでモデルと推論の予算を選び、新しいチャットを開く
- /poteto-modeに目標と完了の確かめ方を書いて頼む
- 話題を変えるときは「new task」と書く
最初は小さな修正を1つ頼み、やることリストと最後に示される証拠を見て、pstackの進め方を確かめましょう。
参考リンク
- Cursor Marketplace「pstack」
- GitHub「cursor/plugins/pstack」
- GitHub「The pstack guide」
- GitHub「Set up pstack」
- GitHub「Route work through /poteto-mode」
- GitHub「Run work while you sleep」
- GitHub「Recipes and pitfalls」
- GitHub「pstack in Claude Code」
- GitHub「setup-pstack」
- GitHub「poteto-mode」
- GitHub「poteto-help」
- Cursor Docs「Plugins」
- Cursor Docs「Agent Skills」
- Claude Code Docs「プラグインのインストールと管理」
- Oracle「pstack - man pages section 1: User Commands」



