Codex CLI での PSM 使い方ガイド

セットアップがまだの場合は先に Codex CLI のセットアップ を完了してください。

---

ツールの呼び出し（自動）

PSM のツールは Codex が必要と判断したときに自動で呼び出します。明示的に指定する必要はありません。

コードの複雑度を分析して改善提案してください

→ Codex が analyze_complexity ツールを自動呼び出し

TypeScript のコードレビューチェックリストを作って

→ Codex が review_checklist ツールを自動呼び出し

GitHub Actions のワークフローを生成して

→ Codex が generate_github_actions ツールを自動呼び出し

TIP

AGENTS.md が配置されているプロジェクトでは「PSM を使って〜」と明示しなくても、Codex が状況に応じて PSM ツールを呼び出します。

---

プロンプトの呼び出し

PSM のプロンプトは、プロンプト名を自然言語で指定して呼び出します。

基本の構文

PSM の <プロンプト名> プロンプトを使って、<やりたいこと>

例

PSM の tech_selection_matrix プロンプトを使って、React と Vue を比較してほしい

PSM の requirements_analyzer プロンプトを使って、このアイデアを要件定義に落としてほしい

PSM の code_review_framework プロンプトを使って、このPRをレビューして

PSM の issue_driven_start プロンプトを使って、このバグ修正を進めたい

---

psm コマンド（番号選択ショートカット）

Claude Code の /psm に近い体験を実現するシェル関数です。psm と打つとプロンプト一覧が表示され、番号を選ぶと Codex が起動します。

設定方法

Windows（PowerShell）

PowerShell プロファイルを開きます。

notepad $PROFILE

以下の関数を貼り付けて保存します。

function psm {
    $prompts = @(
        @{ id="S.0"; name="check_project_setup";        desc="初回セットアップ確認" },
        @{ id="S.1"; name="help";                       desc="全プロンプト一覧表示" },
        @{ id="0.0"; name="project_start";              desc="新規プロジェクト開始ガイド" },
        @{ id="0.1"; name="product_discovery";          desc="アクター定義・VPC・ユーザーストーリー" },
        @{ id="0.2"; name="feature_design";             desc="機能設計" },
        @{ id="0.3"; name="screen_design_brief";        desc="画面設計指示書" },
        @{ id="1.0"; name="requirements_analyzer";      desc="要件定義" },
        @{ id="1.1"; name="estimate_proposal";          desc="見積書生成" },
        @{ id="2.0"; name="tech_selection_matrix";      desc="技術選定マトリクス" },
        @{ id="2.1"; name="architecture_decision_record"; desc="ADR作成" },
        @{ id="2.2"; name="module_boundary_design";     desc="モジュール境界設計" },
        @{ id="2.3"; name="api_design_review";          desc="API設計レビュー" },
        @{ id="3.0"; name="infra_design";               desc="インフラ設計ナビゲーター 🚧" },
        @{ id="3.1"; name="aws_architecture";           desc="AWS構成設計 🚧" },
        @{ id="3.2"; name="gcp_architecture";           desc="GCP構成設計 🚧" },
        @{ id="3.3"; name="azure_architecture";         desc="Azure構成設計 🚧" },
        @{ id="3.4"; name="infra_cost_estimate";        desc="クラウドコスト見積もり 🚧" },
        @{ id="3.5"; name="security_hardening";         desc="セキュリティ強化チェック 🚧" },
        @{ id="4.0"; name="task_breakdown";             desc="タスク分解" },
        @{ id="5.0"; name="project_builder";            desc="実装ガイド" },
        @{ id="5.3"; name="pr_description_template";   desc="PR説明文テンプレート" },
        @{ id="6.0"; name="code_review_framework";     desc="コードレビュー統合フレームワーク" },
        @{ id="6.1"; name="refactoring_strategy";      desc="リファクタリング戦略" },
        @{ id="6.2"; name="incident_postmortem";        desc="ポストモーテム" },
        @{ id="I.0"; name="issue_driven_start";         desc="Issue-Driven開発オーケストレーター" },
        @{ id="I.1"; name="issue_instruction_generator"; desc="バグ修正用指示書生成" }
    )

    Write-Host ""
    Write-Host "=== Prime Style MCP (PSM) ===" -ForegroundColor Cyan
    Write-Host ""
    for ($i = 0; $i -lt $prompts.Count; $i++) {
        $p = $prompts[$i]
        Write-Host ("  [{0,2}] {1,-6}  {2,-40} {3}" -f $i, $p.id, $p.name, $p.desc)
    }
    Write-Host ""

    $sel = Read-Host "番号を選択（Enter でキャンセル）"
    if ([string]::IsNullOrWhiteSpace($sel)) { return }

    $idx = [int]$sel
    if ($idx -lt 0 -or $idx -ge $prompts.Count) {
        Write-Host "無効な番号です" -ForegroundColor Red
        return
    }

    $selected = $prompts[$idx]
    $extra = Read-Host "追加の指示（省略可）"

    $text = "PSM の $($selected.name) プロンプトを使って"
    if (-not [string]::IsNullOrWhiteSpace($extra)) {
        $text += "、$extra"
    }

    codex $text
}

新しいターミナルを開くか、以下で即時反映します。

. $PROFILE

Mac / Linux（zsh / bash）

.zshrc または .bashrc に以下を追記します。

psm() {
  local -a names=( check_project_setup help project_start product_discovery feature_design
    screen_design_brief requirements_analyzer estimate_proposal tech_selection_matrix
    architecture_decision_record module_boundary_design api_design_review
    "infra_design 🚧" "aws_architecture 🚧" "gcp_architecture 🚧" "azure_architecture 🚧"
    "infra_cost_estimate 🚧" "security_hardening 🚧"
    task_breakdown project_builder pr_description_template
    code_review_framework refactoring_strategy incident_postmortem
    issue_driven_start issue_instruction_generator )

  echo ""
  echo "=== Prime Style MCP (PSM) ==="
  echo ""
  for i in "${!names[@]}"; do
    printf "  [%2d] %s\n" "$i" "${names[$i]}"
  done
  echo ""

  read -p "番号を選択（Enter でキャンセル）: " sel
  [[ -z "$sel" ]] && return

  local name="${names[$sel]%% *}"
  read -p "追加の指示（省略可）: " extra

  local text="PSM の ${name} プロンプトを使って"
  [[ -n "$extra" ]] && text="${text}、${extra}"

  codex "$text"
}

使い方

$ psm

=== Prime Style MCP (PSM) ===

  [ 0] S.0   check_project_setup                初回セットアップ確認
  [ 1] S.1   help                               全プロンプト一覧表示
  [ 2] 0.0   project_start                      新規プロジェクト開始ガイド
  [ 3] 0.1   product_discovery                  アクター定義・VPC・ユーザーストーリー
  ...

番号を選択（Enter でキャンセル）: 8
追加の指示（省略可）: React と Vue を比較して

→ codex "PSM の tech_selection_matrix プロンプトを使って、React と Vue を比較して"

---

Claude との違い

操作	Claude Code	Codex CLI
プロンプト選択	/psm → 一覧UI → 選択	psm コマンド → 番号入力
プロンプト直接呼び出し	/mcp__psm__tech_selection_matrix	PSM の tech_selection_matrix プロンプトを使って
ツール呼び出し	自動（Claude が判断）	自動（Codex が判断）
コンテキストファイル	CLAUDE.md	AGENTS.md

---

次のステップ

• Claude Code での PSM 使い方
• プロジェクト知識の管理