Skip to Content
ユーザーガイド機能Output Styles

Output Styles

Output style は Qwen Code の応答の書き方 — トーン、ナレーションの量、説明の詳しさ — を変更するもので、できることの範囲は変わりません。スタイルは組み込みのシステムプロンプトに重ねられる名前付きの指示ブロックであり、モデルは毎ターンアクティブなスタイルを思い出して長いセッションでも一貫性を保ちます。

Built-in styles

StyleWhat it does
default追加のスタイルなし — 標準のプロンプト。
Concise前置き、ナレーション、まとめなしでまず回答。作業自体の徹底度は変わらず、エラーレポートや安全確認は内容をそのまま保持します。
Proactiveすぐに作業を始め、低リスクの判断では質問よりも明示された前提を優先します。許可される範囲は変わりません。承認モードと確認ルールは引き続き完全に適用されます。
Explanatory作業と並行して、コードベースや実装の選択に関する短い教育的な「Insight」メモを追加します。
Learning協調型の学び: 書くべき小さく意味のあるコードの断片(TODO(human) でマーク)を手渡し、待機します。ヘッドレス実行ではスキップされます(待機できないため)。

Choosing a style

/output-style を実行してピッカーを開くか、直接設定します:

/output-style Concise /output-style default # back to no style

変更は実行中のセッションに即座に適用されます — システムプロンプトはその場で再構築されるため、次のターンからすでに新しいスタイルで応答します — そして将来のセッションにも持続されます。信頼されたプロジェクト設定が現在 general.outputStyle を所有している場合、コマンドはそのプロジェクト設定を更新します。そうでない場合はユーザー設定を更新します。スタイル名は大文字小文字を区別しません。

コマンドを使わずにスタイルを設定することもできます:

  • Settings: settings.json(ユーザーまたはプロジェクトスコープ)で "general": { "outputStyle": "Concise" }。値は組み込みまたはカスタムスタイル名です。手動編集は次の起動時に反映されます。
  • One run: qwen -p "..." --output-style Concise でその実行だけ設定を上書きします。Headless Mode を参照。

Custom styles

カスタムスタイルは、本文がスタイルの指示となる Markdown ファイルです。以下の 2 つのディレクトリのいずれかに配置します:

LocationScope
~/.qwen/output-styles/<name>.mdあなたのスタイル。すべてのプロジェクトで利用可能
<project>/.qwen/output-styles/*.mdプロジェクトのスタイル。ワークスペースが信頼されている場合のみ読み込まれる

信頼のチェックはスタイルが使用されるたびに行われます。ファイルの読み込み時だけではないため、セッション中に信頼を取り消すとプロジェクトスタイルが会話に影響を与えるのを停止します。

--- name: Reviewer description: Reviews code and reports findings without editing anything keep-coding-instructions: false --- You are reviewing, not implementing. Read the code the user points you at, list concrete findings ordered by severity, and never edit files unless the user asks for a fix.

フロントマターは省略可能です。各フィールドにはデフォルトがあります:

  • name — スタイルの名前。/output-style <name>general.outputStyle で使用されます。デフォルトは .md を除いたファイル名です。default は予約済みです。
  • description — ピッカーに表示される一行の要約。デフォルトは本文の最初の行です。
  • keep-coding-instructionstrue にすると組み込みのソフトウェアエンジニアリングワークフローの指示がスタイルと一緒にプロンプトに残ります。false にするとそのセクションだけが削除され、コーディング以外の作業用スタイル向けになります。何も指定しない場合、上書きする組み込みスタイルの値を継承します。つまり concise.md を書き換えても文言が変わるだけでその指示は削除されません。組み込みに対応するものがないファイルは false がデフォルトです。組み込みプロンプトのそれ以外 — アイデンティティ、安全ルール、ツールガイダンス — はすべてのスタイルで常に有効です。

カスタムスタイルはピッカーで組み込みの後ろに表示され、ソースがラベル付けされます。ピッカーが開かれるたびや名前が指定されるたびに再読み込みされるため、新しいファイルも再起動不要です。名前は大文字小文字を区別せずに照合され、一意である必要があります。プロジェクトスタイルは同じ名前のユーザースタイルを上書きし、どちらもその名前の組み込みを上書きします。読み込めないファイルはスキップされてデバッグログに報告されますが、他のファイルは引き続き読み込まれます — 空の本文、無効な名前、25 kB を超えるファイル(スタイルはプロンプトでありドキュメントではありません)、UTF-8 テキストでないもの、または本文全体が HTML コメントであるもの。HTML コメントは本文から取り除かれるため、チームメートへのメモはモデルに送信されません。

スタイルファイルは自身のみを参照できます。プロジェクトファイルがシンボリックリンクの場合はスキップされます。ユーザーファイルは自分のホーム内へのシンボリックリンク(dotfiles の設定など)は許可されますが、それ以外へのリンクは許可されません。ハードリンクはどちらのレベルでも拒否されます。

カスタムスタイルは --bare--safe-mode では無視され、組み込みのみが保持されます。

Scope and interactions

  • スタイルは組み込みプロンプトに重ねられます。--system-promptQWEN_SYSTEM_MD がプロンプト全体を置き換える場合、スタイル(およびそのターンごとのリマインダー)は適用されません。
  • スタイルはメインの会話にのみ適用されます。サブエージェントは独自のシステムプロンプトを実行し、アリーナピアはそのスタイルがコーディング指示を保持している場合にのみセッションのスタイルを継承します。ピアは生成する diff で評価されるため、ソフトウェアエンジニアリングの指示が削除された状態で実行されることはありません。
  • --bare--safe-mode はこの設定を無視し、/output-style の変更も許可しません。
  • セッション中にスタイルを変更するとキャッシュされたプロンプトプレフィックスが 1 回だけ無効化されます。その後は通常通りキャッシュが機能します。

スタイルはトーンとワークフローを調整するもので、知識や権限を変更するものではありません。モデルが常に知るべきプロジェクトの規約にはコンテキストファイル(QWEN.md)を使用し、プロンプトへの一回限りの追加には --append-system-prompt を使用します。

Last updated on