diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index b18c11b4..7d735314 100644 --- a/.claude-plugin/marketplace.json +++ b/.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", diff --git a/AGENTS.md b/AGENTS.md index ef4ef54b..952069be 100644 --- a/AGENTS.md +++ b/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を提供 diff --git a/CLAUDE.md b/CLAUDE.md index 26753da1..4deb1993 100644 --- a/CLAUDE.md +++ b/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` などの作業段階を確認できる。 追加レビュー観点は以下のどちらかで渡す: diff --git a/README.md b/README.md index a05f2721..a7d20dd7 100644 --- a/README.md +++ b/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` を生成し、暗黙起動を抑止します。`$` での明示起動は従来どおり動きます。 ### NDF v4.20.1 の主な変更 diff --git a/docs/presentations/2026-08-06-ai-plugins-intro.html b/docs/presentations/2026-08-06-ai-plugins-intro.html index f645d48f..51bf2781 100644 --- a/docs/presentations/2026-08-06-ai-plugins-intro.html +++ b/docs/presentations/2026-08-06-ai-plugins-intro.html @@ -76,7 +76,7 @@

-
ai-plugins / NDF v4.20.1
+
ai-plugins / NDF v5.0.0

まず全体像を1枚で

-

+

編集するのは plugins/ndf-shared/ の 1か所だけ。そこから3ランタイム分の配布物が生成されます。
ほかに MCP プラグインが 10個（Serena / BigQuery / Playwright / Chrome DevTools / Redash など）。

-
-
ai-plugins / NDF v4.20.1
+
ai-plugins / NDF v5.0.0

インストールは2コマンド（Claude Code）

# 1. マーケットプレイスを登録（初回だけ）
 /plugin marketplace add https://github.com/devbasex/ai-plugins
@@ -242,7 +242,7 @@ 

-
ai-plugins / NDF v4.20.1

+
ai-plugins / NDF v5.0.0

 
今日の地図: PRを1本出すまで

 

 
この4つに加えて、全工程に効く「書き方・調べ方」のルールが3つあります。

@@ -332,7 +332,7 @@ 

-
ai-plugins / NDF v4.20.1

+
ai-plugins / NDF v5.0.0

 
① /ndf:implementation-plan — 作る前に書く

 

 

@@ -438,7 +438,7 @@ 

-
ai-plugins / NDF v4.20.1

+
ai-plugins / NDF v5.0.0

 
② /ndf:pr — commit から PR まで

 
/ndf:pr                       # main へ通常PR
 /ndf:pr --draft               # ドラフトPR
@@ -528,7 +528,7 @@ 

-
ai-plugins / NDF v4.20.1

+
ai-plugins / NDF v5.0.0

 
③ /ndf:review — 何を優先して見るか

 
/ndf:review 123           # Claude 自身がレビュー
 /ndf:review 123 codex     # Codex CLI に委譲
@@ -608,7 +608,7 @@ 

-
ai-plugins / NDF v4.20.1

+
ai-plugins / NDF v5.0.0

 
③ /ndf:review — 指摘の書き方が決まっている

 
各インラインコメントの先頭に [重要度 / カテゴリ] を付けます。

 
[critical / セキュリティ] SQL がエスケープなしで連結されている。プレースホルダ必須。
@@ -714,7 +714,7 @@ 

-
ai-plugins / NDF v4.20.1

+
ai-plugins / NDF v5.0.0

 
④ /ndf:cross-review — 両AIが納得するまで回す

 

 

 
最大12ラウンド。8ラウンドで未収束ならPRをローテーション。修正はサブエージェントに投げるのでメインの会話は汚れません。

 

 

-

-
ai-plugins / NDF v4.20.1

+
ai-plugins / NDF v5.0.0

 
④ /ndf:cross-review — 観点はPRの中身で切り替わる

 
変更ファイルを全件取得して分類し、該当する観点テンプレートだけを両AIに渡します。

 

@@ -898,7 +898,7 @@ 

-
ai-plugins / NDF v4.20.1

+
ai-plugins / NDF v5.0.0

 
⑤ /ndf:plan-to-spec — プランを仕様書に変える

 

 

@@ -1009,7 +1009,7 @@ 

-
ai-plugins / NDF v4.20.1

+
ai-plugins / NDF v5.0.0

 
⑥ /ndf:markdown-writing — 第三者に伝わる書き方

 
読み手は会話もコードベースも検討過程も知らない第三者、という前提で書かせるルール。

 
@@ -1125,7 +1125,7 @@ 

-
ai-plugins / NDF v4.20.1

+
ai-plugins / NDF v5.0.0

 
⑦ 「無い」と言う前に — 調査とバグ修正のルール

 

 

@@ -1236,7 +1236,7 @@ 
/ndf:problem-solving

 

 

 

-
/ndf:problem-solving

 .small { font-size: 20px; color: #5a6b7a; }
 header { color: #8899aa; font-size: 16px; }
 footer { color: #8899aa; font-size: 16px; }
-" lang="en-US" data-marpit-pagination="14" style="--paginate:true;--header:ai-plugins / NDF v4.20.1;--theme:default;--style:section {
+" lang="en-US" data-marpit-pagination="14" style="--paginate:true;--header:ai-plugins / NDF v5.0.0;--theme:default;--style:section {
   font-family: "Hiragino Sans", "Noto Sans JP", "Yu Gothic", sans-serif;
   font-size: 25px;
   padding: 46px 58px;
@@ -1299,7 +1299,7 @@ 
/ndf:problem-solving

 header { color: #8899aa; font-size: 16px; }
 footer { color: #8899aa; font-size: 16px; }
 ;" data-marpit-pagination-total="15" data-size="16:9">
-
ai-plugins / NDF v4.20.1

+
ai-plugins / NDF v5.0.0
Codex / Kiro でも同じスキルが使えます

 

@@ -1319,17 +1319,18 @@ 
Kiro CLI

 
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 を生成。

 

 
--with-slack でStop時のSlack通知、--with-codex でCodex CLI連携を追加。何度実行しても安全（冪等）。

 

 

 

-
Kiro CLI
 .small { font-size: 20px; color: #5a6b7a; }
 header { color: #8899aa; font-size: 16px; }
 footer { color: #8899aa; font-size: 16px; }
-" lang="en-US" data-marpit-pagination="15" style="--paginate:true;--header:ai-plugins / NDF v4.20.1;--theme:default;--style:section {
+" lang="en-US" data-marpit-pagination="15" style="--paginate:true;--header:ai-plugins / NDF v5.0.0;--theme:default;--style:section {
   font-family: "Hiragino Sans", "Noto Sans JP", "Yu Gothic", sans-serif;
   font-size: 25px;
   padding: 46px 58px;
@@ -1392,7 +1393,7 @@ 
Kiro CLI

 header { color: #8899aa; font-size: 16px; }
 footer { color: #8899aa; font-size: 16px; }
 ;" data-marpit-pagination-total="15" data-size="16:9">
-
ai-plugins / NDF v4.20.1

+
ai-plugins / NDF v5.0.0

 
まとめ: スキルは「判断基準」が本体

 

 

diff --git a/docs/presentations/2026-08-06-ai-plugins-intro.md b/docs/presentations/2026-08-06-ai-plugins-intro.md
index 3fdb26e5..5c1a4fef 100644
--- a/docs/presentations/2026-08-06-ai-plugins-intro.md
+++ b/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` を生成。
 
 

 
diff --git a/docs/presentations/2026-08-06-ai-plugins-intro.pdf b/docs/presentations/2026-08-06-ai-plugins-intro.pdf
index a7c763b8..d328695f 100644
Binary files a/docs/presentations/2026-08-06-ai-plugins-intro.pdf and b/docs/presentations/2026-08-06-ai-plugins-intro.pdf differ
diff --git a/docs/presentations/README.md b/docs/presentations/README.md
index 6ba536dd..e17664bd 100644
--- a/docs/presentations/README.md
+++ b/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` で両方を再生成してコミットしてください。**
 
diff --git a/docs/presentations/diagrams/overview.mmd b/docs/presentations/diagrams/overview.mmd
index ac5a99f8..046ef4d2 100644
--- a/docs/presentations/diagrams/overview.mmd
+++ b/docs/presentations/diagrams/overview.mmd
@@ -1,5 +1,5 @@
 flowchart TB
-  S["plugins/ndf-shared/
skills 49 個
ここだけを編集する"]
+  S["plugins/ndf-shared/
skills 29 個
ここだけを編集する"]
 
   S --> C["ndf-claude
skills 29 + agents 8
+ SessionStart/Stop hook"]
   S --> X["ndf-codex
skills 30 + hook"]
diff --git a/docs/presentations/images/overview.png b/docs/presentations/images/overview.png
index 99d7b16b..4fb2944e 100644
Binary files a/docs/presentations/images/overview.png and b/docs/presentations/images/overview.png differ
diff --git a/docs/presentations/index.html b/docs/presentations/index.html
index a8eb9d22..a939a91b 100644
--- a/docs/presentations/index.html
+++ b/docs/presentations/index.html
@@ -42,7 +42,7 @@ 
プレゼンテーション資料

 
 

   
ai-plugins — ndfを使った開発ワークフロー

-  
2026-08-06 ／ 15分 ・ 15枚 ／ NDF v4.20.1

+  
2026-08-06 ／ 15分 ・ 15枚 ／ NDF v5.0.0

   各スキルに何が書いてあり、何を重視しているかを紹介します。

   

     スライドを開く
diff --git a/plugins/ndf-claude/.claude-plugin/plugin.json b/plugins/ndf-claude/.claude-plugin/plugin.json
index 2b441255..d4785d91 100644
--- a/plugins/ndf-claude/.claude-plugin/plugin.json
+++ b/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"
   ]
 }
diff --git a/plugins/ndf-claude/skills/ndf-policies/SKILL.md b/plugins/ndf-claude/skills/ndf-policies/SKILL.md
index f1a22887..176736e2 100644
--- a/plugins/ndf-claude/skills/ndf-policies/SKILL.md
+++ b/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` が暗黙起動の一覧から外れる。`$` で
+  明示起動する
+
diff --git a/plugins/ndf-codex/.codex-plugin/plugin.json b/plugins/ndf-codex/.codex-plugin/plugin.json
index 127ba714..fd4c59d7 100644
--- a/plugins/ndf-codex/.codex-plugin/plugin.json
+++ b/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"
diff --git a/plugins/ndf-codex/README.md b/plugins/ndf-codex/README.md
index 85dd2324..63313731 100644
--- a/plugins/ndf-codex/README.md
+++ b/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////skills//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 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) の実測値をそのまま載せています。
 
 | 検証 | 内容 | 結果 |
 |------|------|------|
diff --git a/plugins/ndf-codex/skills/ndf-policies/SKILL.md b/plugins/ndf-codex/skills/ndf-policies/SKILL.md
index f1a22887..176736e2 100644
--- a/plugins/ndf-codex/skills/ndf-policies/SKILL.md
+++ b/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` が暗黙起動の一覧から外れる。`$` で
+  明示起動する
+
diff --git a/plugins/ndf-kiro/skills/ndf-policies/SKILL.md b/plugins/ndf-kiro/skills/ndf-policies/SKILL.md
index f1a22887..176736e2 100644
--- a/plugins/ndf-kiro/skills/ndf-policies/SKILL.md
+++ b/plugins/ndf-kiro/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` が暗黙起動の一覧から外れる。`$` で
+  明示起動する
+
diff --git a/plugins/ndf-shared/skills/ndf-policies/SKILL.md b/plugins/ndf-shared/skills/ndf-policies/SKILL.md
index f1a22887..176736e2 100644
--- a/plugins/ndf-shared/skills/ndf-policies/SKILL.md
+++ b/plugins/ndf-shared/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` が暗黙起動の一覧から外れる。`$` で
+  明示起動する
+