スキルレビュー

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

レビューワークフロー

ステップ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

改善の機会：

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

レビューセッション例

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

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