using-pythia

pythia の使い方 — ポケットハンドブック

フェーズ： 学ぶ → 尋ねる → 実行する — このページが適切なものへ案内します

pythia はメインの書籍であり、この小冊子はその表紙に挟まれています。 その役割は一貫性を保つことです。セッションで適切な質問をするかどうかが、その日のエージェントの気分に左右されてはいけません。

ルール

pythia のスキルが当てはまる可能性が少しでもあれば、行動する前に開いてください。回答する前、調べる前、確認の質問をする前です。 違うスキルを開いてしまいましたか？ 閉じればよく、問題ありません。確認を省くとセッションの進め方にばらつきが生じ、一部では質問し、別のセッションでは何も言わずに決めてしまいます。

開発者の発言に応じたルート

リクエストの内容	最初に開くもの	次に行うこと
「X を作る／追加する／変更する」— 何らかの決定が未確定	pythia-spec — 質問は必須です。仕様書／計画書の作成は提案されますが、省略できます	影響調査 → 作成 → 適用
「X を説明して／なぜ／どのように動くのか」	pythia-explore
「X に手を加えても安全か」	pythia-impact
「テーブルを作る／列を追加する／列にコメントを付ける」（「tạo bảng」、「thêm cột」）	pythia-table	デプロイ
「パッケージ／プロシージャ／トリガーを書く」（「viết package」）	pythia-package	作成 → 適用
「このプロシージャを変更する」— 小さな編集で、仕様は確定済み	pythia-impact、続けて pythia-write	適用
「遅い／このクエリを最適化して」（「chậm」、「tối ưu」）	pythia-tune	テーブルまたは作成
「これをレビューして」	pythia-review
「これを反映／適用して」— 1 つのステートメント	pythia-apply
「このスクリプトを実行／リリースをデプロイして」（「chạy script DDL」）	pythia-deploy
「何も聞かずにすべて実行して」（「tự động hoàn toàn」）	pythia-autopilot — 範囲を定めた一時的な許可であり、白紙委任ではありません	まず仕様を確定
完了／修正済み／高速化したと言おうとしている	pythia-verify — まず証拠を確認
「チームの標準／このベースのスタイルを採用する」	pythia-conventions
「X のやり方をスキルにして」	pythia-skill-author
セットアップ、接続失敗、権限に関する警告、承認が届かない	pythia-setup（pythia doctor）
変更中のコードにコメントを書こうとしている	pythia-comment — 1 行に収めるか、別の場所に書いてください
調査する必要がある ORA-/PLS- エラー	pythia-explore（errors、src）	pythia-review

複数の項目が当てはまる場合の優先順位：構築よりプロセスを優先します。書く前に仕様を確定し、適用前に影響を調査し、「完了」と言う前に検証します。開いたスキルを「pythia-spec を使用します — …」のように伝え、開発者がどのページにいるか分かるようにしてください。セッション開始時の STATE 行には autopilot の許可が有効かどうかが示されます。書き込みに承認が必要か判断する前に確認してください。

他のパックと併用する

この小冊子は、ほかに何もインストールされていないことを前提とします。一般的なプロセスパック（ブレインストーミング、TDD、計画）がセッションで有効な場合は、一般的なプロセスはそちらに任せ、pythia の Oracle ゲートを維持してください。両者は組み合わせて使えます。他のパックがあるからといって pythia-spec を省略したり、pythia があるからといって他のパックを省略したりしてはいけません。

危険信号 — 「一部のセッションでは質問し、別のセッションでは質問しない」につながる考え

考え	実態
「このタスクは簡単だ」	簡単なタスクほど仕様の抜けが隠れています。パスワードを忘れたときのフローには、質問されなかった決定事項が 7 つありました。
「そのスキルに書いてあることは覚えている」	スキルは更新されます。最新のページを開いてください。
「まず少し見てみよう」	pythia-explore がまさに調べるためのスキルです。まずルートを選んでください。
「別のパックが質問してくれる」	そのパックが機能すれば問題ありません。機能しない場合は、pythia-spec が最低限の基準です。
「質問すると開発者の作業が止まる」	質問しなかった決定の代償のほうが、より大きな遅延を招きます。

このプラットフォームでスキルを使えない場合

pythia guide は契約全体を表示します。pythia guide --brief はこの小冊子の最初のページで、セッションの前置きに使える長さです。AGENTS.md に常時適用されるルールが記載されています。このハンドブックを利用するのに、スキル対応エージェントは必要ありません。

---

あらゆる行動の前に参照するルーターというパターンは、Jesse Vincent の Superpowers をこのキット向けにゼロから再構築したものです。