refactor: 外部 AI 委譲の Skill を external-ai へ統合 (0-3)

AGENTS.md

@@ -78,7 +78,7 @@ ai-plugins/
 - Claude Code版は 8個の専門サブエージェント、公開Skills、SessionStart/Stopフックを提供
 - Codex版は Codex向け公開Skillsと任意Slack通知hookを提供
 - Kiro版は installer で `.kiro/skills/` と `.kiro/agents/default.json` を生成
-- 外部AI委譲は `/ndf:codex` skill と `corder` エージェント経由で Codex CLI を呼び出し（v4.0.0 で Codex MCP サーバは廃止）
+- 外部AI委譲は `/ndf:external-ai` skill と `corder` エージェント経由で Codex / Gemini CLI を呼び出し（v4.0.0 で Codex MCP サーバは廃止）
 
 詳細は各 runtime README と `docs/ndf-plugin-reference.md` を参照。
 

KIRO.md

@@ -9,7 +9,7 @@
 ### 前提条件
 - Kiro CLI がインストール済み
 - Node.js（Slack通知を使う場合）
-- Codex CLI（`/ndf:codex` skill で外部AI委譲を使う場合、または `--with-codex` で Kiro に Codex MCP サーバ設定を生成する場合）: `npm install -g @openai/codex`
+- Codex CLI（`/ndf:external-ai` skill で外部AI委譲を使う場合、または `--with-codex` で Kiro に Codex MCP サーバ設定を生成する場合）: `npm install -g @openai/codex`
 
 ### インストール
 
@@ -21,7 +21,7 @@ bash plugins/ndf-kiro/install.sh
 bash plugins/ndf-kiro/install.sh --with-slack
 
 # 全部入り（Slack通知 + Kiro 側 Codex MCP 設定生成）
-# 注: NDF v4.0.0 本体は Codex MCP に依存せず、/ndf:codex skill 経由で
+# 注: NDF v4.0.0 本体は Codex MCP に依存せず、/ndf:external-ai skill 経由で
 # CLI 直接実行に一本化。--with-codex は Kiro セッションで
 # `mcp__codex__*` を直接呼びたい場合のみ有効化すればよい。
 bash plugins/ndf-kiro/install.sh --with-slack --with-codex

README.md

@@ -8,18 +8,18 @@ Claude Code / Codex / Kiro CLI向けのスキル・MCP設定を共有するた
 
 **NDFプラグイン v4.20.1** は、同じ `ndf@ai-plugins` という名前で Claude Code / Codex / Kiro CLI へ配布されるランタイム別プラグインです。共通ソースは `plugins/ndf-shared/` に集約し、利用者が install する配布物は `plugins/ndf-claude/` / `plugins/ndf-codex/` / `plugins/ndf-kiro/` に分かれています。
 
-- **公開Skills**: Claude Code向け core 21個、Kiro向け core 20個、Codex向け core 21個に分離。
-- **元Skills（30個）**:
+- **公開Skills**: Claude Code向け core 20個、Kiro向け core 20個、Codex向け core 22個に分離。
+- **元Skills（29個）**:
  - PR/レビューワークフロー (7): pr, pr-tests, fix, review, cherry-pick-pr, deploy, merged
  - 原則・ガイドライン (9): ndf-policies, implementation-plan, plan-to-spec, investigation-rules, problem-solving, logging-guidelines, markdown-writing, issue-plan-strategy, ml-model-structure
- - データ分析・品質・環境 (5): qa-security-scan, docker-container-access, google-auth, codex, official-skills-autoloader
+ - データ分析・品質・環境 (4): qa-security-scan, docker-container-access, google-auth, official-skills-autoloader
  - E2Eテスト/Playwright (4): playwright-planning, playwright-authoring, playwright-evidence, playwright-kit-ops
  - 外部サービス連携 (1): google-drive
- - AIクロスレビュー (2): cross-review, gemini
+ - AIクロスレビュー (2): cross-review, external-ai
  - 運用 (2): skill-stats, statusline
 - **8つの専門エージェント**: director, data-analyst, corder, researcher, qa, debugger, devops-engineer, code-reviewer
 - **自動フック**: SessionStart (transcript保持期間を最低90日に保つ) + Stop (AI要約生成+Slack通知)
-- **外部AI委譲**: `/ndf:codex` skill + `corder` エージェント経由で Codex CLI をバックグラウンド実行 (v4.0.0 で Codex MCP サーバは廃止)
+- **外部AI委譲**: `/ndf:external-ai` skill + `corder` エージェント経由で Codex / Gemini CLI をバックグラウンド実行 (v4.0.0 で Codex MCP サーバは廃止)
 - **AIクロスレビュー強化**: `/ndf:cross-review` は codex/gemini 両方に PR レビューを委譲し、Gemini の進捗 heartbeat、`--focus` / `--extra-instructions-file`、PR 種別別の自動レビュー観点テンプレートに対応
 - **Kiro CLI対応**: `plugins/ndf-kiro/install.sh` によるワンコマンドセットアップ
 - **MCPプラグイン**: `plugins/mcp/shared/` を編集元とし、Claude / Codex / Kiro 向け配布物を `plugins/mcp/{claude,codex,kiro}/` に生成
@@ -100,7 +100,7 @@ kiro-cli chat
 
 | プラグイン名 | バージョン | 説明 | 詳細 |
 |------------|----------|------|------|
-| **ndf** | 4.20.1 | Claude Code / Codex / Kiro CLI 向けに runtime 別配布物を提供する NDF プラグイン。8個の専門エージェント（Claude版）、公開Skills（Claude Code向け core 21個、Kiro向け core 20個、Codex向け core 21個）、Claude SessionStart/Stopフック、Codex/Kiro向け通知・実行補助を提供。v4.0.0 で Codex MCP サーバを廃止し、`/ndf:codex` skill + `corder` エージェント経由の CLI 直接実行に一本化。 | [Claude](./plugins/ndf-claude/README.md) / [Codex](./plugins/ndf-codex/README.md) / [Kiro](./plugins/ndf-kiro/README.md) |
+| **ndf** | 4.20.1 | Claude Code / Codex / Kiro CLI 向けに runtime 別配布物を提供する NDF プラグイン。8個の専門エージェント（Claude版）、公開Skills（Claude Code向け core 20個、Kiro向け core 20個、Codex向け core 22個）、Claude SessionStart/Stopフック、Codex/Kiro向け通知・実行補助を提供。v4.0.0 で Codex MCP サーバを廃止し、`/ndf:external-ai` skill + `corder` エージェント経由の CLI 直接実行に一本化。 | [Claude](./plugins/ndf-claude/README.md) / [Codex](./plugins/ndf-codex/README.md) / [Kiro](./plugins/ndf-kiro/README.md) |
 
 ### NDF v4.20.1 の主な変更
 

docs/ndf-plugin-reference.md

@@ -99,7 +99,7 @@ bash scripts/runtime-smoke-test.sh --runtime kiro
 
 ## 外部 AI 委譲
 
-Codex MCP サーバは廃止済みです。外部 AI 委譲は `/ndf:codex` Skill と Claude Code 版の `corder` エージェントから Codex CLI を直接呼び出す方式を標準とします。
+Codex MCP サーバは廃止済みです。外部 AI 委譲は `/ndf:external-ai` Skill と Claude Code 版の `corder` エージェントから Codex / Gemini CLI を直接呼び出す方式を標準とします。
 
 ## Slack 通知
 

docs/specifications/ndf-knowledge-and-kiro.md

@@ -31,7 +31,7 @@ Kiro CLI 用設定は `.kiro/agents/default.json` で管理する。agent 設定
 
 Kiro CLI では `plugins/ndf-kiro/install.sh` が `plugins/ndf-kiro/skills/` から `.kiro/skills/` への symlink と `.kiro/agents/default.json` を生成する。`agentSpawn` hook は初期化時の案内に使い、`--with-slack` 指定時のみ `stop` hook 相当の Slack 通知を有効化する。Kiro の stop hook payload に `assistant_response` が含まれる場合、`plugins/ndf-kiro/scripts/slack-notify.js` は transcript よりも `assistant_response` を優先して要約に使う。
 
-Codex 連携は MCP サーバではなく `/ndf:codex` skill と `corder` エージェント経由の Codex CLI 直接実行を標準とする。Kiro 用 `--with-codex` は Kiro セッションから Codex CLI を扱う場合の補助設定である。
+Codex 連携は MCP サーバではなく `/ndf:external-ai` skill と `corder` エージェント経由の Codex CLI 直接実行を標準とする。Kiro 用 `--with-codex` は Kiro セッションから Codex CLI を扱う場合の補助設定である。
 
 ## データ・設定
 
@@ -47,7 +47,7 @@ Codex 連携は MCP サーバではなく `/ndf:codex` skill と `corder` エー
 |---|---|
 | Kiro CLI | `.kiro/agents/default.json` と `.kiro/skills/` で Skill / hook / MCP 設定を提供 |
 | Serena MCP | `mcp-serena` プラグインとして分離提供 |
-| Codex CLI | `/ndf:codex` skill と `corder` エージェントから直接実行 |
+| Codex CLI | `/ndf:external-ai` skill と `corder` エージェントから直接実行 |
 | Slack | Claude Code / Kiro / Codex の終了通知に使用 |
 
 ## テスト観点

plugins/ndf-claude/.claude-plugin/plugin.json

@@ -44,8 +44,7 @@
  "./skills/cherry-pick-pr",
  "./skills/deploy",
  "./skills/playwright-authoring",
- "./skills/codex",
- "./skills/gemini",
+ "./skills/external-ai",
  "./skills/statusline",
  "./skills/issue-plan-strategy",
  "./skills/plan-to-spec"

plugins/ndf-claude/README.md

@@ -42,7 +42,7 @@ SLACK_USER_MENTION=<@U0123456789>
 
 ## 外部 AI 委譲
 
-`/ndf:codex` skill または `corder` エージェントから外部 AI 委譲を使う場合は、利用環境に Codex CLI をインストールしてログインします。
+`/ndf:external-ai` skill または `corder` エージェントから外部 AI 委譲を使う場合は、利用環境に Codex CLI をインストールしてログインします。
 
 ```bash
 npm install -g @openai/codex

plugins/ndf-claude/agents/corder.md

@@ -13,7 +13,7 @@ description: |
 
 ## v4.0.0 変更点
 
-以前は `mcp__codex__codex` / `mcp__codex__codex-reply` (Codex MCPサーバ) を使っていましたが、v4.0.0 で **Codex MCPは廃止**し、**Codex CLI の直接バックグラウンド実行**に切り替わりました。`mcp__codex__*` は利用できません。代わりに `/ndf:codex` skill に従って `codex exec` を呼び出してください。
+以前は `mcp__codex__codex` / `mcp__codex__codex-reply` (Codex MCPサーバ) を使っていましたが、v4.0.0 で **Codex MCPは廃止**し、**Codex CLI の直接バックグラウンド実行**に切り替わりました。`mcp__codex__*` は利用できません。代わりに `/ndf:external-ai` skill に従って `codex exec` を呼び出してください。
 
 ## 専門領域
 
@@ -42,25 +42,46 @@ description: |
 
 ### Codex CLI（推奨: バックグラウンド実行）
 
-`codex` CLI を `codex exec` コマンドで直接呼び出す。詳細な手順・プロンプトテンプレート・サンドボックス制約への対処は `/ndf:codex` skillに記載のとおり:
+`codex` CLI を `codex exec` コマンドで直接呼び出す。詳細な手順・プロンプトテンプレート・サンドボックス制約への対処は `/ndf:external-ai` skill（Codex 固有の差分は `references/cli-codex.md`）に記載のとおり:
 
 ```bash
 # 1. プロンプトを一時ファイルに書く (ファイル書き込みツール)
+# 最終結果は必ず $FINAL へ apply_patch で書き出すよう本文で指示する
+FINAL=/tmp/codex-output-<タスク名>.md
 cat > /tmp/codex-prompt.md <<EOF
 ...
+## 出力先（必須）
+最終結果を **必ず** \`${FINAL}\` に \`apply_patch\` で新規作成してください。
+**stdout への出力だけでは不十分です**。書き出し後、stdout にも同じ内容を出力してください。
 EOF
 
 # 2. バックグラウンド実行
-codex exec --dangerously-bypass-approvals-and-sandbox -C "$PWD" \
+codex exec --dangerously-bypass-approvals-and-sandbox \
+ --config reasoning.effort=medium \
+ -C "$PWD" \
  < /tmp/codex-prompt.md \
- > /tmp/codex-output.md \
+ > /tmp/codex-stdout.md \
  2> /tmp/codex-err.log &
 
-# 3. PID を控えて終了確認
-ps -p <PID> 2>/dev/null && echo RUNNING || echo EXITED
+# 3. 完了検知は stderr の sentinel で行う（`ps -p` は zombie を生存と誤判定する）
+until grep -q '^tokens used$' /tmp/codex-err.log 2>/dev/null; do
+ sleep 30
+done
+
+# 4. 成果物を回収（ファイル → stdout → stderr の三段フォールバック）
+if [ -s "$FINAL" ]; then
+ cp "$FINAL" ./codex-result.md
+elif [ -s /tmp/codex-stdout.md ]; then
+ cp /tmp/codex-stdout.md ./codex-result.md
+ echo "WARN: stdout からフォールバック回収（ファイル書き出しなし）" >&2
+else
+ echo "ERROR: Codex の最終出力を回収できませんでした。stderr 末尾を確認:" >&2
+ tail -200 /tmp/codex-err.log
+fi
 ```
 
-- **必ず `/ndf:codex` skill を参照**してから実行すること（サンドボックス・プロンプト設計・出力回収のベストプラクティスが記載されている）
+- **必ず `/ndf:external-ai` skill と `references/cli-codex.md` を参照**してから実行すること（サンドボックス・プロンプト設計・出力回収のベストプラクティスが記載されている）
+- **`ps -p` による完了確認は使わない**。Codex は zombie (defunct) 化して `ps -p` が 0 を返し続けるため、待機ループが抜けなくなる。脱出条件は stderr 末尾の `^tokens used$` sentinel
 - 未インストールなら `npm install -g @openai/codex` → `codex login`
 
 ### Serena MCP
@@ -77,7 +98,7 @@ ps -p <PID> 2>/dev/null && echo RUNNING || echo EXITED
 3. **最新情報収集**: Context7で最新のベストプラクティスを確認
 4. **設計**: アーキテクチャと実装方針を決定
 5. **実装**: クリーンなコードを作成
-6. **レビュー**: Codex CLI を `/ndf:codex` skill の手順でバックグラウンド起動し、独立レビューを依頼
+6. **レビュー**: Codex CLI を `/ndf:external-ai` skill の手順でバックグラウンド起動し、独立レビューを依頼
 7. **改善**: レビュー結果に基づいて修正
 8. **テスト**: 動作確認とテストコード作成
 
@@ -94,7 +115,7 @@ ps -p <PID> 2>/dev/null && echo RUNNING || echo EXITED
 
 - 実装前にSerenaで既存コードパターンを確認
 - Context7で最新のフレームワーク仕様を参照
-- 実装後は必ず Codex CLI (`/ndf:codex`) で第二意見レビュー
+- 実装後は必ず Codex CLI (`/ndf:external-ai`) で第二意見レビュー
 - テストコードも併せて作成
 - 破壊的変更は事前に影響範囲を確認
 

plugins/ndf-claude/agents/debugger.md

@@ -54,7 +54,7 @@ description: |
 
 ### MCPツール（必要に応じて）
 - Serena MCP（シンボル参照解析）
-- Codex CLI（`/ndf:codex` skill または `corder` エージェント経由、独立した原因分析の第二意見）
+- Codex CLI（`/ndf:external-ai` skill または `corder` エージェント経由、独立した原因分析の第二意見）
 
 ## 診断方針
 

plugins/ndf-claude/agents/devops-engineer.md

@@ -52,7 +52,7 @@ description: |
 - `Grep` - 既存設定の参照
 
 ### MCPツール
-- Codex CLI（`/ndf:codex` skill または `corder` エージェント経由で第二意見マニフェストレビュー）
+- Codex CLI（`/ndf:external-ai` skill または `corder` エージェント経由で第二意見マニフェストレビュー）
 
 ## セキュリティ方針
 

plugins/ndf-claude/agents/director.md

@@ -137,7 +137,7 @@ TodoWrite([{content: "タスク内容", status: "in_progress", activeForm: "進
 1. ndf:corder
  - 目的: JWT認証機能を実装
  - 対象ファイル: src/auth/
- - 指示内容: 「login/logout/token refreshエンドポイントを実装してください。セキュリティベストプラクティスに従い、Codex CLI（`/ndf:codex` skill）でレビューを実施してください。」
+ - 指示内容: 「login/logout/token refreshエンドポイントを実装してください。セキュリティベストプラクティスに従い、Codex CLI（`/ndf:external-ai` skill）でレビューを実施してください。」
 
 2. ndf:qa
  - 目的: セキュリティレビュー

plugins/ndf-claude/agents/qa.md

@@ -9,7 +9,7 @@ description: |
 
 # 品質管理エージェント
 
-あなたは品質管理とテストの専門家です。WebFetch tool、Serena MCP、Chrome DevTools MCP、Claude Code MCPを活用して、コード品質、セキュリティ、パフォーマンス、ドキュメント品質を包括的に検証します。外部AIによる独立レビューが必要な場合は `corder` エージェント (Codex CLI) に委譲するか、`/ndf:codex` skill の手順で `codex exec` を直接呼び出します。
+あなたは品質管理とテストの専門家です。WebFetch tool、Serena MCP、Chrome DevTools MCP、Claude Code MCPを活用して、コード品質、セキュリティ、パフォーマンス、ドキュメント品質を包括的に検証します。外部AIによる独立レビューが必要な場合は `corder` エージェント (Codex CLI) に委譲するか、`/ndf:external-ai` skill の手順で `codex exec` を直接呼び出します。
 
 ## 専門領域
 

plugins/ndf-claude/agents/researcher.md

@@ -9,7 +9,7 @@ description: |
 
 # リサーチャーエージェント
 
-あなたは情報収集と分析の専門家です。WebFetch tool、AWS Documentation MCP、Chrome DevTools MCPを活用して、外部サイトから情報を収集し、分析して結果を返します。コードベース自体の大規模調査が必要な場合は `corder` エージェントに委譲するか、`/ndf:codex` skill の手順で Codex CLI を直接起動してください（Codex MCP は v4.0.0 で廃止）。
+あなたは情報収集と分析の専門家です。WebFetch tool、AWS Documentation MCP、Chrome DevTools MCPを活用して、外部サイトから情報を収集し、分析して結果を返します。コードベース自体の大規模調査が必要な場合は `corder` エージェントに委譲するか、`/ndf:external-ai` skill の手順で Codex CLI を直接起動してください（Codex MCP は v4.0.0 で廃止）。
 
 ## 専門領域
 
@@ -62,7 +62,7 @@ description: |
  - **静的Webページ** → WebFetch（優先）
  - **AWS技術情報** → AWS Docs MCP
  - **動的サイト/インタラクティブ操作** → Chrome DevTools MCP
- - **コードベース調査** → 本エージェントの責務外。`corder` エージェントまたは `/ndf:codex` skill を使う
+ - **コードベース調査** → 本エージェントの責務外。`corder` エージェントまたは `/ndf:external-ai` skill を使う
 3. **情報収集**: 選択したツールで情報を取得
 4. **情報整理**: 収集した情報を構造化
 5. **分析**: データを分析し、インサイトを抽出