poteto-help

Poteto ヘルプ

太字またはバッククォートで示されたスキル名、あるいは /<name> として実行するスキルは、このスキルのディレクトリの隣にある ../<name>/SKILL.md ファイルです。接頭辞なしで示された原則名は、../principle-<name>/SKILL.md です。そのファイルを読み、従ってください。pstack のスキルのほとんどはユーザー専用のため、あなたのスキルツールでは読み込めません。

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

「pstack を使ってこのバグを修正して」のように作業を依頼するメッセージは、使い方の質問ではありません。poteto-mode を読み、その指示に従って作業してください。各タスクを /poteto-mode で始めると、継続して有効になることを一度だけ伝えてください。

このファイルでは、質問と回答が記載されたスキルや参考資料を対応付けています。詳細は、それぞれのファイルが定めます。案内先のファイルを引用する前に読み、この一覧と異なる場合は、そのファイルの内容を優先してください。ここにあるリンク先はインストール済みのスキル内にあり、ユーザーが開けない可能性があります。そのため、https://github.com/mariusflorescu/pstack-t3/blob/main/skills/ に skills/ 以下のパスを続けた、公開版のファイルを案内してください。

必要な内容を確認する

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

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

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

• ~/.config/pstack/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 mariusflorescu/pstack-t3 -g -a claude-code -a codex でインストールします。Codex のスレッドでは、pstack が /<name> に書き込むスキルを $<name> として実行します。
2. /setup-pstack を実行します。推論予算を尋ね、各ロールにモデルを割り当て、~/.config/pstack/pstack-models.md に書き込みます。スキルは次に委任するときにこのファイルを読み込みます。その後、プロジェクトにまだ存在しない場合は、検証スキルと形式検証スキルをそれぞれ一度だけ生成するか尋ねます。
3. /poteto-mode、目標、そして合格または不合格を判定できるチェックを指定して、実際のタスクを開始します。

ユーザーがスキルを呼び出すまでは、インストールによる変更はほとんどありません。ユーザーの言葉から読み込まれるのは /setup-pstack と deslop のみで、エージェントが .ts または .tsx ファイルを扱うときは typescript-best-practices が読み込まれます。詳しくはリポジトリを参照してください。最初のプロンプトを一緒に作成するよう提案してください（references/prompting.md を参照）。

コストが心配な場合は、トークンの消費先と節約方法を伝えてください。pstack はサブエージェントとレビューパネルに追加のトークンを使います。/setup-pstack を再実行し、より小さい予算または安価なモデルを選択してください。ロールを auto または inherit-parent に設定すると、親スレッドのモデルで実行されます。スレッドがより安価なモデルで動作している場合は、トークンを節約できます。パネルのリストを短くすると、各項目につき1つずつ、実行されるサブエージェントの数が減ります。厳密さが必要な作業に /poteto-mode を使ってください。

この pstack は T3 Code 向けに構築されています。スキルは Agent Skills 形式を使用しているため、ほかのツールでも読み込めます。ただし、/poteto-mode、/how、/why、/teach など、ほとんどのワークフロースキルはロールごとのモデルを指定した delegate_task サブエージェントを起動します。また、PR の監視とスケジュール設定は T3 Code のツールです。そのため、これらの機能はほかのツールでは動作しない場合があります。

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

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

/poteto-mode はスキルを1つのメッセージに適用します。チャットが進むにつれて効力は薄れ、オンに切り替えるモードはないため、新しいタスクを始めるたびに /poteto-mode を使ってください。

チャットの途中で「new task」と入力すると、モードは新しいプレイブックに合わせて更新されます。/poteto-mode は、プレイブックの手順で起動するサブエージェントのブリーフを、poteto-agent とともにすでに開きます。自分で起動したサブエージェントにも同じ形式を適用するには、そのファイルのテキストを使って delegate_task のブリーフを開き、プレースホルダーを poteto-mode/SKILL.md の絶対パスに置き換えてください。

スキルを選ぶ

基本の回答は /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
テストではほとんど確認できない競合状態、不変条件、その他の特性を形式検証する	/create-formal-verification-skill
対象コードの変更後に形式検証を現状に合わせ、失敗が陳腐化によるものかバグによるものかを確認する	/maintain-formal-verification-skill
パフォーマンスの数値を報告または利用する前に検証する	/benchmark-checklist
大規模な変更や広範囲に及ぶ変更、または時間を置いてからレビューする変更に取り組む	/figure-it-out
作業中に判断ログを残し、終了後に見直す	/show-me-your-work
各役割に使うモデルと推論の予算を選ぶ	/setup-pstack
自分の作業習慣を、個人用のモードスキルにする	/automate-me
完了したタスクから得た知見を、スキルの編集に反映する	/reflect
このリポジトリでエージェントが同じ間違いを繰り返さないようにする	/correct
Webhook 経由で T3 のスケジュールタスクを起動するボタンを備えたページを作る	/make-bot-ui
pstack の使い方を調べる	/poteto-help

隣接するスキルディレクトリがこの表にない場合は、その frontmatter を読み、説明に基づいて適切なスキルに案内してください。principle-* ディレクトリは、以下の原則の項目で扱います。

判断に迷う場合：

• /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 に含まれないもの：

• preview_*、device_*、watch_pull_request、schedule_task は T3 Code のツールです。
• skill-creator は独立したスキルです。
• pstack には /orchestrate スキルはありません。Orchestrate は /poteto-mode のプレイブックです。スラッシュメニューに /orchestrate が表示される場合は、別のプラグインが提供しています。

プレイブックと原則

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

• 「babysit this pr」または「check on pr 123」と言うと、Babysit が実行されます。PR をマージ可能な状態まで進め、そこで停止します。ユーザーがマージ、land、または ship を依頼しない限り、マージはしません。
• 「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 の Playbooks セクションには、すべてのプレイブックと適用される状況が記載されています。プレイブックでは、PR の作成、進捗確認、マージまでの手順を扱います。

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

原則は、/poteto-mode が返信内で読み取り、引用する、1つのルールに特化したスキルです。ユーザーが直接呼び出すことはほとんどありません。代わりに、「apply prove it works. show me the real output.」のように、名前を使って指示します。/principle-<name> と入力すれば、必要に応じて引き続き読み込めます。リポジトリに一覧があります。

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

症状	修正方法
数ターン後にモードが適用されなくなった	チャットが進むにつれて効果が薄れます。各タスクの開始時に /poteto-mode を実行してください。
質問が前のタスクの続きとして扱われた	「新しいタスク」と伝えるか、そのターンではモードが不要だと伝えてください。
新しいモデルの選択が反映されなかった	スキルは委任時に ~/.config/pstack/pstack-models.md を読み込みます。すでに実行中のサブエージェントのモデルは変わりません。
実行コストが想定より高かった	「セットアップ」のコストに関する段落を参照してください。
スキルが自動で読み込まれなかった	ユーザーの発言から読み込まれるのは /setup-pstack と deslop のみで、.ts および .tsx ファイルから読み込まれるのは typescript-best-practices のみです。それ以外は、ユーザーが名前を入力するか、/poteto-mode が実行したときに読み込まれます。また、すべてのスキルが実行されるわけではありません。
並列エージェントが互いの変更を上書きした	t3_thread_launch スレッドを使い、各エージェントに専用のワークツリーを割り当ててください。または、同じチェックアウト内のサブエージェントに、互いに重複しないファイルを割り当ててください。
一晩実行したものの、進んだだけで何も完了しなかった	実行時間ではなく、合格または不合格を判定できるチェックが必要です。references/prompting.md を参照してください。
ビルドが成功しただけで、返信が成功を主張している	実際のコマンド、フロー、保存された値、またはプロフィールを確認してください。これが、動作を実証する原則です。

実行が脱線した場合は、references/prompting.md に一行で軌道修正する方法があります。真似る価値のあるレシピは references/recipes.md にあります。

pstackを自分用にする

• /automate-me は、ユーザー自身の履歴から個人用のモードスキルを作成します。/poteto-mode と併用できます。
• セッション後に /reflect を実行すると、学んだことが、ユーザーの承認を得てスキルの編集に反映されます。
• /poteto-mode write a skill for <workflow> はスキル作成手順を実行します。評価手順では、スキルの変更をブラインドテストします。
• 不具合のあるスキルは、問題が起きた機能の作業に混ぜず、そのスキル専用のPRで修正してください。

リポジトリでは、これらをそれぞれ紹介しています。

返信

まず答えを伝えてください。コードブロックで示すプロンプト例は最大1つとし、適切なものがあれば references/recipes.md を参考にしてください。その後に同ファイルへのリンクを示してください。全体像を求められていない限り、短くまとめてください。