コマンド

---
description: オプションの説明（/help で表示されます）
---
 
ここにプロンプトの内容を記述します。
パラメータの注入には {{args}} を使用してください。

---
description: ステージされた変更に基づいてコミットメッセージを生成する
---
 
以下の diff に基づいてコミットメッセージを生成してください:
 
```diff
!{git diff --staged}
```

#### 4. ファイルコンテンツの注入（`@{...}`）

| ファイルタイプ | サポート状況           | 処理方法                    |
| -------------- | ---------------------- | --------------------------- |
| テキストファイル | ✅ 完全サポート        | コンテンツを直接注入      |
| 画像/PDF         | ✅ マルチモーダル対応 | エンコードして注入        |
| バイナリファイル | ⚠️ 制限付きサポート   | スキップまたは切り捨てられる可能性あり |
| ディレクトリ     | ✅ 再帰的注入         | .gitignore のルールに従う |

例：コードレビューのコマンド

```markdown
---
description: ベストプラクティスに基づくコードレビュー
---

{{args}} をレビューし、以下の基準を参照：

@{docs/code-standards.md}
```

### 実践的な作成例

#### 「純粋関数リファクタリング」コマンド作成手順表

| 操作                         | コマンド/コード                           |
| ---------------------------- | ----------------------------------------- |
| 1. ディレクトリ構造を作成   | `mkdir -p ~/.qwen/commands/refactor`      |
| 2. コマンドファイルを作成   | `touch ~/.qwen/commands/refactor/pure.md` |
| 3. コマンド内容を編集       | 下記の完全なコードを参照してください。     |
| 4. コマンドをテスト         | `@file.js` → `/refactor:pure`             |

```markdown
---
description: 純粋関数にコードをリファクタリングする
---

現在のコンテキスト内のコードを分析し、純粋関数にリファクタリングしてください。
要件：

1. リファクタリングされたコードを提供する
2. 主な変更点と純粋関数の特徴実装について説明する
3. 関数の動作は変更しない
```

### カスタムコマンドのベストプラクティスまとめ

#### コマンド設計推奨テーブル

| プラクティスポイント | 推奨アプローチ                      | すべきではないこと                          |
| -------------------- | ----------------------------------- | ------------------------------------------- |
| コマンド命名         | 組織のために名前空間を使用する      | あまりにも一般的な名前を避ける              |
| パラメータ処理       | 明確に `{{args}}` を使用する        | デフォルトの追加に依存する（混同しやすい）  |
| エラー処理           | シェルのエラー出力を活用する      | 実行失敗を無視する                          |
| ファイル構成         | 機能ごとにディレクトリで整理する    | すべてのコマンドをルートディレクトリに置く  |
| 説明フィールド       | 常に明確な説明を提供する            | 自動生成された説明に依存する                |

#### セキュリティ機能リマインダーテーブル

| セキュリティメカニズム | 保護効果                   | ユーザー操作           |
| ---------------------- | -------------------------- | ---------------------- |
| シェルエスケープ       | コマンドインジェクションの防止 | 自動処理               |
| 実行確認               | 偶発的な実行の回避         | ダイアログでの確認     |
| エラーレポート         | 問題の診断を支援           | エラー情報の表示       |