スキルレビュー

公式ベストプラクティスに基づいてスキルをレビューし、具体的な改善提案を行う。

ワークフロー

ステップ1: 対象スキルの特定

レビュー対象のSKILL.mdファイルを特定する：

• •ユーザーがパスを直接指定
• •カレントディレクトリでSKILL.mdを検索
• •複数のスキルが存在する場合はユーザーに確認

ステップ2: 読み込みと分析

1. •対象のSKILL.mdファイルを完全に読み込む
2. •best-practices.md でチェックリストを確認
3. •YAMLフロントマター（name, description）を解析
4. •ボディコンテンツの構造を分析

ステップ3: ベストプラクティスとの照合

各カテゴリを評価：

フロントマターチェック

• •name: 長さ、形式、命名規則
• •description: 完全性、具体性、トリガー

ボディチェック

• •行数（目標: 500行以下）
• •構造の明確さ
• •Progressive Disclosureの使用
• •ワークフロー設計の品質

コンテンツチェック

• •用語の一貫性
• •例の品質
• •テンプレートの適切さ

アンチパターン検出

• •デフォルトなしの複数選択肢
• •Windowsスタイルのパス
• •時間に依存する情報
• •マジック定数

ステップ4: レビューレポート生成

出力形式：

# スキルレビューレポート: {skill-name}

## サマリー
- 総合評価: {PASS | NEEDS_IMPROVEMENT | CRITICAL_ISSUES}
- Critical: {件数}
- Warning: {件数}
- Info: {件数}

## Critical（必須修正）
{修正必須の問題をリスト}

## Warning（推奨修正）
{推奨される改善をリスト}

## Info（改善提案）
{オプションの強化をリスト}

## 具体的な推奨事項
{例を含む具体的なアクションアイテム}

ステップ5: インタラクティブな改善

レポート提示後：

1. •ユーザーに修正を希望するか確認
2. •Critical問題を優先的に修正
3. •段階的に修正を適用
4. •各修正後に再検証

重要な注意事項

重大度分類の基準

Critical - スキルの正常な機能を妨げる問題:

• •descriptionが空または不足
• •ボディが500行を大幅に超過
• •スクリプトのセキュリティ脆弱性
• •スクリプトのエラー処理不足

Warning - スキルの効果を低下させる問題:

• •Progressive Disclosureが適用されていない
• •例が不十分
• •用語が一貫していない
• •ワークフローが不明確

Info - 改善の機会:

• •より簡潔にできる
• •構造の最適化
• •追加の例があると良い

レビューの原則

• •ベストプラクティスに厳格に準拠
• •具体的で実行可能な改善提案を提供
• •Critical問題を最優先で指摘
• •段階的な改善アプローチを推奨

実行例

例1: 基本的なスキルレビュー

ユーザー: 「pdf-processorスキルをレビューして」

実行内容:

1. •読み込み: skills/pdf-processor/SKILL.md
2. •ロード: references/best-practices.md
3. •チェックリストに照らして分析
4. •レビューレポートを生成
5. •修正を提案

レポート例:

# スキルレビューレポート: pdf-processor

## サマリー
- 総合評価: NEEDS_IMPROVEMENT
- Critical: 1件
- Warning: 2件
- Info: 1件

## Critical（必須修正）
- description不足: トリガーワードが含まれていない

## Warning（推奨修正）
- Progressive Disclosure未使用: 長い手順が平坦に記述されている
- 例が不十分: 実行例セクションがない

例2: カレントディレクトリのスキルレビュー

ユーザー: 「このスキルをレビューして」（カレントディレクトリで実行）

実行内容:

1. •カレントディレクトリで SKILL.md を検索
2. •見つかった場合は自動的にレビュー開始
3. •複数見つかった場合はユーザーに選択を促す