Skip to content

Refine モード

長い AI コーディングセッションを、残す価値のある部分だけ——整ったドキュメントや再利用可能なプロンプトへ——蒸留します。分割ペインのエディターでメッセージを取捨選択し、その結果をエクスポートします。

Refine モード(⌘3)は、セッションのトランスクリプトを素材として扱います。シグナルのあるメッセージを残し、ノイズを落とし、引き締めが必要な部分を編集し、自分のつなぎのメモを挿入したうえで、Markdown または素のプロンプトをエクスポートします。すべての処理は、すでにインポート済みのメッセージに対してブラウザ内で行われます。元のセッションログには一切手を触れず、何もアップロードされません。左ペインは各メッセージのコントロールを備えた全文トランスクリプト、右ペインは実際にエクスポートされる内容のライブな Compressed Preview です。

分割ペイン

  • 左 — トランスクリプト。 各メッセージが 1 行として、その役割とメッセージごとのトークンバッジ付きでタグ付けされます。ここで取捨選択を行います。
  • 右 — Compressed Preview。 エクスポートに含まれる内容そのもので、編集に合わせて更新されます。3 つのビューチップで表示内容を制御します。
    • 👁 Full — すべてのメッセージ。削除したものは取り消し線付きで表示されるため、文脈の中でどこを切り落としたかを確認できます。
    • ≶ Changes Only — 削除・編集・挿入したメッセージのみ。自分の編集を見直すためのビューです。
    • ⌦ Hide Deleted — 残したメッセージのみ。つまり、実際に出力されるクリーンなエクスポートです。

メッセージのラベルは役割に忠実で、src/kinds.js の単一の正規マップに由来します。これは Playback が使うのと同じ語彙です(User、Assistant、Thinking、Tool Call、Tool Result、Inserted)。Refine はこれらを大文字のタグとして表示しますが、語句がアプリの他の部分とずれることはありません。

トークンバッジはエクスポートサイズであり、コンテキストウィンドウではありません。 メッセージごとおよび合計のトークン数は、エクスポートドキュメントのサイズ(おおよそ文字数 ÷ 4)を見積もったもので、ツール呼び出しは 1 行のプレビューに切り詰められます。これはモデルのコンテキストウィンドウ使用量ではありません。それについては セッションインサイト を参照してください。

操作

各行には 4 つの操作があり、ボタンとして、または行が選択されているときは 1 キーのショートカットとして利用できます。

キー操作効果
KKeepメッセージの削除を取り消します(含めるようマークします)。
DDeleteメッセージをエクスポートから除外します(取り消し線付き。削除はされません)。
EEditプレビューペインでインラインのテキストエリアを開きます。フォーカスが外れると確定し、Esc でキャンセルします。プレビューブロックをダブルクリックしても編集できます。
IInsert選択中の行のに空の Inserted メモを追加し、自分のつなぎの文章を入力できるようにします。

↑/↓(または j/k)で選択を移動します。K または D を押すと次の行へ進むため、片手で上から下へ順にトリアージできます。

ノイズは初めから削除済み

ツール結果と思考ブロックはトランスクリプトの容量の大半を占め、蒸留された成果物にはめったに含まれません。そのためこれらは初めから削除された状態になっています。特定のツール結果や思考を残す価値がある場合は、それを選択して K を押します。それ以外——ユーザーのターン、アシスタントのターン、ツール呼び出し——は初めから残す状態です。

一括コントロール

  • Keep All / Delete All / Insert at start ボタンがトランスクリプトの上に配置されています。
  • By type トグルチップは、セッションに複数のメッセージ種別があるときに現れます。各チップは種別とその件数を示し(例: Tool Result 214)、クリックするとその種別全体を一度に含める/除外する切り替えを行います——たとえばツール呼び出しをすべて落とす、あるいはアシスタントのターンをすべて戻す、といった操作を素早く行えます。

ステータスバー

一番下のバーは編集セッションを追跡し、エクスポートを駆動します。

  • Undo / Redo / Reset⌘Z で元に戻し、⇧⌘Z でやり直し、リセットコントロール(⟲)で元のトランスクリプトに戻します。編集中の入力は 1 打鍵ごとではなく、まとめて 1 つの undo ステップになります。
  • トークン統計Original → Compressed → Saved。加えて、削り取ったトークンの割合を示すバーが表示されます。削除するにつれて満たされていきます。
  • 変更件数 — deleted / edited / inserted(− / ✎ / +)。

エクスポート

Export メニュー(または Markdown デフォルトの ⌘S)は、ファイルを直接お使いのマシンに書き出します。

  • 📄 Export Markdown — source/date/kept-count のヘッダーを持つタイトル付きドキュメント。その後、残した各メッセージが ### Role 見出しの下に並びます。ドキュメント、PR、セッションのまとめに適しています。
  • ⌁ Export as Prompt — 残したメッセージ本文だけを、空行で連結し、ヘッダーもラベルも付けずに出力します。新しい AI セッションの起点や、再利用可能なプロンプトテンプレートに適しています。

どちらもトランスクリプトの順序で残したメッセージのみをエクスポートするため、⌦ Hide Deleted で見えているものが、そのまま得られる内容です。

関連

  • セッションインサイト — Overview の統計、実際のコンテキストウィンドウ使用量、そしてここのトークンバッジがあえて再現しようとしないコスト内訳。
  • キーボードショートカット — すべての Refine キー(K/D/E/I、⌘Z、⇧⌘Z、⌘S)と、他のセッションモードのショートカット。

Released under the MIT License.