Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
16 commits
Select commit Hold shift + click to select a range
775a636
feat: analyzable-coding skill を追加(v7.1.0)
takemi-ohama Aug 14, 2026
5434aeb
fix: 一括処理の失敗方針を安全性に応じて選べる規範へ直し、版数の取り残しを解消する
takemi-ohama Aug 14, 2026
6cedc7f
fix: pandas .apply の断定を弱め、生ログの誤出典に注記を付け、marketplace の版数を直す
takemi-ohama Aug 14, 2026
ef206dc
fix: 外部化と静的解析の関係を実測が支える条件へ限定し、JavaScript を明示的に扱う
takemi-ohama Aug 14, 2026
28f1dc0
fix: 型生成とスキーマ検証を排他にせず、実行時ロードの有無で分ける
takemi-ohama Aug 14, 2026
1de9beb
docs: analyzable-coding の SKILL.md を第三者向けに書き直す
takemi-ohama Aug 14, 2026
4f75ee7
fix: 冒頭の確認対象を業務判断に限定し、README の Skill 分類を揃える
takemi-ohama Aug 14, 2026
a8f4df4
feat!: safe-refactoring を refactoring へ改名し、表現の判断材料を統合(v8.0.0)
takemi-ohama Aug 15, 2026
45d411f
fix: v8.0.0 への版数・Skill 数の取り残しを解消し、再発を CI で止める
takemi-ohama Aug 15, 2026
ab9722e
refactor: 言語ごとの手段を 1 言語 1 ファイルへ分割する
takemi-ohama Aug 15, 2026
4e8cb1e
fix: 構造改善を必須工程にする
takemi-ohama Aug 15, 2026
33769d0
fix: 構造改善で「直す」を既定にする
takemi-ohama Aug 15, 2026
7a83207
fix: 反復の分類を実行方式にし、Skill 数の抽出失敗をエラーにする
takemi-ohama Aug 15, 2026
1478541
fix: 構造改善の対象範囲を関連領域まで広げる
takemi-ohama Aug 15, 2026
2f0b967
fix: 構造改善の範囲基準と記録追加の完了条件を整合させる
takemi-ohama Aug 15, 2026
a93b92d
fix: array_column を高階反復から切り離して分類し直す
takemi-ohama Aug 15, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .claude-plugin/marketplace.json
Original file line numberDiff line numberDiff line change
Expand Up@@ -9,7 +9,7 @@
{
"name": "ndf",
"source": "./plugins/ndf-claude",
"description": "Claude Code plugin (v7.0.0): 8 specialized agents and 26 focused NDF skills for PR/review workflows, cross-review, implementation planning, plan-to-spec, Docker container access, statusline, external AI delegation (Codex/Gemini), transcript retention guard, and optional Slack notifications."
"description": "Claude Code plugin (v8.0.0): 8 specialized agents and 26 focused NDF skills for PR/review workflows, cross-review, implementation planning, plan-to-spec, Docker container access, statusline, external AI delegation (Codex/Gemini), transcript retention guard, and optional Slack notifications."
},
{
"name": "playwright-kit",
Expand Down
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -77,7 +77,7 @@ ai-plugins/

## NDFプラグインについて

**NDFプラグイン**は、このマーケットプレイスの主要プラグインです(v7.0.0)。plugin 名は全ランタイムで `ndf` を維持し、配布物は `plugins/ndf-claude` / `plugins/ndf-codex` / `plugins/ndf-kiro` に分離しています。
**NDFプラグイン**は、このマーケットプレイスの主要プラグインです(v8.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を提供
Expand Down
8 changes: 5 additions & 3 deletions CLAUDE.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -29,13 +29,15 @@ skills/ → 実行可能なワークフロー

詳細は `docs/specifications/ndf-knowledge-and-kiro.md` を参照。

## NDF v7.0.0 の Skill 構成
## NDF v8.0.0 の Skill 構成

Skill は 30 個で、配布は `plugins/ndf-shared/manifests/` が唯一の基準(Claude Code 26 / Codex 24 / Kiro 25)。ブラウザ自動テストの 4 個は `playwright-kit` プラグインへ分離した(`plugins/playwright-kit-shared/`)。frontmatter の書き方は `plugins/ndf-shared/skills/README.md` の規約に従い、`python3 scripts/check-skill-frontmatter.py` で検査する。利用実績と維持・統合・削除の判定は `docs/specifications/ndf-skill-inventory.md` に記録する。

v6.1.0 で開発方法論レイヤーの 5 個(`development-workflow` / `requirements-design` / `tdd-cycle` / `safe-refactoring`/ `quality-gates`)を追加した。モード判定の基準を持つのは `development-workflow` だけで、他の Skill とエージェント定義は判定結果を受け取る側に徹する。
v6.1.0 で開発方法論レイヤーの 5 個(`development-workflow` / `requirements-design` / `tdd-cycle` / `refactoring`(当時は `safe-refactoring`/ `quality-gates`)を追加した。モード判定の基準を持つのは `development-workflow` だけで、他の Skill とエージェント定義は判定結果を受け取る側に徹する。

v7.0.0 で playwright 系 4 個を `playwright-kit` プラグインへ分離した。対応表は `ndf-policies` skill にある(v8.0.0 で削除)。
v7.0.0 で playwright 系 4 個を `playwright-kit` プラグインへ分離した。対応表は予告どおり v8.0.0 で削除済み。

v8.0.0 で `safe-refactoring` を `refactoring` へ改名し、分岐・反復・定数の表現を決める観点を統合した。観点は `references/data-representation.md` に置き、言語固有の手段は `references/lang-<言語>.md` に 1 言語 1 ファイルで置く。SKILL.md が対象言語のファイルだけを読ませるため、他言語の内容はコンテキストに載らない。言語を追加するときも他のファイルは変更しない。対応表は `ndf-policies` にある(v9.0.0 で削除)。

v6.0.0 の対応表(`review` → `pr-review`)は予告どおり削除済み。v6.0.0 以前から移行する場合は v6.1.0 の `ndf-policies` を参照する。

Expand Down
38 changes: 34 additions & 4 deletions README.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -6,12 +6,12 @@ Claude Code / Codex / Kiro CLI向けのスキル・MCP設定を共有するた

このマーケットプレイスは、チーム全体でAI開発ツール(Claude Code / Codex / Kiro CLI)の導入を加速するための事前設定されたプラグインを提供します。

**NDFプラグイン v7.0.0** は、同じ `ndf@ai-plugins` という名前で Claude Code / Codex / Kiro CLI へ配布されるランタイム別プラグインです。共通ソースは `plugins/ndf-shared/` に集約し、利用者が install する配布物は `plugins/ndf-claude/` / `plugins/ndf-codex/` / `plugins/ndf-kiro/` に分かれています。
**NDFプラグイン v8.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 26個、Kiro向け core 25個、Codex向け core 24個に分離。
- **元Skills(30個)**:
- PR/レビューワークフロー (7): pr, pr-tests, fix, pr-review, cherry-pick-pr, deploy, merged
- 開発方法論 (5): development-workflow, requirements-design, tdd-cycle, safe-refactoring, quality-gates
- 開発方法論 (5): development-workflow, requirements-design, tdd-cycle, refactoring, quality-gates
- 原則・ガイドライン (9): ndf-policies, implementation-plan, plan-to-spec, investigation-rules, problem-solving, logging-guidelines, markdown-writing, issue-plan-strategy, ml-model-structure
- データ分析・品質・環境 (4): qa-security-scan, docker-container-access, google-auth, official-skills-autoloader
- 外部サービス連携 (1): google-drive
Expand DownExpand Up@@ -102,9 +102,39 @@ kiro-cli chat --agent ndf

| プラグイン名 | バージョン | 説明 | 詳細 |
|------------|----------|------|------|
| **ndf** | 7.0.0 | Claude Code / Codex / Kiro CLI 向けに runtime 別配布物を提供する NDF プラグイン。8個の専門エージェント(Claude版)、公開Skills(Claude Code向け core 26個、Kiro向け core 25個、Codex向け core 24個)、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** | 8.0.0 | Claude Code / Codex / Kiro CLI 向けに runtime 別配布物を提供する NDF プラグイン。8個の専門エージェント(Claude版)、公開Skills(Claude Code向け core 26個、Kiro向け core 25個、Codex向け core 24個)、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) |
| **playwright-kit** | 1.0.0 | Playwright による E2E テストの計画・実装・証跡管理を提供するプラグイン。ページ役割からのテスト計画、動画 / trace 付きスクリプト実装、レポート生成と Drive 保管、playwright_kit ランタイム(init、a11y / CWV スキャン)の 4 Skill。NDF v7.0.0 で分離。 | [Claude](./plugins/playwright-kit-claude/README.md) |

### NDF v8.0.0 の主な変更(非互換)

**構造改善の Skill を `/ndf:refactoring` へ改名しました。** 引数と手順は変わりません。

| 旧コマンド | 移行先 |
|---|---|
| `/ndf:safe-refactoring` | `/ndf:refactoring` |

`safe-` を外したのは、`/refactoring` で一意に決まり、入力が短くなるためです。対応表は
`ndf-policies` にあり、v9.0.0 で削除します。

**あわせて、分岐・反復・定数の表現を決める観点を統合しました。** リファクタリングの起点となる
兆候(コードスメル)に 3 件を追加し、判断材料を参照資料として持たせています。

| 追加した観点 | 置き換え先 |
|---|---|
| 業務ルールの埋め込み(料率・区分・しきい値が制御構文に埋まっている) | 対応表への置き換え |
| 一件ずつの反復(往復回数や実行時間が件数に比例する) | 一括処理への置き換え |
| 検証のない外部化(設定・マスタにスキーマ・版・検証がない) | スキーマと版を与え、読み込み境界で検証する |

判断材料は
[references/data-representation.md](./plugins/ndf-shared/skills/refactoring/references/data-representation.md)
にあります。「分岐が多いから表にする」ではなく**変化するから表にする**、という切り分けを置き、
ガード節・静的に網羅性を検査できる分岐・逐次依存のループ・閉じた状態集合の列挙型は「そのままで
よい」ものとして明示しています。具体的な手段は言語ごとに 1 ファイルへ分けており(`references/lang-python.md` /
`lang-javascript.md` / `lang-typescript.md` /
[`lang-php.md`](./plugins/ndf-shared/skills/refactoring/references/lang-php.md))、
SKILL.md が対象言語のファイルだけを読ませます。他言語の内容はコンテキストに載りません。
記載のない言語でも判断材料はそのまま使えます。

### NDF v7.0.0 の主な変更(非互換)

**ブラウザ自動テストの 4 Skill を `playwright-kit` プラグインへ分離しました。** Skill 名は
Expand DownExpand Up@@ -159,7 +189,7 @@ Skill の `name` と `description` は起動時の一覧としてコンテキス
| `/ndf:development-workflow` | 変更を 4 モード(`light` / `standard` / `architecture` / `legacy-refactor`)へ分類し、必要な工程だけへ振り分ける |
| `/ndf:requirements-design` | 曖昧な要求を、観測可能で検証できる受け入れ条件へ変換する |
| `/ndf:tdd-cycle` | 「失敗するテスト → 通す最小実装 → 整理」のサイクルを定義する |
| `/ndf:safe-refactoring` | コードスメル起点の構造改善と、テストが乏しい既存コード向けの現状固定テスト |
| `/ndf:refactoring` | コードスメル起点の構造改善と、テストが乏しい既存コード向けの現状固定テスト(v6.1.0 当時の名称は `/ndf:safe-refactoring`) |
| `/ndf:quality-gates` | 完了宣言の前に、実行コマンド・終了コード・実行時刻・対象範囲を証跡として要求する |

全変更にフル工程を課さないことを設計の中心に置いています。文言修正や設定変更は
Expand Down
43 changes: 43 additions & 0 deletions docs/specifications/ndf-skill-inventory.md
Original file line numberDiff line numberDiff line change
Expand Up@@ -425,6 +425,49 @@ superpowers は 28 個で NDF と同規模ながら frontmatter が 1/2.7 だっ
`description` が `Use when …` の 1 文だけで、トリガ語の列挙・引用符・追加フィールドを持たない。
v7.0.0 の書式はこの方針に寄せたものである。

## v8.0.0 での統合と改名(refactoring)

`safe-refactoring` を **`refactoring`** へ改名し、分岐・反復・定数の表現を決める観点を統合した。
この観点は独立 Skill `analyzable-coding` として一度追加したもので(v7.1.0 / Skill 31 個)、
`refactoring` へ吸収したため **Skill 数は 31 個から 30 個へ戻る**。v7.1.0 は同じリリース作業の
途中で作った中間の版で、配布はしていない。したがって配布済みの v7.0.0 から見ると 30 個のままである。

統合の根拠は本書「判断基準」節の「機能が他 Skill と重複するものは、統合の対象とし、内容は
統合先へ残す」である。観点を独立 Skill として置くと、発動条件が「コードを書くとき」以外に
書けず、常に該当するトリガは発動判定として働かない。構造改善の起点である
`safe-refactoring` の観点へ寄せることで、発動点が「リファクタリングを始めるとき」に定まる。

| Skill | 配布 | 変更 | 判定 |
| --- | --- | --- | --- |
| `refactoring` | CXK | `safe-refactoring` から改名。コードスメルに 3 件追加、参照資料を 2 件追加 | 改名前の実測を引き継ぐ |

追加した観点と参照資料:

| 追加物 | 内容 |
| --- | --- |
| コードスメル 3 件 | 業務ルールの埋め込み / 一件ずつの反復 / 検証のない外部化 |
| 手法 2 件 | 対応表への置き換え / 一括処理への置き換え |
| `references/data-representation.md` | 分岐・反復・定数の判定表、外部化してよい条件、判断の記録 |
| `references/lang-python.md` ほか 3 件 | 言語ごとの手段。1 言語 1 ファイルとし、SKILL.md が対象言語のものだけを読ませる |

改名は公開コマンドの非互換変更にあたるため、対応表を `ndf-policies` へ置いた(v9.0.0 で削除)。
あわせて v7.0.0 の対応表(playwright 系の分離)を予告どおり削除した。

予算への影響(`python3 scripts/check-skill-frontmatter.py --report`):

Skill 数以外は全 family 合計(ndf + playwright-kit)である。v7.1.0 は配布していない中間の版だが、
31 個へ増えた地点の実測として残す。

| 指標 | v7.0.0 | v7.1.0(未配布) | v8.0.0 | 運用値 |
| --- | ---: | ---: | ---: | ---: |
| Skill 数(ndf 単独) | 30 | 31 | 30 | — |
| Claude Code 初期一覧 | 5,807 | 6,041 | 5,855 | 8,000 |
| Codex 初期一覧 | 5,395 | 5,629 | 5,443 | 8,000 |
| frontmatter 合計 | 10,559 | 10,782 | 10,612 | 11,200 |

Skill 数は v7.0.0 と同じ 30 個に戻るが、初期一覧は 48 文字(frontmatter 合計は 53 文字)多い。
`refactoring` の `description` を統合後の役割に合わせて書き足したためで、運用値には余裕がある。

## 参照

- 棚卸の計画: [issues/ndf-development-skills/02-skill-inventory.md](../../issues/ndf-development-skills/02-skill-inventory.md)
Expand Down
Loading
Loading