コンテキスト効率
目標はトークン削減ではなく、不要な繰り返しを減らすこと
ツールが魔法のようにトークンを節約するわけではありません。同じ手順、出力形式、OS 差分を毎回説明し直さなくてよいときに効果が生まれます。
コンテキストが浪費される場所
同じ診断でも、OS コマンドの選択、一時スクリプト作成、プラットフォーム差の処理、人向け出力の再構造化にコンテキストを使うことがあります。
共通語彙で指示を短くする
エージェントが diagnoseProject や diagnoseStorage を理解していれば、利用者は実装手順ではなく目的を伝えられます。
qzx diagnoseProject . --jsonqzx diagnoseStorage . --jsonJSON は必ず短いわけではない
構造は文字数を増やす場合があります。本当の価値は曖昧さと再試行を減らすことです。総トークンが減るかどうかはワークフロー全体で測定する必要があります。
測っていない数字を宣伝しない
再現可能な benchmark がないなら「X% 削減」といった普遍的な数字を出すべきではありません。試行と修正も含めた実タスクで比較します。
よくある質問
QZX は一定割合のトークン削減を保証しますか？
いいえ。効果はエージェント、タスク、コンテキストによって変わるため、普遍的な数値は測定なしには主張できません。
削減が期待できるのはどこですか？
診断ごとに OS 固有のスクリプトや説明を再作成する必要がなくなる場面です。
JSON は必ず短いですか？
必ずしもそうではありません。主な価値は短さではなく、構造が予測可能で再解釈を減らせる点です。