feat(claude): add pm-codex skill

Introduce SKILL.md detailing the pm-codex skill, which delegates implementation tasks to Codex while acting as a product manager. The document outlines arguments, prerequisites, principles, and execution settings.

Add workflow.md to describe the detailed workflow for using the pm-codex skill, including phases from preflight checks to completion verification.

Author: peinan

src/.claude/skills/pm-codex/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: pm-codex
+description: |
+  プロダクトマネージャーとして振る舞い、Codex に実装を委譲するスキル。
+  タスク記述または GitHub Issue 番号を受け取り、プラン作成 → Issue 分割 →
+  Codex 並列実行 → コミット管理を行う。自分では一切コードを書かない。
+  使用例: /pm-codex "認証機能のリファクタリング", /pm-codex 42
+---
+
+# pm-codex
+
+プロダクトマネージャーとして振る舞い、すべての実装を Codex に委譲するオーケストレーションスキル。
+
+## 引数
+
+```
+/pm-codex <タスク記述 | Issue番号>
+```
+
+- 数値 → GitHub Issue 番号として解釈
+- それ以外 → フリーテキストのタスク記述として解釈
+
+## 前提条件
+
+| ツール | 確認コマンド |
+|--------|-------------|
+| `gh` CLI（認証済み） | `gh auth status` |
+| `codex` CLI | `codex --version` |
+| `gh sub-issue` extension | `gh sub-issue --help` |
+
+## 原則
+
+- **PM 専任**: Claude はコードを一切書かない。すべて Codex に委譲する
+- **Human-in-the-loop**: プラン承認後に実行。承認なしに Phase 5 に進まない
+- **Git 責務分離**: Codex は commit/push/branch 操作を行わない。Git 操作は Claude が担当
+- **進捗報告**: 変更や進捗がある都度、該当 Issue に `gh issue comment` でアップデート
+- **実行単位**: sub-issue = branch = worktree = 1 Codex session
+- **タスク管理**: TASKS.md は作成不要。GitHub Issues がタスクマネージャー
+
+## Codex 実行設定
+
+共通フラグ:
+
+```bash
+-m gpt-5.4 --config model_reasoning_effort="high" --skip-git-repo-check --full-auto
+```
+
+| 用途 | sandbox | 追加フラグ |
+|------|---------|-----------|
+| レビュー | `--sandbox read-only` | — |
+| 実装 | `--sandbox workspace-write` | `-C <worktree-path>` |
+
+ログ: `2>> .claude/logs/codex-<issue番号>.log`
+
+## ワークフロー概要
+
+| Phase | 概要 |
+|-------|------|
+| 0: Preflight | 前提条件・clean worktree・GitHub repo 確認 |
+| 1: タスク理解 | Issue 取得 or フリーテキスト分析。成功基準の明確化 |
+| 2: プラン作成 | コードベース調査 → タスク分割 → Codex レビュー → ユーザー承認 |
+| 3: プランコミット | `.claude/plans/` にコミット。commit SHA を記録 |
+| 4: Issue 分割 | 親 Issue + sub-issue 作成。固定テンプレート使用 |
+| 5: Codex 実行 | worktree 隔離で並列実行。完了後コミット (`fix #<issue>`) |
+| 6: 完了確認 | 検証 → sub-issue クローズ → `/create-pr` 提案 |
+
+詳細は [references/workflow.md](references/workflow.md) を参照。
+
+## 注意事項
+
+- `codex exec` を使用すること。MCP 経由の Codex はハングすることがあるため使用しない
+- 中断復帰時は既存の親 Issue / sub-issue を確認し、重複作成しない
+- sub-issue を close するのは検証完了後。全体テスト前に close しない
+- PR body にも closing keyword (`fix #<issue>`) を含め、squash merge 時の取りこぼしを防ぐ

src/.claude/skills/pm-codex/references/workflow.md

@@ -0,0 +1,234 @@
+# pm-codex ワークフロー詳細
+
+## Phase 0: Preflight
+
+以下を並列で確認し、失敗があれば中止して案内する:
+
+```bash
+gh auth status
+codex --version
+gh sub-issue --help
+git status --porcelain
+gh repo view --json nameWithOwner --jq '.nameWithOwner'
+```
+
+確認事項:
+- worktree が clean であること（未コミット変更がある場合は警告しユーザーに確認）
+- `.claude/plans/` ディレクトリが存在すること（なければ作成）
+- `.claude/logs/` ディレクトリが存在すること（なければ作成）
+
+## Phase 1: タスク理解
+
+### Issue 番号の場合
+
+```bash
+gh issue view <番号> --json title,body,labels,comments,assignees,state
+```
+
+- Issue が closed の場合は警告
+- Issue の内容から成功基準を抽出
+
+### フリーテキストの場合
+
+- タスク記述を分析
+- 成功基準を明確化
+- 親 Issue を作成:
+
+```bash
+gh issue create --title "<タスクタイトル>" --body "<タスク詳細と成功基準>"
+```
+
+### 中断復帰チェック
+
+既存の親 Issue に紐づく sub-issue がないか確認:
+
+```bash
+gh sub-issue list <親Issue番号>
+```
+
+既存の sub-issue がある場合は状態を確認し、未完了分から再開する。
+
+## Phase 2: プラン作成
+
+### 2-1: コードベース調査
+
+Explore エージェントを使用して関連ファイル・パターンを特定する。
+
+### 2-2: プラン策定
+
+1. 解決アプローチの候補を列挙
+2. 各アプローチの tradeoff を分析
+3. 推奨アプローチを選択
+4. タスクを Codex が 1 セッションで完結するサイズに分割
+5. 依存関係と並列実行性を整理
+6. テスト計画を明記
+
+### 2-3: Codex レビュー
+
+プランを Codex に送り、致命的な欠陥がないかレビューさせる:
+
+```bash
+echo "<プラン全文>" | codex exec \
+  --skip-git-repo-check \
+  -m gpt-5.4 \
+  --config model_reasoning_effort="high" \
+  --sandbox read-only \
+  --full-auto \
+  2>> .claude/logs/codex-review.log
+```
+
+レビュー結果を反映し、必要に応じて修正。
+
+### 2-4: ユーザー承認
+
+プランを提示し、承認を待つ。**承認されるまで Phase 3 に進まない。**
+
+## Phase 3: プランコミット
+
+```bash
+git add .claude/plans/<slug>.md
+git commit -m "docs(plan): <タスクサマリ>"
+```
+
+commit SHA を記録し、以降の Issue に含める。
+
+## Phase 4: Issue 分割
+
+### 親 Issue の準備
+
+Phase 1 で作成済み、または既存の Issue を使用。
+
+### sub-issue 作成
+
+各タスクを以下のテンプレートで sub-issue として登録:
+
+```bash
+gh sub-issue create --parent <親Issue番号> --title "タスクN: <タイトル>" --body "$(cat <<'EOF'
+## 概要
+<タスクの説明>
+
+## 背景
+<なぜ必要か>
+
+## 対象範囲
+- <変更するファイル/モジュール>
+
+## 非対象
+- <触らないもの>
+
+## 完了条件
+- [ ] <具体的な条件>
+
+## 検証コマンド
+```bash
+<検証コマンド>
+```
+
+## 期待出力
+<期待される結果>
+
+## ブロック時
+<依存タスクが未完了の場合の対応>
+
+## プラン
+<plan の commit SHA / permalink>
+EOF
+)"
+```
+
+依存関係がある場合は Issue body の「ブロック時」セクションに明記する。
+
+## Phase 5: Codex 実行
+
+### 5-1: worktree 作成
+
+sub-issue ごとに専用 worktree を作成:
+
+```bash
+git worktree add .worktrees/issue-<番号> -b issue-<番号>/task
+```
+
+### 5-2: Codex 実行
+
+Issue body を元に Codex プロンプトを構成し実行:
+
+```bash
+echo "<wrapper prompt + issue body>" | codex exec \
+  --skip-git-repo-check \
+  -m gpt-5.4 \
+  --config model_reasoning_effort="high" \
+  --sandbox workspace-write \
+  --full-auto \
+  -C .worktrees/issue-<番号> \
+  2>> .claude/logs/codex-<番号>.log
+```
+
+**並列実行**: 依存関係のない sub-issue は複数の Bash tool call で同時に実行する。
+**順次実行**: 依存関係がある sub-issue は前のタスク完了後に実行する。
+
+### 5-3: 変更のマージとコミット
+
+Codex 完了後:
+
+1. worktree の変更を確認
+2. 変更をメインブランチにマージ:
+
+```bash
+cd .worktrees/issue-<番号>
+git add -A
+git stash
+cd -
+git stash pop
+git add <変更ファイル>
+git commit -m "<type>(<scope>): <description> (fix #<issue番号>)"
+```
+
+3. worktree を削除:
+
+```bash
+git worktree remove .worktrees/issue-<番号>
+```
+
+### 5-4: 進捗報告
+
+各タスク完了後、Issue にコメントを追加:
+
+```bash
+gh issue comment <番号> --body "実装完了。コミット: <SHA>"
+```
+
+問題が発生した場合も Issue にコメントして報告する。
+
+## Phase 6: 完了確認
+
+### 6-1: 全 sub-issue の検証
+
+各 sub-issue の検証コマンドを実行し、期待出力と一致するか確認する。
+検証完了した sub-issue をクローズ:
+
+```bash
+gh issue close <番号> --comment "検証完了"
+```
+
+### 6-2: 全体テスト
+
+プロジェクトのテストスイートを実行（存在する場合）。
+
+### 6-3: サマリ報告
+
+完了した全タスクのサマリをユーザーに報告する。
+
+### 6-4: PR 提案
+
+feature ブランチ上にいる場合、`/create-pr` を提案する。
+PR body には全 sub-issue の closing keyword を含める:
+
+```markdown
+## Summary
+- ...
+
+Fixes #<親Issue番号>
+- fix #<sub-issue-1>
+- fix #<sub-issue-2>
+- ...
+```