astro:help — アストロ・パイプラインの使い方
astro: パイプラインは、契約書からPR/納品までをAIで開発するためのスキル群です。コード実行前に安全ルールを強制するゲート（ガード）を備えています。各スキルは1つのフェーズです。順番に使用してくださいが、必要なものだけを呼び出して構いません。
パイプライン概要
| フェーズ | コマンド | 使用タイミング |
|---|---|---|
| 0 · 契約 | astro:setup | プロジェクトの開始/再開時、コードを書く前に。 |
| 1 · 計画 | astro:plan | 変更内容を説明し、実装前に計画が欲しいとき。 |
| 2 · 実行 | astro:exec | 計画全体を1タスクずつ実行します。 |
| 3 · 完了 | astro:commit | 論理的な変更に対してコミットメッセージを生成しコミットします。 |
| 3 · 完了 | astro:pr | プルリクエストの説明文を作成します。 |
| 3 · 完了 | astro:answer | QA/PO向けのタスク納品テキスト（ローカルファイル）を生成します。 |
| ゲート | astro:gate | ブラウザでゲートルールエディタを開きます。 |
| ヘルプ | astro:help | このガイド。 |
典型的なフロー
astro:setup（プロジェクトにつき1回）—CLAUDE.mdに契約を確立（セーフガード＋パターン）、スタックを検出し、Laravel の場合はアーキテクチャをダウンロードし、ドメインごとにAGENTS.mdを保証します。ゲートをインストールします。ミニアプリai-gate/（SQLite）が.claude/hooks/astro_gate.pyを生成し、禁止コマンドをブロックするフックを登録します。astro:plan— 変更内容を説明すると、状況を把握し、あなたの判断に委ねるべきことだけを質問し（AskUserQuestion）、計画を提案します。承諾後、セッション内のタスクに分解します（プロジェクトにファイルは作成しません）。astro:exec— 計画を1タスクずつ実行し、スコープのみを実装し、契約とアーキテクチャに従い、実際のテスト（実際の出力）を行います。astro:commit—TIPO: タイトル+ 変更リスト（日本語、過去分詞）の形式のメッセージ。論理的な変更ごとに1コミット。- 完了:
astro:pr（PRの説明）および/またはastro:answer（QA/PO向け納品テキスト、コミットされないローカルファイルに保存）。
ゲート（コードによる保証）
プロンプトは方向づけをし、ゲートは保証します。すべてのコマンド実行が検査され、禁止テキスト（migrate:fresh、rm -rf、git push --force、truncate…）が含まれている場合はブロックされます。ルールは編集可能です。
astro:gate（またはpython3 ai-gate/app.py）でUI（http://127.0.0.1:8787）が開き、ルールの追加/編集/無効化ができます。「ゲートを生成」をクリックすると.claude/hooks/astro_gate.pyが再生成されます。- 生成されたゲートはスタンドアロンで動作します — VM/CI でもCLIとして実行可能：
python3 astro_gate.py "$CMD" && eval "$CMD"。
全フェーズで有効な原則
- あなたの判断事項のみを質問せよ。それ以外は決定せよ（安全なデフォルト値を使い、仮定を通知すること）。
- ソースを確認し、捏造するな — API/ルート/カラム/バージョンを勝手に作らない。
- 小さくレビュー可能な変更、テストを伴うこと、実際のエビデンス、主張ではない。
- 破壊的操作なし、秘密なし、依存関係を上げない — そしてゲートがこれを強化する。