hasegama/pstack-claude

hasegama profile

Latest recorded source activity: October 4, 2026 at 12:15

SkillsMP catalog refreshed: October 17, 2026 at 00:09

skills collected: 43

GitHub stars: 0
GitHub forks: 0

Repository README

Repository README source: README.md

Read the source README

Expand full README

# pstack-claude [pstack](https://github.com/cursor/plugins/tree/799151d91b6e12ee7dbd09f708eec108d7de9b3b/pstack) の設計・実装・レビュー手順を、Claude のモデルで使うための非公式プラグイン。ラッパー40件・共通スキル34件・エージェント2件を提供する。pstack の手順・参照資料・補助スクリプトは、固定コミットの原文を無改変で同梱する。Claude 用の差分は [共通読み替え](plugins/pstack-claude/pstack/runtime.md) にまとめている。 ## ローカルの Claude Code ```sh claude plugin marketplace add hasegama/pstack-claude#v0.2.0 claude plugin install pstack-claude@hasegama-pstack ``` Claude Code を起動し、例えば次のように呼ぶ。 ```text /pstack-claude:how 対象のデータの流れを調べて /pstack-claude:architect この要件の型とモジュール構成を設計して /pstack-claude:arena この変更の実装案を比較して /pstack-claude:interrogate この差分の盲点をレビューして /pstack-claude:poteto-mode この機能を実装して ``` 原本が同梱されているので、Cursor のインストールは不要。モデルは親の Claude を継承し、比較は独立したコンテキストで実行する。複数社のモデルを比較する機能にはならない。 ## Claude クラウドクラウドではローカルやプロジェクト設定のプラグインが自動導入されないため、同じ配布物をプロジェクトのスキル・エージェントとして展開する。 [scripts/cloud-install.sh](scripts/cloud-install.sh) の内容を環境設定の **Setup script** へ貼り付ける。既定でリリースタグ `v0.2.0` を取得する。コミット単位で固定する場合は、環境変数 `PSTACK_CLAUDE_REF` にこのリポジトリの 40 桁のコミット SHA を指定する。 `WORKSPACE_ROOT` は対象リポジトリのルート。未設定なら `CLAUDE_PROJECT_DIR`、次に現在の Git ルートを使う。複数リポジトリのセッションなどで作業場所が親ディレクトリになる場合は `WORKSPACE_ROOT` を指定する。展開先は以下のとおり。 | 場所 | 内容 | | --- | --- | | `.claude/pstack-claude/` | 同じ配布物の原本・読み替え・起動処理 | | `.claude/skills/pstack-claude-*/` | クラウド用pstack入口40件 | | `.claude/skills/<name>/` | 共通スキル34件（deslop・control-cli・control-ui・AX・Matt Pocock・explainer・test-audit） | | `.claude/agents/pstack-claude-*.md` | クラウド用エージェント 2 件 | | `.claude/settings.json` | 既存設定を維持して `SessionStart` を追加 | | `.claude/pstack-claude-install.json` | 導入したファイルのハッシュ。更新時にローカルの変更を検出 | クラウドでは `/pstack-claude-architect` のように、区切りをハイフンにした名前で呼ぶ。読み替え内の内部呼び出しも同じ名前に変換する。初回導入とクラウドの起動・再開時には、次も実行する。 - `.gitmodules` から `apps/` 配下を列挙し、未取得のサブモジュールだけを初期化する。既存の checkout はリセットしない。 - `AGENTS_MD_GZ_B64`、`AGENTS_LOCAL_MD_GZ_B64`、`AGENTS_PROJECT_MD_GZ_B64` があれば gzip + base64 の UTF-8 指示ファイルを復元する。 - `CLAUDE_MD_GZ_B64` があれば `CLAUDE.md` を復元する。なければ既存の内容を維持して `AGENTS.md` への import を追加する。 private サブモジュールの取得は別途リポジトリへのアクセス権が必要。必要な場合は `SUBMODULE_GITHUB_TOKEN` を設定する。既存環境との互換用に `HMO_REPOS_TOKEN` も読める。トークンは Git の一時的なプロセス設定で渡し、URL・ログ・設定ファイルには保存しない。プラグイン本体のダウンロードにはトークンを使わない。環境には `python3`（3.9 以降）・`git`・`curl`・`tar` が必要。アプリ固有のビルドツール・パッケージ・MCPを導入するスクリプトではない。Linux クラウドでの iOS ビルドには対応しない。ネットワークは `codeload.github.com` への HTTPS アクセスを使い、GitHub API や Release assets を使わない。クラウドの起動・キャッシュ復元後のスキル読み込みは、利用する環境で確認する必要がある。[Claude のクラウド環境仕様](https://code.claude.com/docs/en/cloud-environments) ## 共通スキルの配置共通34件は [pstack-agents](https://github.com/hasegama/pstack-agents) と同じ取得SHA・内容を使う。Claudeではすべて `.claude/skills/` に直接配置し、`.agents/` は作らない。`deslop`・`control-cli`・`control-ui` はCursor専用ではないため、共通スキルとして `/deslop` などの名前で利用できる。プラグイン経由では `/pstack-claude:deslop` のように呼ぶ。公開スキルはライセンスとともに同梱する。YAMLメタデータの引用とホスト別の呼び出し設定を整え、本文は原文を保持する。対応する取得元は `plugins/pstack-claude/shared-skills.json`、ライセンスは同ディレクトリの `licenses/` を参照。 privateテンプレートを利用する場合は `DOTCONFIG_HUB_TOKEN`、`PSTACK_TEMPLATE_REPOSITORY`（owner/repository）、`PSTACK_TEMPLATE_SUBDIR` を設定する。6スキルとdeepsecの補助ファイルは利用者の環境で取得し、この公開リポジトリには含めない。 ## pstack のバージョンを揃える取得元と対応バージョンは [upstream.json](upstream.json) を正とする。初回版は pstack `0.14.4`、`cursor/plugins@799151d91b6e12ee7dbd09f708eec108d7de9b3b`。 Cursor 側のセットアップも、利用するこの配布物の `upstream.json` を読み、`revision` の SHA を取得する。ラッパーと pstack の組み合わせを固定できる。ラッパーのバージョンは `plugin.json`、対応する pstack の SHA は `upstream.json` が管理する。更新時は原本と `upstream.json`・`upstream-files.sha256` を更新し、ラッパーと [機能対応表](plugins/pstack-claude/pstack/capabilities.md) を確認する。検証後にプラグインのバージョンを上げ、新しいリリースタグを作る。公開済みタグは移動しない。 ## 検証 ```sh python3 scripts/validate.py python3 -m unittest discover -s tests -v claude plugin validate . claude plugin validate ./plugins/pstack-claude ``` 検証するのは配布物の構造・参照先・原本ハッシュと、展開・再実行・既存設定の維持・指示ファイル復元・サブモジュール追従。Claude のモデルによる全ワークフローの実行を保証するものではない。PR 監視や Cursor transcript 連携などの未移植部分は機能対応表を参照。未移植機能への遷移を制限するルールは追加していない。 ## ライセンスラッパーと導入処理は [MIT](LICENSE)。同梱原文のライセンスは [pstack](plugins/pstack-claude/upstream/pstack/LICENSE) と [cursor-team-kit](plugins/pstack-claude/upstream/cursor-team-kit/LICENSE) を維持する。Cursor や Anthropic が提供・保証するプラグインではない。

Loading the repository README…

Skills in this repository

classification pending

skill

occupation

description

updated

architect

unclassified

型・関数シグネチャ・モジュール構成を設計し、独立した複数案を比較してから実装する。/architect や、構造の判断を伴う実装に使う。

Source text: Japanese

2026-10-04

arena

unclassified

同じ課題に独立した複数候補を作り、評価して基準案に優れた部分を統合する。/arena や、設計・実装案の比較に使う。

Source text: Japanese

2026-10-04

blast-radius

unclassified

変更が差分の外に及ぼす影響を調べ、成立条件を実コードの実行で確認する。影響範囲や小さな差分の安全性をレビューするときに使う。

Source text: Japanese

2026-10-04

bro

unclassified

直前の説明を専門用語に頼らない平易な言葉で言い直す。/bro や、説明をわかりやすくしてほしいという依頼に使う。

Source text: Japanese

2026-10-04

control-cli

unclassified

既存のハーネスや PTY・tmux で CLI・TUI を操作し、表示と挙動を検証する。端末 UI の不具合再現や操作確認に使う。

Source text: Japanese

2026-10-04

control-ui

unclassified

既存のブラウザー・Playwright・CDP ハーネスで UI を操作し、表示と挙動を検証する。Web・Electron の不具合再現や操作確認に使う。

Source text: Japanese

2026-10-04

create-verification-skill

unclassified

アプリを利用者と同じ経路で検証するプロジェクト用スキルと機能マップを作る。/create-verification-skill や、検証手順をスキルにしたい依頼に使う。

Source text: Japanese

2026-10-04

deslop

unclassified

差分から不要なコメント、防御的なコード、型の回避などを見つけ、既存の書き方に合わせる。コミット前のコード整理に使う。

Source text: Japanese

2026-10-04

figure-it-out

unclassified

既存の手順で扱いきれない大きな変更について、検証できる単位と仮説検証の手順を組み立てる。/figure-it-out や、大規模な移行の設計・実装に使う。

Source text: Japanese

2026-10-04

how

unclassified

実コードから仕組み・処理の流れ・配置先・責務を説明する。どう動くか、どの層に置くか、変更前の構造理解を求める依頼に使う。設計意図の履歴調査は why を使う。

Source text: Japanese

2026-10-04

interrogate

unclassified

独立した複数の Claude レビュアーで同じ対象を批判的に検証し、盲点や反証をまとめる。/interrogate や、設計・コードを厳しくレビューする依頼に使う。

Source text: Japanese

2026-10-04

maintain-verification-skill

unclassified

既存の検証スキルと機能マップを実装・実動作と照合し、確認できた不整合を直す。/maintain-verification-skill や、検証手順の棚卸しに使う。

Source text: Japanese

2026-10-04

no-comments

unclassified

Comment Sicko にコメントの妥当性を調べさせ、採用した指摘を反映する。/no-comments や、コメントで補っている設計を見直す依頼に使う。

Source text: Japanese

2026-10-04

poteto-mode

unclassified

pstack の設計原則と作業手順を使い、調査・設計・実装・検証を進める。/poteto-mode、poteto の流儀で作業してほしいという依頼に使う。

Source text: Japanese

2026-10-04

principle-boundary-discipline

unclassified

検証やエラー処理を CLI・設定・ネットワークなどの境界へ集め、内部の型と純粋な処理を活かす。境界の設計時に使う。

Source text: Japanese

2026-10-04

principle-build-the-lever

unclassified

繰り返せるツール・スクリプトで変更や検証を実行する。手作業の反復が発生する編集・移行・分析に使う。

Source text: Japanese

2026-10-04

principle-encode-lessons-in-structure

unclassified

繰り返す注意事項を lint・型・メタデータ・実行時検査に落とし込む。同じ修正や指示が再発したときに使う。

Source text: Japanese

2026-10-04

principle-exhaust-the-design-space

unclassified

前例のない UI・設計判断で複数の試作を比べる。単一案に決める前に設計空間を探索するときに使う。

Source text: Japanese

2026-10-04

principle-experience-first

unclassified

機能の範囲や UX の判断を利用者の体験から決める。実装都合と体験の品質が競合するときに使う。

Source text: Japanese

2026-10-04

principle-fix-root-causes

unclassified

症状を再現して原因までたどり、根本を直す。不具合調査・修正で使う。

Source text: Japanese

2026-10-04

principle-foundational-thinking

unclassified

ロジックを書く前に型・データ構造・共有状態を決める。実装の土台や作業順を設計するときに使う。

Source text: Japanese

2026-10-04

principle-guard-the-context-window

unclassified

大量の出力やファイルを扱う作業で、主会話に残す要点と分担する調査を整理する。コンテキストの消費が大きいときに使う。

Source text: Japanese

2026-10-04

principle-laziness-protocol

unclassified

削除と必要最小限の変更で問題を解く。リファクタリングや抽象化・層の追加を判断するときに使う。

Source text: Japanese

2026-10-04

principle-make-operations-idempotent

unclassified

中断や再試行の後も同じ状態へ収束する処理を設計する。コマンド・初期化・処理ループを作るときに使う。

Source text: Japanese

2026-10-04

principle-migrate-callers-then-delete-legacy-apis

unclassified

新しい内部 API へ呼び出し側を移し、旧 API を同じ作業で取り除く。内部 API の移行に使う。

Source text: Japanese

2026-10-04

principle-minimize-reader-load

unclassified

処理を読むために追う層と覚える状態を減らす。追跡しにくいコードの設計・レビューに使う。

Source text: Japanese

2026-10-04

principle-model-the-domain

unclassified

分岐や状態の前提をデータ構造・状態機械・型で表現する。状態を持つ処理や重複した条件を設計するときに使う。

Source text: Japanese

2026-10-04

principle-never-block-on-the-human

unclassified

可逆的な作業を進めて具体的な結果を示す。作業を進めるか確認するかの判断に使い、ユーザーの依頼範囲に従う。

Source text: Japanese

2026-10-04

principle-outcome-oriented-execution

unclassified

移行の最終形へ収束する作業順を組み立てる。段階的な書き換えや移行で中間実装の要否を判断するときに使う。

Source text: Japanese

2026-10-04

principle-prove-it-works

unclassified

実物・実値・実行結果を確認して作業の完了を示す。完了報告前の検証に使う。

Source text: Japanese

2026-10-04

principle-redesign-from-first-principles

unclassified

新しい要件を最初から前提にした構造を考える。既存設計へ要件を統合するときに使う。

Source text: Japanese

2026-10-04

principle-separate-before-serializing-shared-state

unclassified

並列処理の共有書き込みを分離し、共有が本当に必要な部分だけ直列化する。同じファイル・ブランチ・状態への競合を設計するときに使う。

Source text: Japanese

2026-10-04

principle-sequence-verifiable-units

unclassified

各段階で結果を確かめられる単位に分割して順に進める。多段階の変更や移行を計画するときに使う。

Source text: Japanese

2026-10-04

principle-subtract-before-you-add

unclassified

不要なコードや参照を除去してから変更を加える。追加・リファクタリング・書き換えの作業順を決めるときに使う。

Source text: Japanese

2026-10-04

principle-type-system-discipline

unclassified

不正な状態を表しにくい型、境界のパース、網羅的な分岐を設計する。型付き言語の実装・シグネチャのレビューに使う。

Source text: Japanese

2026-10-04

show-me-your-work

unclassified

判断・理由・根拠・結果を追跡できる TSV の意思決定ログを残す。/show-me-your-work や、長い作業の判断を後からレビューしたい場合に使う。

Source text: Japanese

2026-10-04

swarm

unclassified

複数の Claude ワーカーで調査範囲を分担、または同じ課題を独立して試し、結果を集約する。/swarm や、並列調査・候補比較に使う。

Source text: Japanese

2026-10-04

tdd

unclassified

失敗するテストから修正を進める。TDD・失敗テスト・回帰テストを明示的に依頼された場合、または不具合に安価で明確なローカルテストがある場合に使う。

Source text: Japanese

2026-10-04

teach

unclassified

how と why の調査をつなぎ、変更や仕組みを理解できる説明にまとめる。/teach や、変更・サブシステムをきちんと理解したい依頼に使う。

Source text: Japanese

2026-10-04

technical-writing

unclassified

技術文書の構造と文章を整える。文書、RFC、README、PR 説明、コミットメッセージの作成・レビューに使う。

Source text: Japanese

2026-10-04

Showing 40 of 43 collected skills.

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/hasegama/pstack-claude.