Skip to main content
拡張機能

コマンド

/ で繰り返し使うワークフローを呼び出し、独自の作業指示をコマンドとして保存します。

引き継ぎの作成、変更のレビュー、決まった形式での報告など、繰り返し使う作業指示を Command（コマンド）として保存できます。タスクの入力欄で / から選択し、今回の対象を補足すると、同じ指示を再利用できます。 コマンドは、インストール済みのプラグインから提供されるものと、自分で作成する Markdown ファイルがあります。

利用できるコマンドを探す

Settings → Extension management → Commands では、プラグインが提供するコマンドの名前、説明、提供元を確認できます。利用したい場合は、Extensions → Plugins で該当プラグインをインストールして有効にします。 タスクの入力欄で / に続けて名前やキーワードを入力し、コマンドの候補を探します。プロジェクトのコマンドは、そのプロジェクトのワークスペースで使用します。複数のプロジェクトで使う指示はユーザーコマンドとして保存できます。

タスクでコマンドを呼び出す

  1. タスクを開きます。プロジェクトのコマンドを使う場合は、対応するワークスペースが選択されていることを確認します。
  2. / と名前やキーワードを入力し、上下キーで候補を選び、Enter または Tab で追加します。
  3. コマンドの後に、今回の目標、対象範囲、必要な資料を補足して送信します。
  4. 指示に沿った結果になっているか確認し、調整が必要な場合は同じタスクで追加の要求を伝えます。
たとえば GitLab プラグインをインストールして有効にした後、/pipeline から gitlab:pipeline-status を選び、確認するプロジェクトとパイプラインを指定します。外部サービスを使う場合は、該当コネクターの認証も必要です。 コマンドを選んだだけでは処理が始まらない場合、「このコマンドに従って現在のタスクの引き継ぎを作成してください」のように、実行する要求を明示してください。

カスタムコマンドを作成する

利用する範囲を決めて、対応するディレクトリに Markdown ファイルを保存します。ディレクトリがなければ作成してください。
範囲保存先適した内容
ユーザー~/.qoder/commands/複数のワークスペースで再利用する作業指示
プロジェクト<project>/.qoder/commands/そのプロジェクトのタスクで使用する規約や手順
~ はホームディレクトリです。 たとえば、次の内容で handoff.md を作成します。 
---
description: タスクの引き継ぎを作成する
---

現在の会話で行った作業を「完了した内容」「検証結果」「未確認の項目」に分けてまとめてください。
根拠のある結果だけを記載し、計画や未検証の作業を完了扱いにしないでください。
コマンドディレクトリ直下のファイルは、.md を除いた名前がコマンド名になります。description は候補一覧の説明、本文は再利用する作業指示です。入力欄で探しやすい、短く分かりやすい名前を付けてください。 保存したら新しいタスクで /handoff を入力し、コマンドを選び、「このタスクの引き継ぎを、未完了の項目も含めて作成してください」と補足します。ほかの資料は @ で追加できます。メッセージの送信も参照してください。

サブディレクトリのコマンド

呼び出し名はコマンドファイルの相対パスから決まります。階層はコロンで区切られ、tools/review.md は tools:review になります。/ メニューに検出された名前を選んで呼び出します。 frontmatter の表示名ではこの呼び出し名を上書きできません。ファイルの移動や名前変更後は、メニューの名前を再確認してください。

コマンドを変更・削除する

カスタムコマンドの指示は、自分の Markdown ファイルを編集して保存します。新しいタスクで / の一覧を開き直して確認してください。削除する場合は、ファイルを commands ディレクトリの外へ移し、一覧に表示されなくなったことを確認します。 プラグインが提供するコマンドは、所属するプラグインの管理から利用状態を変更します。

コマンドが見つからない場合

  • プラグインのコマンド：プラグインがインストール済みで有効か確認し、名前やキーワードで探します。gitlab:pipeline-status のように提供元の接頭辞を含む場合があります。
  • プロジェクトのコマンド：対応するワークスペースを選択し、そのプロジェクトの .qoder/commands/ にファイルがあるか確認します。
  • ユーザーコマンド：上表の保存先、.md 拡張子、実行する指示の本文を確認します。
ファイルの保存やプラグインの変更後は、候補一覧を閉じて / を再入力します。見つからない場合は、新しいタスクでもう一度確認してください。