/review-skill — Skills 品質レビュー（エージェント分離実行）

このコマンドは別エージェントを起動してレビューを行う。現在のセッションでは直接レビューしない。 実装コンテキスト（作成時の思考過程・設計判断・会話履歴）をレビューエージェントに渡さないことで客観性を確保する。 作成済みの Claude Code スラッシュコマンド / Claude.ai Skills が Anthropic のベストプラクティスに沿っているかを5軸（構造・トリガー・命令品質・出力設計・実用性）で100点満点評価する。 詳細な評価基準は workflows/software-development/review-skill.md を参照。 評価の根拠となるマニュアルは workflows/software-development/skills-building-guide.md。

---

実行手順

ステップ1: 情報収集（この実装セッションで行う）

以下の事実情報のみを収集する。スキル作成の意図・目的・設計判断の説明は含めない。

収集対象:
1. スキル作成マニュアル: workflows/software-development/skills-building-guide.md の内容（評価基準の根拠）
2. 詳細評価基準: workflows/software-development/review-skill.md の内容
3. 対象スキルファイル: 引数で指定されたファイル、または .claude/commands/*.md の全ファイルの内容
4. 関連ドキュメント: 対象スキルが参照している workflows/*/review-*.md 等のファイルの内容
5. CLAUDE.md のスキル一覧テーブル
6. README.md のドキュメント反映状況

引数によるスコープ制御

• 引数なし → .claude/commands/ 内の全スキルをレビュー
• ファイルパス指定 → そのファイルのみレビュー
• 複数ファイル指定 → 指定ファイル群をレビュー

ステップ2: レビューエージェント起動

Agent ツールを使い、以下の設定で別エージェントを起動する:

Agent ツールの設定:
- subagent_type: "general-purpose"
- description: "Review skill quality objectively"
- prompt: 以下のテンプレートに収集した情報を埋め込む

プロンプトテンプレート（レビューエージェントに渡す内容）:

あなたは Claude Skills のエキスパートレビュアーです。
Anthropic 公式ガイド「The Complete Guide to Building Skills for Claude」に基づき、
以下のスキルファイルの品質を客観的にレビューし、100点満点で評価してください。

## 行動原則
- 証拠主義: スキルファイルの記述事実のみに基づいて評価する。推測でスコアを付けない
- 各スコアにはファイルパスと該当箇所の引用を含めること
- 非破壊: レビューのみ行い、スキルファイルの編集は行わない
- 証拠不十分時は各レンジの下限で採点する

## スキル作成マニュアル（評価基準の根拠）
[ここに workflows/software-development/skills-building-guide.md の内容を埋め込む]

## 詳細評価基準
[ここに workflows/software-development/review-skill.md の内容を埋め込む]

## 対象スキルファイル
[ここに対象スキルファイルの内容を埋め込む（複数ある場合は全て）]

## 関連ドキュメント
[ここに対象スキルが参照している workflows/*/review-*.md 等の内容を埋め込む]

## CLAUDE.md スキル一覧テーブル
[ここに該当部分を埋め込む]

## README.md ドキュメント反映状況
[ここに該当部分を埋め込む]

## 評価軸（5項目・各20点 = 100点満点）

### 1. 構造・命名・フォーマット（20点）
- ファイル・フォルダ命名規則の準拠
- YAML フロントマター / ヘッダーの品質
- Progressive Disclosure の実装（詳細基準の分離）
- Markdown フォーマットの品質

### 2. Description / トリガー設計（20点）
- 「何をするか」の明確さ
- 「いつ使うか」のトリガーフレーズ
- オーバー/アンダートリガーのリスク
- 他スキルとの責任境界

### 3. 命令の品質・明確性（20点）
- 具体性・アクション可能性
- ステップ構造と依存関係
- 例・ユースケースの充実度
- エラーハンドリング

### 4. 出力設計・一貫性（20点）
- 出力テンプレート・フォーマット定義
- 採点基準・判定表の明確さ
- 行動原則・制約の明記
- 再現性の高さ

### 5. 実用性・保守性（20点）
- ユースケースの実用性
- 保守性・ドキュメント反映
- ポータビリティ
- Composability（他スキルとの共存）

---

## 詳細な評価基準

`workflows/software-development/review-skill.md` の内容を読み込んで詳細なチェックリストとして使用すること。
評価の根拠となるベストプラクティスは `workflows/software-development/skills-building-guide.md` に記載。

---

## 採点・判定

| 評価 | 点数 | 判定 |
|------|------|------|
| S | 90〜100 | 高品質。そのまま配布・共有可能 |
| A | 80〜89  | 軽微な改善後に配布可能 |
| B | 70〜79  | 重点項目の改善が必要。再レビュー |
| C | 60〜69  | 大幅な改善が必要 |
| D | 59以下  | 根本的な再設計が必要 |

---

## 出力フォーマット

```markdown
# Skills 品質レビュー結果

## 基本情報
- スキル名:
- レビュー日:
- スキル形式:（Claude Code コマンド / SKILL.md）
- ユースケースカテゴリ:
- 参照マニュアル: workflows/software-development/skills-building-guide.md

## 総合評価
- **総合点: XX / 100点**
- **判定: X (S/A/B/C/D)**

## 観点別採点

| # | 観点 | 配点 | 得点 | 主なコメント |
|---|------|------|------|-------------|
| 1 | 構造・命名・フォーマット | 20 | | |
| 2 | Description / トリガー設計 | 20 | | |
| 3 | 命令の品質・明確性 | 20 | | |
| 4 | 出力設計・一貫性 | 20 | | |
| 5 | 実用性・保守性 | 20 | | |

## 良かった点（Keep）

## 改善提案（Problem / Try）

## Anthropic ベストプラクティスとの差分

| チェック項目 | 状態 | コメント |
|------------|------|----------|
| kebab-case 命名 | OK / NG / N/A | |
| description に「何を・いつ」 | OK / NG / N/A | |
| Progressive Disclosure | OK / NG / N/A | |
| エラーハンドリング記載 | OK / NG / N/A | |
| 出力テンプレート定義 | OK / NG / N/A | |
| 行動原則の明記 | OK / NG / N/A | |
| 例・ユースケースの提供 | OK / NG / N/A | |
| CLAUDE.md / README への反映 | OK / NG / N/A | |

## 具体的な改善箇所

| 観点 | ファイル/箇所 | 現状 | 問題点 | 改善案 |
|------|-------------|------|--------|--------|
| | | | | |

## 次のアクション

1. 【必須】
2. 【推奨】
3. 【任意】
```

ステップ3: 結果の報告

レビューエージェントから返却された結果を、そのままユーザーに表示する。 要約や解釈を加えない（レビューの客観性を維持するため）。

---

注意事項

• 絶対に実装セッション内で直接レビューしない。必ず Agent ツールで別エージェントを起動すること
• レビューエージェントに渡す情報は事実（スキルファイルの記述内容・評価基準ドキュメント）のみ。スキル作成の意図・設計判断・会話履歴は渡さない
• 対象スキルの規模が小さい場合でも分離実行する。規模で判断しない
• 詳細なアーキテクチャは agents.md を参照