poteto-help

Poteto のヘルプ

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

「pstack を使ってこのバグを修正して」のように作業を依頼するメッセージは、ヘルプの質問ではありません。poteto-mode を読み、その指示に従って作業してください。また、各タスクの開始時に /poteto-mode を実行するとモードを維持できることを一度伝えてください。

このファイルでは、質問と回答の根拠となるスキルやガイドページを対応付けています。詳細はそれらのファイルに記載されています。案内するファイルを読んでから引用し、この対応表と食い違う場合は、案内先の記載を優先してください。ここにあるスキルへのリンクはインストール済みプラグイン内を指しているため、ユーザーが開けない可能性があります。その場合は、ファイルの公開版として https://github.com/ericlitman/open-pstack/blob/main/plugins/pstack/ に続けてそのパスを指定してください。ガイドページは Lauren の上流ガイドです。Cursor のインターフェースが使われているため、Cursor の操作手順を伝える前に、このファイルに沿って置き換えてください。

必要なことを特定する

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

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

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

• アクティブなハーネスの設定ホームに pstack-models.md がない場合、このユーザーは /setup-pstack を実行していないため、すべてのロールでデフォルトのモデルが使われます。設定ホームは codex-tools.md に従って特定してください。
• プロジェクトに verify-* スキルやその他のアプリハーネスがない場合、エージェントがアプリを操作するためのスクリプト化された方法はありません。変更の動作確認についての質問なら、/create-verification-skill を案内してください。

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

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

セットアップ

1. インストールします。Claude Code では、/plugin marketplace add ericlitman/open-pstack、続けて /plugin install pstack@open-pstack、最後に /reload-plugins を実行します。Codex では、codex plugin marketplace add ericlitman/open-pstack --ref main、続けて codex plugin add pstack@open-pstack を実行し、codex-tools.md に従って multi_agent を有効にします。
2. /setup-pstack を実行します。各ロールにモデルを割り当て、割り当てるモデルファミリーごとに希望する努力レベルを尋ね、それらのモデルをテストして、モデルシートを作成します。このシートは新しいセッションに適用されます。
3. /poteto-mode、目標、そして合否を判定できるチェックを指定して、実際のタスクを始めます。

Claude Code では、入力するスキル名に /pstack:poteto-mode のようなプラグインのプレフィックスが付きます。Codex では、「use pstack:poteto-mode」のように、スキル名を指定して依頼します。詳細はREADME とガイド 1 ページ目をご覧ください。references/prompting.md に従って、最初のプロンプトを一緒に作成することを提案してください。

コストが心配な場合は、トークンがどこで使われるのか、どうすれば使用量を減らせるのかを説明してください。pstack はサブエージェントとレビューパネルに追加のトークンを使います。/setup-pstack を再実行し、より低い努力レベルか、より安価なモデルを選んでください。ロールを auto または inherit-parent に設定すると、セッションのモデルで実行されます。セッションで安価なモデルを使えば、トークンを節約できます。パネルの数を減らすと、リストの各項目につき 1 つずつ、実行されるサブエージェントの数も減ります。厳密さが必要な作業には /poteto-mode を使います。

Open Pstack は、Claude Code と Codex で共通のスキルツリーを 1 つ使います。/poteto-mode、/how、/why、/teach などのワークフロースキルは、ロールごとにモデルを指定してサブエージェントを起動します。使用中のアプリのモデルはそのアプリ内で実行され、その他のモデルはサインイン済みのコマンドラインツールを通じて実行されます。Codex には loop スキルも poteto-agent タイプもありません。codex-tools.md では、Claude Code の各ツールに対応する Codex の形式を説明しています。

/poteto-mode でタスクを始める

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

/poteto-mode を継続して使うかどうかは、ハーネスによって異なります。

• Claude Code では、短い起動時の指示によって、単純でない作業は /poteto-mode に振り分けられます。/pstack:poteto-mode と入力すると、そのタスクにスキルが適用され、セッションが進むにつれて適用が薄れていくことがあります。
• Codex では、各タスクの開始時に pstack:poteto-mode を名前で指定します。
• どちらの場合も、必要に応じて、新しいタスクの開始時に /poteto-mode を使います。

セッションの途中で「新しいタスク」と指示すると、モードは新しいプレイブックに合わせます。Claude Code では、/poteto-mode はプレイブックの手順が起動するサブエージェントに、すでに poteto-agent を使っています。自分で起動するサブエージェントにも同じスタイルを適用するには、subagent_type: "poteto-agent" を指定して起動します。Codex には poteto-agent タイプがないため、最初に poteto-mode スキル全体を読むよう指示した spawn_agent を割り当ててください。

スキルを選ぶ

通常は /poteto-mode を使います。手順で必要になれば、ほかのスキルの多くも実行されます。ユーザーがプレイブックの内容よりも多く、または少なく何かを求めている場合は、スキルを直接指定してください。推奨する前にそのスキルを読み、プロンプトの例を 1 つ示してください。

ユーザーの目的	スキル
重要なタスクを厳密に進める	/poteto-mode
作業を始める前に、エージェントが目標と問題を理解しているか確認する	/in-your-own-words
作業を始める前に、より専門的で成果重視にし、細かく指定しすぎない形でタスクを磨き上げる	/sharpen
コードの現在の動作や、新しいコードを配置すべき場所を把握する	/how
コードがこの形になっている理由や、数値の由来を把握する	/why
変更やサブシステムについて、平易な説明で理解する	/teach
特定の話題について、自分が最近行った作業を振り返る	/recall
前回のメッセージ以降、このチャットで変わったことを、各アクションアイテムを判断できるだけの文脈とともに、簡潔な文章や小さな図で把握する	/ketchup
小さな差分が、その範囲外に及ぼす影響を把握する	/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
パフォーマンスの数値を報告したり、それに基づいて行動したりする前に検証する	/benchmark-checklist
大規模な変更や広範囲に及ぶ変更、または時間を置いてからレビューする変更を進める	/figure-it-out
作業中に決定ログを記録し、完了後に振り返る	/show-me-your-work
役割ごとにモデルを選び、モデルファミリーごとに求める作業量を指定する	/setup-pstack
自分の作業習慣を、個人用のモードスキルにする	/automate-me
完了したタスクから得た学びを、スキルの編集に反映する	/reflect
このリポジトリでエージェントが同じ間違いを繰り返さないようにする	/correct
pstack の使い方を把握する	/poteto-help

この表に、現在のディレクトリの隣にあるスキルディレクトリが載っていない場合は、その frontmatter を読み、説明に基づいて振り分けてください。principle-* ディレクトリについては、以下の principles の項で扱います。

判断に迷う場合：

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

pstack に含まれないもの：

• run（CLI と TUI）、verify（UI）、loop は Claude Code の組み込み機能です。plugin-dev:skill-development は別の plugin-dev プラグインに含まれており、スキル作成のルートで必要になります。Claude Code では、/plugin marketplace add anthropics/claude-plugins-official を実行してから、/plugin install plugin-dev@claude-plugins-official を実行してインストールします。codex-tools.md には、それぞれに相当する Codex の機能が記載されています。
• /make-bot-ui は Cursor のルーティンと Webhook に依存するため、移植されていません。
• pstack に /orchestrate スキルはありません。Orchestrate は /poteto-mode の playbook です。スラッシュメニューに /orchestrate が表示される場合は、別のプラグインが提供しています。

Playbook と原則

Playbook は /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」のようなフレーズで、同じ作業を行う同梱の /babysit スキルが起動することがあります。poteto-mode の Playbooks セクションには、すべての playbook と、それぞれが適用される状況が記載されています。ガイドページ 6 では、PR の作成、見守り、取り込みについて説明しています。

pstack に計画用スキルはありません。Claude Code のプランモードは pstack と併用できます。複数フェーズや積み重ねた PR にまたがる作業では、/poteto-mode に計画を依頼すると、Multi-phase plan playbook が実行されます。これは計画を作成しますが、実装はしません。設計に関する質問には、Prototype playbook または /architect がまずコード上で設計を固めます。

原則は1つのルールを示すスキルで、/poteto-mode が読み込み、返信で引用します。ユーザーが直接呼び出すことはほとんどありません。「apply prove it works. show me the real output.」のように、名前を指定して方向性を示します。原則はスラッシュメニューには表示されませんが、pstack:principle-prove-it-works のように名前を指定して依頼すると、必要に応じて読み込まれます。ガイドページ 8 に一覧が記載されています。

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

症状	修正方法
数ターン後にモードが適用されなくなった	入力したスキルは、セッションが進むにつれて効力が薄れます。各タスクの開始時に /poteto-mode を実行してください。
質問が前のタスクの続きとして扱われた	「新しいタスク」と伝えるか、そのターンではモードが不要だと伝えてください。
新しいモデルの選択が反映されなかった	/setup-pstack のモデルシートは新しいセッションに適用されます。新しいセッションを開始してください。
実行コストが想定より高かった	「セットアップ」の下にあるコストの段落を参照してください。
スキルが自動で読み込まれなかった	/poteto-help、/correct、/ketchup は入力したときにのみ実行されます。その他のスキルはユーザーの言葉から読み込まれることがありますが、リクエストが説明に一致する場合に限られ、/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を参考に調整してから、そのファイルへのリンクを続けてください。ユーザーが全体像を求めていない限り、簡潔にまとめてください。