Skip to main content
設定とセキュリティ

出力スタイル

応答のトーン、詳細度、構成を調整します。システムプロンプトに指示を追加するのみで、Qoder のコアアイデンティティとセキュリティ制約は変更しません。

出力スタイル（Output Style）は、Qoder CLI の応答のトーン、詳細度、構成方法を調整するために使用されます。たとえば、応答をより簡潔にしたり、教育的なトーンにしたり、特定の構造を持たせたりしたい場合があります。出力スタイルを選択またはカスタマイズすることで、毎回会話で繰り返し指示することなく、Qoder の表現方法を個人やチームの習慣に合わせることができます。 出力スタイルは「表現方法」にのみ影響し、Qoder のコアアイデンティティやセキュリティ制約を変更することはありません。システムプロンプトに追加の指示を重ねるだけであり、組み込みの行動指針を置き換えたり回避したりすることはできません。

設定方法

出力スタイルは、構成項目 outputStyle （トップレベルキー）で指定し、値にはスタイル名を指定します。 
{
  "outputStyle": "concise"
}
general.outputStyle の下に記述することも可能です。両方に設定されている場合は、トップレベルの設定が優先されます。 outputStyle を変更した後、Qoder CLI を再起動する必要があります。 特定のスタイルを一時的に使用したい場合は、起動時に --output-style パラメーターで指定できます。 
qoder --output-style concise
このパラメーターは現在のセッションにのみ有効で、構成項目よりも優先され、再起動も不要です。完全なパラメーターについては、CLI コマンドとパラメーター を参照してください。 この項目を設定しないか、デフォルトスタイルに設定した場合、Qoder は組み込みのデフォルト表現方法を使用し、追加のスタイルは適用されません。

スタイルのソースと優先順位

出力スタイルは複数のソースから取得できます。同じ名前のスタイルが複数のソースに存在する場合、以下の優先順位でマージされ、後者が前者を上書きします。
  1. 組み込みスタイル：Qoder CLI に付属するプリセットスタイル。
  2. プラグインが提供するスタイル：有効化されたプラグインによって宣言されたスタイル。
  3. ユーザーレベルスタイル：ユーザーレベル構成からのスタイル。
  4. プロジェクトレベルスタイル：プロジェクトレベル構成からのスタイル。
つまり、プロジェクトレベルの同名スタイルはユーザーレベルを上書きし、ユーザーレベルはプラグインおよび組み込みスタイルを上書きします。 さらに、一部のプラグインは「強制スタイル」を宣言できます。強制スタイルが存在する場合、それは outputStyle で指定されたスタイルよりも優先して適用されます。複数の強制スタイルがある場合は、最初のものが適用され、警告がログに記録されます。

カスタム出力スタイル

組み込みスタイルやプラグインが提供するスタイルを使用するだけでなく、独自のスタイルを定義して、よく使う表現の好みを固定し、再利用することもできます。

定義方法

カスタムスタイルは、指定されたディレクトリに配置された Markdown ファイル（.md）であり、各ファイルが1つのスタイルを定義します。
  • ユーザーレベル：~/.qoder/output-styles/、すべてのプロジェクトに適用されます。
  • プロジェクトレベル：<プロジェクト>/.qoder/output-styles/、現在のプロジェクトにのみ適用されます。
ファイルはオプションの YAML フロントマターと本文で構成され、本文はシステムプロンプトに追加されるスタイル説明となります。 
---
name: concise-cn
description: 簡潔な中国語の応答スタイル
---

応答はできるだけ簡潔にし、まず結論を述べてから理由を説明してください。
ユーザーが既に知っている情報の重複は避け、コード例は重要な部分のみを残してください。
frontmatter フィールド必須説明
nameいいえスタイル名。省略時はファイル名（.md を除く）が使用されます。
descriptionいいえスタイルの説明。省略時は本文の最初の非見出し行が使用されます。
作成後、構成で outputStyle を通じてその名前を参照することで有効化できます（再起動が必要です）。プラグインが提供するスタイルを参照する際は、プラグイン名:スタイル名 のようにプラグインプレフィックスを付けます。

作成のヒント

カスタムスタイルを作成する際のヒント：
  • 表現方法に焦点を当てる：タスクのロジックではなく、トーン、詳細度、構造などの表現レベルの好みを記述します。
  • 簡潔に保つ：スタイル説明はシステムプロンプトに追加されるため、長すぎるとコンテキストを消費します。
  • セキュリティ制約を上書きしようとしない：スタイルは表現方法を拡張するだけであり、Qoder のアイデンティティやセキュリティガイドラインを変更することはできません。

他のメカニズムとの関係

  • 言語設定との関係：language は応答に使用される言語を制御し、outputStyle は表現方法を制御します。これらは組み合わせて使用できます。
  • プロジェクト指示との関係：プロジェクト指示ファイル（AGENTS.md）は「このプロジェクトでどのように作業するか」を記述するプロジェクト規約であり、出力スタイルは「どのように表現するか」を記述する表現の好みです。両者は役割が異なり、詳細は メモリ を参照してください。
  • UI設定との関係：出力スタイルは応答テキスト自体に影響し、UIテーマやステータスバーなどは表示レイヤーに影響します。詳細は UIとショートカット を参照してください。

次のステップ

はじめに
コアコンセプト
Qoder CLI を使用する
Qoder CLI の拡張
リモートと統合
設定とセキュリティ
リファレンス
トラブルシューティング
出力スタイル - Qoder