refactor: 利用実績のない Skill を削除し発動条件を見直す (0-6)

[takemi-ohama]

Summary

棚卸台帳の「整理の判断基準」（起動数 × 機会数）に従い、plugins/ndf-shared/skills/ から 8 個を削除した。sync-main は Task 0-4 の担当のためここには含まない。あわせて、起動ゼロだが機会があり削除対象にしない 4 個の発動条件を見直した。

Skill 総数は 41 個（削除前 49 個 − 本 PR の 8 個。統合分は別 PR）。

削除した 8 個

Skill	起動 / 機会	適用した判定	根拠
git-gh-operations	0 / 1,840	例外（モデルの標準能力で足りる）	Git / gh の一般操作はモデルが熟知。機会 1,840 はトリガ git addgit commit が広すぎることによる誤検出で、需要ではない
knowledge-reorg	0 / 0	既定	需要がない
google-chat	0 / 16	例外（モデルの標準能力で足りる）	手順は汎用の HTTP 呼び出しで代替できる
mcp-builder	0 / 0	既定	需要がない。上流の公式 Skill をそのまま同梱していたもの
data-analyst-sql-optimization	0 / 14	例外（モデルの標準能力で足りる）	最適化パターンの一覧のみで、Skill 固有の知識が残らない
python-execution	0 / 1,207	例外（モデルの標準能力で足りる）	実行環境の検出はモデルが自力で行える。トリガ pythonスクリプト が広すぎ、他 Skill の発動を埋もれさせていた
data-analyst-export	0 / 54	例外（モデルの標準能力で足りる）	出力形式の指定のみで、データ分析エージェントの定義に直接書けば足りる
deepwiki-transfer	1 / —	例外（起動 1 回・代替あり）	最終利用 2026-05-21。取り込み手順は汎用の取得コマンドで代替できる

manifest に載っていた（＝実際に配布されていた）のは python-execution と git-gh-operations の 2 個のみで、残る 6 個は共通編集元にのみ存在していた。

data-analyst エージェントへ移した内容

data-analyst-export と data-analyst-sql-optimization は「データ分析エージェントの定義に直接書けば足りる」が削除理由のため、削除前に plugins/ndf-claude/agents/data-analyst.md へ次を移した。

• SQL最適化パターン: N+1削減 / インデックス / JOIN最適化 / ウィンドウ関数 / EXISTS vs IN / LIMIT活用 の 6 パターン表と、EXPLAIN で実行計画を確認してから適用し再度確認する手順、DO / DON'T 表
• エクスポート形式の選択: CSV / JSON / Excel / Markdown の用途と注意点（Excel 向け CSV は UTF-8 BOM、日付は ISO 8601、Excel は 1,048,576 行で分割、Markdown はパイプ文字のエスケープ）、DO / DON'T 表
• 専門領域「3. データ出力」に Markdown テーブルを追記

移さなかったもの: scripts/export-csv.js。01-formats.md は export-json.js / export-excel.js / export-markdown.js も案内していたが、実体は export-csv.js の 1 本しか存在せず、記載の 4 分の 3 が動かない状態だった。出力自体はモデルが直接書けるため、スクリプトは移さず削除した。

mcp-builder のライセンス確認結果

告知義務は残らない。削除して問題ない。

• mcp-builder は上流 anthropics/skills 由来で、frontmatter に license: Complete terms in LICENSE.txt を持つ唯一の Skill だった
• 同梱の LICENSE.txt は Apache License 2.0（Copyright 2026 Anthropic, PBC.）。NOTICE ファイルは同梱されておらず、リポジトリ全体にも存在しない
• Apache-2.0 の第 4 条（ライセンス文の同梱・改変告知・NOTICE の伝達）はいずれも 頒布する場合の義務である。SKILL.md / reference/ / scripts/ / LICENSE.txt を含むディレクトリ全体を削除し、上流由来の記述を派生物として残していないため、削除後に伝達すべき告知は残らない
• リポジトリに残る mcp-builder の記載は、docs/claude-code-skills-survey.md / docs/claude-code-skills-official-reference.md / docs/official-skills-installation.md の Apache-2.0 一覧など、上流カタログの紹介であり当リポジトリの同梱物を指していない。そのまま残した
• docs/official-skills-installation.md の「NDFが同梱している公式Skill」節は、同梱がなくなった旨とインストーラでの入手手順に書き換えた
• 代替経路として official-skills-autoloader の対応マッピングに「MCPサーバー作成 → mcp-builder」を追加した

発動改善した 4 個（削除しない）

deploy（0 / 340）

環境ブランチへ書き込む破壊的操作のため disable-model-invocation: true は維持した。description のみ改善している。

• before: "Create deploy PRs from feature to environment branches."
• after: "Create a deploy PR from the current feature branch to an environment branch such as qa/staging or release/v2. 破壊的操作のため、利用者が /ndf:deploy を明示的に指示したときのみ実行する（環境ブランチへデプロイ / qaに上げる / stagingに反映 / リリースブランチへPR）。deployブランチを作成し origin/main を取り込んでからPRを出す。"

qa-security-scan（0 / 66）

when_to_use に閉じ込めていたトリガを description へ移し、自動発動できるようにした。

• before: description"Run OWASP-focused security checks." / when_to_use"Use when conducting security testing or vulnerability assessment. Triggers: 'security scan', ..."
• after: description"Run an OWASP Top 10 security review of code, authentication, authorization, and data protection. Use when asked for a security scan, vulnerability assessment, or a security review of a change（セキュリティスキャン / 脆弱性チェック / セキュリティレビュー / OWASP / 認証認可の確認 / SQLインジェクションの確認）."（when_to_use は description の言い換えになるため削除）

official-skills-autoloader（0 / 97）

各ランタイムの公式 Skill 提供状況を確認した結果、Claude Code 専用と確定した。

ランタイム	Skill 読込先	本 Skill が有効か
Claude Code	.claude/skills/、プラグインの skills/	有効（インストール先 ~/.claude/skills/ を読む）
Codex	.agents/skills/	無効
Kiro CLI	.kiro/skills/ / ~/.kiro/skills/	無効

• before: description"Install and use official document Skills on demand." / when_to_use に Word/Excel 等のトリガ
• after: description"Install an Anthropic official Skill on demand and run it. Use when the request needs Word/Excel/PowerPoint/PDF creation or editing, frontend design, webapp testing, or MCP server scaffolding（Word作成 / Excel出力 / スライド生成 / PDF作成 / .docx / .pptx / .xlsx / .pdf / MCPサーバーを作りたい）. Claude Code 専用。"（when_to_use は削除）
• 本文に「対応ランタイム」節を追加し、Codex / Kiro では効かないこと、および現在どの manifest にも載っておらず配布物へ含まれていないことを明記した

logging-guidelines（0 / 112）

paths でコード変更時に限定した（Claude Code 独自項目。Codex / Kiro では無視される）。

• before: description"Design safe and useful application logging." / when_to_use に 'logger''logging' 等の広いトリガ
• after: description"Choose log levels and write safe, useful application logs when adding or reworking logging in code（ログ追加 / logger / ログレベル / デバッグログ / エラーログ / print文をログに）. Use when editing source code that emits logs, to pick the level and keep secrets and personal data out of the output."
• paths に **/*.py**/*.ts**/*.tsx**/*.js**/*.jsx**/*.go**/*.rb**/*.java**/*.kt**/*.php**/*.rs**/*.sh を追加

4 個とも description は二重引用符で囲み、最初の 1 文に「何をするか + 主要トリガ」を置き、300 文字以内（244 / 262 / 288 / 270 文字）で、<> を含まない。

併せて更新した参照

• plugins/ndf-shared/manifests/{claude,codex,kiro}-skills.txt から python-execution / git-gh-operations を除去（27 / 28 / 26 個）
• plugins/ndf-claude/.claude-plugin/plugin.json の skills 配列
• plugins/ndf-codex/.codex-plugin/plugin.json の description（"GitHub operations" を除去）
• plugins/ndf-shared/skills/docker-container-access/SKILL.md / skill-stats/SKILL.md の関連 Skill リンク
• README.md の Skill 一覧（49 → 41 個。区分ごとの件数が合っていなかったため、未記載だった playwright-browser-connect / playwright-evidence-drive / statusline も補って合計を一致させた）
• docs/ndf-plugin-reference.md / docs/official-skills-installation.md
• 生成物 plugins/ndf-{claude,codex,kiro}/skills/ は scripts/build-runtime-plugins.sh で同期

issues/ 配下のプラン文書と docs/specifications/ndf-skill-inventory.md（棚卸台帳）は記録のため書き換えていない。

本 PR では扱わなかった点（後続タスクへ）

• qa-security-scan と official-skills-autoloader はどの manifest にも載っておらず配布されていない。起動ゼロの直接の原因はここにあり、description を直しても配布されるまで発動しない。配布セットの決定は Task 0-7 / 0-10 の担当のため、本 PR では manifest を変更していない
• deploy の argument-hint に <env-branch> という <> が残っている（frontmatter の <> 禁止に抵触）。frontmatter の一括見直しは Task 0-7 の担当のため触っていない
• disable-model-invocation の一括見直しも Task 0-7 の担当。本 PR は deploy の維持のみ

Test plan

• grep -rn で削除した 8 個の Skill 名が、issues/ と棚卸台帳を除いてヒットしない（残るのは上流カタログとしての mcp-builder の記載のみ）
• 削除が manifest 3 種すべてに反映されている
• 発動改善対象 4 個の description に発動条件が含まれ、二重引用符・300 文字以内・<> なしを満たす
• bash scripts/build-runtime-plugins.sh 実行後、bash scripts/build-runtime-plugins.sh --check が差異なし
• python3 scripts/check-markdown-links.py --root . が成功する
• bash scripts/validate-runtime-plugins.sh が成功する（claude plugin validate を含む）

release PR: #66
plan: issues/ndf-development-skills/07-tasks.md

[takemi-ohama]

🤖 cross-review | round 1 | codex | APPROVE

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

[takemi-ohama]

🤖 cross-review | round 1 | gemini | APPROVE

変更内容を網羅的に確認しました。
Skill の削除と 3 ランタイムの manifest (claude-skills.txt, codex-skills.txt, kiro-skills.txt) への反映漏れはなく、ビルドスクリプトを通じた生成物・プラグイン定義の同期も正常に行われる状態です。
また、統合元 (data-analyst-sql-optimization, data-analyst-export) の手順は、要点を損なうことなく data-analyst.md へ適切に要約・移植されていることを確認しました。
設計や後方互換性においても特に懸念点はありません。適切なクリーンアップです。