目次
pstackは、コーディングエージェントが変更前にシステムを理解し、完了を宣言する前に結果を検証するのを支援します。まず /poteto-mode を実行し、目指す結果と受け入れ条件を伝えると、適切なワークフローが選ばれます。
要点#
/poteto-modeは、バグ修正やリポジトリ調査などのタスクに応じたプレイブックを選びます。- 開発原則では、既存の動作を理解し、有効な状態をモデル化し、変更範囲を絞ることを重視します。
- 完了には、元の不具合を捉える確認を含め、実際の動作に基づく証拠が必要です。
- インストールとモデル設定は別の手順であり、設計の確認段階で止めるには明示的な指示が必要です。
pstackの作業の進め方#
pstackは、potetoが提供するCursorとClaude Code向けのエージェントスキル集です。入口となる /poteto-mode は、作業に必要なスキルを呼び出すタスク別の手順である「プレイブック」を選びます。
ドキュメントに記載されたバグ修正の流れは、次の4段階です。
1. 不具合を再現する。 2. 仮説を立て、実行時の証拠を集める。 3. 修正を設計し、実装を委任する。 4. 元の操作を繰り返し、結果を検証する。
調査では別のプレイブックを使います。コードを変更せずにリポジトリに関する疑問に答え、証拠に裏づけられた説明や提案をまとめます。プレイブックは内部手順であり、直接実行できる /bug-fix コマンドはありません。
変更を導く原則#
how スキルは、既存のコードがどう動くかを調べます。キャッシュの問題なら、値がどこに保持され、いつ読み取られ、失敗した結果が後続の呼び出しにどう影響するかを追跡します。これにより、キャッシュ自体を直すべき場面で、呼び出し元にリトライ条件を追加することを防ぎます。
「Model the Domain」は、ビジネスルールと有効な状態をデータ構造で表すようエージェントに求めます。複数の独立した真偽値フラグより、明確に定義したステートマシンのほうが分かりやすい場合があります。architect スキルは、型、関数シグネチャ、モジュール境界の概要を示し、構造の異なる設計を比較することで、この原則を適用します。単純な表現ですでにルールを明確に表せているなら、それを維持します。
「Laziness Protocol」は、必要十分な最小限の変更と、繰り返される判断の削減を重視します。短いコードは複雑さを減らすときに役立ちますが、無関係な抽象化は不具合の原因特定に貢献せず、レビュー範囲を広げます。「Fix Root Causes」は、これに関連する要件として、局所的な回避策を選ぶ前に、不正な動作やデータが存在する理由を調べることを求めます。
インストールと設定#
Claude Code向けのREADMEでは、次のコマンドが案内されています。
/plugin marketplace add cursor/plugins
/plugin install pstack@cursor-plugins
/setup-pstack/setup-pstack は利用可能なモデルを確認し、役割ごとにモデルと推論予算を設定します。解説では、判断の比重が大きい役割にはOpusが提案され、実装と調査の役割は現在のセッションのモデルを引き継ぐとされています。その既定値を前提にする前に、自分の環境で提示される選択肢を確認してください。
設定は ~/.claude/rules/pstack-models.md に保存されます。変更するには /setup-pstack を再実行します。スキルの選択やスキル集の使い方に迷ったら、/poteto-help を使ってください。
有用なタスク依頼を書く#
エージェントには、観測できる問題、関連する環境の違い、完了を確認する方法を伝えます。たとえば、「タグページがブラウザーではエラーを表示するのに、curlでは200が返ります。ローカルの本番プレビューで再現し、原因を特定して、タグ一覧が描画されることを検証してください。修正前後のHTTPステータスとブラウザーのエラーを示してください」と依頼します。
この違いは重要です。紹介されている事例では、空のタグスラッグがキーの重複とハイドレーションの失敗を引き起こしていました。サーバーの応答は200でしたが、ブラウザーにはエラーページが表示されていました。そのため、HTTPだけの確認では不具合を見逃していたはずです。この事例では、不正なタグデータの修正とタグ生成のバグへの対処が提案されています。
アーキテクチャの作業で設計をレビューしたい場合は、いったん停止するよう依頼してください。ドキュメント上、architect は既定で実装まで進みます。具体的には、「キャッシュ設計をレビューしてください。実装前に公開関数と状態の表現を示し、私のレビューを待ってください」と指示します。
証拠とレビューの助言を確認する#
「Prove It Works」は、コンパイルの成功やエージェントの完了報告を受け入れるだけでなく、実際の結果を確認することを求めます。バグ修正では、元の失敗した操作を繰り返します。回帰テストは元の動作では失敗し、修正後に成功する必要があります。もともと成功していたテストでは、バグが直ったことを示せません。
検証方法は不具合に合わせます。ブラウザーの描画問題にはブラウザーでの確認が必要で、本番環境特有のデータアクセスには、その条件を再現した設定が必要です。再利用可能な検証スクリプトは、こうした確認を繰り返し行うのに役立ちます。
interrogate スキルは、複数のモデルによるレビューをまとめ、指摘を対応、検討、記録、却下に分類します。すべての提案を自動的に適用するわけではありません。モデル間の一致は検討すべき証拠であり、各指摘は引き続きコードと要件に照らして確認する必要があります。
次のステップ#
再現可能なバグを1つ選び、失敗する操作、環境、修正を実証する具体的な動作を指定して、/poteto-mode を実行してください。
出典: https://azukiazusa.dev/blog/pstack-agent-skills/
目次
