refactor: ブラウザ自動テストの Skill を 9 個から 4 個へ集約 (0-5)

[takemi-ohama]

概要

Task 0-5。ブラウザ自動テスト関連の 9 Skill を工程単位で 4 個へ集約する。単純連結ではなく、重複記述を落として再構成した。

統合後の Skill 名と対応

統合後	工程	統合元
playwright-planning	テスト計画	playwright-test-planning + playwright-scenario-test
playwright-authoring	スクリプト作成と実行	playwright-script-creation + playwright-execution + browser-test + playwright-browser-connect
playwright-evidence	証跡とレポート	playwright-report + playwright-evidence-drive
playwright-kit-ops	実行環境の運用	playwright-kit-ops（改名せず単独で維持）

playwright-kit-ops は playwright_kit パッケージ本体・tests/・scripts/・templates/ を持つため他へ吸収せず、ディレクトリ配置も変更していない。scripts/build-runtime-plugins.sh の除外パターン（.venv / .pytest_cache / __pycache__ / *.pyc / *.pyo を find で除去）は Skill ディレクトリを丸ごと走査するため、この配置のまま従来どおり効く。

playwright-scenario-test が担っていた orchestrator の役割（大原則・全体ワークフロー・クイックスタート）は、工程の入口である playwright-planning へ移した。

統合前後の行数

SKILL.md の行数。

統合後	行数	統合元	行数
playwright-planning	124	playwright-test-planning 97 + playwright-scenario-test 68	165
playwright-authoring	250	playwright-script-creation 108 + playwright-execution 101 + browser-test 159 + playwright-browser-connect 484	852
playwright-evidence	172	playwright-report 55 + playwright-evidence-drive 190	245
playwright-kit-ops	116	playwright-kit-ops 119	119
合計	662		1,381

SKILL.md 合計は 1,381 → 662 行（-52%）。統合元に 484 行（上限 500 行間際）の playwright-browser-connect があったため、CDP 接続の手順を playwright-authoring/references/browser-connection.md（326 行）へ分割した。補助ファイルを含めても 1,381 → 988 行（-28%） で、統合前合計を下回る。全 SKILL.md は 500 行以内（最大 250 行）に収まっている。

playwright-browser-connect では Chrome 起動コマンドが Windows で 3 回・macOS で 2 回重複し、--remote-allow-origins=* の説明も 3 箇所にあった。これらをフラグ表 1 つへ集約したことが削減の主因である。

manifest の判断

manifest	変更
claude-skills.txt	browser-test → playwright-authoring（用途順の同位置を維持、29 個で不変）
kiro-skills.txt	同上（28 個で不変）
codex-skills.txt	playwright-execution / playwright-kit-ops / playwright-report / playwright-script-creation / playwright-test-planning の 5 個 → playwright-authoring / playwright-evidence / playwright-kit-ops / playwright-planning の 4 個（アルファベット順、30 → 29 個）

判断理由:

• claude / kiro に playwright-authoring のみを載せる: 統合前に両 runtime へ配布していたのは browser-test 1 個だけで、pytest ベースの一式は codex 限定だった。browser-test の内容は「MCP でのブラウザ動作確認」節として playwright-authoring に入ったため、この 1 個を置き換えれば従来の配布範囲を過不足なく引き継げる。playwright-kit-ops を追加すると Python パッケージ一式が両 runtime の配布物に加わり、配布範囲の拡大という別判断になるため本 PR では行わない。
• codex に playwright-evidence を載せる: 統合元のうち playwright-report は codex に載っており、playwright-evidence-drive は載っていなかった。統合後は Drive 連携の記述を含むが、playwright-kit-ops が既に「Codex 公開セットには google-auth skill を同梱しないため GOOGLE_AUTH_SCRIPTS を設定する」と optional dependency として案内済みで、同じ扱いで整合する。レポート生成という codex に必要な機能を落とさないことを優先した。
• playwright-authoring の「関連 Skill」に、他の 3 個が codex 公開セット同梱であり claude / kiro では plugins/ndf-shared/skills/ を参照する旨を注記した。

frontmatter

description は二重引用符で囲み、最初の 1 文に「何をするか + 主要トリガ」を置いた。when_to_use には追加トリガのみを残している。<> は含まない。

Skill	description	when_to_use	合計
playwright-planning	239	161	400
playwright-authoring	269	249	518
playwright-evidence	238	176	414
playwright-kit-ops	56	266	322

いずれも運用目標 300 文字以内 / 合計 1,536 文字以内に収まる。

disable-model-invocation の付け外しは Task 0-7 の担当範囲のため行っていないが、統合元 4 個のうち browser-test だけがこれを持っていたため、統合により結果として外れている（残る 3 個は自動発動可）。3 個分の自動発動を失う方が損失が大きいと判断した。browser-test の argument-hint: "[url]" は URL 指定のスモーク確認で使うため引き継いだ。Task 0-7 で再評価する。

更新した参照箇所

ファイル	内容
plugins/ndf-shared/manifests/{claude,codex,kiro}-skills.txt	上表のとおり
plugins/ndf-claude/.claude-plugin/plugin.json	./skills/browser-test → ./skills/playwright-authoring
README.md	Skill 一覧の分類と個数（PR/レビュー 13 → 12、E2E/Playwright 6 → 4、元 Skills 49 → 44、codex 公開 30 → 29）。あわせて集計漏れだった statusline を運用カテゴリへ追加し、内訳の合計を総数と一致させた
plugins/ndf-shared/skills/issue-plan-strategy/SKILL.md	/ndf:playwright-scenario-test → /ndf:playwright-planning（2 箇所）
plugins/ndf-shared/skills/playwright-kit-ops/SKILL.md	関連 Skill を統合後の 3 個へ
playwright-kit-ops/templates/conftest.py.template / templates/scenario.config.yaml	/ndf:playwright-browser-connect → /ndf:playwright-authoring
playwright-kit-ops/playwright_kit/pytest_plugin.py / playwright_kit/fixtures/__init__.py	docstring と pytest option group の表示名から、存在しなくなる Skill 名 playwright-scenario-test を除去

plugins/ndf-{claude,codex,kiro}/skills/ は bash scripts/build-runtime-plugins.sh で同期した生成物であり、直接編集していない。issues/ 配下のプラン文書、docs/superpowers/plans|specs/、docs/external-reviews/ は当時の記録であるため書き換えていない。

Test plan

• bash scripts/build-runtime-plugins.sh — 生成物を同期
• bash scripts/build-runtime-plugins.sh --check — runtime plugin generated files are up to date（差異なし）
• python3 scripts/check-markdown-links.py --root . — Markdown local links are valid
• bash scripts/validate-runtime-plugins.sh — runtime plugin validation passed（claude plugin validate 2 件、manifest / 生成パス検査、Kiro installer の dry-run を含む）
• 旧 Skill 名 9 個の全文検索で、履歴文書（issues/ / docs/superpowers/ / docs/external-reviews/）以外に残存参照なし
• 全 SKILL.md が 500 行以内（最大 playwright-authoring 250 行）
• 統合後の SKILL.md 合計 662 行 < 統合前合計 1,381 行

release PR: #66

[takemi-ohama]

🤖 cross-review | round 1 | codex | APPROVE

修正必須の指摘はありません。

[takemi-ohama]

🤖 cross-review | round 1 | gemini | APPROVE

Skill 統合・削除の網羅性、および 3 ランタイム (Claude Code / Codex / Kiro) への配布物・manifest 反映を重点的に確認しました。
削除・統合対象の参照漏れはなく、manifest の更新も正確に行われています。修正が必要な点はありません。

[takemi-ohama]

🤖 cross-review | round 2 | codex | APPROVE

修正必須の指摘はありません。旧 Skill 名の参照漏れ、3 runtime の manifest / 生成物同期、Markdown link、runtime plugin validation を確認しました。

[takemi-ohama]

🤖 cross-review | round 2 | gemini | APPROVE

Skill の統合・削除による不要ファイルのパージと、それに伴う各ランタイム向け plugin.json やマニフェストファイル (codex-skills.txt, claude-skills.txt, kiro-skills.txt) の整合性を確認しました。

• 削除された古い Skill (browser-test や python-execution 等) への参照漏れがないことを確認済みです。
• playwright_kit へのリネーム、および配布先ごとの Skill 選別がマニフェストおよびドキュメントに正しく反映されており、設計や仕様に矛盾や問題はありません。