text-optimizer

プラグイン: kochetkov-ma/claude-brewcode

テキストオプティマイザー

意味を損なうことなく、プロンプト、ドキュメント、エージェント命令のトークン数を 20～40% 削減します。 8 つのカテゴリにわたる 52 の研究に裏付けられたルール を適用します: Claude の挙動、トークン効率、構造、重複排除、参照整合性、知覚、LLM の理解、アグレッシブな非可逆圧縮(deep のみ)。

メリット: API 呼び出しのコスト削減 · モデル応答の高速化 · LLM 命令の明確化 · ハルシネーションの低減

例:

/text-optimize prompt.md          # single file, medium mode (default)
/text-optimize -d agents/         # deep mode — all .md files in directory

スキルのテキストは LLM による消費を目的として書かれており、トークン効率が最適化されています。

---

テキスト & ファイルオプティマイザー

ステップ 0: ルールの読み込み

必須: 最適化を実行する前に references/rules-review.md を読んでください。 ファイルが見つからない場合 -> エラー + 停止。ルールの参照なしで続行しないでください。

モード

$ARGUMENTS を解析します: -l/--light | -d/--deep | フラグなし -> medium(デフォルト)。

モード	フラグ	対象範囲
Light	-l、--light	テキストのクリーンアップのみ — 構造、リスト、流れはそのまま
Medium	(デフォルト)	バランスの取れた再構築 — すべての標準的な変換
Deep	-d、--deep	最大密度 — 言い換え、統合、アグレッシブな圧縮

ルール ID クイックリファレンス

カテゴリ	ルール ID	対象範囲
Claude の挙動	C.1-C.8	文字通りの遵守、「think」の回避、ポジティブなフレーミング、スタイルの一致、記述的な命令、過剰設計、ALL-CAPS の回避、プロンプト形式
トークン効率	T.1-T.8、T.10	テーブル、箇条書き、ワンライナー、インラインコード、略語、冗長表現、カンマ区切りリスト、矢印、空白の除去
構造	S.1-S.8	XML タグ、命令形、単一ソース、コンテキスト/動機、ブロッククォート、段階的開示、一貫した用語、参照の深さ
重複排除	D.1-D.6	完全一致/近似/異なる形式をまたぐ統合、強調は最大 2 回、ファイルをまたぐ SSOT、誤統合の防止
参照整合性	R.1-R.3	ファイルパスの検証、URL の確認、循環参照の線形化
知覚	P.1-P.6	ルールの近くの例、階層、キーワードの太字化、標準記号、命令の順序、オプションよりデフォルト
LLM の理解	L.1-L.8	重要情報の位置、ドキュメント優先、簡潔さ、引用優先、WHY の追加、制約の再掲、プロンプトの繰り返し、スコープ修飾子の保持
アグレッシブな非可逆圧縮(deep のみ)	A.1-A.4	行の融合、低価値な語の削除、アグレッシブな言い換え、常識の省略

ID とルールの対応表

ID	ルール	ID	ルール
C.1	指示への文字どおりの従順	C.2	「think」という語を避ける
C.3	肯定的な表現を使う（「Xするな」ではなく「Yせよ」）	C.4	プロンプトのスタイルを出力に合わせる
C.5	強調的な指示より記述的な指示	C.6	過剰設計の防止
T.1	文章より表（複数列）	T.2	番号付きより箇条書き（約5〜10%）
T.3	ルールは一行で	T.4	コードブロックよりインラインコード
T.5	標準的な略語（表のみ）	T.6	不要な語を削除
T.7	カンマ区切りのインラインリスト	T.8	フロー表記に矢印を使う
S.1	セクションに XML タグ	S.2	命令形
S.3	唯一の信頼できる情報源	S.4	コンテキスト・動機を追加
S.5	重要な箇所に引用ブロック	S.6	段階的な開示
R.1	ファイルパスを検証	R.2	URL を確認
R.3	循環参照を線形化	P.1	ルールの近くに例を配置
P.2	見出しによる階層（最大3〜4）	P.3	キーワードを太字に（100行あたり最大2〜3）
P.4	標準的な記号（→ + / ✅❌⚠️）
S.7	用語の一貫性	S.8	参照の深さは1階層
P.5	指示の順序（アンカリング）	P.6	選択肢よりデフォルト
C.7	すべて大文字での強調を避ける（4.x）	C.8	プロンプトの形式 → 出力形式
T.10	コードから空白を削除
L.1	重要な情報を先頭か末尾に配置	L.2	文書を先に、クエリを最後に
L.3	簡潔さを明示的に要求	L.4	引用を先に行うグラウンディング
L.5	指示に理由を追加	L.6	制約を末尾で再掲
L.7	プロンプトの反復（非推論）	L.8	スコープ修飾子を保持
D.1	完全重複のマージ	D.2	ほぼ重複のマージ（具体的な方を保持）
D.3	形式をまたぐ重複	D.4	強調の上限（1文書あたり2以下、末尾で再掲）
D.5	ファイルをまたぐ重複排除（SSOT + ポインタ）	D.6	誤マージの防止
A.1	行の融合（損失のないマージ）	A.2	低価値な語の削除（ゲート中立）
A.3	積極的な言い換え（保持）	A.4	常識の省略（台帳）

モードとルールの対応表

モード	適用	備考
Light	C.1〜C.8、T.6、D.1、R.1〜R.3、P.1〜P.4、L.1〜L.8	テキストの整理のみ — 再構成なし
Medium	すべてのルール（C + T + S + D + R + P + L）	バランスの取れた変換
Deep	すべてのルール（C + T + S + D + R + P + L）+ A.1〜A.4（積極的な損失あり）	セクションのマージ、最大限の圧縮

モードごとの損失許容範囲

コンテンツの本質は light/medium では不可侵です。意図的な小さな損失は deep のみで発生し、明示的に報告されます。重複排除でマージされた事実は保持として数え、損失とは決して見なしません。

モード	意味的一致の目標	許容される損失
Light	100%	なし — 文言の整理のみ
Medium	100%	なし — 事実目録を自己チェック、損失ゼロ
Deep	95%以上	低価値な接続的な詳細。自己検証ラウンドが必須で、95%未満の場合は損失リストとともに警告

重複排除パス（すべてのモード）

分析中に、圧縮の前に実行されます。

1. 事実目録を構築：1行につき1つの原子的な事実、番号付き
2. 2回以上出現する事実にフラグを立てる（完全一致、言い換え、または形式をまたぐ）
3. 各繰り返しを分類：意図的な強調（重要または引用ブロックとしてマーク、あるいは先頭と末尾のサンドイッチ）か、偶発的か
4. 偶発的 → 最も具体的な単一の記述にマージ（D.1〜D.3）、最良の位置が優先
5. 意図的 → 2回までに制限：早い段階で完全な形 + 末尾に1行以内の再掲（D.4）
6. 誤マージの防止（D.6）：スコープ・数値・条件が異なる場合は重複ではない — 両方を保持

使用方法

入力	アクション
引数なし	ファイルまたはフォルダのパスをユーザーに尋ねる
単一のパス	ファイルを直接処理
path1, path2	ファイルを順番に処理
-l file.md	Light モード — テキストの整理のみ
-d file.md	Deep モード — 最大限の圧縮
folder/	ディレクトリ内のすべての .md ファイル

ファイル処理

入力の解析

入力	アクション
引数なし	ファイルまたはフォルダのパスをユーザーに尋ねる
単一のパス	直接処理
path1, path2	ファイルを順番に処理

実行フロー

1. references/rules-review.md を読み込む — すべての最適化ルールをロードします
2. 対象ファイルを読み込みます
3. 分析: 種類 (プロンプト、ドキュメント、エージェント、スキル) を特定し、重要な情報と相互参照を記録します 3a. 重複排除パス (D.1-D.6): 事実インベントリ -> 偶発的な重複を統合 -> 意図的な強調は 1 ドキュメントあたり 2 件までに制限 3b. Deep のみ: 積極的な非可逆パス (A.1 融合 -> A.3 言い換え -> A.2 語句削除 -> A.4 省略); A.2/A.4 の削除 -> 損失台帳; A.4 は >=95% ゲートに対して elided-known としてカウントされ、A.2 はゲートに影響しません
4. モード別にルールを適用します (モードとルールの対応表を参照)
5. 最適化した内容でファイルを編集します 5a. Medium: セルフチェック — 事実インベントリを出力と照合し、損失ゼロを必須とします 5b. Deep モード: セルフ検証 — 事実インベントリのオリジナルと圧縮後を比較し、(保持 + 統合)/合計 >= 95%; 統合 = 保持とみなします; 下回る場合は損失リストとともに警告します
6. 最適化レポートを生成します

品質チェックリスト

実施前

• 全文を読み込む
• 種類 (プロンプト、ドキュメント、エージェント、スキル) を特定する
• 重要な情報と相互参照を記録する

実施中 — モード別に適用

チェック	Light	Med	Deep
C.1-C.8 (Claude の挙動)	Yes	Yes	Yes
T.6 (フィラー除去)	Yes	Yes	Yes
T.1-T.5, T.7-T.8 (トークン圧縮)	-	Yes	Yes
T.10 (コードの空白を除去)	-	Yes	Yes
S.1-S.8 (構造/明確さ)	-	Yes	Yes
D.1 (完全一致の重複排除)	Yes	Yes	Yes
D.2-D.4, D.6 (スマート重複排除 + 強調上限)	-	Yes	Yes
D.5 (ファイル間の重複排除、フォルダ実行)	Yes	Yes	Yes
R.1-R.3 (参照の整合性)	Yes	Yes	Yes
P.1-P.4 (LLM の認識)	Yes	Yes	Yes
P.5-P.6 (アンカリング、デフォルト優先)	-	Yes	Yes
L.1-L.8 (LLM の理解)	Yes	Yes	Yes
A.1-A.4 (積極的な非可逆圧縮)	-	-	Yes
モードの予算内の損失	100%	100%	>=95%

実施後

• すべての事実が保持されている
• ロジックが一貫している
• 参照が有効である (R.1-R.3)
• トークンが削減されている

出力形式

## Optimization Report: [filename]

| Metric | Before | After | Change |
|--------|--------|-------|--------|
| Lines  | X      | Y     | -Z%    |
| Tokens | ~X     | ~Y    | -Z%    |

### Rules Applied
- [Rule IDs]: [Description of changes]

### Issues Found & Fixed
- [Issue]: [Resolution]

### Cross-Reference Verification
- [x] All file refs valid (R.1)
- [x] All URLs checked (R.2)
- [x] No circular refs (R.3)

---

**Full development platform:** [brewcode](https://github.com/kochetkov-ma/claude-brewcode) — infinite focus tasks, 16 agents, quorum reviews, knowledge persistence.
Install: `claude plugin marketplace add https://github.com/kochetkov-ma/claude-brewcode && claude plugin install brewcode@claude-brewcode`

アンチパターン

避けること	理由
すべての例を削除する	汎化を損なう (P.1)
過度に省略する	可読性を下げる (T.5 の注意点)
汎用的な圧縮	ドメイン用語が重要
過度に強引な表現	Opus 4.5 は過剰に反応する (C.5)
階層を平坦化する	構造を失う (P.2)
「X をするな」という枠組み	「Y をせよ」より効果が低い (C.3)
プロンプトを過剰に作り込む	Opus 4.5 は文字どおりに従う (C.6)
単一のプロンプトに過剰な負荷をかける	注意の分散、ハルシネーション (S.3)
文言に過度に集中する	構造 > 語句の選択 (T.1)
似て見える事実を盲目的に統合する	スコープ/数値/条件が異なれば別の事実 (D.6)