poteto-help

Poteto のヘルプ

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

「pstack を使ってこのバグを修正して」のように、作業を依頼するメッセージは使い方についての質問ではありません。poteto-mode を読み、その内容に従って作業し、Custom Mode を使えばこの設定を維持できることを一度伝えてください。

このファイルでは、質問に答えるスキルとガイドページを案内します。詳細はそれらのファイルに記載されています。案内先の内容を引用する前にそのファイルを読み、この一覧と食い違う場合は、案内先の内容を優先してください。ここにあるリンクはインストール済みプラグイン内を指しているため、ユーザーが開けないことがあります。その場合は、https://github.com/cursor/plugins/blob/main/pstack/ に続けてパスを指定し、公開コピーのファイルを案内してください。

必要な内容を確認する

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

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

回答に影響する状態を確認し、影響する場合にだけ言及してください。

• pstack の設定ファイル（Cursor では ~/.cursor/rules/pstack-models.mdc、その他のハーネスでは ~/.agents/pstack-models.md）がない場合、このユーザーは /setup-pstack を実行していないため、すべてのロールでデフォルトのモデルが使われます。
• プロジェクトに verify-* スキルもその他のアプリ用ハーネスもない場合、アプリを操作するスクリプト化された手段がエージェントにありません。変更が機能することの確認方法についての質問では、/create-verification-skill を案内してください。

モデルのルールがなく、そのことが回答に関係する場合は、各ロールのモデルと推論バジェットを今選ぶかどうか、ユーザーに尋ねてください。ユーザーが初めての場合、セットアップやコストについての質問の場合、またはどのモデルを実行するかによって回答が変わる場合に関係します。質問するのはチャットごとに一度までです。必要な内容も不明な場合は、両方の質問をまとめて尋ねてください。次の 2 つから選べるようにします。

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

セットアップする

1. チャットで /add-plugin pstack を実行するか、サイドバーの「カスタマイズ」からインストールします。Cursor 以外では npx skills add backnotprop/pstack を実行し、スキルを選択します。
2. /setup-pstack を実行します。推論バジェットを尋ね、各ロールにモデルを割り当てて、ルールを書き込みます。このルールは新しいチャットに適用されます。
3. /poteto-mode、目標、合否を判定できる確認方法を指定して、実際のタスクを開始します。

ユーザーがスキルを呼び出すまでは、インストールによって何も変わりません。ユーザーの言葉をもとに読み込まれるのは /setup-pstack だけです。詳細は README と ガイドページ 1 に記載されています。references/prompting.md に従って、最初のプロンプトを一緒に考えることを提案してください。

コストが懸念事項の場合は、トークンがどこで使われるかと、消費を抑える方法を説明してください。pstack はサブエージェントとレビューパネルで追加のトークンを消費します。/setup-pstack を再実行し、より小さいバジェットか、より安価なモデルを選んでください。ロールに auto または inherit-parent を設定すると、チャットのモデルで実行されます。チャットが Auto またはより安価なモデルで実行されている場合は、トークンを節約できます。パネルのリストを短くすると、項目 1 つにつき 1 つずつ、より少ない数のサブエージェントが実行されます。厳密さが必要な作業には /poteto-mode を使ってください。

pstack は Cursor 向けに作られています。このミラーのスキルは、その他のハーネス（Claude Code、Codex、Pi、OpenCode など）でも動作します。poteto-mode の「ハーネス」セクションでは、Cursor のサブエージェント、質問、トランスクリプト、設定の各パスを、それぞれのハーネス固有のものに対応付けています。Custom Mode は Cursor の機能です。

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

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

/poteto-mode が有効なままになるかどうかは、ユーザーの起動方法によって異なります。

• /poteto-mode の上で Enter キーを押すと、スキルは1つのメッセージに適用されます。チャットが進むにつれて適用されなくなります。
• Mac では Option+Enter、Windows では Alt+Enter を押すか、スキルの項目から Use as Mode を選ぶと、カスタムモードになります。ユーザーがモードを終了するまで、毎回のやり取りでコンテキストに残り、通常のやり取りでは適用されません。
• Cursor のドキュメントでは、Agents Window と CLI でカスタムモードを使えると説明されています。それ以外の場所では、新しいタスクを始めるたびに /poteto-mode を指定してください。

この話題が出たときは、Cursor のスキルに関するドキュメント にリンクしてください。チャットの途中で「新しいタスク」と伝えると、モードは新しいプレイブックを選び直します。/poteto-mode は、プレイブックの手順で起動するサブエージェントに、すでに poteto-agent を使用しています。独自のサブエージェントでも同じスタイルにするには、subagent_type: "poteto-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
Webhook 経由で Grok Bot を起動するボタンを備えたページを作る	/make-bot-ui
pstack の使い方を知る	/poteto-help

この表に載っていない、隣接するスキルディレクトリがある場合は、その frontmatter を読み、説明に沿って振り分けてください。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 に含まれないもの：

• /deslop、control-cli、control-ui は cursor-team-kit プラグインに含まれます。
• /loop と /create-skill は Cursor 組み込み機能です。
• 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」のようなフレーズを入力すると、同じ作業を行う Cursor 独自のスキルが起動する場合があります。poteto-mode の Playbooks セクションには、すべてのプレイブックと適用される状況が記載されています。ガイドの6ページでは、PR の開始、状況確認、取り込みを説明しています。

pstack に計画スキルはありません。Cursor の Plan Mode は pstack と併用できます。複数のフェーズにまたがる作業や、積み重ねた PR に取り組む場合、/poteto-mode に計画を依頼すると、計画を作成して実装は行わない Multi-phase plan プレイブックが起動します。設計に関する質問には、Prototype プレイブックまたは /architect を使い、まずコードで設計を確定します。

原則は、/poteto-mode が読み込み、返信で引用する、1つのルールから成るスキルです。ユーザーが直接呼び出すことはほとんどありません。「apply prove it works. show me the real output.」のように、名前を使って誘導します。/principle-<name> と入力すれば、必要に応じて読み込むこともできます。ガイドの8ページに原則の一覧があります。

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

症状	修正方法
数ターン後にモードが適用されなくなった	Enter で開始されています。カスタムモードとして開始するか、各タスクの開始時に /poteto-mode を実行してください。
質問が前のタスクの続きとして扱われた	「新しいタスク」と伝えるか、そのターンではモードが不要だと伝えてください。
新しいモデルを選んでも反映されなかった	/setup-pstack のルールは新しいチャットに適用されます。新しいチャットを開始してください。
実行コストが予想より高かった	「セットアップ」のコストに関する段落を参照してください。
スキルが自動で読み込まれなかった	ユーザーの言葉から読み込まれるのは /setup-pstack だけです。それ以外は、ユーザーが入力したとき、または /poteto-mode が実行したときに読み込まれます。ただし、すべてのスキルが実行されるわけではありません。
並列エージェントがお互いの変更を上書きした	各エージェントに専用の worktree を割り当てるか、それぞれ専用のマシンが割り当てられるクラウドエージェントとして実行してください。
一晩の実行で進んだものの、何も完了しなかった	/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 を参考にして調整してください。その後にこのファイルへのリンクを示してください。ユーザーが全体像を求めていない限り、簡潔にしてください。