hafuture

pstack 使い方ガイド:AIに速く、そして正しくコードを書かせるCursorプラグイン

CursorやClaude CodeでAIエージェントが高品質なコードを書けるようにするpstackプラグインの導入方法、/poteto-mode、23のプレイブック、全スキル一覧と24の原則を分かりやすく解説します。

CursorClaude CodeAIpstackDeveloper Tools

目次


pstackとは?

  • 作者 — poteto。Meta、Netflix、Cursorで数百万行のコードを扱い、現在はReactコアチームでReact Compilerを開発しているエンジニアです。
  • 作った理由 — 「AIがゴミ(slop)コードを大量に生成してしまう」という問題意識に共感しつつ、そのまま放置したくありませんでした。スピードだけを上げて品質を落とすことは本来の目的ではないからです。
  • 解決策 — 自身がCursorで毎日使っているスキルをそのまま公開したのが pstack です。目指すのは「より多くのコード」ではなくその逆 — より少なく、高品質なコードです。

インストール

利用中の環境タブを切り替えてコマンドをコピーしてください。

bash
/add-plugin pstack
この1行をCursorのチャット欄に入力するだけで導入完了です。

はじめ方(2ステップ)

  1. 1
    役割ごとのモデルと推論予算を設定/setup-pstack

    推論予算(reasoning budget)と役割ごとの使用モデルを選択します。デフォルトではコード実装・判断・レビューパネルごとにモデルが割り当てられます。

  2. 2
    最初のタスクを実行・迷ったらヘルプ/poteto-mode

    初めて使う場合、pstackガイドが実際のタスク1件を最初から最後まで(導入 → プロンプト → 検証 → 夜間実行)案内してくれます。迷ったら /poteto-help を入力してください。

デフォルトのモデル構成

コード作業(機能開発・リファクタリング・バグ修正・性能改善・ヒルクライム)、執筆、判断は Opus 5.5 が担当し、最も難易度の高い変更は Fable 5.2 が担当します。デフォルトのレビューパネルは Fable 5.2 / Opus 5.5 / Gemini 4 Carbon で、すべて /setup-pstack から変更できます。


中核:/poteto-mode

/poteto-mode は pstack のメインゲートウェイです。

使い方

  1. / メニューから /poteto-mode を選択し、続けて作業内容を入力します(メッセージにスキルが添付されます)。
  2. モードが作業に合ったプレイブックをマッチングし、手順入りのToDoリストを作成します。
  3. 進行しながら必要な別スキルへルーティングし、人間が読みやすく整理された回答を返します。
プロンプト例 1 — バグ再現から修正・検証まで
/poteto-mode このPRには何も操作しなくても750msごとにスクロールがずれる微妙なバグがある。
再現から始めて、修正して、検証までやって。
プロンプト例 2 — 夜間自律実行・スタックのマージ
/poteto-mode これから寝る。CIが不安定でもスタックをマージして。朝までに全部マージされてほしい。

23のプレイブック

「/poteto-mode は状況に応じて何を選ぶのか?」を知りたい場合は、以下のエクスプローラーでグループ選択やキーワード検索を試してみてください。

クイック選択&全23プレイブック一覧

プレイブック検索・選択ガイド23件
  • バグが見える / 不具合を直したい1位· 1. コード変更

    不具合を再現し、根本原因を特定し、ランタイム証拠をもとに修正します。症状が生きているのに再現しない場合は runtime forensics へ。

    第1候補:bug fix代替案:runtime forensics
  • 新機能を作りたい1位· 1. コード変更

    名前付きのデータ構造から出発して新しい振る舞いを作る・変更します。設計で迷う場合は先に prototype を実行します。

    第1候補:feature代替案:prototype
  • 動作は変えず構造だけ直したい1位· 1. コード変更

    外部の振る舞いを維持したまま、コードの構造・形だけを整えます。

    第1候補:refactoring
  • 遅い・カクつく2位· 1. コード変更

    計測された遅さを追跡し、ベースライン比で改善します。取得済みプロファイルがある場合は trace forensics が適しています。

    第1候補:perf代替案:trace forensics
  • 単一指標を目標値まで引き上げたい2位· 1. コード変更

    仮説 → 前後計測 → 承認ごとに1コミットを繰り返し、指標を科学的に改善します。

    第1候補:hillclimb
  • 設計の分岐を低コストで検証したい3位(条件付き)· 1. コード変更

    本実装の前に設計や挙動の判断を下すための使い捨てスケッチです。

    第1候補:prototype
  • 2つの実装のピクセル単位一致が必要3位(条件付き)· 1. コード変更

    デザイン検収や移行検証など、ピクセル単位のUI一致が求められるときのみ使用します。

    第1候補:visual parity
  • 再現しにくいが症状が起き続けている1位· 2. 原因診断

    メモリリーク、アイドル時CPU占有、グリッチなど、今起きている症状を計測で診断します。

    第1候補:runtime forensics
  • 取得済みのプロファイル成果物がある2位· 2. 原因診断

    cpuprofile、trace、spindump、ヒープスナップショットを詳細解析します。

    第1候補:trace forensics
  • 既存の実装を調査・理解したい唯一· 3. 理解・調査

    コードを変えずに「どう動く?」「なぜこう作った?」を調査します。「なぜ?」に特化するなら /why スキルが最適です。

    第1候補:investigation代替案:/why
  • PRがレビュー・CI・コンフリクトで止まっている1位· 4. PR・マージ運用

    コンフリクト、レビュー対応、CI修正、状態確認を行いマージ可能な状態へ導きます。スタック全体なら shipping を使用します。

    第1候補:babysit代替案:shipping
  • グリーンのPRスタックを安全に着地させたい1位· 4. PR・マージ運用

    グリーンのスタックを独立検証し、検証済みの連続区間を下から順にGitHub(origin)へ着地させます。

    第1候補:shipping
  • 独立したPR群をマージまで自動処理したい2位(大量向け)· 4. PR・マージ運用

    PRごとにオーナー1名を割り当て、検証スワームがヘッドごとに検証してマージまで自動実行します。

    第1候補:autopilot-full
  • 検証済みPRスタックを積み、マージは自分で行いたい2位(大量向け)· 4. PR・マージ運用

    autopilot-full からマージを除いたもの。依存関係通りにPRスタックを積み、検証まで完了させます。

    第1候補:autopilot-stack
  • 作業後に整理されたPRを作成したい自動呼び出し· 4. PR・マージ運用

    小さな順序付きコミット+Conventional Commitsタイトル+簡潔な本文でPRを作成します。

    第1候補:opening a PR
  • 席を外している間に1つの作業を完遂したい1位· 5. 長期・自律実行

    止まらずに1つの長いタスクを完遂します。複数日・複数PR規模なら orchestrate を選んでください。

    第1候補:autonomous run代替案:orchestrate
  • 複数日・複数スタックPRを要する常設プロジェクト2位(大規模)· 5. 長期・自律実行

    サブエージェント部隊を伴う大規模プロジェクトを1つのコーディネーターチャットで統括します。

    第1候補:orchestrate
  • 複数フェーズにまたがる作業構造を先に組みたい3位(設計段階)· 5. 長期・自律実行

    複数フェーズやスタックPRにまたがる作業の構造と順序を組むための事前設計プレイブックです。

    第1候補:multi-phase plan
  • 昨日の作業の続きから再開したい1位· 6. 作業ライフサイクル

    以前のエージェントが進めていた作業を引き継いで再開します。先にクリーンに止めたい場合は pause safely を使います。

    第1候補:session pickup代替案:pause safely
  • 後で再開できるよう作業をクリーンに中断したい2位· 6. 作業ライフサイクル

    進行中の作業状態を整理し、後から再開しやすい形で安全に中断します(session pickup とペア)。

    第1候補:pause safely
  • 古いworktreeを整理してディスク容量を回収したい3位(ときどき)· 6. 作業ライフサイクル

    マージ済み・破棄済みのworktreeや古いiOSシミュレータを安全に削除して容量を回収します。

    第1候補:worktree cleanup
  • SKILL.md を新規作成・修正したい1位· 7. メタ作業

    スキル定義ファイル SKILL.md を作成または改善するときに使用します。

    第1候補:authoring a skill
  • スキル・プロンプト変更の効果をテストしたい2位· 7. メタ作業

    スキルやプロンプト変更がエージェントの振る舞いに与える影響をブラインドテストします。

    第1候補:eval

迷いやすい3モード比較:autonomous run / autopilot-full / orchestrate

  • 一言で言うと:1つの目標を最後まで押し切るなら autonomous run、確定済みの独立PRキューなら autopilot-full、設計から必要な常設プログラムなら orchestrate。
3つの質問で選ぶ — 該当する質問をクリックしてください
autonomous run

完了条件を定義し止まらずに推進

“You own the exit condition”

作業単位
目標1つ+検証可能な完了条件1つ
実行主体
エージェント自身が反復して直接修正
PR構造
完了条件に含まれるのみで制約なし
検証方法
毎回完了条件と照合、停滞時は巻き戻し
規模・期間
セッション内で /loop による数時間単位
autopilot-full

判定はコーディネーター、PRは各オーナーが担当

“You own the verdicts, never the PRs”

作業単位
事前に用意された独立PRキュー
実行主体
PRごとにオーナー1名+コードを書いていない検証スワーム
PR構造
trunk に対して並列(スタック禁止)
検証方法
フルスワーム1回+実画面ライブ検証
規模・期間
キューの規模分(数時間〜1日程度)
orchestrate

コードは書かずプログラム全体の進行を統括

“You run the program, never the code”

作業単位
複数領域・複数スタックPR(分解・順序・依存設計を含む)
実行主体
コーディネーター → サブコーディネーター → ワーカー(最大3階層)
PR構造
スタックPR・依存関係管理を含む
検証方法
実装者と別モデル系統の検証者による承認・diff直接確認
規模・期間
数日以上、数十〜数百のサブエージェント

全スキル一覧

各スキルチップをクリックすると、スラッシュコマンドを即座にコピーできます。

コマンドをクリックするとクリップボードにコピーされます

ヘルプ&スタート

理解する

設計&並列作業

検証&レビュー

検証スキルの作成

執筆&保守

その他


サブエージェント

サブエージェント説明
subagent_type: "poteto-agent"poteto-mode が内部で使う基本ラッパーです。通常の generalPurpose に置き換えるとルール読み込みがスキップされ、品質が低下する恐れがあります。
subagent_type: "comment-sicko"読み取り専用のコメントレビュアーです。通常は直接呼ばず /no-comments 経由で利用します。

24の原則

/poteto-mode はタスクの性質に合わせて以下の24原則を適用します。グループ切り替えやキーワード検索で確認できます。

laziness-protocolコア

最小限の変更と削除を優先する。

foundational-thinkingコア

ロジック前に型とデータ構造を設計する。

redesign-from-first-principlesコア

初日から前提だったかのように再設計する(つぎはぎ禁止)。

attack-the-premiseコア

同じ前提で2回以上失敗したら前提自体を検証する。

subtract-before-you-addコア

死んだコードや重複検証を先に削減してから積み上げる。

minimize-reader-loadコア

読み手の認知負荷と隠れた状態を減らす。

outcome-oriented-executionコア

計画された書き換え・移行では目標アーキテクチャへ収束させる。

experience-firstコア

実装の楽さよりユーザー体験を優先する。

exhaust-the-design-spaceコア

決定前に2〜3個の競合プロトタイプを比較する。

build-the-leverコア

手作業を繰り返さず再利用可能なツールやスクリプトを作る。

model-the-domainアーキテクチャ

散在する条件分岐ではなくドメイン構造で表現する。

boundary-disciplineアーキテクチャ

検証ガードは境界に集め、内部型を信頼して純粋関数で書く。

type-system-disciplineアーキテクチャ

不可能な状態を型で表現不能にし、外部データは境界でパースする。

make-operations-idempotentアーキテクチャ

部分実行の履歴に関わらず同一の最終状態へ収束させる。

migrate-callers-then-delete-legacy-apisアーキテクチャ

呼び出し元を移行したら同じ波で旧APIを削除する。

separate-before-serializing-shared-stateアーキテクチャ

共有をまず排除し、単一書き込み主体が真の不変条件のときだけ直列化する。

prove-it-works検証

コンパイル成功ではなく実際の出力で証明する。

fix-root-causes検証

最初に壊れた箇所まで遡って根本から修正する。

sequence-verifiable-units検証

個別に検証可能な小単位に分け、順番に検証しながら積み上げる。

test-behavior-not-implementation検証

実装詳細ではなくユーザーが観察可能な振る舞いをテストする。

explain-the-number検証

計測値を報告する前にボトルネックと誤計測の可能性を排除する。

guard-the-context-window委譲&メタ

大量作業はサブエージェントへ委譲し要約のみ残す。

never-block-on-the-human委譲&メタ

不可逆な操作以外は止まらず進めて後から軌道修正する。

encode-lessons-in-structure委譲&メタ

教訓は文章ではなくlint・チェック・スクリプトに刻む。


自分用にカスタマイズする

  • モデルの変更 (/setup-pstack):利用可能なモデルを検出し、コード・判断・レビューパネルごとのマッピングルールを保存します。
  • 自分専用モード (/automate-me):/poteto-mode が作者のスタイルであるのに対し、/automate-me は直近のトランスクリプトを分析し、あなた自身の働き方に合わせた <your-name>-mode スキルのドラフトを生成します。

よくある質問

Q1. pstack に含まれていない機能はありますか?
/deslop、/autopilot、control-cli・control-ui は cursor-team-kit に含まれています。/create-skill やPR監視の /babysit はCursor標準機能内でPR状態確認を行うと babysit プレイブックへ案内されます。
Q2. なぜ計画(planning)専用スキルがないのですか?
/poteto-mode が必要に応じて計画フェーズを含みますが、過度な事前計画よりも素早い検証と実装を重視しています。しっかり計画を立てたい場合はCursorの標準 Plan Mode と併用するのが相性抜群です。
Q3. 自動化(automations)にも対応していますか?
対象リポジトリの .cursor/automations/benny/ にパックを配置することで、Cursor automations 上でUI証拠をもとにバグを再現・修正する運用が可能です(Cursor専用、詳細は FOR_AGENTS.md を参照)。
Q4. 改変や拡張は自由ですか?
はい、MITライセンスです。フォーク・改善・PRを歓迎します。Claude Code向けの構成を編集した場合は、node scripts/generate-pstack-harness-trees.mjs を実行して生成物をコミットしないとCIが失敗します。
Q5. まず何を使えばよいか分かりません。
どの機能を使うべきか迷ったら /poteto-help、プロンプト自体を磨きたいときは /sharpen を使ってみてください。

Hafuture JSONフォーマッターで設定ファイルを検証

CursorやClaude Codeの設定JSONやプロンプト構造を、ブラウザ上でサーバー送信なしに整形・検証できます。

JSONフォーマッターを開く