poteto-help

Poteto のヘルプ

pstack についてユーザーの質問に答え、送信できるプロンプトを提示し、回答の根拠となったファイルへのリンクを付けます。ヘルプの質問では、作業を開始しないでください。ユーザーが尋ねているのは方法であり、pstack の実行には実際にトークンを消費するため、プロンプトはユーザー自身に送信してもらいます。

「pstack を使ってこのバグを修正して」のように作業を依頼するメッセージは、ヘルプの質問ではありません。poteto-mode を読み、その指示に従って作業してください。

このファイルでは、質問に答える責任を持つインストール済みのスキル、プレイブック、プラットフォームのマッピングを示します。回答する前に、該当する参照元を読んでください。その指示はこのマップおよび Cursor について記述されており、この移植版とは異なる場合がある上流ガイドより優先されます。ローカルのリンクはインストール済みプラグイン内を指しているため、ユーザーにはファイルの公開版を案内してください。公開版の URL は https://github.com/michael-denyer/pstack-claude/blob/main/plugins/pstack/ に、プラグインのルートからの相対パスを続けたものです。

必要なことを確認する

メッセージと会話から必要なことを推測してください。「PR のレビューに使うスキルはどれ？」のように状況が明示されている場合は、該当するセクションに進んでください。必要なことがまだ不明な場合は、次の選択肢を示して複数選択式の質問を 1 つ行い、ユーザーが選んだセクションだけに答えてください。

• セットアップする
• /poteto-mode でタスクを開始する
• 状況に応じてスキルを選ぶ
• 失敗した実行を修正する
• pstack をカスタマイズする

回答に影響する状態を確認し、該当する場合にのみ説明してください。

• モデルやルーティングに関する質問では、ランタイムとインストールの種類を特定し、setup-pstack を読んで、設定シートの場所と、そのランタイムがシートを読み込む方法を確認してください。デフォルト設定が適用されるか、上書き設定が適用されるかを伝える前に、その設定を確認してください。
• プロジェクトに verify または verify-* スキルも、その他のアプリのハーネスもない場合、エージェントにはアプリを操作するスクリプト化された方法がありません。変更が機能することの証明に関する質問では、/create-verification-skill に触れてください。
• プロジェクトに正式検証スキルがない場合、テストで到達できる範囲を超えて検証されるプロパティはありません。競合状態、不変条件、その他テストでめったに確認されないケースに関する質問では、/create-formal-verification-skill に触れてください。正式検証スキルが存在し、そのスキルが対象とするコードが、記録されている最後の同期コミット以降に変更されている場合は、そのコードに関する質問で /maintain-formal-verification-skill に触れてください。

モデルシートがなく、それが回答に影響する場合は、各ロールのモデルとデフォルトのエフォートを今選ぶかどうか、ユーザーに尋ねてください。ユーザーが初めての場合、セットアップやコストに関する質問の場合、または実行するモデルによって回答が変わる場合は、これが影響します。チャットごとに一度だけ尋ねてください。必要なことも不明な場合は、両方の質問をまとめて尋ねてください。次の 2 つの選択肢を提示してください。

• 今：入力する /setup-pstack を案内し、質問にも回答します。
• 後で：質問に回答し、すべてのロールは /setup-pstack を実行するまでデフォルトのモデルを使い続けることを 1 行で付け加えます。

セットアップ

1. ユーザーのランタイムと、ネイティブプラグイン／パッケージのインストールを希望しているか、スキルのみのインストールを希望しているかを確認します。README または共通インストールリファレンスの該当セクションを読み、対応するインストールコマンドを提示します。
2. モデルの選択、作業量、シートの読み込み、自動ルーティングについて説明する前に、Other runtimes の表も含めて/setup-pstackを読みます。組み込みのルーティングフックまたは拡張機能を使う場合は、現在のランタイムのシートにある永続設定session hook: offでルーティングをオフにします。モデルシートの後、プロジェクトに検証スキルまたは形式検証スキルがまだない場合は、それぞれ一度ずつ生成するかどうかを尋ねます。
3. references/prompting.mdに従って、目標と合否を判定できるチェックを含む最初のタスクプロンプトを提案します。スラッシュコマンドリファレンスに記載された現在のランタイムの呼び出し構文を使います。

ランタイム固有の手順を案内する場合やレシピを調整する場合は、該当する場合、先にCodex マッピングまたはPi マッピングを読みます。各マッピングのルーティングに関するセクションでは、フックの信頼設定、拡張機能の読み込み、スキルのみのインストールについて説明しています。その他のランタイムについては、ランタイムサポートリファレンスを使います。

費用が気になる場合は、トークンの使用先と節約方法を伝えます。pstack はサブエージェントとレビューパネルで追加のトークンを使用します。/setup-pstackを再実行し、作業量を減らすか、より安価なモデルを選びます。autoまたはinherit-parentに設定されたロールはチャットのモデルで実行されるため、チャットで安価なモデルを使えば費用を抑えられます。パネルの項目数を減らすと、項目ごとに起動するサブエージェントの数も減ります。厳密さが必要な作業には/poteto-modeを使います。

/poteto-modeでタスクを開始する

/poteto-modeはタスクに合ったプレイブックを選び、その手順をToDoリストにコピーして、必要な手順に応じてほかのスキルを実行します。スキップした手順は、skip: <reason>としてリストに残ります。よいプロンプトには、目標と完了の判定方法が記されています。スキルを列挙する必要はありません。手書きの手順では、プレイブックに含まれる手順が抜けたり、順序が入れ替わったりしがちなためです。プロンプトの作成を手伝う前に、references/prompting.mdを読みます。

後続のタスクが自動でルーティングされるかどうかを確認するには、セットアップに記載されたセットアップ情報とランタイムの情報を参照します。このインストールでルーティングが有効になっていることを確認してから、自動ルーティングについて案内します。自動ルーティングが無効な場合は、新しいタスクごとにpoteto-modeを呼び出します。チャットの途中で「new task」と指示すると、モードが新しいプレイブックを選びます。サブエージェントのデフォルト設定については、poteto-modeのSubagentsセクションと現在のランタイムのマッピングを読みます。

スキルを選ぶ

デフォルトでは/poteto-modeを案内します。各手順で必要に応じて、ほかのスキルの大半も実行するためです。ユーザーがプレイブックの内容より多く、または少なく何かを求めている場合は、スキルを直接指定します。推奨する前にスキルを読み、プロンプトの例を1つ提示します。

ユーザーの目的	スキル
重要な作業を厳密に進める	/poteto-mode
作業を始める前に、エージェントが目標と課題を理解しているか確認する	/in-your-own-words
プロンプトを送信する前に、長くするのではなく内容を深めて書き直す。トップクラスの専門家が加えること、その素材や手法、第三者による確認を盛り込む。プロンプトを返し、作業自体は行わない	/sharpen
コードの現在の動作や、新しいコードを置くべき場所を把握する	/how
コードがこの形になっている理由や、数値の出どころを把握する	/why
変更やサブシステムについて、平易な言葉で理解する	/teach
特定のトピックについて、最近の自分の作業を振り返る	/recall
このチャットで前回のメッセージ以降に変わったことを、平易な言葉と簡単な図で把握する。自分の対応待ちになっている項目をすべて一覧にし、返信だけで判断できるようにする	/ketchup
/ketchup のように状況を把握する。対応待ちの依頼をテキストで添えた、短いスライド動画で確認する	/ketchup-video
小さな差分が、それ以外の箇所に及ぼす影響を把握する	/blast-radius
関数の境界を越えるコードを書く前に、型とモジュールの構成を決める	/architect
1つの概要に対して複数の案を試し、最良の案にまとめる	/arena
範囲ごとに並行してチェックしたり、ワーカーを競わせたりする	/swarm
複数のモデルに差分をレビューさせ、問題点を探させる	/interrogate
手軽なローカルテストがある場合に、テストファーストでバグを修正する	/tdd
.ts または .tsx の作業に TypeScript のルールを適用する	/typescript-best-practices
コメントを書いていないレビュアーを使い、レビュー前にコメントを削除する	/no-comments
文章から AI らしい不自然さを取り除く	/unslop
基準に沿ったドキュメント、RFC、README、PR の説明、コミットメッセージを書く	/technical-writing
直前の返信を平易な言葉でもう一度聞く	/bro
エージェントがアプリを操作し、動作を証明するためのスクリプト形式の方法を用意する	/create-verification-skill
検証スキルとその機能マップをアプリの最新状態に合わせる	/maintain-verification-skill
テストではめったに確認できない競合、不変条件、その他の性質を形式検証する	/create-formal-verification-skill
対象コードの変更後に形式検証を最新状態に合わせ、失敗がドリフトによるものかバグによるものかを見極める	/maintain-formal-verification-skill
モデルで検証したユーザー向けの表示をチャートとして PM やデザイナーに示し、各バグを番号付きの経路で描画する。合意済みのチャートを TLA+ の骨組みに変換する。または、TLA+ 仕様に照らしてコードを監査する	/statechart
パフォーマンスの数値を報告したり、その数値に基づいて対応したりする前に妥当性を確認する	/benchmark-checklist
大規模な変更や複数領域にまたがる変更、あるいは作業を中断した後にレビューする変更に取り組む	/figure-it-out
作業中に判断ログを残し、終了後に見直す	/show-me-your-work
役割ごとにモデルとデフォルトの思考量を選ぶ	/setup-pstack
自分の作業習慣を、個人用のモードスキルにする	/automate-me
完了した作業から得た学びを、スキルの編集に反映する	/reflect
エージェントがこのリポジトリで同じ間違いを繰り返さないようにする	/correct
pstack の使い方を調べる	/poteto-help
このディレクトリの隣にあるスキルディレクトリが表にない場合は、そのフロントマターを読んで説明に基づいて振り分けてください。principle-* ディレクトリは、以下の Principles に記載されています。

判断に迷いやすいケース：

• /how はコードの動作を説明します。/why はその理由を説明します。/teach はどちらか、または両方を実行し、その結果をわかりやすく説明します。
• /arena はすべてのワーカーに同じ概要を渡し、最良の部分をまとめます。/swarm は作業を分割するか競争させ、レポートを1つ返します。
• /architect は設計を決めた直後に実装します。コードを書く前に設計をレビューするには、「with checkpoint」を追加します。
• /interrogate は差分をレビューします。/blast-radius は差分の外側にある破損の可能性を探し、変更が安全であることを示す決め手となる事実を証明します。
• /recall は最近のチャットをまたいでコンテキストを再構築します。/ketchup は、このチャットでユーザーが最後にメッセージを送ってからの内容だけを扱います。特定のチャットやブランチを再開するには、Session pickup プレイブックを使います。
• /figure-it-out は、厳密な実行を1回分設計します。Orchestrate プレイブックは、数日間にわたり多数の PR にまたがるプログラムを実行します。Autonomous run プレイブックは、1つのタスクを完了条件まで進めます。

pstack にないもの：

• Cursor ドライバーのスキルには移植版がありません。ドライバーポリシーについては、poteto-mode の Non-negotiables に Claude Code での同等の機能、run スキル、プロジェクトの verify スキルが記載されています。
• /loop は Claude Code にバンドルされているスキルで、plugin-dev:skill-development スキルは Claude Code のスキル作成ガイダンスです。
• pstack に orchestrate スキルはありません。Orchestrate は /poteto-mode のプレイブックです。スラッシュメニューに orchestrate コマンドが表示される場合は、別のプラグインが提供しています。

プレイブックと原則

プレイブックは /poteto-mode 内の手順リストであり、スキルではないため、スラッシュコマンドはありません。/poteto-mode では、タスクを説明すると適切なプレイブックが選ばれ、次のフレーズでプレイブックを直接指定できます。

• 「babysit this pr」または「check on pr 123」と言うと、Babysit が実行されます。PR をマージ可能な状態まで進め、そこで停止します。ユーザーがマージ、ランディング、またはリリースを依頼しない限り、マージはしません。
• 「land the stack」と言うと、Shipping が実行されます。
• 「take over this branch」と言うと、Session pickup が実行されます。
• 「pause safely」と言うと、Pause safely が実行されます。
• 「full autopilot on this queue」と言うと、Autopilot-full が実行されます。「stack them, don't ship」と言うと、Autopilot-stack が実行されます。何が無人で実行されるかを説明する前に、選択したプレイブックのマージルールを確認してください。
• 「run the eval playbook」と言うと、Eval が実行されます。

/poteto-mode を使わない場合、「babysit this pr」のようなフレーズで、pstack の単独の /babysit スキルが実行されることがあります。Playbooks セクションには、すべてのプレイブックと適用条件が記載されています。この移植版の PR ワークフローについては、Babysit または Shipping をお読みください。

pstack に計画スキルはありません。Claude Code の plan モードは、pstack と併用できます。フェーズをまたぐ作業や積み重ねた PR に対して /poteto-mode に計画を依頼すると、Multi-phase plan playbook が実行されます。このプレイブックは計画を作成し、実装は行いません。設計に関する質問には、Prototype プレイブックまたは /architect を使うと、まずコードで設計を決められます。

Principles は、/poteto-mode が読み込み、返信で引用する、1つのルールを定めたスキルです。ユーザーが直接呼び出すことはほとんどありません。代わりに、「apply prove it works. show me the real output.」のように、名前を使って指示します。Claude Code では principle-* の各リーフはスラッシュメニューに表示されず、/poteto-mode がパスを指定して読み込みます。他のランタイムでは、スキルピッカーに表示されることがあります。Principles indexに一覧が記載されています。

うまくいかなかった実行を修正する

症状	修正方法
数ターン後にモードが適用されなくなった	「セットアップ」の各ソースを参照して、現在のランタイムのルーティング設定を確認します。自動ルーティングがない場合は、タスクごとに poteto-mode を呼び出します。
質問が前のタスクの続きとして扱われた	「新しいタスク」と伝えるか、このターンではモードを使わないと伝えます。
新しいモデルの選択が反映されなかった	setup-pstack と現在のランタイムのマッピングを読み、シート内の場所と読み込み方法を確認します。
実行コストが予想より高かった	「セットアップ」のコストに関する段落を確認します。
スキルが自動で読み込まれなかった	スキルの説明と現在のランタイムのスキル読み込み手順を確認します。必要に応じて明示的に呼び出してください。/poteto-mode がすべてのスキルを実行するわけではありません。
並列エージェントが互いの変更を上書きした	各エージェントに専用の worktree を割り当てます。
夜間の実行で進展はあったものの、何も完了しなかった	自律実行 と現在のランタイムの起動メカニズムを確認します。キューを使う場合は、上記の選択した Autopilot プレイブックを確認します。合否を判定できるチェックを実行に設定します。
ビルドが成功しただけで、応答が成功を主張している	実際のコマンド、フロー、保存された値、またはプロファイルを求めます。これが「動作を実証する」という原則です。

実行が軌道から外れた場合は、references/prompting.md に一行で指示を修正する方法があり、references/recipes.md には応用できるプロンプトがあります。

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

• /automate-me は、ユーザー自身の履歴から個人用のモードスキルを作成し、/poteto-mode と併用できるようにします。
• セッション後に /reflect を使うと、学んだことをユーザーが承認するスキルの編集内容に変換します。
• /poteto-mode write a skill for <workflow> は、スキル作成プレイブックを実行します。評価プレイブックでは、スキルの変更をブラインドテストします。
• 問題のあるスキルは、そのスキル専用の PR で修正し、問題が起きた機能の作業に含めないでください。

応答

最初に答えを提示します。該当する場合は、references/recipes.md を応用したプロンプトの例を、コードブロックで最大 1 つ示してから、そのファイルへのリンクを記載します。ユーザーが全体像を求めていない限り、簡潔にまとめます。