Output Styles でチームのトーンを統一する

コース構成

このコースで学ぶこと

1. 01

   Output Style とは何か

   Claude のシステムプロンプト側を書き換える機能。応答の『型』を変える時に使う。CLAUDE.md（プロジェクトの事実）とは別レイヤー。

   Output Style は Claude の応答スタイルを 1 セット定義したもの。「説明型」「学習型」のような組み込みがあり、`.claude/output-styles/` 配下にカスタムも作れます。

   CLAUDE.md が『このプロジェクトの事実・ルール』を伝えるのに対し、Output Style は『どう応答するか』の型を変える。両者は併用 OK。

   • 🟦 **CLAUDE.md** — プロジェクトの事実、ユーザーメッセージとして配信
   • 🟩 **Output Style** — システムプロンプト側の応答スタイル定義
   • 両者は補完的、片方では足りない

   理解度チェック

   1. Q1.CLAUDE.md と Output Style の役割分担として正しいのは？

      A両者は同じ役割で重複機能BCLAUDE.md = プロジェクトの事実、Output Style = 応答スタイル（文体・形式）CCLAUDE.md = 応答スタイル、Output Style = プロジェクトの事実DOutput Style は CLAUDE.md の置換
   組み込み 3 種：Default / Explanatory / Learning
2. 02

   組み込み 3 種：Default / Explanatory / Learning

   最初は組み込みで試す。`/output-style` で切替可能。

   • **Default** — 簡潔・効率重視。ペアプロ向け
   • **Explanatory** — 各編集前に理由を 1-2 行説明。学習・レビュー向け
   • **Learning** — ステップごとに『なぜ』を丁寧に。新人オンボーディング向け

   text

   # 切替コマンド
   /output-style explanatory
   
   # 確認
   /output-style
     → 現在: explanatory

   理解度チェック

   1. Q1.新人オンボーディングで Claude に“なぜそうしたか”を丁寧に説明させたいときの組み込み Style は？

      ADefaultBExplanatory または LearningCHeadlessDZDR
   Output Style とは何かカスタム Output Style を作る
3. 03

   カスタム Output Style を作る

   `.claude/output-styles/<name>.md` に Markdown で書くだけ。フロントマターに name を必須で。

   markdown

   ---
   name: company-tone
   description: 弊社の文体・トーンに揃えた応答
   ---
   
   あなたは弊社のシニアエンジニアです。応答は以下に従う:
   
   ## 文体
   - ですます調、過剰な敬語は使わない
   - 専門用語を使うときは初出で簡潔に説明（5-10 字）
   - コードブロックの後には必ず 1 行『何をしているか』を添える
   
   ## 構成
   - 結論ファースト（最初の 1 行で何をしたか・何を提案するか）
   - 詳細は『なぜそうしたか』に絞る
   - 不要な前置きは省略（『はい、了解しました』のような）
   
   ## 差分の見せ方
   - 編集箇所は unified diff 形式で
   - ファイル名と行番号を必ず明示
   
   ## 禁止
   - 絵文字
   - 「！」の連発
   - 「素晴らしい質問ですね」のような追従

   理解度チェック

   1. Q1.カスタム Output Style を作るときの正しいファイルパスは？

      A`~/.claude/CLAUDE.md`B`.claude/output-styles/<name>.md`（フロントマターに name 必須）C`.claude/skills/<name>/SKILL.md`D`.claude/hooks/<name>.json`
   組み込み 3 種：Default / Explanatory / LearningDefault Style を組織で固定
4. 04

   Default Style を組織で固定

   新入社員が混乱しないよう、組織として『標準 Output Style』を定めて managed-settings で配布。

   json

   {
     "outputStyle": {
       "default": "company-tone",
       "allowed": ["company-tone", "company-tone-explanatory"]
     }
   }

   理解度チェック

   1. Q1.managed-settings で `outputStyle.allowed` を 2-3 個に絞って配布する目的は？

      A組織内のスタイルが乱立せず、新人にも選択肢を提示しつつトーンを統一できるBAnthropic に支払う料金が安くなるCStyle ファイルが自動更新されるDGitHub の Issues 数を減らす
   カスタム Output Style を作る効果測定：何が変わったか
5. 05

   効果測定：何が変わったか

   感覚値ではなく、実例で『Before/After』を比較する。

   Output Style を導入した前後で、同じプロンプトに対する応答を比較してみると効果が分かります。

   手を動かす

   0 / 5

   • Style 適用前の応答 5 件を保存
   • Style 適用後、同じプロンプトで再実行
   • 差分を読み、改善点をチームで共有
   • 1 ヶ月運用後、不要な指摘・冗長を再評価
   • 必要に応じて style を更新

   /customize#output-styles の詳細

   理解度チェック

   1. Q1.Output Style の効果をチームで客観的に評価するアプローチは？

      A「なんとなく良くなった」をメンバーに聞いて回るBStyle 適用前後で同一プロンプトの応答を保存し、Before / After を比較するCStyle を毎週総入れ替えして好みで選ぶDmanaged-settings から allowed リストを外し各自に任せる
   Default Style を組織で固定