Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

全体像と4つのレイヤー

pstack には 58 個のスキルと 22 本のプレイブックがあります。数だけ見ると圧倒されますが、構造は 4 つの層に整理されています。この層構造を先につかんでおけば、日常の利用で覚えることは驚くほど少なくて済みます。

4つのレイヤー

第1層は入口です。 人間が直接触れる入口は /poteto-mode ひとつだけです。タスクの開始時にこれを選び、あとは普通の言葉で依頼を書きます。基本的にはこの入口だけ覚えれば pstack は動きます。

第2層はプレイブックです。 プレイブックは /poteto-mode の内部にある手順書で、スラッシュコマンドではありません。依頼内容に合ったものが自動で選ばれ、その手順が TODO リストにそのままコピーされます。バグ修正なら「再現、原因特定、修正、実行して証拠を取る」といった順序が、タスクごとに毎回同じ品質で展開されるわけです。

第3層はスキルです。 スキルは個別の道具で、プレイブックの手順が必要に応じて呼び出します。たとえばコードベースの仕組みを調べる、複数のモデルに差分を攻撃させる、といった単位です。スキルは /how のように自分で直接呼ぶこともできますが、通常は入口に任せておけば足ります。

第4層は原則です。 原則は 1 ファイル 1 ルールの短いスキルで、全部で 24 個あります。/poteto-mode はタスク開始時に原則の索引を読み込み、判断に使った原則を返信の中で名指しします。逆に人間も、原則の名前を出すことでエージェントの進み方を軌道修正できます。原則はプロンプトの飾りではなく、運用中の共通言語として機能するのです。

裏方の構成要素

表の層のほかに、裏方も同梱されています。

  • サブエージェントは 2 種類。 poteto-agent は、実行中に委譲される作業の受け皿です。仕事を始める前に poteto-mode の全文と原則索引を読むため、委譲先でも流儀が揃います。もうひとつの Comment Sicko は読み取り専用のコメント審査役で、通常はコメント除去のスキル経由で呼ばれます。
  • benny は休眠状態の自動化パックです。 Slack の不具合報告を仕分けし、確認できたバグを実際の UI 証拠つきで再現・修正する仕組みで、Cursor の Automations 上で動きます。スラッシュスキルとしては登録されていないため、使うには別途セットアップが要ります。

内訳を表にするとこうなります。

種類数呼び方
入口スキル1/poteto-mode
その他のスキル33/how など。自動で呼ばれることも多い
原則スキル24名前で言及する。直接呼ぶことはまれ
プレイブック22/poteto-mode が自動で選ぶ
サブエージェント2poteto-agent、Comment Sicko
自動化パック1benny(Cursor 専用)

スキル 34 個と原則 24 個を合わせて、全 58 スキルという数になります。

計画用スキルが無い理由

目立つ欠落があります。pstack には「計画を立てる」専用スキルが意図的に用意されていません。作者の言葉は率直で、「計画は信じていない。最高の仕様書はコードだ」というものです。

机上の計画を磨くより、捨てる前提の試作品を作って実際に動かし、その観察から判断するほうが早く正解に近づける、という考え方が根底にあります。どうしても段階的な計画書が必要な場面には Multi-phase plan プレイブックがありますが、それも設計が固まってから書くことが前提です。

仕様駆動開発(SDD)との違い

この姿勢は、仕様駆動開発(SDD)と対比すると際立ちます。SDD は要件、設計、タスクの順に仕様を固めてから実装させる手法で、品質を「入口」で守ります。何を作るかを先に縛るわけです。

対して pstack が守るのは「出口」です。書いたあとで証拠を出させる。仕様書が正しいという保証はどこにもない以上、信頼を置くべきは実際のアプリケーションの振る舞いだ、という立場です。

  • 何を信じるか:SDD は仕様書、pstack は動くコード
  • どこで品質を守るか:SDD は入口(何を作るか)、pstack は出口(本当に動くか)
  • 計画の扱い:SDD は事前に固める、pstack は試作で確かめる

思想の出発点が違うため、pstack を使うなら SDD の流儀はいったん脇に置くのが近道です。設計のために仕様書を書くこと自体は否定されませんが、実装が済んだら仕様書は捨て、決定の理由だけを ADR に残す、という運用が勧められています。