全体像と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 が自動で選ぶ |
| サブエージェント | 2 | poteto-agent、Comment Sicko |
| 自動化パック | 1 | benny(Cursor 専用) |
スキル 34 個と原則 24 個を合わせて、全 58 スキルという数になります。
計画用スキルが無い理由
目立つ欠落があります。pstack には「計画を立てる」専用スキルが意図的に用意されていません。作者の言葉は率直で、「計画は信じていない。最高の仕様書はコードだ」というものです。
机上の計画を磨くより、捨てる前提の試作品を作って実際に動かし、その観察から判断するほうが早く正解に近づける、という考え方が根底にあります。どうしても段階的な計画書が必要な場面には Multi-phase plan プレイブックがありますが、それも設計が固まってから書くことが前提です。
仕様駆動開発(SDD)との違い
この姿勢は、仕様駆動開発(SDD)と対比すると際立ちます。SDD は要件、設計、タスクの順に仕様を固めてから実装させる手法で、品質を「入口」で守ります。何を作るかを先に縛るわけです。
対して pstack が守るのは「出口」です。書いたあとで証拠を出させる。仕様書が正しいという保証はどこにもない以上、信頼を置くべきは実際のアプリケーションの振る舞いだ、という立場です。
- 何を信じるか:SDD は仕様書、pstack は動くコード
- どこで品質を守るか:SDD は入口(何を作るか)、pstack は出口(本当に動くか)
- 計画の扱い:SDD は事前に固める、pstack は試作で確かめる
思想の出発点が違うため、pstack を使うなら SDD の流儀はいったん脇に置くのが近道です。設計のために仕様書を書くこと自体は否定されませんが、実装が済んだら仕様書は捨て、決定の理由だけを ADR に残す、という運用が勧められています。