カスタムコマンド(Custom Commands)
カスタムコマンド機能を使用すると,よく使用するプロンプトやワークフローを再利用可能なコマンドとしてカプセル化できます。Agent ダイアログで/ を入力するだけで,これらのコマンドをすばやく呼び出すことができ,日常の開発効率が大幅に向上します。
コードレビュー,テストケースの生成,プロジェクト仕様への素早いアクセスなど,頻繁に行う作業をカスタムコマンドで「ワンクリック」タスクに簡素化できます。
コマンドの種類とスコープ
| 機能 | ユーザーコマンド（User Commands） | プロジェクトコマンド（Project Commands） |
|---|---|---|
| スコープ | 現在のユーザーのすべてのプロジェクトに適用 | 現在のプロジェクトルートディレクトリとそのサブディレクトリでのみ有効 |
| 保存場所 | - macOS / Linux: /home/<username>/.qoder/commands/ または /Users/<username>/.qoder/commands/- Windows: C:\Users\<username>\.qoder\commands\ | <プロジェクトルート>/.qoder/commands/ |
| ディレクトリ構成 | commands ディレクトリ下でのフォルダーによる分類をサポート | commands ディレクトリ下でのフォルダーによる分類をサポート |
| ユースケース | 一般的な開発タスク： • コードレビュー • ユニットテストの生成 | プロジェクト固有のタスク： • プロジェクトの API 仕様確認 • 設定ファイル形式の検証 |
| 共有方法 | 現在のユーザーのみ使用可能 | Git などのバージョン管理システムを通じてチームメンバーと共有可能 |
注意:ユーザーレベルのコマンドはデバイス間同期をサポートしていません。設定ファイルを手動で移行することができます。 注意:プロジェクトレベルのコマンドを作成する前に、対象のプロジェクトを開いてください。同名のユーザーレベルとプロジェクトレベルのコマンドが同時に存在する場合、リストには区別しやすくするためにスコープのインジケーターが表示されます。
カスタムコマンドの作成
-
コマンド管理画面を開く
- 方法1：Qoder 設定のコマンドページに移動し、**「追加」**ボタンをクリック
- 方法2：ダイアログで
/を入力し、下部の**「コマンドを追加」**ショートカットをクリック（表示されている場合）
-
上部の検索バーに一意のコマンド名（例：
gen-test）を入力し、Enter キーを押します。 -
コマンド名のルール：
- 小文字のアルファベット、数字、ハイフン（
-）、アンダースコア（_）のみサポート - 名前は空にできません
- 名前の長さは 100 文字以内を推奨
- 同じスコープ内で既存のコマンド名と重複することはできません
- 小文字のアルファベット、数字、ハイフン（
-
コマンドタイプを選択：
- ユーザーレベル：すべてのプロジェクトに適用される汎用コマンド
- プロジェクトレベル：現在のプロジェクトでのみ使用可能。プロジェクトが開かれていない場合は作成できません。
- 編集エリアにコマンドの説明と本文内容を記入します。冒頭に目的を簡単に説明し、本文に完全なプロンプトや手順を記述することをお勧めします。
-
保存後、会話に戻り、ダイアログで
/を入力すると、新しく作成したコマンドが表示されます。
注意:コマンドの本文が空の場合、またはデフォルトのプレースホルダー内容のみが残っている場合、そのコマンドは利用可能なリストに表示されません。
コマンドの更新とリストの更新
コマンドファイルを追加、変更、または削除すると、コマンドリストは最新の状態に更新され、会話で最新バージョンを引き続き使用できます。 一般的な更新シナリオは次のとおりです：- コマンドを追加すると、リストに新しい選択肢が表示されます
- コマンド内容を変更すると、その後の選択時に更新された内容が使用されます
- コマンドを削除すると、リストから対応する項目が消えます
- 整理しやすいように、目的別にコマンドを異なるサブディレクトリに配置する
- リストでの検索と識別を容易にするために、コマンドに明確な説明を記述する
- 重複と混乱を減らすために、使用されなくなった古いコマンドを定期的にクリーンアップする
コマンドの例
/code-inspect
/code-inspect
/security-check
/security-check
/create-pr
/create-pr
/project-test
/project-test
/gen-agents-md
/gen-agents-md