disler/fixing-smartass-opus-5

解決する課題

Opus 5 は利用可能な最もスマートなモデルの一つですが、デフォルトのコミュニケーションスタイルはトークンと時間を浪費します。回答を複数の見出しの下に埋め込み、「load-bearing」や「worth stating plainly」といった繰り返しフレーズを使用し、お世辞を加え、コミットに共同作成者のクレジットをスタンプすることさえあります。エンジニアは個々のユーザープロンプトを調整してこれを修正しようとしますが、それは一度に一つのタスクにしか役立ちません。真のレバレッジは、セッションのすべてのターンに適用されるシステムプロンプトにあります。このプロジェクトは、冗長でスコープが拡大しがちなアシスタントを、簡潔で正確なエンジニアリングパートナーに変える、慎重に作成されたシステムプロンプトを提供します。

仕組み

製品全体は単一の markdown ファイル sr_opus_5_system_prompt.md であり、--append-system-prompt-file フラグを使用してコーディングエージェントのシステムプロンプトに追加します。プロンプトは4つの指示セクションと具体的な例で構成されています：

• ポジティブおよびネガティブパターン：「これを行う/これを行わない」リスト。 「load-bearing」やダッシュの連鎖などのフレーズを禁止し、すべての応答において簡潔で直接的なコミュニケーション習慣を強化します。
• 参照ポイント：モデルは出力を短いコードでラベル付けします — F1 は発見、D1 は決定、O1 はオプション、R1 はリスク、Q1 は質問、A1 はアクション。フォローアップは keep D1, reject O2, answer Q1 のような、ほぼゼロトークンのコマンドになります。
• 厳格な運用境界：要求されていないリファクタリング、付随的なクリーンアップ、証拠のない完了主張、コミット内の共同作成者クレジットをブロックするスコープ制御。
• エイリアス：完全な指示に展開される2〜3文字のコマンド。例：scr (簡略化、圧縮、繰り返し), eli (18歳向けに説明), foc (一つのことに集中), ref (参照ポイント付きで書き直し)。

実際のモデル出力から構築された「To do」と「Not to do」の例もあります。モデルはルールよりも例を強くパターンマッチングするためです。

リポジトリには比較ループが含まれています。just コマンドと herdr を使用して、2つの Claude Code ペインを並べて起動できます。一つは標準モデル、もう一つはシステムプロンプトを追加したものです。両方に同じユーザープロンプト（長いブログ記事の要約）が与えられ、応答の長さ、出力トークン、実行時間がリアルタイムで乖離していく様子を観察できます。同じシステムプロンプトは Pi コーディングエージェントでも機能し、ハーネス間での移植性が証明されています。

対象読者

最先端のコーディングエージェント（Claude Code、Pi、またはシステムプロンプトを追加可能なハーネス）を実行しており、出力品質を犠牲にすることなくコストを削減し、反復を高速化したい中級から上級のエンジニア。タスクごとにユーザープロンプトを調整することに疲れ、システムレベルでコミュニケーションチャネルを修正する準備ができているすべての人向けです。

ハイライト

• 単一ファイル、ビルドや依存関係なし — 純粋な markdown と --append-system-prompt-file フラグのみ。
• 簡潔で無駄のない応答を強化するための、明示的な禁止フレーズリストとポジティブな行動パターン。
• 参照コードにより、フォローアップがほぼゼロトークンのコマンドに変わります。
• 厳格な境界により、スコープの拡大、要求されていないクリーンアップ、共同作成者クレジットを停止します。
• scr, eli, foc, ref などのエイリアスが会話の bash エイリアスとして機能します。
• コンテキスト内の例は、ルール単体よりもトーンをうまく抽出します。
• 内蔵の比較ループ (just compare <name>) により、標準モデルとの違いを並べて表示できます。
• 同じシステムプロンプトが Claude Code と Pi の両方で機能し、移植性を証明しています。