poteto-help

Poteto ヘルプ

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

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

このファイルでは、質問と回答が記載されているスキルおよびガイドページを対応付けています。詳細はそれらのファイルを参照してください。案内先のファイルを読んでから内容を引用し、このマップと食い違う場合は、案内先の記述を優先してください。インストール済みスキルのルートから、同じ階層にあるスキルを読んでください。README とガイドページはインストール済みスキルには含まれていないため、セッションが pstack のチェックアウト内で実行されている場合はそこから読み、それ以外の場合は公開版を参照してください。ユーザーには、ファイルの公開版を案内してください。URL は https://github.com/mdsmithaustin/pstack/blob/main/ に続けて、skills/how/SKILL.md や docs/guide/01-setup.md のようなリポジトリ内のパスを指定します。スキルのファイルは skills/ の下にあるため、how/SKILL.md のようなスキルルートからの相対パスでは 404 になります。

必要なことを把握する

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

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

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

• ~/.agents/pstack-models.md とワークスペースの .agents/pstack-models.md の両方が存在しない場合、このユーザーは /setup-pstack を実行していません。そのため、すべてのロールでデフォルトのモデルが使われます。
• プロジェクトに verify-* スキルも、アプリを操作するためのその他のハーネスもない場合、エージェントにはアプリを操作するスクリプト化された方法がありません。変更が機能することの確認についての質問では、/create-verification-skill に触れてください。
• プロジェクトに正式検証スキルがない場合、テストで確認できる範囲を超えて検証されるプロパティはありません。競合状態、不変条件、その他テストで扱われることがまれなケースについての質問では、/create-formal-verification-skill に触れてください。正式検証スキルがあり、そのスキルが対象とするコードが、記録されている最後の同期時点のコミット以降に変更されている場合、そのコードに関する質問では /maintain-formal-verification-skill に触れてください。

モデル設定がなく、そのことが回答に関係する場合は、各ロールで使うモデルと推論予算を今決めるかどうか、ユーザーに尋ねてください。ユーザーが初めて使う場合、質問がセットアップやコストについての場合、または回答がどのモデルを実行するかによって変わる場合は、関係があります。チャットごとに質問は最大 1 回です。必要なことも不明な場合は、両方の質問をまとめて尋ねてください。選択肢を 2 つ提示します。

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

セットアップ

1. プロジェクトのルートから npx skills add mdsmithaustin/pstack を実行してインストールし、ユーザーが使うターゲットを選択します。-g を指定すると、プロジェクトごとではなくユーザーレベルでインストールします。
2. /setup-pstack を実行します。バンドルされているペルソナを確認し、推論予算を尋ね、各ロールにモデルを割り当てて、~/.agents/pstack-models.md に書き込みます。スキルは次回の実行時にこのファイルを読み込みます。Claude Code ではスキル一覧も設定するため、名前だけで読み込まれるスキルは説明を表示しなくなります。その後、プロジェクトにまだない場合は、検証スキルと形式検証スキルをそれぞれ一度ずつ生成するか確認します。
3. /poteto-mode、目標、合否を判定できるチェックを指定して、実際のタスクを開始します。

ユーザーの言葉から読み込まれるスキルは、「失敗した実行を修正する」の下に一覧表示されています。呼び出し時の動作と Claude Code のセットアップ要件については、README を参照してください。ガイドページ 1 ではセットアップについて詳しく説明しています。最初のプロンプトを一緒に考えることを提案してください。詳しくは references/prompting.md を参照してください。

コストが心配な場合は、トークンがどこで使われるかと、使用量を抑える方法を説明してください。pstack はサブエージェントとレビューパネルで追加のトークンを使用します。/setup-pstack を再実行して、予算を小さくするか、より安価なモデルを選択してください。ロールに auto または inherit-parent を設定すると、セッションのモデルで実行されます。セッションで安価なモデルを使う場合、トークンを節約できます。パネルのリストを短くすると、項目ごとに起動するサブエージェントが少なくなります。厳密さが必要な作業には /poteto-mode を使ってください。

pstack は Claude Code、Codex、Hermes、Grok Build で動作します。/poteto-mode、/how、/why、/poteto-teach など、ほとんどのワークフロースキルはロールごとのモデルを使ってサブエージェントを起動します。pstack-harness スキルは、起動方法、モデル、作業リスト、ループを各 CLI に対応付けます。Hermes には同梱されている Claude エイリアスの変換機能がないため、Hermes ではデフォルトのロールはセッションのモデルで実行され、デフォルトのマルチモデルパネルは同じモデルのパネルになります。モデル設定に記述した Hermes のモデル名は、そのまま実行されます。

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

/poteto-mode はタスクに合ったプレイブックを選び、プレイブックの冒頭の説明と手順を作業リストにコピーして、各手順で必要になる他のスキルを実行します。スキップした手順は skipped: <reason> としてリストに残ります。PR で終わるプレイブックは、ユーザーが「PR は不要」または「コミットしないで」と指示しない限り、別途依頼されなくてもコミット、プッシュ、PR の作成を行います。コミットには .env などの認証情報ファイルや、バージョン管理に含めるよう依頼されていないユーザー自身のメモやデータは含めません。タスクツールがオフの場合、作業リストはチャット内の番号付きリストになります。良いプロンプトには目標と、完了を判断する方法が記されています。スキルを列挙する必要はありません。手書きの手順では、プレイブックで維持されるはずの手順が抜けたり、順序が入れ替わったりしがちだからです。プロンプトを一緒に考える前に references/prompting.md を読んでください。ガイドページ 2 に例があります。

/poteto-mode は継続して有効になります。一度呼び出すと会話中は有効なままになり、プレイブックが適用できる場合やタスクに厳密さが必要な場合に適用され、それ以外では邪魔になりません。オプトアウトするには、ユーザーがそう伝えます。圧縮や切り詰めが発生した場合は、モードの復旧ルールを読んでください。チャットの途中で「新しいタスク」と言うと、モードは新たなプレイブックを選びます。/poteto-mode は、プレイブックの手順で起動するサブエージェントにすでに poteto-agent を使っています。自分で起動するサブエージェントにも同じスタイルを適用するには、pstack-harness スキルの「ロールを起動する」セクションの説明に従って poteto-agent ペルソナを起動してください。/setup-pstack でネイティブエージェントとして登録できます。

スキルを選ぶ

デフォルトの回答は/poteto-modeです。手順で必要になったときに、他のスキルのほとんどを実行します。プレイブックで定められた内容よりも、何かを多く、または少なくしてほしいとユーザーが望む場合は、スキルを直接指定してください。スキルを推奨する前に内容を読み、プロンプトの例を1つ提示してください。

ユーザーの目的	スキル
手間のかかるタスクを厳密に進める	/poteto-mode
作業を始める前に、エージェントが目標と問題を理解しているか確認する	/in-your-own-words
プロンプトを送る前に、内容を膨らませず、より深く書き直す。トップクラスの専門家なら何を追加するか、その人が使う素材や手法、第三者による確認を盛り込む。タスクは実行せず、プロンプトを返す	/sharpen
コードが現在どのように機能するか、または新しいコードをどこに配置すべきかを知る	/how
コードがこの形になっている理由や、数値の出所を知る	/why
変更やサブシステムについて、わかりやすい説明を得る	/poteto-teach
特定のトピックについて、自分の最近の作業を振り返る	/recall
前回のメッセージ以降、このチャットで何が変わったかを、わかりやすい言葉と簡単な図で把握し、保留中の項目をすべて挙げて、返信だけで判断できるようにする	/ketchup
/ketchup と同様に状況を把握する。ただし、保留中の判断事項を下部にテキストで示した、音声なしの短いスライド動画で受け取る	/ketchup-video
小さな差分が、その範囲外の何に影響するかを把握する	/blast-radius
関数境界を越えるコードを書く前に、型とモジュール構成を決める	/architect
1つの要件に対する複数の案を作り、その中から最善の案にまとめる	/arena
並列サブエージェントとして、範囲ごとのチェックを並行実行したり、作業者同士を競わせたりする	/swarm
異なるモデルに差分をレビューさせ、問題を見つけてもらう	/interrogate
手軽なローカルテストがある場合に、テストファーストでバグを修正する	/poteto-tdd
.ts または .tsx の作業に TypeScript のルールを適用する	/typescript-best-practices
コメントを書いていないレビュアーを使って、レビュー前にコメントを取り除く	/no-comments
プルリクエストの目的と変更内容を、図解とともに1つのコメントでレビュアーに伝える	/pr-recap
コミット前に、ブランチで変更したコードから余計な記述を取り除く	/deslop
文章から AI らしい癖を取り除く	/unslop
ドキュメント、RFC、README、PR の説明、コミットメッセージを一定の水準で書く	/technical-writing
変更の影響を受けるドキュメントを更新またはレビューする	/documentation-impact
直前の返信をわかりやすい言葉で聞き直す	/bro
エージェントがアプリを操作し、動作を証明できるよう、スクリプトで実行する方法を用意する	/create-verification-skill
検証スキルとその機能マップを、アプリの現状に合わせて更新する	/maintain-verification-skill
テストではほとんど到達できない競合状態、不変条件、その他の性質を形式検証する	/create-formal-verification-skill
対象コードの変更後に形式検証を現状に合わせ、失敗が仕様とのずれによるものかバグなのかを判断する	/maintain-formal-verification-skill
TLA+ モデルで検証した図として、ユーザーに見える内容を PM やデザイナーに示し、ルールに違反する各状態への最短経路も提示する	/statechart
何も測定していないのに成功してしまうことのない、テスト実行コマンド、CI ゲート、またはシェルアサーションを書く	/verify-commands
コードを書く前に、仕様のエッジケースと絶対に起きてはならないことを洗い出す	/spec-probes
稼働中の製品、機能、PR を調査し、未報告のバグを見つける	/runtime-probes
報告や対応の前に、パフォーマンスの数値を検証する	/benchmark-checklist
大規模な変更や広範囲に及ぶ変更、または時間を置いてからレビューする変更を進める	/figure-it-out
作業中に判断ログを記録し、終了後に振り返る	/show-me-your-work
役割ごとにモデルと推論の予算を選ぶ	/setup-pstack
自分の作業習慣を、個人用のモードスキルにする	/automate-me
完了したタスクから得た学びを、スキルの編集に反映する	/reflect
このリポジトリでエージェントが同じ間違いを繰り返さないようにする	/correct
Webhook 経由で Grok Bot を起動するボタン付きのページを作る	/make-bot-ui
pstack の使い方を調べる	/poteto-help
この隣にあるスキルディレクトリが表にない場合は、そのフロントマターを読み、説明に基づいて振り分けてください。principle-* ディレクトリは、以下の「原則」で扱います。

迷った場合：

• /how はコードの動作を説明します。/why はその理由を説明します。/poteto-teach はどちらか、または両方を実行し、結果を平易に説明します。
• /arena はすべてのワーカーに同じ概要を渡し、最良の部分を統合します。/swarm は作業を分割するか競争形式にし、レポートを1つ返します。
• /architect は設計を固めた直後に実装します。コードを書く前に設計をレビューするには、「チェックポイント付きで」と追加してください。
• /interrogate は差分をレビューします。/blast-radius は差分の範囲外で問題が起きないかを調べ、変更が安全だと示す決定的な事実を検証します。
• /deslop はコードを整理します。/unslop は文章を整理します。
• /recall は最近のチャットを通じてコンテキストを再構築します。/ketchup は、ユーザーの最後のメッセージ以降の、このチャットだけを扱います。特定のチャットやブランチを再開する場合は、Session pickup プレイブックを使います。
• /figure-it-out は、厳密な実行を1回分設計します。Orchestrate プレイブックは、数日間にわたり多数の PR にまたがるプログラムを実行します。Autonomous run プレイブックは、1つのタスクを完了条件まで進めます。

pstack に含まれないもの：

• control-cli と control-ui は Cursor プラグインに属します。pstack は、/create-verification-skill が作成する、プロジェクト独自の verify-<app> スキルを通じてアプリを操作します。
• /loop は CLI の起動を促す仕組みであり、pstack のスキルではありません。Claude Code には組み込みで用意されています。組み込みの仕組みがない CLI では、一定間隔で再度プロンプトを送るか、ウォッチャーのサブエージェントを実行してください。
• pstack に /orchestrate スキルはありません。Orchestrate は /poteto-mode のプレイブックです。スラッシュメニューに /orchestrate が表示される場合は、別のスキルセットが提供しています。

プレイブックと原則

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

• 「この PR を見守って」または「PR 123 を確認して」は Babysit を実行します。PR をマージ可能な状態まで進め、そこで停止します。ユーザーがマージ、取り込み、またはリリースを依頼しない限り、マージはしません。
• 「この PR をレビューして」は、他の人のプルリクエスト、ブランチ、または差分を対象に Code review を実行します。
• 「スタックを取り込んで」は Shipping を実行します。
• 「このブランチを引き継いで」は Session pickup を実行します。
• 「安全に一時停止して」は Pause safely を実行します。
• 「このキューを完全自動で進めて」は Autopilot-full を実行します。「スタックに積んで、リリースはしないで」は Autopilot-stack を実行します。
• 「評価プレイブックを実行して」は Eval を実行します。

/poteto-mode がない場合、「この PR を見守って」のようなフレーズを使うと、CLI または別のスキルセットにある、同名のスキルが起動することがあります。poteto-mode の「Playbooks」セクションには、すべてのプレイブックとその適用条件が記載されています。ガイドの6ページでは、PR の作成、見守り、取り込みについて説明しています。

pstack に計画用のスキルはありません。CLI 独自のプランモードは、pstack と併用できます。複数のフェーズや積み重ねた PR にまたがる作業では、/poteto-mode に計画を依頼すると、Multi-phase plan プレイブックが計画を作成しますが、実装はしません。設計に関する質問には、Prototype プレイブックまたは /architect を使うと、まずコードで設計を固めます。

原則は、/poteto-mode が読み込み、返信で引用する、1つのルールを定めたスキルです。ユーザーが直接呼び出すことはほとんどありません。代わりに、「動作を証明して。実際の出力を見せて」のように、名前を指定して方向づけます。/principle-<name> と入力すれば、必要に応じて今でも読み込めます。ガイドの8ページに一覧があります。

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

症状	修正方法
モードが適用されなくなった	README の継続に関するガイダンスを読んでください。
質問が前のタスクの次のステップとして扱われた	「新しいタスク」と伝えるか、そのターンではモードが不要だと伝えてください。
新しいモデルの選択が反映されなかった	ワークスペースの .agents/pstack-models.md はホームディレクトリのファイルより優先され、## codex のようなハーネス用セクションは単独の行より優先されます。Claude Code では、/setup-pstack によって pstack のエフォートエージェントが登録された後に限り、指定したエフォートが適用されます。
実行コストが予想より高かった	「セットアップ」のコストに関する段落を参照してください。
スキルが自動で読み込まれなかった	Codex では、また Claude Code では /setup-pstack がスキル一覧を設定した後に限り、ユーザーの発言から読み込まれるのは /setup-pstack、/how、/why、/unslop、/deslop、/pr-recap、/documentation-impact、/verify-commands、/spec-probes、/runtime-probes のみです。それ以外のスキルは、ユーザーが入力したとき、または /poteto-mode などの別の pstack スキルがエージェントに使用を指示したときに読み込まれます。/poteto-mode はすべてのスキルを実行するわけではありません。
並列エージェントが互いの変更を上書きした	各エージェントに専用のワークツリーを割り当ててください。
一晩の実行で作業は進んだものの、何も完了しなかった	/loop に必要なのは、実行時間ではなく、合格または不合格を判定できるチェックです。ガイド 7 ページを参照してください。
ビルドが成功しただけで返信が成功を主張している	実際のコマンド、フロー、保存された値、またはプロファイルを確認してください。これが「動作を証明する」という原則です。

実行が意図から逸れたときは、references/prompting.md に一行で軌道修正する方法があります。ガイド 10 ページには、その他の落とし穴と、コピーして使う価値のあるレシピがあります。

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

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

ガイド 9 ページでは、これらをそれぞれ説明しています。

返信

回答を最初に示してください。最大 1 つの例示プロンプトをコードブロックで提示し、適切なものがあれば references/recipes.md を参考にしてください。その後、そのファイルへのリンクを示してください。ユーザーが全体像を求めていない限り、簡潔にしてください。