diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index c5f41bd286..93d3eab909 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -9,7 +9,7 @@ { "name": "ndf", "source": "./plugins/ndf", - "description": "Claude Code plugin (v11.0.13): 8 specialized agents (plus 2 supervisor agents and 1 worker agent for the 3-layer workflow) and 49 focused NDF skills for PR/review workflows, cross-review, implementation planning, plan-to-spec, Docker container access, statusline, external AI delegation (Codex/agy), and optional Slack notifications.", + "description": "Claude Code plugin (v11.0.14): 8 specialized agents (plus 2 supervisor agents and 1 worker agent for the 3-layer workflow) and 49 focused NDF skills for PR/review workflows, cross-review, implementation planning, plan-to-spec, Docker container access, statusline, external AI delegation (Codex/agy), and optional Slack notifications.", "policy": { "installation": "AVAILABLE", "authentication": "ON_INSTALL" @@ -22,7 +22,7 @@ { "name": "playwright-kit", "source": "./plugins/playwright-kit", - "description": "Claude Code plugin (v4.0.4): 4 Playwright E2E skills — test planning by page role, script authoring with video / trace evidence, report generation with collected evidence, and the playwright_kit runtime (init, a11y / CWV scans).", + "description": "Claude Code plugin (v4.0.5): 4 Playwright E2E skills — test planning by page role, script authoring with video / trace evidence, report generation with collected evidence, and the playwright_kit runtime (init, a11y / CWV scans).", "policy": { "installation": "AVAILABLE", "authentication": "ON_INSTALL" diff --git a/CHANGELOG.md b/CHANGELOG.md index cc21304384..a5c2af95be 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,6 +9,36 @@ **開発版(接尾辞の付いた版)は載せない。** `9.8.0` は `9.8.0-dev.1` までしか出ておらず、 その内容は `10.0.0` で届いている。 +## [mcp-serena 3.0.4] - 2026-11-22 + +- 依存の Python のパッケージを、公開から 7 日たった最新の安定版へ上げた。コマンドと振る舞いは変わらない(#3961) + +## [playwright-kit 4.0.5] - 2026-11-22 + +- 依存の Python のパッケージを、公開から 7 日たった最新の安定版へ上げた。Skill の手順と振る舞いは変わらない(#3961) + +## [ndf 11.0.14] - 2026-11-22 + +- 並列の計画の同時実行の制御を、マシン全体の稼働中のレーンの数とテストのスロットの 2 層にした。計画とレーンの設定の `max_lanes`・`max_plans`・レーンの `plans`、検査 I20・I2、`ndf lanes limits`・`ndf lanes set --plans` を消した。3 つの値を書いた `plan.json`・`lane.json` は、キーの名前を名指して断る(#4001) + - 稼働中のレーンの上限は、判定のたびにマシンの設定 → 環境変数 `NDF_RELAY_MAX_NAMED` → `relay.max-named` の順で読む。`ndf relay cap [--named N | --clear]` でマシンの設定を書く + - 行を始める起動・続きの起動は、元のラッパーを止める前に上限を判定する(`ndf relay spawn --replace --seat <席>`)。上限で断られても元のラッパーは動いたままになる + - `ndf relay ls` は登録簿に無く錠を持つラッパーも `registered: false` で載せ、`ndf lanes status` は待ちの理由(`machine-lanes`・`lock`・`observe`)と数・上限を出す +- NDF は `gh`・`claude`・`codex` を起動する前にバージョンを下限(`gh` 2.17.0・`claude` 2.1.268・`codex` 0.122.0。`plugins/ndf/contracts/domains/cli-floors.json`)と比べ、下限より古ければ起動せずに CLI の名前・見つけたバージョン・実パス・下限を出して止まる。下限と同じ数字のプレリリース(例 `0.122.0-alpha.1`)も古いとして止まる。バージョンを読めない(出力の形が違う・5 秒で返らない)ときは、標準エラーへ 1 行を出して比べずに起動する。Kiro と agy は比べない(#3961) + - ラッパー(中継)のパススルーは `ndf-relay: claude を起動できない(<理由>)` を出して終了コード 127 で終わる。`claude --version` などパススルーする起動でも、その前に NDF が `claude --version` を 1 回打つ + - ラッパーが子の claude を起動するときは `ndf-relay: 子の claude を起動できない(<理由>)` を出し、停止理由 `precondition`(終了コード 3)で終わる + - `ndf launch-args` は `precondition` で止まり、`bin/ndf-claude` はその回答を出して同じ終了コードで終わる(`exec claude` に進まない) +- NDF が使う Python の依存のバージョンが上がった(filelock 4.0.3 → 4.2.10・pydantic 2.13.5 → 2.14.3・slack-sdk 3.44.1 → 3.47.0 ほか)。DBOS(3.4.0)と httpx(0.28.1)は変わらない。コマンドと結果の形は変わらない(#3961) +- `release` の Skill が配るスライドのテンプレート(`plugins/ndf/skills/release/assets/slides/`)に `.npmrc`(`min-release-age=7`)を置いた。テンプレートで `npm install` すると、公開から 7 日たったバージョンだけを入れる(#3961) + +### 移行の手順 + +- 外部 CLI が下限より古い環境では、`gh` を 2.17.0 以上・Claude Code を 2.1.268 以上・Codex を 0.122.0 以上へ上げる。今のバージョンは `gh --version`・`claude --version`・`codex --version` で見られる(#3961) +- 並列の計画の設定(`.ndf/parallel/<計画>/plan.json`)に `max_lanes`・`max_plans`・レーンの `plans` を書いていれば、消してから `ndf lanes start` を打ち直す。消す前に打つと、キーの名前を名指して断られる(#4001) + + ```bash + jq 'del(.max_lanes, .max_plans) | .lanes |= map(del(.plans))' .ndf/parallel/<計画>/plan.json > plan.json.new && mv plan.json.new .ndf/parallel/<計画>/plan.json + ``` + ## [ndf 11.0.13] - 2026-11-21 - Fix: cross-review の run が指摘をスレッドにして閉じた指摘を resolve し、修正の記録を PR へ残す(#3939)(#3940) diff --git a/README.md b/README.md index c07e76f1b8..45a771ff3f 100644 --- a/README.md +++ b/README.md @@ -93,8 +93,8 @@ Claude Code では `/ndf:` と打って呼びます。**Skill** は | プラグイン名 | バージョン | できること | 詳細 | | --- | --- | --- | --- | -| **ndf** | 11.0.13 | 開発の工程の Skill、専門のサブエージェントと実行主体(supervisor・worker)、hook、コマンド `ndf` | [README](./plugins/ndf/README.md) | -| **playwright-kit** | 4.0.4 | Playwright による E2E テストの計画・スクリプトの作成・証跡のレポート | [README](./plugins/playwright-kit/README.md) | +| **ndf** | 11.0.14 | 開発の工程の Skill、専門のサブエージェントと実行主体(supervisor・worker)、hook、コマンド `ndf` | [README](./plugins/ndf/README.md) | +| **playwright-kit** | 4.0.5 | Playwright による E2E テストの計画・スクリプトの作成・証跡のレポート | [README](./plugins/playwright-kit/README.md) | ndf に入るもの: @@ -125,7 +125,7 @@ ndf に入るもの: ### NDF の Skill の一覧 -**NDFプラグイン v11.0.13** に入る Skill の数は、AI ツールごとに違います。 +**NDFプラグイン v11.0.14** に入る Skill の数は、AI ツールごとに違います。 Claude Code向け core 49個、Codex向け core 45個です(配る先は [manifests/skills.json](./plugins/ndf/manifests/skills.json) が決めます)。 元Skills(49個)の内訳は次のとおりです。 - Pull Request とレビュー (7): pr, pr-tests, fix, pr-review, cherry-pick-pr, deploy, merged diff --git a/docs/metrics/ndf-token-usage/2026-11-22.json b/docs/metrics/ndf-token-usage/2026-11-22.json new file mode 100644 index 0000000000..d093c35920 --- /dev/null +++ b/docs/metrics/ndf-token-usage/2026-11-22.json @@ -0,0 +1,23 @@ +{ + "per_pr": [], + "per_role": [], + "external": [], + "meta": { + "by": [ + "version", + "mode", + "model", + "cc", + "reviewers" + ], + "min_version": "10.27.76", + "until": "2026-11-22T00:44:00Z", + "sessions": 0, + "sessions_with_pr": 0, + "unlinked_external": 0, + "unlinked_ledger": 0, + "skipped": {}, + "released": "11.0.14", + "previous": "2026-11-21.json" + } +} diff --git a/docs/metrics/ndf-token-usage/2026-11-22.md b/docs/metrics/ndf-token-usage/2026-11-22.md new file mode 100644 index 0000000000..3e358fc604 --- /dev/null +++ b/docs/metrics/ndf-token-usage/2026-11-22.md @@ -0,0 +1,73 @@ +# ndf の版ごとのトークン消費と所要時間(2026-11-22 集計・11.0.14 のリリース) + +**11.0.14 を正式版として出したときの記録である。** 打ち切りの時刻は `2026-11-22T00:44:00Z`。表の最初の行は 10.27.76(前の記録: 2026-11-21.md)。既定では前の記録の最後の版で、記録どうしが 1 行ずつ重なる。生の記録・会話の本文・リポジトリ名・会話の ID は残していない。集計した日時点の記録で、以後の記録の増減には追随しない。 + +## 作り方 + +同じ打ち切りの時刻で走らせ直すと、記録が残っている間は同じ `.json` ができる。ただし kiro の記録はターンに時刻を持たないため、打ち切りをまたいで進行中だった席は credit が変わりうる。 + +```bash +python3 scripts/token-usage-snapshot.py --released 11.0.14 --until 2026-11-22T00:44:00Z --min-version 10.27.76 +python3 scripts/token-usage.py --min-version 10.27.76 --until 2026-11-22T00:44:00Z --by version # 末尾の「集計の出力」 +``` + +## 比べるときの注意 + +- **PR を作った会話が 2 件以下の版:** 無し。作業の中身の違いが版の違いより大きい +- **CHANGELOG.md にあって表に出ない版:** 10.27.76, 10.27.77, 11.0.0, 11.0.1, 11.0.2, 11.0.3, 11.0.4, 11.0.5, 11.0.6, 11.0.7, 11.0.8, 11.0.9, 11.0.10, 11.0.11, 11.0.12, 11.0.13, 11.0.14。その版で始めた PR つきの会話が無い(会話の版は最初に読んだ版で決まる) +- **打ち切りの 30 分前以降にも行がある会話を含む版:** 無し。進行中だった会話は、値が打ち切りの時刻までの分である + +## 版ごとの差(PR 1 本あたり) + +換算の合計は conductor・supervisor・worker の換算の和。前の版との差は、表の 1 つ上の行との比である。±30% を超えた版を下の「読み取り」で扱う。 + +| ndf の版 | 会話 | PR | 換算の合計 | 前の版との差 | conductor | supervisor | worker | 入力 | 所要 | codex 入力 | +| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | + +## 版と層ごとの呼び出しとキャッシュ(1 起動あたり) + +P と k と書き込みは 1 起動あたり、書き直しとうち 5 分超は合計の回数である。 + +| ndf の版 | 層 | 起動 | P | k | 書き込み 5 分 | 書き込み 1 時間 | 書き直し | うち 5 分超 | 1 起動あたりの書き直し | +| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | + +## 読み取り + +差の大きい版は無い(すべて ±30% の内)。読み取りは要らない。 + +## 集計の出力 + +対象の会話: 0 件 / PR を作った会話: 0 件 / 寄せ先の無い外部 CLI: 0 件 / 寄せ先の無い帳簿の行: 0 件 + +換算は input を 1 とした費用(cache read はモデル別: claude-opus-5-5 0.05 / claude-sonnet-5-5 0.05 / claude-fable-5-2 0.025 / claude-fable-5-1 0.025 / 他 0.1。cache write 5 分 1.25・1 時間 2 / output 5)。入力は input + cache read + cache write。所要は分。 + +### PR 1 本あたり + +| 動いた版 | 会話 | PR | conductor 換算 | supervisor 換算 | worker 換算 | 入力 | 出力 | 所要 | codex 入力 | codex 出力 | kiro credit | claude 席 換算 | +| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | + +### フェーズごと(1 起動あたり) + +| 動いた版 | 層 | フェーズ | 定義 | 起動 | 換算 | 入力 | 出力 | 所要 | +| --- | --- | --- | --- | --- | --- | --- | --- | --- | + +### フェーズごとの呼び出しとキャッシュ + +P は起動ごとの固定費(最初の呼び出しの文脈)、k は呼び出し回数(どちらも 1 起動あたり)。書き直しは 2 回目以降の呼び出しのうち、書き込みが文脈の 50% を超え、かつ 20k を超えたものの回数(合計)。5 分超はそのうち直前の呼び出しとの間隔が 5 分を超えた回数、間隔は直前の間隔の中央値(分)。5 分超の書き直し・読み込みは、直前の間隔が 5 分を超えた呼び出しの書き直しの量と、書き直しでない呼び出しの読み込みの量(どちらも合計)。定義はサブエージェントの定義の名前。 + +| 動いた版 | 層 | フェーズ | 定義 | 起動 | P | k | 書き込み 5 分 | 書き込み 1 時間 | 書き直し | 5 分超 | 5 分超の書き直し | 5 分超の読み込み | 間隔 | +| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | + +### 外部 CLI(1 起動あたり) + +kiro はトークン数を記録しない(値が 0)ため credit だけを載せる。agy は読まない。 + +| 動いた版 | ランタイム | Skill | モデル | 起動 | 入力 | cache | 出力 | credit | 所要 | +| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | + +### 外部 CLI の呼び出しとキャッシュ(1 起動あたり) + +codex は input のうち cached に当たらなかった分を書き込みとみなし、呼び出しごとの値(last_token_usage)を持つ席だけで数える。kiro は呼び出し回数を記録しない(利用者のターン数は JSON の turns)。取れない値は -。 + +| 動いた版 | ランタイム | Skill | モデル | 起動 | P | k | 書き直し | 5 分超 | 5 分超の書き直し | 5 分超の読み込み | 間隔 | +| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | diff --git a/docs/versioning-and-distribution.md b/docs/versioning-and-distribution.md index 1ba81edd0a..75d6deb3ef 100644 --- a/docs/versioning-and-distribution.md +++ b/docs/versioning-and-distribution.md @@ -61,11 +61,11 @@ NDF が開発版チャネルを持つリポジトリで使う版の形として | 版 | 形 | 意味 | | --- | --- | --- | -| 正式版 | `11.0.13` | 利用者が常用してよい | +| 正式版 | `11.0.14` | 利用者が常用してよい | | 開発版 | `11.1.0-dev.1` | 検証中。入れたくない利用者は取得を控えられる | | 公開前の確認版 | `11.1.0-rc.1` | 正式版の候補。残るのは確認だけ | -- 接尾辞は**次に出す正式版の版数へ付ける**。`11.0.13` の次を開発するなら `11.1.0-dev.1` +- 接尾辞は**次に出す正式版の版数へ付ける**。`11.0.14` の次を開発するなら `11.1.0-dev.1` - 連番は開発版を出すたびに増やす。**同じ版数で中身を差し替えない**。差し替えると、利用者の 手元にある版と `main` の版が同じ番号で別物になり、何を確かめたのかが分からなくなる - **正式版を出すときは接尾辞を外す。** `11.1.0-dev.3` の次は `11.1.0` diff --git a/plugins/mcp/mcp-serena/.claude-plugin/plugin.json b/plugins/mcp/mcp-serena/.claude-plugin/plugin.json index a0e37b4bf1..ebedaf59ee 100644 --- a/plugins/mcp/mcp-serena/.claude-plugin/plugin.json +++ b/plugins/mcp/mcp-serena/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "mcp-serena", - "version": "3.0.3", + "version": "3.0.4", "description": "Serena MCP server (serena-agent 1.7.0) for symbol-level code reading and editing, with a per-project language-server setup skill and hooks that steer repeated grep/reads toward symbol tools", "author": { "name": "takemi-ohama", diff --git a/plugins/mcp/mcp-serena/.codex-plugin/plugin.json b/plugins/mcp/mcp-serena/.codex-plugin/plugin.json index 41b1614d1a..5c20cc8f9d 100644 --- a/plugins/mcp/mcp-serena/.codex-plugin/plugin.json +++ b/plugins/mcp/mcp-serena/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "mcp-serena", - "version": "3.0.3", + "version": "3.0.4", "description": "Serena MCP server (serena-agent 1.7.0) for symbol-level code reading and editing, with a per-project language-server setup skill and hooks that steer repeated grep/reads toward symbol tools", "author": { "name": "takemi-ohama", diff --git a/plugins/ndf/.claude-plugin/plugin.json b/plugins/ndf/.claude-plugin/plugin.json index 7fef18dca5..21a869e331 100644 --- a/plugins/ndf/.claude-plugin/plugin.json +++ b/plugins/ndf/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "ndf", - "version": "11.0.13", - "description": "Claude Code plugin (v11.0.13): 8 specialized agents (plus 2 supervisor agents and 1 worker agent for the 3-layer workflow) and 49 focused NDF skills for PR/review workflows, cross-review, implementation planning, plan-to-spec, Docker container access, statusline, external AI delegation (Codex/agy), and optional Slack notifications.", + "version": "11.0.14", + "description": "Claude Code plugin (v11.0.14): 8 specialized agents (plus 2 supervisor agents and 1 worker agent for the 3-layer workflow) and 49 focused NDF skills for PR/review workflows, cross-review, implementation planning, plan-to-spec, Docker container access, statusline, external AI delegation (Codex/agy), and optional Slack notifications.", "author": { "name": "takemi-ohama", "url": "https://github.com/takemi-ohama" diff --git a/plugins/ndf/.codex-plugin/plugin.json b/plugins/ndf/.codex-plugin/plugin.json index 92a5839df3..efa611059f 100644 --- a/plugins/ndf/.codex-plugin/plugin.json +++ b/plugins/ndf/.codex-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "ndf", - "version": "11.0.13", - "description": "Codex plugin (v11.0.13): 45 focused NDF skills for PR/review workflows, cross-review, implementation planning, plan-to-spec, Docker container access, external AI delegation (Codex/agy), and optional Slack completion notifications.", + "version": "11.0.14", + "description": "Codex plugin (v11.0.14): 45 focused NDF skills for PR/review workflows, cross-review, implementation planning, plan-to-spec, Docker container access, external AI delegation (Codex/agy), and optional Slack completion notifications.", "skills": [ "./skills/backlog-refinement", "./skills/cherry-pick-pr", diff --git a/plugins/ndf/README.md b/plugins/ndf/README.md index 6560441632..a9c1e96429 100644 --- a/plugins/ndf/README.md +++ b/plugins/ndf/README.md @@ -244,14 +244,14 @@ agy models # 認証確認 ```text $CODEX_HOME/plugins/cache////skills//SKILL.md # 既定 ($CODEX_HOME=~/.codex) の例: -# ~/.codex/plugins/cache/ai-plugins/ndf/11.0.13/skills/deploy/SKILL.md +# ~/.codex/plugins/cache/ai-plugins/ndf/11.0.14/skills/deploy/SKILL.md ``` 実体のパスは `codex plugin list` で確かめます。 ```bash codex plugin list | grep 'ndf@ai-plugins' -# => ndf@ai-plugins installed, enabled 11.0.13 +# => ndf@ai-plugins installed, enabled 11.0.14 ``` Claude Code では `disable-model-invocation: true` と `/ndf:deploy` のスラッシュコマンドで同じ役割を果たします。 diff --git a/plugins/playwright-kit/.claude-plugin/plugin.json b/plugins/playwright-kit/.claude-plugin/plugin.json index 32ff57329f..a67311da7a 100644 --- a/plugins/playwright-kit/.claude-plugin/plugin.json +++ b/plugins/playwright-kit/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "playwright-kit", - "version": "4.0.4", - "description": "Claude Code plugin (v4.0.4): 4 Playwright E2E skills — test planning by page role, script authoring with video / trace evidence, report generation with collected evidence, and the playwright_kit runtime (init, a11y / CWV scans).", + "version": "4.0.5", + "description": "Claude Code plugin (v4.0.5): 4 Playwright E2E skills — test planning by page role, script authoring with video / trace evidence, report generation with collected evidence, and the playwright_kit runtime (init, a11y / CWV scans).", "author": { "name": "takemi-ohama", "url": "https://github.com/takemi-ohama" diff --git a/plugins/playwright-kit/plugin.json b/plugins/playwright-kit/plugin.json index c4514691c5..4c4c2fd8ef 100644 --- a/plugins/playwright-kit/plugin.json +++ b/plugins/playwright-kit/plugin.json @@ -1,8 +1,8 @@ { "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", "name": "playwright-kit", - "version": "4.0.4", - "description": "Agent Plugins package (v4.0.4): 4 Playwright E2E skills — test planning by page role, script authoring with video / trace evidence, report generation with collected evidence, and the playwright_kit runtime (init, a11y / CWV scans).", + "version": "4.0.5", + "description": "Agent Plugins package (v4.0.5): 4 Playwright E2E skills — test planning by page role, script authoring with video / trace evidence, report generation with collected evidence, and the playwright_kit runtime (init, a11y / CWV scans).", "author": { "name": "takemi-ohama", "url": "https://github.com/takemi-ohama"