chore: 棚卸結果を manifest と文書へ反映し v5.0.0 へ (0-10)

.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
  {
  "name": "ndf",
  "source": "./plugins/ndf-claude",
- "description": "Claude Code plugin (v4.20.1): 8 specialized agents, focused NDF skills for PR/review workflows, implementation planning, plan-to-spec, browser smoke testing, statusline, Codex CLI delegation, transcript retention guard, default statusline setup, and optional Slack notifications."
+ "description": "Claude Code plugin (v5.0.0): 8 specialized agents and 22 focused NDF skills for PR/review workflows, implementation planning, plan-to-spec, browser automation, statusline, external AI delegation (Codex/Gemini), transcript retention guard, and optional Slack notifications."
  },
  {
  "name": "mcp-playwright",

AGENTS.md

@@ -73,7 +73,7 @@ ai-plugins/
 
 ## NDFプラグインについて
 
-**NDFプラグイン**は、このマーケットプレイスの主要プラグインです（v4.20.1）。plugin 名は全ランタイムで `ndf` を維持し、配布物は `plugins/ndf-claude` / `plugins/ndf-codex` / `plugins/ndf-kiro` に分離しています。
+**NDFプラグイン**は、このマーケットプレイスの主要プラグインです（v5.0.0）。plugin 名は全ランタイムで `ndf` を維持し、配布物は `plugins/ndf-claude` / `plugins/ndf-codex` / `plugins/ndf-kiro` に分離しています。
 - 共通編集元は `plugins/ndf-shared/`
 - Claude Code版は 8個の専門サブエージェント、公開Skills、SessionStart/Stopフックを提供
 - Codex版は Codex向け公開Skillsと任意Slack通知hookを提供

CLAUDE.md

@@ -29,9 +29,15 @@ skills/ → 実行可能なワークフロー
 
 詳細は `docs/specifications/ndf-knowledge-and-kiro.md` を参照。
 
-## NDF v4.18.0 / cross-review
+## NDF v5.0.0 の Skill 構成
 
-`/ndf:cross-review` は codex / gemini の両方に PR レビューを委譲し、両者が `APPROVE` するまで修正ループを回す。v4.18.0 では Gemini の progress log を heartbeat に表示するため、無言に見える時間でも `scan` / `analyze` / `post` / `done` などの作業段階を確認できる。
+Skill は 29 個で、配布は `plugins/ndf-shared/manifests/` が唯一の基準（Claude Code 22 / Codex 23 / Kiro 21）。frontmatter の書き方は `plugins/ndf-shared/skills/README.md` の規約に従い、`python3 scripts/check-skill-frontmatter.py` で検査する。利用実績と維持・統合・削除の判定は `docs/specifications/ndf-skill-inventory.md` に記録する。
+
+v4.20.1 から統合・削除で消えたコマンド名の対応表は `ndf-policies` skill にある（v6.0.0 で削除）。
+
+## cross-review
+
+`/ndf:cross-review` は codex / gemini の両方に PR レビューを委譲し、両者が `APPROVE` するまで修正ループを回す。Gemini の progress log を heartbeat に表示するため、無言に見える時間でも `scan` / `analyze` / `post` / `done` などの作業段階を確認できる。
 
 追加レビュー観点は以下のどちらかで渡す:
 

README.md

@@ -6,9 +6,9 @@ Claude Code / Codex / Kiro CLI向けのスキル・MCP設定を共有するた
 
 このマーケットプレイスは、チーム全体でAI開発ツール（Claude Code / Codex / Kiro CLI）の導入を加速するための事前設定されたプラグインを提供します。
 
-**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/` に分かれています。
+**NDFプラグイン v5.0.0** は、同じ `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 20個、Kiro向け core 20個、Codex向け core 22個に分離。
+- **公開Skills**: Claude Code向け core 22個、Kiro向け core 21個、Codex向け core 23個に分離。
 - **元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
@@ -102,7 +102,18 @@ kiro-cli chat --agent ndf
 
 | プラグイン名 | バージョン | 説明 | 詳細 |
 |------------|----------|------|------|
-| **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** | 5.0.0 | Claude Code / Codex / Kiro CLI 向けに runtime 別配布物を提供する NDF プラグイン。8個の専門エージェント（Claude版）、公開Skills（Claude Code向け core 22個、Kiro向け core 21個、Codex向け core 23個）、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 v5.0.0 の主な変更（非互換）
+
+Skill を利用実績にもとづいて棚卸し、**49 個から 29 個へ整理**しました。旧コマンド名から新コマンド名への対応表は `ndf-policies` skill に 1 リリース分だけ載せています（v6.0.0 で削除）。
+
+- **統合（-11）**: 重複していた Skill を、利用実績の多い側の名前を残して統合しました。`/ndf:review-branch` → `/ndf:review --branch`、`/ndf:review-pr-comments` `/ndf:resolve-pr-comments` → `/ndf:fix`、`/ndf:clean` `/ndf:sync-main` → `/ndf:merged`、`/ndf:branch-fix-strategy` → `/ndf:cherry-pick-pr`、`/ndf:codex` `/ndf:gemini` → `/ndf:external-ai`、ブラウザ自動テスト 9 個 → 4 個。
+- **削除（-9）**: 起動実績がなく、現在のモデルの標準能力か汎用コマンドで足りるものを削除しました（`/ndf:git-gh-operations` `/ndf:python-execution` など）。このうち `/ndf:sync-main` は内容を `/ndf:merged` へ吸収しているため移行先があります。移行先を用意せず消したのは 8 件です。
+- **自然文で発動するようになりました**: `merged` / `pr` / `review` / `pr-tests` から明示指示専用の設定を外しました。取り消しの難しい手順の前には対象を提示して確認を取ります。
+- **frontmatter 規約と機械検査**: 発動判定に必要な情報を `description` へ集約し、`scripts/check-skill-frontmatter.py` で CI 検査します（規約は `plugins/ndf-shared/skills/README.md`）。
+- **Kiro CLI**: エージェント名が `default` → `ndf` に変わりました。`install.sh` の再実行が必要です。`--set-default` と `--scope workspace|global` を追加し、常時指示を `.kiro/steering/` へ移しました。
+- **Codex**: 明示指示専用の Skill に `agents/openai.yaml` を生成し、暗黙起動を抑止します。`$<skill 名>` での明示起動は従来どおり動きます。
 
 ### NDF v4.20.1 の主な変更
 

docs/presentations/2026-08-06-ai-plugins-intro.md

@@ -3,7 +3,7 @@ marp: true
 theme: default
 paginate: true
 size: 16:9
-header: 'ai-plugins / NDF v4.20.1'
+header: 'ai-plugins / NDF v5.0.0'
 style: |
  section {
  font-family: "Hiragino Sans", "Noto Sans JP", "Yu Gothic", sans-serif;
@@ -515,11 +515,12 @@ Claude版との差: エージェント8個とSessionStart/Stopフックは無し
 git clone \
  https://github.com/devbasex/ai-plugins.git
 bash plugins/ndf-kiro/install.sh
-kiro-cli chat
+kiro-cli chat --agent ndf
 ```
 
-`.kiro/skills/` に**28個**、
-`.kiro/agents/default.json` を生成。
+`.kiro/skills/` に**21個**、
+`.kiro/agents/ndf.json` と
+`.kiro/steering/ndf-policies.md` を生成。
 
 <div class="small">
 

docs/presentations/README.md

@@ -10,7 +10,7 @@
 
 | ファイル | 内容 | 想定時間 |
 |---|---|---|
-| [2026-08-06-ai-plugins-intro.md](2026-08-06-ai-plugins-intro.md) | ai-plugins / NDF v4.20.1 の個別機能紹介。各スキルに何が書いてあり、何を重視しているかを扱う | 15分 / 15枚 |
+| [2026-08-06-ai-plugins-intro.md](2026-08-06-ai-plugins-intro.md) | ai-plugins / NDF v5.0.0 の個別機能紹介。各スキルに何が書いてあり、何を重視しているかを扱う | 15分 / 15枚 |
 
 書き出し済みの成果物も同じディレクトリに置いています。**Markdown を編集したら `build.sh` で両方を再生成してコミットしてください。**
 

docs/presentations/diagrams/overview.mmd

@@ -1,5 +1,5 @@
 flowchart TB
- S["plugins/ndf-shared/<br/>skills 49 個<br/><i>ここだけを編集する</i>"]
+ S["plugins/ndf-shared/<br/>skills 29 個<br/><i>ここだけを編集する</i>"]
 
  S --> C["ndf-claude<br/>skills 29 + agents 8<br/>+ SessionStart/Stop hook"]
  S --> X["ndf-codex<br/>skills 30 + hook"]

docs/presentations/index.html

@@ -42,7 +42,7 @@ <h1>プレゼンテーション資料</h1>
 
 <div class="card">
  <h3>ai-plugins — ndfを使った開発ワークフロー</h3>
- <p>2026-08-06 ／ 15分 ・ 15枚 ／ NDF v4.20.1<br>
+ <p>2026-08-06 ／ 15分 ・ 15枚 ／ NDF v5.0.0<br>
  各スキルに何が書いてあり、何を重視しているかを紹介します。</p>
  <div class="actions">
  <a class="primary" href="2026-08-06-ai-plugins-intro.html">スライドを開く</a>

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

@@ -1,6 +1,6 @@
 {
  "name": "ndf",
- "version": "4.20.1",
+ "version": "5.0.0",
  "description": "Claude Code plugin with 8 specialized agents, focused NDF skills for PR/review workflows, implementation planning, debugging principles, statusline, browser smoke testing, Codex CLI delegation, transcript retention guard, default statusline setup, and optional Slack notifications.",
  "author": {
  "name": "takemi-ohama",
@@ -47,6 +47,8 @@
  "./skills/external-ai",
  "./skills/statusline",
  "./skills/issue-plan-strategy",
- "./skills/plan-to-spec"
+ "./skills/plan-to-spec",
+ "./skills/qa-security-scan",
+ "./skills/official-skills-autoloader"
  ]
 }

plugins/ndf-claude/skills/ndf-policies/SKILL.md

@@ -17,3 +17,39 @@ user-invocable: false
 3. **短命ブランチを push する前に `origin/main` を取り込む。** CI に最新 main 必須の Workflow があるため
 4. **マージ済みブランチには push しない。** 既存 PR の状態を確認し、マージ済みなら新ブランチ + 新 PR を作る（サフィックス `-v2`, `-v3`）
 5. **revert を連鎖させない。** 最終的なあるべき状態を直接コミットする方が履歴上の意図が明確になり、後の cherry-pick も簡単になる
+
+## v5.0.0 で変わったコマンド名（v6.0.0 で削除）
+
+Skill の棚卸で 49 個を 29 個へ整理した。旧コマンドは存在しない。次のメジャー
+バージョンでこの節ごと削除する。
+
+| 旧コマンド | 移行先 |
+| --- | --- |
+| `/ndf:review-branch` | `/ndf:review --branch` |
+| `/ndf:review-pr-comments` | `/ndf:fix --classify-only` |
+| `/ndf:resolve-pr-comments` | `/ndf:fix` |
+| `/ndf:clean` | `/ndf:merged` |
+| `/ndf:sync-main` | `/ndf:merged` |
+| `/ndf:branch-fix-strategy` | `/ndf:cherry-pick-pr`（原則は本 Skill の「ブランチ運用の原則」） |
+| `/ndf:codex` `/ndf:gemini` | `/ndf:external-ai` |
+| `/ndf:playwright-test-planning` `/ndf:playwright-scenario-test` | `/ndf:playwright-planning` |
+| `/ndf:playwright-script-creation` `/ndf:playwright-execution` `/ndf:browser-test` `/ndf:playwright-browser-connect` | `/ndf:playwright-authoring` |
+| `/ndf:playwright-report` `/ndf:playwright-evidence-drive` | `/ndf:playwright-evidence` |
+
+移行先を用意せず削除したもの（いずれも起動実績がなく、現在のモデルの標準能力か
+汎用コマンドで足りる）:
+`/ndf:git-gh-operations` `/ndf:python-execution` `/ndf:data-analyst-export`
+`/ndf:data-analyst-sql-optimization` `/ndf:deepwiki-transfer` `/ndf:google-chat`
+`/ndf:knowledge-reorg` `/ndf:mcp-builder`
+
+`data-analyst-export` と `data-analyst-sql-optimization` の内容は `data-analyst`
+エージェントの定義へ移した。
+
+そのほかの非互換な変更:
+
+- `merged` / `pr` / `review` / `pr-tests` が自然文の依頼でも起動するようになった。
+ 取り消しの難しい手順の前には確認を取る
+- Kiro はエージェント名が `default` → `ndf` に変わった。`install.sh` を再実行する
+- Codex では `deploy` / `cherry-pick-pr` が暗黙起動の一覧から外れる。`$<skill 名>` で
+ 明示起動する
+

plugins/ndf-codex/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
  "name": "ndf",
- "version": "4.20.1",
+ "version": "5.0.0",
  "description": "Codex plugin with focused NDF skills for PR/review workflows, cross-review, implementation planning, Playwright testing, Docker container access, and optional Slack completion notifications.",
  "skills": "./skills/",
  "hooks": "./hooks/hooks.json"

plugins/ndf-codex/README.md

@@ -51,7 +51,7 @@ Claude Code 専用の agents、statusline 自動設定、transcript retention 
 $deploy qa/staging
 
 # 動く: 実体パスを示して読ませる
-~/.codex/plugins/cache/ai-plugins/ndf/4.20.1/skills/deploy/SKILL.md を読んで、その手順どおりに qa/staging へ deploy PR を作成してください。
+~/.codex/plugins/cache/ai-plugins/ndf/5.0.0/skills/deploy/SKILL.md を読んで、その手順どおりに qa/staging へ deploy PR を作成してください。
 
 # 動かない: 名前だけで起動を依頼する
 deploy skill を実行してください。
@@ -66,14 +66,14 @@ marketplace 経由でインストールした場合、Skill の実体は **ワ
 ```text
 $CODEX_HOME/plugins/cache/<marketplace>/<plugin>/<version>/skills/<skill>/SKILL.md
 # 既定 ($CODEX_HOME=~/.codex) の例:
-# ~/.codex/plugins/cache/ai-plugins/ndf/4.20.1/skills/deploy/SKILL.md
+# ~/.codex/plugins/cache/ai-plugins/ndf/5.0.0/skills/deploy/SKILL.md
 ```
 
 そのため「`deploy` の SKILL.md を探して読んで」のような曖昧な依頼は、Codex のファイル探索がワークスペース内に限られる状況では失敗しえます。`$<skill 名>` はキャッシュ配下の Skill も skill roots から解決するため、まず `$` 起動を使ってください。パスで指示したい場合は `codex plugin list` で実体パスを確認し、絶対パスを渡します。
 
 ### 実機検証結果 (codex-cli 0.146.1 / gpt-5.5)
 
-`.agents/skills/` 配下に検証用 Skill (`probe-explicit` = 本プラグインと同じ `openai.yaml` を配置 / `probe-open` = 抑止なし) を置き、`codex exec` で確認した結果です。
+`.agents/skills/` 配下に検証用 Skill (`probe-explicit` = 本プラグインと同じ `openai.yaml` を配置 / `probe-open` = 抑止なし) を置き、`codex exec` で確認した結果です。表中のパスは検証時点 (プラグイン v4.20.1) の実測値をそのまま載せています。
 
 | 検証 | 内容 | 結果 |
 |------|------|------|

plugins/ndf-codex/skills/ndf-policies/SKILL.md

@@ -17,3 +17,39 @@ user-invocable: false
 3. **短命ブランチを push する前に `origin/main` を取り込む。** CI に最新 main 必須の Workflow があるため
 4. **マージ済みブランチには push しない。** 既存 PR の状態を確認し、マージ済みなら新ブランチ + 新 PR を作る（サフィックス `-v2`, `-v3`）
 5. **revert を連鎖させない。** 最終的なあるべき状態を直接コミットする方が履歴上の意図が明確になり、後の cherry-pick も簡単になる
+
+## v5.0.0 で変わったコマンド名（v6.0.0 で削除）
+
+Skill の棚卸で 49 個を 29 個へ整理した。旧コマンドは存在しない。次のメジャー
+バージョンでこの節ごと削除する。
+
+| 旧コマンド | 移行先 |
+| --- | --- |
+| `/ndf:review-branch` | `/ndf:review --branch` |
+| `/ndf:review-pr-comments` | `/ndf:fix --classify-only` |
+| `/ndf:resolve-pr-comments` | `/ndf:fix` |
+| `/ndf:clean` | `/ndf:merged` |
+| `/ndf:sync-main` | `/ndf:merged` |
+| `/ndf:branch-fix-strategy` | `/ndf:cherry-pick-pr`（原則は本 Skill の「ブランチ運用の原則」） |
+| `/ndf:codex` `/ndf:gemini` | `/ndf:external-ai` |
+| `/ndf:playwright-test-planning` `/ndf:playwright-scenario-test` | `/ndf:playwright-planning` |
+| `/ndf:playwright-script-creation` `/ndf:playwright-execution` `/ndf:browser-test` `/ndf:playwright-browser-connect` | `/ndf:playwright-authoring` |
+| `/ndf:playwright-report` `/ndf:playwright-evidence-drive` | `/ndf:playwright-evidence` |
+
+移行先を用意せず削除したもの（いずれも起動実績がなく、現在のモデルの標準能力か
+汎用コマンドで足りる）:
+`/ndf:git-gh-operations` `/ndf:python-execution` `/ndf:data-analyst-export`
+`/ndf:data-analyst-sql-optimization` `/ndf:deepwiki-transfer` `/ndf:google-chat`
+`/ndf:knowledge-reorg` `/ndf:mcp-builder`
+
+`data-analyst-export` と `data-analyst-sql-optimization` の内容は `data-analyst`
+エージェントの定義へ移した。
+
+そのほかの非互換な変更:
+
+- `merged` / `pr` / `review` / `pr-tests` が自然文の依頼でも起動するようになった。
+ 取り消しの難しい手順の前には確認を取る
+- Kiro はエージェント名が `default` → `ndf` に変わった。`install.sh` を再実行する
+- Codex では `deploy` / `cherry-pick-pr` が暗黙起動の一覧から外れる。`$<skill 名>` で
+ 明示起動する
+