feat: ml-model-structure skill 追加 (ndf v4.10.0)

.claude-plugin/marketplace.json

@@ -8,7 +8,7 @@
     {
       "name": "ndf",
       "source": "./plugins/ndf",
-      "description": "All-in-one plugin (v4.0.0): 8 specialized agents, 33 skills (PR/review workflows, principles, data analysis, Codex CLI integration, skill usage stats), SessionStart hook (transcript retention >= 90 days), Stop hook (AI-summarized Slack notifications). Codex CLI is invoked via /ndf:codex skill or corder agent (MCP server removed in v4.0.0)."
+      "description": "All-in-one plugin (v4.10.0): 8 specialized agents, 45 skills (PR/review workflows, principles, ML model structure standard, data analysis, Codex CLI integration, skill usage stats), SessionStart hook (transcript retention >= 90 days), Stop hook (AI-summarized Slack notifications). Codex CLI is invoked via /ndf:codex skill or corder agent (MCP server removed in v4.0.0)."
     },
     {
       "name": "affaan-m",

AGENTS.md

@@ -62,9 +62,9 @@ ai-plugins/
 
 ## NDFプラグインについて
 
-**NDFプラグイン**は、このマーケットプレイスの主要プラグインです（v4.7.6）：
+**NDFプラグイン**は、このマーケットプレイスの主要プラグインです（v4.10.0）：
 - 8個の専門サブエージェント（director、data-analyst、corder、researcher、qa、debugger、devops-engineer、code-reviewer）
-- 39個のSkills（PR/コードレビューワークフロー、AIクロスレビュー (codex/gemini)、原則・ガイドライン、issue→multi-PR ワークフロー戦略、SQL最適化、データエクスポート、skill利用統計、Codex CLI連携、Playwrightシナリオテスト、Google Drive/Chat連携 等）
+- 45個のSkills（PR/コードレビューワークフロー、AIクロスレビュー (codex/gemini)、原則・ガイドライン、MLモデル構造標準 (ml-model-structure)、issue→multi-PR ワークフロー戦略、SQL最適化、データエクスポート、skill利用統計、Codex CLI連携、Playwrightシナリオテスト、Google Drive/Chat連携 等）
 - SessionStartフック（transcript保持期間自動管理 `cleanupPeriodDays >= 90`）
 - Stopフック（AI要約生成 + 自動Slack通知）
 - 外部AI委譲は `/ndf:codex` skill と `corder` エージェント経由で Codex CLI を呼び出し（v4.0.0 で Codex MCP サーバは廃止）

README.md

@@ -6,14 +6,16 @@ Claude CodeプラグインおよびKiro CLI向けのスキル・MCP設定を共
 
 このマーケットプレイスは、チーム全体でAI開発ツール（Claude Code / Kiro CLI）の導入を加速するための事前設定されたプラグインを提供します。
 
-**NDFプラグイン v4.0.0** は、以下の機能を**オールインワン**で提供する統合プラグインです：
-
-- **33個のSkills**:
-  - PR/レビューワークフロー (pr, pr-tests, fix, review, review-branch, review-pr-comments, resolve-pr-comments, cherry-pick-pr, deploy, sync-main, merged, clean, browser-test)
-  - 原則・ガイドライン (ndf-policies, branch-fix-strategy, implementation-plan, investigation-rules, problem-solving, logging-guidelines, markdown-writing)
-  - データ分析・品質 (data-analyst-sql-optimization, data-analyst-export, qa-security-scan)
-  - 外部連携・環境 (codex, git-gh-operations, google-auth, python-execution, docker-container-access, deepwiki-transfer, knowledge-reorg, mcp-builder, official-skills-autoloader)
-  - 運用 (skill-stats)
+**NDFプラグイン v4.10.0** は、以下の機能を**オールインワン**で提供する統合プラグインです：
+
+- **45個のSkills**:
+  - PR/レビューワークフロー (13): pr, pr-tests, fix, review, review-branch, review-pr-comments, resolve-pr-comments, cherry-pick-pr, deploy, sync-main, merged, clean, browser-test
+  - 原則・ガイドライン (9): ndf-policies, branch-fix-strategy, implementation-plan, investigation-rules, problem-solving, logging-guidelines, markdown-writing, issue-plan-strategy, ml-model-structure
+  - データ分析・品質・環境 (12): data-analyst-sql-optimization, data-analyst-export, qa-security-scan, python-execution, docker-container-access, git-gh-operations, google-auth, codex, deepwiki-transfer, knowledge-reorg, mcp-builder, official-skills-autoloader
+  - E2Eテスト/Playwright (6): playwright-test-planning, playwright-script-creation, playwright-execution, playwright-report, playwright-kit-ops, playwright-scenario-test
+  - 外部サービス連携 (2): google-drive, google-chat
+  - AIクロスレビュー (2): cross-review, gemini
+  - 運用 (1): skill-stats
 - **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 サーバは廃止)
@@ -81,7 +83,7 @@ kiro-cli chat
 
 | プラグイン名 | バージョン | 説明 | 詳細 |
 |------------|----------|------|------|
-| **ndf** | 4.0.0 | Claude Code / Kiro CLI開発環境を**オールインワン**で強化する統合プラグイン。8個の専門エージェント（director、data-analyst、corder、researcher、qa、debugger、devops-engineer、code-reviewer）、33個のSkills（PR/レビューワークフロー、原則・ガイドライン、データ分析、品質、Codex CLI連携、skill利用統計など）、SessionStartフック（transcript保持期間自動管理）、Stopフック（AI要約生成+Slack通知）を提供。v4.0.0 で Codex MCP サーバを廃止し、`/ndf:codex` skill + `corder` エージェント経由の CLI 直接実行に一本化。 | [README](./plugins/ndf/README.md) |
+| **ndf** | 4.10.0 | Claude Code / Kiro CLI開発環境を**オールインワン**で強化する統合プラグイン。8個の専門エージェント（director、data-analyst、corder、researcher、qa、debugger、devops-engineer、code-reviewer）、45個のSkills（PR/レビューワークフロー、原則・ガイドライン、MLモデル構造標準、データ分析、品質、Playwright E2E、Google連携、AIクロスレビュー、Codex CLI連携、skill利用統計など）、SessionStartフック（transcript保持期間自動管理）、Stopフック（AI要約生成+Slack通知）を提供。v4.0.0 で Codex MCP サーバを廃止し、`/ndf:codex` skill + `corder` エージェント経由の CLI 直接実行に一本化。 | [README](./plugins/ndf/README.md) |
 
 ## 開発ガイドライン
 

docs/ndf-plugin-reference.md

@@ -4,7 +4,7 @@
 
 NDF プラグインは、Claude Code / Kiro CLI 向けのオールインワン開発支援プラグイン。エージェント、Skills、フックを統合して提供する。
 
-**現行バージョン**: **v4.7.0** — `/ndf:fix` の修正ポリシー刷新（minor/nit のうち performance/readability/duplication は積極修正、+30 行超は要問い合わせ）、CI 完了待ち廃止、PR範囲外 flaky テストも修正対象。`/ndf:cross-review` 内のサブエージェントプロンプトも同期。重要度ラベルは AI agent の付与を鵜呑みにせず独自再判定。完了報告には PR URL 必須。詳細は [CHANGELOG.md](../plugins/ndf/CHANGELOG.md)。`/ndf:codex` skill + `corder` エージェント経由の Codex CLI 直接実行に一本化、Serena MCP は別プラグイン `mcp-serena` に分離済み、Playwright シナリオ E2E、Google Drive / Chat 連携 skill を提供。
+**現行バージョン**: **v4.10.0** — `ml-model-structure` skill（MLモデル構築・推論API開発の標準ディレクトリ構造: 版内feature SSoT / train↔serve契約）を追加。`/ndf:fix` の修正ポリシー刷新（minor/nit のうち performance/readability/duplication は積極修正、+30 行超は要問い合わせ）、CI 完了待ち廃止、PR範囲外 flaky テストも修正対象。`/ndf:cross-review` 内のサブエージェントプロンプトも同期。重要度ラベルは AI agent の付与を鵜呑みにせず独自再判定。完了報告には PR URL 必須。詳細は [CHANGELOG.md](../plugins/ndf/CHANGELOG.md)。`/ndf:codex` skill + `corder` エージェント経由の Codex CLI 直接実行に一本化、Serena MCP は別プラグイン `mcp-serena` に分離済み、Playwright シナリオ E2E、Google Drive / Chat 連携 skill を提供。
 
 ## ディレクトリ構造
 
@@ -18,7 +18,7 @@ plugins/ndf/
 │   ├── ensure-retention.sh  # cleanupPeriodDays >= 90 を保つ
 │   └── slack-notify.js      # Slack通知スクリプト
 ├── agents/                  # 専門エージェント（8個）
-├── skills/                  # Skills（36個）
+├── skills/                  # Skills（45個）
 ├── CLAUDE.md                # プラグイン開発者向けガイド
 └── README.md                # 利用者向けドキュメント
 ```
@@ -74,6 +74,8 @@ NDF プラグイン本体はコア MCP サーバを**同梱しない**（v4.0.0
 | `problem-solving` | 根本原因分析・多層防御 |
 | `logging-guidelines` | ログ運用 (言語非依存) |
 | `markdown-writing` | Markdown 文書の体裁 |
+| `issue-plan-strategy` | issue→plan 作成・multi-PR 実行のワークフロー戦略 |
+| `ml-model-structure` | ML モデル構築・推論API の標準ディレクトリ構造 (版内 feature SSoT / train↔serve 契約) |
 
 ### 4. 補助 Skills
 
@@ -91,6 +93,16 @@ NDF プラグイン本体はコア MCP サーバを**同梱しない**（v4.0.0
 | `knowledge-reorg` | 知識再編成 |
 | `mcp-builder` | MCP サーバ作成（Anthropic 公式） |
 | `official-skills-autoloader` | Anthropic 公式 Skill の自動ロード |
+| `playwright-test-planning` | E2E テスト計画立案 (HTSM/ISTQB) |
+| `playwright-script-creation` | E2E テストスクリプト作成 |
+| `playwright-execution` | E2E 実行+エビデンス収集 (動画/a11y/CWV) |
+| `playwright-report` | E2E テスト結果の Markdown レポート |
+| `playwright-kit-ops` | playwright_kit スクリプト操作 |
+| `playwright-scenario-test` | フル E2E ワークフロー統括 |
+| `google-drive` | Google Drive/Docs 操作 |
+| `google-chat` | Google Chat メッセージ取得 |
+| `cross-review` | codex/gemini 両方でレビュー自動ループ |
+| `gemini` | gemini CLI 直接実行 |
 
 ### 5. 専門エージェント（8個、モデル階層化）
 
@@ -175,3 +187,4 @@ claude -p --settings '{"disableAllHooks": true, "disableAllPlugins": true}' --ou
 | v3.7.0 | transcript 保持期間自動管理 hook、`/ndf:skill-stats` skill |
 | **v4.0.0 (BREAKING)** | **Codex MCP 廃止 → CLI 直接実行一本化**、レガシー CLAUDE.ndf.md 救済機構削除、skill-stats にプロジェクト別/日付範囲フィルタ追加 |
 | **v4.1.0** | `playwright-scenario-test` / `google-drive` / `google-chat` skill 追加、`google-auth` v0.2.0 (永続トークン `~/.config/gcloud/google_token.json` + `get_credentials()` API + 手動 copy-paste フロー) |
+| **v4.10.0** | `ml-model-structure` skill 追加 (MLモデル構築・推論API開発の標準ディレクトリ構造、版内 feature SSoT / train↔serve 契約) |

issues/i19.md

@@ -0,0 +1,77 @@
+# [新規skill] ml-model-structure を ndf に登録する
+
+- 対象 plugin: `ndf` (現 v4.9.0)
+- 種別: 新規 skill 追加 (登録作業のみ依頼。skill 実体は作成済み)
+- 報告者: takemi-ohama
+- 起点: `carmo-screening` の PLAN43 (OAC予測モデルの analysis ディレクトリ再編) で確立した
+  「機械学習モデルの構築・推論API開発の標準構造」を、横展開可能な基準として skill 化したもの
+
+## 背景・目的
+
+機械学習モデルの学習コードと推論API(コンテナ)を、連番スクリプトでプロジェクト直下にフラットに並べると
+「どれがデプロイ済みの正規コードか」「どれが旧版・ボツ実験か」が判別できなくなる。
+また将来 v2/v3 を champion/challenger・shadow で**並行運用**する際、全版が単一の特徴量ライブラリを
+共有する設計は (特徴量ロジックが版ごとに進化するため) 破綻する。
+
+これを **版 (version) 単位の自己完結ディレクトリ + 版内 feature SSoT** で解決する構造・実装方法を、
+`carmo-screening` の実プロジェクトで確立・検証した。これを ndf の標準 skill として登録し、
+以後のモデル構築・API開発の基準としたい。
+
+## 追加する skill (作成済み)
+
+- パス: `plugins/ndf/skills/ml-model-structure/`
+  - `SKILL.md` (148 行)
+  - `references/inference-and-contract.md` (117 行、推論コンテナ規約 + TRAIN_SPEC テンプレ)
+- `name`: `ml-model-structure`
+- `description` (要約): 機械学習モデルの構築・再学習・推論API(SageMaker等)開発における標準ディレクトリ構造と
+  実装方法。版ごとに自己完結する構造 (`vN/`) + 版内 feature SSoT (`features.py`) + 推論コンテナ規約で、
+  train/serve skew を版内で防ぎ champion/challenger の並行運用に備える。
+- `when_to_use` (要約): モデルの新規構築・再学習・推論コンテナ開発・バージョン管理/並行運用を行うとき。
+  Triggers: 'モデル構築', 'モデル再学習', '推論コンテナ', 'SageMaker', 'feature SSoT', 'train/serve skew',
+  'champion challenger', '並行運用' 等。
+
+### skill が定める基準 (要点)
+
+1. **版ごとに自己完結** (`vN/` が独自の `features.py`/`train/`/`inference/` を持つ)。
+   版跨ぎ共有 (`shared/`) や `current -> vN` symlink は作らない。
+2. **版内 feature SSoT** (`vN/features.py` を学習・推論・テストが共有)。train/serve skew は版内で保証。
+3. **「コードの並行」と「デプロイの並行」は別レイヤー** (デプロイ並行は推論基盤側で解決)。
+4. 推論コンテナ規約 (SageMaker 標準ハンドラ / build context=版ルート / `COPY features.py` /
+   `.dockerignore` は context ルート / `model.tar.gz` は成果物のみ)。
+5. `train/` の canonical・採用根拠系 experiments・`lab/` (不採用)・`v1/` (read-only) の区分。
+6. `TRAIN_SPEC.md` (train↔serve 契約書) の章立て。
+7. 受け入れ基準 (テスト緑 / py_compile / docker build smoke / dead-link なし / `git mv` で履歴保持)。
+
+ASCII ツリー以外の図は mermaid を使用 (`ndf:markdown-writing` 準拠)。
+
+## 依頼内容 (登録作業)
+
+skill 実体は配置済みのため、以下の **plugin への登録のみ** をお願いしたい
+(本リポジトリ側の規約・version 運用に合わせて実施してください):
+
+1. `plugins/ndf/.claude-plugin/plugin.json`
+   - `skills` 配列に `"./skills/ml-model-structure"` を追加。
+   - `version` を bump (新規 skill 追加のため、運用ルールに従って minor 等)。
+   - `description` 内の skill 数表記 ("… skills including …") を +1 に更新。
+2. `.claude-plugin/marketplace.json` — ndf エントリの version/description が plugin.json に追従する場合は更新。
+3. `plugins/ndf/AGENTS.md` / ルート `README.md` の skill 数・一覧記述があれば更新
+   (現状 "39個のSkills" 等の表記は既に実数とずれている可能性があるため、合わせて整合を取ると望ましい)。
+
+> skill の中身 (`SKILL.md` / `references/`) のレビュー・微修正は ai-plugins 側の判断で実施して構いません。
+> 命名 (`ml-model-structure`) や粒度に異論があれば調整可。
+
+## 検証済み事項 (skill の根拠となった実プロジェクト)
+
+`carmo-screening` PLAN43 にて本構造を実装・検証済み:
+
+- 推論コンテナ単体テスト 18 passed (train/serve 一致の回帰テスト含む)。
+- 全 `.py` `py_compile` OK / `docker build` (版ルート context) exit 0 / `export --dry-run` OK。
+- ドキュメント dead-link なし (リポジトリ全体 grep)。
+- 全移動を `git mv` で履歴保持。
+
+## 関連
+
+- 由来プロジェクト: `carmo-screening` `analysis/20260505_oac-prediction/`
+  (設計書 `issues/PLAN43-restructure-design.md`、PR #288)
+- 既存類似 skill: `ndf:implementation-plan`, `ndf:issue-plan-strategy`, `ndf:mcp-builder`
+  (本 skill は「ML モデル構築・推論API の構造基準」を担い、これらと相補)

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

@@ -1,7 +1,7 @@
 {
   "name": "ndf",
-  "version": "4.9.0",
-  "description": "Integrated plugin with 8 specialized agents (model-tiered: opus/sonnet/haiku), 44 skills including official mcp-builder, on-demand loader for Anthropic official skills, generic workflow/principle skills, skill usage statistics, pytest-playwright E2E testing split into 5 focused skills (test-planning, script-creation, execution, report, kit-ops) + orchestrator with video-by-default evidence, Google Drive/Chat integration, and Codex CLI integration via /ndf:codex skill. Transcript retention is automatically kept at >= 90 days. Serena MCP is a separate plugin (mcp-serena).",
+  "version": "4.10.0",
+  "description": "Integrated plugin with 8 specialized agents (model-tiered: opus/sonnet/haiku), 45 skills including official mcp-builder, on-demand loader for Anthropic official skills, generic workflow/principle skills, ML model structure standard (ml-model-structure), skill usage statistics, pytest-playwright E2E testing split into 5 focused skills (test-planning, script-creation, execution, report, kit-ops) + orchestrator with video-by-default evidence, Google Drive/Chat integration, and Codex CLI integration via /ndf:codex skill. Transcript retention is automatically kept at >= 90 days. Serena MCP is a separate plugin (mcp-serena).",
   "author": {
     "name": "takemi-ohama",
     "url": "https://github.com/takemi-ohama"
@@ -71,6 +71,7 @@
     "./skills/google-chat",
     "./skills/gemini",
     "./skills/cross-review",
-    "./skills/issue-plan-strategy"
+    "./skills/issue-plan-strategy",
+    "./skills/ml-model-structure"
   ]
 }

plugins/ndf/CHANGELOG.md

@@ -1,5 +1,18 @@
 # NDF Plugin CHANGELOG
 
+### v4.10.0 (feature/add-ml-model-structure-skill: ml-model-structure skill 追加)
+
+機械学習モデル構築・推論API開発の標準ディレクトリ構造を提供する新規 skill を追加。
+skill 数を 45 個に更新し、関連ドキュメントのバージョン・skill 数表記を整合。
+
+- **新規 skill `ml-model-structure` 追加**
+  (`skills/ml-model-structure/`):
+  - 機械学習モデルの版ごと自己完結構造 + 版内 feature SSoT + 推論コンテナ規約。
+  - `references/inference-and-contract.md` に train↔serve 契約・推論コンテナ規約を分離。
+- **plugin.json: version 4.9.0 → 4.10.0、skills 配列に `ml-model-structure` を追加**、
+  description を 45 skills に更新。
+- **marketplace.json / README / AGENTS.md / ndf-plugin-reference: skill 数・version 表記を整合**。
+
 ### v4.7.6 (fix/review-pr-comments: PRコメント取得を3ソース対応に拡張)
 
 PRレビューコメント取得が review body / PR レベルコメントを含む3ソースに対応。