project-skill-scripts

/project:skill-scripts

プラグインのスキルを分析して、サポートスクリプトによってパフォーマンス（トークンの削減、実行の高速化、結果の一貫性）を改善できる機会を特定し、必要に応じてスクリプトを作成します。

このスキルを使う場面

このスキルを使う場面	代替手段を使う場面
スキルの改善機会を分析する	1つのスキル用に単一のスクリプトを作成する
複数のプラグインにまたがってスクリプトを一括作成する	特定のニーズに対して単発のスクリプトを作成する
ポートフォリオ全体のスクリプトの網羅率を測定する	スクリプトの生成がすでに完了している

コンテキスト

• プラグインのルート: !git rev-parse --show-toplevel
• プラグインの合計数: !find . -maxdepth 2 -name 'plugin.json' -type f
• スクリプトがあるスキル: !find . -name 'scripts/*.sh' -type f

パラメーター

$ARGUMENTS を解析して、次の項目を確認します。

• --analyze: すべてのスキルをスキャンして候補を報告します（デフォルト）
• --create <plugin/skill>: 指定したスキルのみスクリプトを作成します
• --all: すべての高スコア候補を分析してスクリプトを作成します

実行

このスキルのスクリプト分析・作成ワークフローを実行します。

ステップ 1: 分析スクリプトを実行する

分析ツールを実行して、すべてのスキルの構造化データを取得します。

1. 分析ツールを実行します: bash "${CLAUDE_PLUGIN_ROOT}/skills/project-discovery/scripts/analyze-skills.sh" $(git rev-parse --show-toplevel 2>/dev/null || echo '.')
2. 出力を解析して、次の項目を特定します。
   • 現在の網羅率（スクリプトがあるスキル）
   • 高スコア候補（スコア >= 8）
   • 推奨されるスクリプトの種類

ステップ 2: 候補を分析する（--create または --all モード）

候補となる各スキルについて、次を実行します。

1. ワークフローを理解するため、SKILL.md を読みます。
2. スクリプト化の機会となるパターンを特定します。
   • 複数の git/gh コマンドを順に実行する → コンテキスト収集スクリプト
   • 複数フェーズのワークフロー → ワークフロースクリプト
   • プロジェクトタイプの検出と条件付き実行 → 複数ツールのスクリプト
   • 引数を変えて同じコマンドを繰り返す → ユーティリティスクリプト
3. 利点を評価します。ツール呼び出しが 4 回以上あること、一貫性、エラー処理、再利用頻度を考慮します。
4. 次の場合はスキップします。単純なコマンドが 1 つだけの場合、対話的・創造的な作業の場合、すでに十分に構造化されている場合。

ステップ 3: スクリプトを作成する

承認された候補について、次を実行します。

1. 構造化出力（KEY=value、セクションマーカー）を含む標準スクリプトテンプレートを使用します。
2. 設計原則に従います。構造化出力、エラー耐性、出力の上限設定、移植性。
3. <plugin>/skills/<skill-name>/scripts/<script-name>.sh に配置します。
4. 実行可能にします: chmod +x <path>
5. スクリプトを参照する「推奨」セクションを SKILL.md に追加します。
6. フロントマターの modified: 日付を更新します。

ステップ 4: 結果を報告する

調査結果を提示します。

• 現在の網羅率（スクリプトがあるスキル数 X/Y）
• 作成したスクリプト（プラグイン、スキル、スクリプト、種類、置き換えたコマンド）
• 残りの候補（プラグイン、スキル、スコア、種類、推奨事項）
• 次の手順（テスト、コミット）

ステップ 5: 変更をコミットする

スクリプトを作成した場合:

feat(<affected-plugins>): add supporting scripts to skills

本文に次の内容を含めます。

• 作成したスクリプト
• 置き換えた内容（トークン／呼び出しの削減）
• 更新した SKILL.md ファイル

例

分析のみ

$ /project:skill-scripts --analyze

Skill Scripts Analysis

Current Coverage: 5/191 skills have supporting scripts

Top Candidates:
  git-plugin/gh-cli-agentic         score=14  type=context-gather
  kubernetes-plugin/kubectl-debugging score=12  type=multi-tool
  testing-plugin/playwright-testing   score=10  type=workflow

特定のスキル向けに作成

$ /project:skill-scripts --create testing-plugin/playwright-testing

Analyzing testing-plugin/playwright-testing...
Found: 6 bash blocks, 3 phases, 12 commands

Creating scripts/run-tests.sh...
- Consolidates: test discovery, execution, report parsing
- Replaces: 5 individual tool calls
- Output: structured test results with file:line references

Updated SKILL.md with "Recommended" section.

エラー処理

状況	対応
スキルに bash パターンがない	スキップし、「スクリプト化の機会なし」と報告する
スクリプトがすでに存在する	既存であることを報告し、上書きするか確認する
SKILL.md が読み取り専用	エラーを報告し、手動で更新するよう提案する
プラグインが見つからない	利用可能なプラグインを一覧表示する