michael-denyer/pstack-claude

pstack‑claude – マルチランタイム エージェントスキル プラグイン

概要

• pstack プラグイン（元々は Cursor の Claude Code 用に書かれた）の移植版で、54 個の再利用可能な Agent Skills を同梱しています。
• スキルは Claude Code 用に書かれていますが、共有の ~/.agents/skills/ ディレクトリを介して Codex、Prime Agent、opencode、Gemini‑CLI ランタイムでも利用できます。
• リポジトリには、プラグインマニフェスト、完全なスキルツリー、Codex 用の生成済みコマンドスタブ、およびスキルセットを上流の Cursor バージョンと同期させるためのツールが含まれています。

重要性

• セッション開始時に短い指示を注入する、すぐに使える「poteto‑mode」ワークフローを提供し、その後、高レベルのエンジニアリングヘルパー（TDD、コードレビュー、PR 自動化、CI 修正など）を提供します。
• 同じスキル定義を複数の AI コーディングエージェントに公開することで、ユーザーはプロンプトを書き直すことなく、Claude Code、Codex、Prime Agent、opencode、Gemini‑CLI を切り替えることができます。
• すべてのコードは MIT ライセンスで、元の Cursor プラグインからの適応に関する徹底的な監査（CHANGES.md、NOTICE.md）が含まれています。

インストール

• Claude Code – マーケットプレイスのエントリを追加し、プラグインをインストールします：

  /plugin marketplace add michael-denyer/pstack-claude
  /plugin install pstack@pstack-claude
  

  プラグインはセッション開始時に自動的に起動します（poteto‑mode の指示を注入）。フックは hooks/hooks.json を削除することで無効にできます。
• 共有スキルのインストール – リポジトリをクローンし、各スキルを ~/.agents/skills/ にシンボリックリンクします：

  git clone https://github.com/michael-denyer/pstack-claude
  cd pstack-claude
  mkdir -p ~/.agents/skills
  for s in plugins/pstack/skills/*/; do ln -s "$PWD/$s" ~/.agents/skills/$(basename "$s"); done
  

  この単一のツリーは、Codex、Prime Agent、opencode、Gemini‑CLI によって検出されます。
• Codex のみ – 共有インストール後、生成されたスラッシュコマンドスタブを ~/.codex/prompts/ にリンクし、~/.codex/config.toml でマルチエージェントサポートを有効にします。
• Gemini‑CLI / opencode / Prime Agent – 同じシンボリックリンクされたスキルディレクトリが機能します。ランタイムのスキルキャッシュをリロードするだけです。

主な機能（厳選スキル）

スキル	目的
poteto-mode	最初のモデル応答の前に、非自明なエンジニアリングリクエストを構造化されたワークフローにルーティングする短い「指示」を設定します。
tdd	テスト駆動開発ヘルパー。テストをスキャフォールドし、実行し、修正を提案します。
fix-ci	CI 障害を分析し、パッチを提案します。
fix-merge-conflicts	マージ競合を自動的に検出して解決します。
make-pr-easy-to-review	簡潔な PR サマリーとチェックリストを生成します。
get-pr-comments	既存の PR ディスカッションをセッションに取り込んでコンテキストを提供します。
what-did-i-get-done	最近の作業を要約して、簡単なステータス更新を提供します。
deslop	コードスタイルの lint とクリーンアップを実行します。
thermo-nuclear-code-quality-review	隠れたバグを表面化する深い静的解析パス。

ランタイム固有の注意事項

• Claude Code – プラグインには、poteto‑mode の指示を自動的に起動する SessionStart フックが同梱されています。フックは plugins/pstack/hooks/ にあり、手動アクティベーションを希望する場合は削除できます。
• Codex – フックシステムがないため、pstack:poteto-mode を明示的に呼び出すか、~/.codex/AGENTS.md に永続的な指示を追加する必要があります。スラッシュコマンドショートカット（/tdd、/fix-ci、…）は、生成された Markdown プロンプトを介して提供されます。
• Prime Agent – 同じディレクトリからスキルを検出します。user-invocable: false フラグを無視するため、内部の「principle‑*」リーフは UI に表示されませんが、poteto-mode からは読み取れます。
• opencode – 54 個のスキルすべてを公開として扱います。principle‑* リーフはピッカーに表示されますが、無害です。
• Gemini‑CLI – ~/.gemini/skills/（または互換エイリアス）を介してスキルをロードします。activate_skill ツールを使用して poteto-mode または他のスキルを実行します。

開発と CI

• CI パイプライン（ci.yml、security.yml）は、生成ファイルを再生成し、コードを lint し（Bun、shell、Markdown）、スキル衝突テストを実行し、osv‑scanner と zizmor で依存関係をスキャンします。
• リポジトリには、スキルツリーを上流の Cursor バージョン（e8d856f）と同期させるヘルパースクリプト（tools/generate.mjs、tools/validate-skills.mjs、tools/sync.mjs）が含まれています。
• VERSION ファイルはプラグインバージョンの単一の情報源です。マニフェストは生成中にそこからスタンプされます。

依存関係

• plugin.json にはランタイムレベルの依存関係は宣言されていません。唯一のオプションのコンパニオンプラグインは plugin‑dev（公式の Claude‑plugins マーケットプレイスから）で、スキル作成ワークフローを改善します。
• 一部のプレイブックで必要なシステムレベルのツール：gh（GitHub CLI）、bun（バンドルスクリプト用）、jq と rg（監査スクリプト用）。対応するプレイブックを実行しない限り、これらはオプションです。

ライセンス

• コアプラグインと同梱のすべてのスキルは MIT ライセンスでリリースされています（LICENSE と LICENSE‑cursor‑team‑kit を参照）。帰属の詳細は NOTICE.md にあります。

結論 pstack‑claude は、十分に文書化され、CI テスト済みのマルチランタイムプラグインで、Claude Code とその互換エージェントに豊富なエンジニアリング自動化スキルをもたらします。サポートされている AI コーディングアシスタントのいずれかを使用している場合、このリポジトリをインストールすると、コード品質、PR 処理、CI デバッグなどのためのすぐに使えるツールボックスが得られ、基礎となるプロンプトを自分で書く必要はありません。