AI が「できました」と言う前に、自分で試させよう
pstack は、AI に入れて使う無料・オープンソースの「仕事のルール」です。入れると AI は、まずあなたが何をしたいのかを確かめ、それから直す必要のあるところだけを直します。コードが書けなくても大丈夫。
入門コースは 3 レッスン、20 分です。
こんな経験、ありませんか?
- AI が「できました!」と言う。開いてみると、ボタンを押しても何も起きない。
- 「まだ動かない」と言うと「すみません、直しました」。でも結果は同じ。それが何度も続く。
- ちょっと直してほしかっただけなのに、頼んでいないところまでたくさん変えられた。
入れると何が変わる?
| 場面 | いつもの AI | pstack を入れた AI |
|---|---|---|
| 始める前 | 何をしたいか確かめずに始める | まずあなたの目的を自分の言葉で言い直すので、違っていたらすぐ直せる |
| 直している間 | それっぽい場所をとりあえず変える | まず問題をつきとめ、変えるのはできるだけ少なく |
| 「できました」と言うとき | 「たぶん大丈夫です」 | 実際に何を確かめて何が見えたかを並べ、確かめられなかったことははっきり言う |
はじめての方は 3 レッスンだけ
順番に読んで、全部で 20 分。この 3 つを終えれば使えます。サイトのほかのページは、あとで必要になったときに調べるためのものです。
- 何をしてくれるの?3 分 · pstack とは何か、必要なもの、かかるコスト
- 入れてみよう5 分 · Claude Code に 2 行入力して、1 つ選ぶだけ
- はじめて使ってみよう10 分 · 3 つのパートでできたメッセージ 1 つで、小さなページを作る
あなたに向いている?
向いているのは
- AI で小さなページや拡張機能、ツールを作ったことがあり、「できました」なのに動かなくて困ったことがある
- Claude Code(または Cursor、Codex)をもう持っていて、その中で AI とチャットできる
- 速さより、ちゃんと動くことを大事にしたい
まだ早いのは
- Claude Code のようなツールをまだ使ったことがない:まず公式ガイドで入れて、チャットできるようになったら戻ってきてください
- 誤字や色の変更のような小さな直し:AI にそのまま頼めば十分です
- とにかく速く安く済ませたい:pstack は確認が多いぶん時間がかかり、プランの利用枠も多めに使います
コードを書く方へ
pstack は、poteto(React コアチームのメンバーで、Cursor 勤務)が毎日自分のコードに使っているスキルのセットです。スキル 34 個、プレイブック 23 個、エンジニアリングの原則 24 個。下は、どの作業でも通る 4 つのステップと、9 ステップの完全ガイドです。
完全ガイドは今のところ英語(と中国語)だけです。
ひとこと伝える
目的と、どうなったら完了か。たとえば「まず再現して、直して、確かめて」。
/pstack:poteto-mode がプレイブックを選ぶ
23 のプレイブックから 1 つ選び、その手順をそのまま ToDo リストに写します。
スキルが一歩ずつ動く
/pstack:how でコードを読み、/pstack:architect で設計を決め、/pstack:interrogate で穴を探す。作業が多いときはヘルパーの AI も使います。
渡す前に確かめる
実際のコマンド出力、スクリーンショット、変更前と変更後。確かめられないことは、そう伝えます。
- What pstack is5-minute read · What it's for, what it costs, what you need
- Install pstack5 minutes · One way each for Claude Code, Cursor and Codex
- Pick models and budget (optional)10 minutes · Works without it; read this to save money or switch models
- Your first task15 minutes · Say it in one message, then check its restatement and results
- Understand before you change15 minutes · Have the AI explain how the code works before deciding to change it
- Design, build, clean up20 minutes · Settle the plan for big changes, have other models pick holes, cut what isn't needed
- Verify and ship20 minutes · Make sure it really works, then hand it in for merging
- Let it run on its own15 minutes · Brief it before bed, read its log in the morning
- Once you're comfortableAs needed · Pull it back in one line; stop the same mistake from happening twice
質問と話し合い
This airali copy is based on the original open-source guide. Visit the source repository for its history and updates.
質問する前によくある質問(英語)も見てみてください。多くの答えはそこにあります。
スクリーンショットを送る前に、API キー、会社のコード、アカウント情報は隠してください。