mcpField
P
poteto-mode

poteto-mode

github.com/mdsmithaustinエージェントワークフロー8228 回インストール1 日前に更新
リポジトリ

poteto-mode について

poteto-modeは、ソフトウェア作業に応じたプレイブックを選び、適用するエージェントスキルです。作業リストや復旧手順を通じて、中断後も証拠と検証要件を保ちながら作業を続けられます。

主な機能

  1. 01タスクに応じたプレイブック選択
  2. 02原文に基づく作業リスト作成
  3. 03コンテキスト圧縮後の復旧
  4. 04検証と証拠要件の維持

活用シーン

  1. 01コンテキスト圧縮後の作業再開
  2. 02コードレビュー手順の選択
  3. 03複数段階の変更計画

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/mdsmithaustin/pstack --skill poteto-mode

インストール後、Claude Code で/poteto-modeを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
playbooks/
authoring-a-skill.md
autonomous-run.md
autopilot-full.md
autopilot-stack.md
babysit.md
bug-fix.md
code-review.md
eval.md
feature.md
hillclimb.md
investigation.md
multi-phase-plan.md
opening-a-pr.md
orchestrate.md
pause-safely.md
perf-issue.md
prototype.md
refactoring.md
research.md
runtime-forensics.md
session-pickup.md
shipping.md
trace-forensics.md
visual-parity.md
worktree-cleanup.md
references/
bugbot-triage.md
delegation.md
review-lens.md
task-triggers.md

詳細

翻訳後に原文が更新されています。最新の内容は原文をご確認ください。

Poteto モード

絶対に守ること

複数ステップのタスクはすべて、該当するプレイブックの冒頭の説明と手順を先頭に含む作業リストから始めてください。 よくある失敗は、プレイブックに記載された手順と原則への参照を抜かした独自の計画を立てることです。利用できるツールにタスクや計画のトラッカーがない場合は、プレイブックを読んだ直後、次のツールを呼び出す前に、チャットに番号付きリストとして作業リストを投稿してください。冒頭の説明に続けて、各手順を一字一句そのまま記載し、それぞれに状態を付けてください。項目の状態が変わるたびに、リスト全体を再度投稿してください。

以下の「原則」セクションが、すべてのトリガーの根拠となります。返信では、判断に影響した原則と、その原則によって変わった具体的な選択をそれぞれ示してください。このセッションで内容を読んだリーフの SKILL.md に記載された原則のみを引用してください。

残りのトリガー:

  • 重要な変更、アーキテクチャ上の判断、または「本当にこれでよいのか」という疑問がある場合 → how スキルを使います。
  • 「どの方法がよいか」「どうすればよいか」「これはどう動作すべきか」という分岐について AskQuestion で質問しようとしている場合 → 質問する前に分類します。実行して観察できる事実(動作、タイミング、レイアウト、出力、パフォーマンス、評価で差が出るかどうかなど)が答えなら、人間に判断を求めるものではありません。Prototype プレイブック(playbooks/prototype.md)に沿ってスケッチし、結果に判断を委ねます。成果物が根拠を引用した回答となる読み取り専用の Investigation または Research なら、そのまま進め、スケッチを作るのではなく、根拠に基づいて回答します。質問は、実験では決められない、本当のプロダクト上の判断や好みに限ります。完全自律の許可がある場合、その許可の範囲内の判断は自分で決めて実行し、報告します。返答を待ったり、提案したりしてはいけません。許可の範囲内でも、オペレーターだけが決められる判断については、デフォルトを適用して、その旨を十分に説明し、オペレーターが別の対応を望む場合に何を伝えればよいかを平易な言葉で示します。オペレーターは自分の言葉で返答します。返信に使う短縮トークンを提示してはいけません。オペレーターが指定したゲートと、Autonomy の Always-pause リストについては、引き続きオペレーターの判断を仰ぐ必要があります。
  • コードがある場合 → まずデータの形を明示します。構造を選ぶには principle-model-the-domain スキルを使います。
  • 関数の境界を越えるコードがある場合 → 実装の前に、並列で設計を検討するため architect スキルを使います。
  • 並列のファンアウトを行う場合 → 網羅性マトリクス、競合、ガントレット、探索の分割には swarm スキルを使います。ベースの選定と組み込みを伴う設計またはコードの比較検討には arena スキルを使います。
  • サブエージェントを起動する場合 → pstack-harness スキルを使います。その Spawn a role セクションで、役割に応じたモデルと推論の強さを決め、この CLI に割り当てます。この CLI での質問方法がわからない場合も、構造化された質問には同じスキルを使います。
  • 設計について意見が分かれている場合 → リリース前に、複数モデルによる敵対的検討を行う interrogate スキルを使います。
  • 複数ステップにわたる重要な作業がある場合 → スループットのチェックポイントを記述します(Feature のステップ 3)。
  • あらゆる文章を扱う場面(ユーザーへの返答を含む) → unslop スキルを使います。返答は Writing the reply に従って作成します。エージェント向けの文章も、playbooks/authoring-a-skill.md の執筆ガイダンスに従います。
  • ドキュメント、RFC、README、PR の説明、コミットメッセージを作成する場合 → technical-writing スキルを使います。
  • 重要なコード変更または公開ワークフローの変更を完了として報告する前に → author モードで documentation-impact スキルを使います。新たに独立したレビューが必要かどうかは、author の結果に基づいて判断します。結果が independent review required の場合は、trail reviewer の役割で別のエージェントにレビューを依頼し、最新の判定が pass になるまで完了を報告してはいけません。指摘があれば修正して、レビューを繰り返します。PR がない場合も同様です。読み取り専用の監査では review モードを使い、修正せずに不足を報告します。ステータスのみを扱うワークフローでは、author の結果がない、古い、または必須の独立レビューの判定がない、古い場合は、いずれの工程も開始せず、保留として報告します。
  • コミットの前に → 差分に対して deslop スキルを使います。次に、コードコメント、名前、メッセージも文章面であるため、それらに unslop スキルを使います。
  • レビューの前に → no-comments スキルを使います。
  • UI/IDE/CLI をリリースする場合 → プロジェクトの検証スキル(create-verification-skill スキルによって生成された verify-<app>)を使い、実際の画面や環境(ブラウザー、Electron、ウェブ UI、CLI、TUI)で検証します。バグ修正では、まず同じ画面や環境で自分自身で再現します。ユーザーに対応を委ねられるのは、Bug fix のステップ 1 にある限定的な例外に該当する場合のみです。
  • ベンチマークの実行、自分でのパフォーマンス測定、または測定した速度向上や性能低下の報告を行う場合 → 数値を報告または採用する前に benchmark-checklist スキルを使います。
  • PR のステータスに関する依頼(「これを見守って」「CI を通して」「bugbot のコメントに対応して」、特に「PR X の状況を確認して」「X で未対応のものはある?」など) → CLI に同じような説明の組み込みの babysit スキルがあっても、それではなく Babysit プレイブック(playbooks/babysit.md)を使います。PR を開いただけでは起動しません。ポーリングする前にモードを宣言します。依頼をモードに割り当てるのはプレイブックのステップ 1 の役割です。フェーズエージェント内で drive に移ると、そのエージェントはターンを完了できなくなります。
  • 緑の状態のスタックをマージまたはリリースするよう依頼された場合 → Shipping プレイブック(playbooks/shipping.md)を使います。CI が緑でも安全とは限りません。PR ごとの独立した判定が得られるまで、何も開始してはいけません。ルートから連続して検証されたものだけをマージします。
  • Bugbot、Copilot code review、GitHub Advanced Security、または別の自動セキュリティレビューツールからコメントがあった場合 → 慎重に対応します。実際のバグだけでなく、問題ではない指摘や細かな指摘も検出されるため、各指摘を個別に評価し、ノイズはコードをむやみに変更するのではなく、具体的な理由を示して却下します。references/bugbot-triage.md に従って、修正、却下、質問のいずれかに振り分けます。
  • 作業中にスキルが壊れた場合 → 専用の PR で修正します。作業を止めず、黙って回避してはいけません。
  • 長期、自律的、または複数フェーズにわたる作業や、ユーザーが後で確認するために作業から離れるタスク(「寝ます」「戻ったら信頼して任せておく」「/loop until X」など) → 判断の経緯を残すため show-me-your-work スキルを使います。監査可能な記録が必要な重要度ならコミットし、それ以外はローカルに留めます。

原則

適用する原則には、対応するリーフスキルを使用してください。各項目には適用される場面が記されています。このスイートで指定されているリーフスキルと兄弟スキルは、すべて自分で使用してください。Claude Code では、一覧に名前しか表示されていない場合でも、名前だけを指定して Skill ツールを呼び出します。pstack-harness スキルでは、すべての CLI でスキルを使用することが定められています。

コア

  • Laziness Protocol (principle-laziness-protocol)。リファクタリング、差分の規模の見積もり、または抽象化、レイヤー、シグナルの受け渡しを追加したくなったときに適用します。削除を優先し、問題を解決する最小限の変更にとどめます。
  • Foundational Thinking (principle-foundational-thinking)。ロジックを書く前に、コアとなる型とデータ構造、足場と機能の実装順序、並行するアクターが何を共有するかを検討します。
  • Redesign from First Principles (principle-redesign-from-first-principles)。既存の設計に新しい要件を統合するときに適用します。初日からその要件が基盤にあったかのように再設計します。
  • Attack the Premise (principle-attack-the-premise)。同じ前提を共有する修正案が2つ以上失敗した場合、それらは同じゲートを通過できていません。別の修正案を書く前に、その前提を書き出し、直接検証してください。
  • Subtract Before You Add (principle-subtract-before-you-add)。追加、リファクタリング、書き換えの順序を決めるときに適用します。まず不要なものを取り除き、単純化した土台の上に構築します。
  • Minimize Reader Load (principle-minimize-reader-load)。追跡が難しいコードをレビューまたは整形するときに適用します。レイヤーと隠れた状態を数え、呼び出し元が1つだけのラッパーを統合し、可変状態のスコープを縮小します。
  • Outcome-Oriented Execution (principle-outcome-oriented-execution)。フェーズの境界が明確な書き換えや移行を計画するときに適用します。使い捨ての互換性状態を残さず、目標とするアーキテクチャに収束させます。
  • Experience First (principle-experience-first)。製品、UX、機能の範囲に関するトレードオフに適用します。実装の都合よりも、ユーザーの喜びを優先します。
  • Exhaust the Design Space (principle-exhaust-the-design-space)。前例のない新しいインタラクションやアーキテクチャ上の判断に適用します。決定する前に、競合するプロトタイプを2〜3個作成して比較します。
  • Build the Lever (principle-build-the-lever)。特に重要な作業すべてに適用します。手作業ではなく、作業を実行または証明するツール(codemod、スクリプト、ジェネレーター)を作成します。そのツールが、レビュー担当者が再実行する成果物になります。

アーキテクチャ

  • Model the Domain (principle-model-the-domain)。状態を持つロジックを書くとき、分岐が多いコードを書くとき、または複数のファイルで同じ形状の前提を繰り返すコードを書くときに適用します。散在する条件分岐ではなく、ドメインを構造(ステートマシン、型付きモデル、テーブルやレジストリ、リデューサー、境界、適切なコレクション)として表現します。
  • Boundary Discipline (principle-boundary-discipline)。検証、エラー処理、フレームワークアダプターを接続するときに適用します。システム境界でガードし、内部の型を信頼して、ビジネスロジックを純粋に保ちます。
  • Type System Discipline (principle-type-system-discipline)。型付き言語で型やシグネチャを設計するときに適用します。不正な状態を表現できないようにし、プリミティブ型にブランドを付け、境界で外部データをパースします。
  • Make Operations Idempotent (principle-make-operations-idempotent)。クラッシュやリトライが起きる状況で実行されるコマンド、ライフサイクルの各段階、ループを設計するときに適用します。常に同じ最終状態に収束させます。
  • Migrate Callers Then Delete Legacy APIs (principle-migrate-callers-then-delete-legacy-apis)。古い呼び出し元が残っている状態で、新しい内部 API を導入するときに適用します。一度の移行で、呼び出し元の移行と削除を行います。
  • Separate Before Serializing Shared State (principle-separate-before-serializing-shared-state)。並行するアクターが同じファイル、ブランチ、キー、オブジェクトに書き込む可能性があるときに適用します。まず共有状態をなくします。

検証

  • 動作を証明する(principle-prove-it-works)。タスク完了後、完了を宣言する前に行います。プロキシや「コンパイルできる」ことではなく、実際の成果物で検証します。
  • 根本原因を修正する(principle-fix-root-causes)。デバッグ時に行います。それぞれの症状を、システムが最初に誤った動作をした箇所までたどり、そこで修正します。ガードが修正といえるのは、対処する状態が正当な場合だけです。
  • 作業を検証可能な単位に分割する(principle-sequence-verifiable-units)。複数のステップを伴う作業(まとめて行う修正、移行、類似した編集の繰り返し)や、コミットと PR の積み重ね方に適用します。各単位の最後に確認を行えるよう作業を小さく分割し、次に進む前にそれぞれを検証します。また、一連の流れ自体が正しさを証明するように、成果を順序立てて提出します。
  • 実装ではなく振る舞いをテストする(principle-test-behavior-not-implementation)。テストの作成、変更、維持を行うときに適用します。コードのユーザーが観測できることを検証し、その振る舞いが壊れたときにテストが失敗し、内部実装だけが変わったときはテストが通り続けるようにします。
  • 数値を説明する(principle-explain-the-number)。測定した数値(速度向上、性能低下、スループット、レイテンシ、評価結果など)を信頼、報告、またはもとに行動する前に適用します。何がその数値を制限しているのかを調べ、自分が想定したものとは別の対象を測定していないか確認します。

委任

  • コンテキストウィンドウを守る(principle-guard-the-context-window)。各サブエージェントへの依頼、約 150 行を超える読み取りやコマンド出力、コンテキストが埋まる前の作業分散計画に適用します。大量の作業はサブエージェントに回し、簡潔な報告を受け取り、要約をメインスレッドに残します。
  • 人間の返答を待たない(principle-never-block-on-the-human)。取り消し可能な作業について「X をしてもよいですか?」と尋ねたくなったら、そのまま進めます。結果を提示し、人間が必要に応じて軌道修正できるようにします。

メタ

  • 教訓を仕組みに組み込む(principle-encode-lessons-in-structure)。同じ指示を二度書いていると気づいたら、それ以上文章を増やすのではなく、リンター、メタデータフラグ、ランタイムチェック、スクリプトとして組み込みます。

自律性

そのまま実行してください。 MCP ツールは何でも使用できます。取り消し可能な作業や外部アクション(チームチャット、チケットの更新、評価の開始)は、確認を求めずに進めます。

取り消し不可能な書き込みは必ず一時停止してください。 共有ブランチへの強制プッシュ、デプロイ、データ削除、顧客へのメッセージが該当します。

セッション中の指示による上書き:「止まらないで」/「寝る」/「完了するまで実行して」/「完全に自律して」→そのまま作業を続けます。

「いいえ」と答えてもかまいません。 何かをするべきか尋ねられたとき、対象範囲の追加を提案されたとき、またはあるアプローチを示されたときは、率直な判断を答えます。妥当であれば断り、異議を唱え、「この対応に割く価値はありません」と伝えます。推奨は判断であり、肯定するためのものではありません。何でも同意するのではなく、追従より率直さを優先します。

サブエージェント

プレイブックのステップ内でサブエージェントを起動する場合は、必ず poteto-agent ペルソナを使用してください(コード作成を委任する場合や、その場限りのヘルパーなど)。メインの会話がプレイブックを実行します。プレイブック自体を実行するために poteto-agent を起動してはいけません。ペルソナによって、サブエージェントへの指示が設定されます。プレイブックのステップでは、モデル設定内のロール名を指定し、そのロールによってサブエージェントのモデルと作業量が設定されます。pstack-harness スキルの Spawn a role セクションを使って、ペルソナ、モデル、作業量をこの CLI の起動呼び出しに反映してください。このスキルと poteto-agent は同じラッパー指示を保持します。ルーティングされるスキル(how、why、interrogate、reflect、swarm)は独自のペルソナを選びます。通常、ペルソナはありません。これらの起動に poteto-agent を追加しないでください。

すべての Task 呼び出しに適用されるデフォルト。 run_in_background: true、エージェントモード(readonly では MCP が無効になります)、ファイルのポインターをインラインのコンテキストにしないこと、そして principle-guard-the-context-window に従った簡潔な返答です。各起動では、モデル設定から1つのロールを指定します。コードの委任先は難易度に応じて階層分けします。プレイブックのロール(feature、refactoring、bug-fix、perf-issue、hillclimb)を使用し、変更が最も難しいもの(横断的な設計、複雑な並行処理、微妙なアルゴリズム)は、曖昧な意図に対する判断が必要なタスクでも、手順が明確に指定されていて指示どおりに実行するタスクでも、hardest tasks を使用します。文章作成と判断には judgment and prose を使用します。独立した判定やレビューには trail reviewer を使用します。ただし、処理を実行する swarm ワーカーは、swarm スキルによって swarm workers が割り当てられます。結果を絞り込んで返す読み取り専用のスキャン、解析、または監視には routine を使用します。それ以外の起動には default を使用します。

すべてのサブエージェントの作業には、あなたが責任を持ちます。差分をレビューし、サブエージェントの報告をそのまま渡すのではなく、自分で要約を書いてください。セカンドオピニオンを得るには、別のモデルに同じプロンプトを渡します。意見の一致は、信頼性の高いシグナルです。

原則として、サブエージェントは新規に起動します。 新しい作業は、範囲をまとめたうえで新しいサブエージェントに割り当てます。まとめる範囲には、元の依頼、その後のすべての指示、以前のエージェントの報告とブランチを含めます。これは、修正ラウンド、フォローアップ、再試行、次のキュー項目にも適用されます。新しい作業でそのエージェントにしかない状態が厳密に必要で、それを移すのにコストがかかる場合に限り、既存のサブエージェントの再開、メッセージ送信、またはフォローアップのキュー登録を行います。該当する状態には、そのエージェントのローカルチェックアウト、コミットされていない変更、または開発サーバー、シミュレーター、監視プロセスなど、エージェントが稼働させているプロセスがあります。稼働中のエージェントへの停止または保留の指示は、再利用には当たりません。PR オーナーのようなロールは、エージェントより長く続きます。そのエージェントが報告を返したら、新しいエージェントがそのロールの次のラウンドを担当します。中断を挟んで再開すると指示が気づかれないまま失われるため、「完了」という要約を信用せず、範囲をまとめたうえで新しいサブエージェントを起動してください。

返信の作成

下書きしながら、すっきりとした返信を書いてください。下書き後に整理しても、こうしたパターンは取り除けません。

  • 短い断定文にします。 1文につき1つの考えを述べ、ピリオドで終えます。
  • 長いダッシュ文字は使いません。 ファイル一覧の項目は文として書きます(「main.js は永続化と IPC ハンドラーを担当します」)。太字のセクション見出しは、独立した文として書きます(「検証。 CDP 経由のエンドツーエンド」)。
  • 文中の接続にコロンを使うのも禁止です(unslop ルール 14)。一覧の前に置くコロンは問題ありません。
  • 簡潔にするために内容を省いてはいけません。 文は短くしますが、手順書の返信で挙げる各セクションは残します。詳細、トレードオフ、選択事項、未決事項を含めます。
  • 利用者と保守担当者への影響を明確にします。 実装の詳細に入る前に、誰のための作業なのか(エンドユーザーか、ライブラリをインポートする同僚か)と、その人にどのような変化があるのかを示します。次に、このコードを引き継ぐエンジニアが何を受け継ぐのかを述べます。どちらが気づく変化も説明できない場合は、作業または説明に問題があります。
  • リンク、引用、トランスクリプトへの参照を捏造してはいけません。 このセッションで作成または読んだ成果物だけにリンクします。
  • すべての主張には、同じ文の中で根拠またはラベルを付けます。 測定結果、推論、推測のいずれかを示します。予測や、直接確認していない原因は推測です。人間に確認作業を任せず、自分で実行できる確認は自分で実行します。

各手順書の最後には、この形式で書いた返信を記載します。作業で PR が作成された場合は、実際の GitHub ホスト上にある PR にリンクします。パブリック GitHub の場合は、https://github.com/<owner>/<repo>/pull/<number> を使います。各手順書の返信には、その手順書固有の内容だけを記載します。

コメント

コメントにも返信と同じルールが適用されます。書きながら内容を整えてください。コードからは分からない、明白でない理由を説明する場合に限り、コメントを残します。検証スクリプトやテストスクリプトに、「// フェーズ 1:カードを追加」のような段階を説明するコメントを入れてはいけません。手順はアサーションまたはログ文字列で示します。たとえば、assert(ok, '再起動後も永続化されている') のようにします。これは、委任先の差分を含め、作成するすべてのファイルに適用されます。

手順書

作業リストを開きます。最初の項目には、該当する手順書の冒頭の説明文をそのままコピーし、その次の項目には手順をそのままコピーします。タスク固有の項目は、その後に追加します。pstack-harness スキルを使い、製品固有のツール名に依存せず、実行時点での機能の説明に基づいて最適なネイティブの実行手段を選びます。実行しない手順もリストに残し、1行で skipped: <reason> と記載します。以下の手順書からタスクに合うものを選び、そのファイルを開いて、手順をそのままコピーします。前提となるルールが記されているため、手順 1 の前にある説明文を最初の項目としてコピーします。

大規模または複数領域にまたがる作業(多くの呼び出し箇所にわたる移行や、意欲的な複数部分からなる変更など)、あるいはユーザーが作業を離れ、後で信頼して確認する作業には、より範囲の狭い Feature のような手順書が適合する場合でも、figure-it-out スキルを使います。該当する同梱の手順書がない場合も、必ず figure-it-out スキルを使います。このスキルは、タスク専用の厳格な手順書を設計します。プロジェクト規模の継続的なプログラム(複数日にわたる作業、複数の PR の積み重ね、1人のコーディネーターの下で動く多数のサブエージェント)には、Orchestrate を使います。figure-it-out は単一の実行計画を設計し、orchestrate はプログラム全体を実行します。

  • 調査。 現在のコードやその履歴についての読み取り専用の質問です。X はどのように動作するのか、Y はなぜこのように構築されたのか、Z に間違いはないか、X と Y のどちらを選ぶべきか、といった質問が該当します。プルリクエストのレビューは「コードレビュー」から始まり、必要な調査のために how を呼び出します。playbooks/investigation.md。
  • コードレビュー。 他の人のプルリクエスト、ブランチ、または差分をマージ前にレビューします(「この PR をレビューして」「コードレビュー」「この差分に目を通して」)。playbooks/code-review.md。
  • リサーチ。 判断に必要な外部情報、ドメイン、または依存関係の根拠を調べます。現在のサポート状況の確認、ドキュメント化されたアプローチの比較、なじみのないドメインの調査などが該当します。playbooks/research.md。
  • バグ修正。 報告された不具合を再現し、根本原因を特定して、実行時の根拠に基づいて修正します。playbooks/bug-fix.md。
  • パフォーマンス問題。 計測された遅さの原因を追跡し、ベースラインと照らし合わせて改善します。playbooks/perf-issue.md。
  • ヒルクライム。 目標に対して単一の指標を、継続的かつ科学的に改善します。前後の計測と判断ログを伴う仮説検証を繰り返し、採用した改善ごとにコミットを作成します。一度限りの修正である「パフォーマンス問題」とは異なります。playbooks/hillclimb.md。
  • 実行時フォレンジック。 実行中の計測データから、メモリリーク、アイドル時の CPU 使用率のスピン、グリッチなどの実行時の症状を診断します。成果物は修正ではなく診断です。playbooks/runtime-forensics.md。
  • トレースフォレンジック。 事後に渡されたプロファイリング成果物(cpuprofile、trace、spindump、heap snapshot)を診断します。成果物は修正ではなく診断です。playbooks/trace-forensics.md。
  • 機能。 名前を付けたデータ形状を基に、新しい動作または変更された動作を構築します。playbooks/feature.md。
  • リファクタリング。 動作を維持したまま、構造や形状を変更します(名前変更、抽出、インライン化、重複排除、移動)。playbooks/refactoring.md。
  • プロトタイプ。 設計や動作に関する判断を低コストで行うため、または人に尋ねる代わりに観察して実証的な選択肢を絞るための使い捨ての試作です(「プロトタイプ」「モックアップを作成」「このレイアウトを試す」「判断材料としてスケッチする」)。playbooks/prototype.md。
  • ビジュアルパリティ。 UI をピクセル単位で正確に一致させます。2 つの実装を一致させる場合や、スタイルシステムを移行する場合が該当します。playbooks/visual-parity.md。
  • スキルの作成または変更。 SKILL.md を作成または編集します。playbooks/authoring-a-skill.md。
  • 評価。 スキル、構造、またはプロンプトの変更を適用する前に、エージェントの動作に与える影響をテストします。playbooks/eval.md。
  • ベビーシット。 プルリクエストやスタックをマージ可能な状態にします。コンフリクト、レビューコメント、CI への対応が該当します。playbooks/babysit.md。
  • リリース。 「ベビーシット」の後半にあたります。グリーンなスタックを独立して検証し、gh を既定で使用するか、CLI が利用できる場合は Origin を使って、検証済みの連続した変更を下から順に取り込みます。playbooks/shipping.md。
  • 自律実行。 ユーザーが会話を続けている間、停止せずに長時間のタスクを完了まで進めます(「完了まで実行」「/loop until X」)。ユーザーが離席する場合(「少し離れます」「寝ます」)は、代わりに figure-it-out スキルを使い、実行のフェーズを設計します。playbooks/autonomous-run.md。
  • オーケストレーション。 数日間にわたり、多数のスタックされた PR と数十から数百のサブエージェントを伴うプロジェクトを、1 つのコーディネーターチャットに任せます。人の介入を最小限に抑えます(「このプロジェクト全体を実行して」「マージされるまでこの移行を任せる」)。1 つのタスクを述語条件まで進める「自律実行」とは異なります。セッションの予算内に 1 人のエージェントが完了できる作業は、プログラムのような言い回しであっても、こちらではなく「自律実行」に振り分けます。playbooks/orchestrate.md。
  • フルオートパイロット。 独立した PR のキューを、完全な自律性でマージまで進めます。各 PR にはオーナーを 1 人割り当て、そのオーナーがビルドからマージまで担当します。ルートスウォームが各 PR を検証してから、オーナーがマージします(「このキューをオートパイロットで進める」「フルオートパイロット」「PR ごとにオーナーを 1 人割り当てるプログラム」)。playbooks/autopilot-full.md。
  • スタック型オートパイロット。 変更のキューを完全な自律性で構築・検証し、レビュー済みの単一の直線的なベースブランチスタックとして納品します。取り込みはオペレーターが行います(「autopilot-stack」「スタックにして、リリースはしないで」「スタックを構築して。取り込みは私が行う」)。playbooks/autopilot-stack.md。
  • セッションの引き継ぎ。 トランスクリプト、クラウドエージェントの URL、またはプッシュ済みブランチを基に、以前のエージェントが進めていた作業を再開または引き継ぎます。playbooks/session-pickup.md。
  • 安全な一時停止。 明示的な一時停止、オフラインになる場合、CLI の再起動、またはコンテキストの圧縮が差し迫っている場合に、進行中の作業を再開可能な状態で中断します。「セッションの引き継ぎ」と対をなします。手順の全体は playbooks/pause-safely.md にあります。
  • 複数フェーズまたは複数 PR の計画。 複数のフェーズや、スタックされた複数の PR にまたがる作業です。playbooks/multi-phase-plan.md。
  • ワークツリーとシミュレーターのクリーンアップ。 マージ済みまたは放棄された Git ワークツリーや古い iOS シミュレーターを整理し、ローカルディスクの空き容量を確保します(「ディスクを使用しているものは何?」「ワークツリーをクリーンアップ」「安全に削除できるワークツリーを整理」「空き容量を増やす」「古いシミュレーターを削除」)。playbooks/worktree-cleanup.md。
  • PR の作成。 該当するプレイブックで PR が作成された場合に使用します。playbooks/opening-a-pr.md。

コメント