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

Text Optimizer

プロンプト、ドキュメント、エージェント命令のトークン数を20～40%削減し、意味を失いません。 6つのカテゴリにわたる41の研究に基づくルールを適用します：Claude動作、トークン効率、構造、参照の整合性、認識、LLM理解。

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

例：

/text-optimize prompt.md          # 単一ファイル、中程度モード（デフォルト）
/text-optimize -d agents/         # ディープモード — ディレクトリ内のすべての .md ファイル

スキルテキストはLLM使用用に書かれており、トークン効率に最適化されています。

---

テキスト・ファイル最適化ツール

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

必須： 最適化を行う前に、references/rules-review.md を読んでください。 ファイルが見つからない場合 → エラー + 停止。ルール参照なしで進めないでください。

モード

$ARGUMENTS を解析：-l/--light | -d/--deep | フラグなし → 中程度（デフォルト）。

モード	フラグ	スコープ
Light	-l、--light	テキストクリーンアップのみ — 構造、リスト、フローは変更なし
Medium	（デフォルト）	バランスの取れた再構成 — すべての標準変換
Deep	-d、--deep	最大密度 — 積極的に言い換え、マージ、圧縮

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

カテゴリ	ルールID	スコープ
Claude動作	C.1-C.6	リテラル従従、「think」を避ける、ポジティブフレーミング、スタイルマッチング、説明的命令、過度なエンジニアリング
トークン効率	T.1-T.8	テーブル、箇条書き、ワンライナー、インラインコード、略語、フィラー、カンマリスト、矢印
構造	S.1-S.8	XMLタグ、命令法、単一の情報源、文脈/動機付け、ブロッククォート、プログレッシブディスクロージャー、一貫した用語、参照深度
参照の整合性	R.1-R.3	ファイルパス検証、URL確認、循環参照の線形化
認識	P.1-P.6	ルール近くの例、階層、太字キーワード、標準シンボル、命令順序、デフォルトオプション優先

ID-ルール マッピング

ID	ルール	ID	ルール
C.1	リテラル命令従従	C.2	「think」を避ける
C.3	ポジティブフレーミング（Yをしろ、Xするなではなく）	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	キーワード用太字（最大2-3/100行）
P.4	標準シンボル（→ + / ✅❌⚠️）
S.7	一貫した用語	S.8	1レベルの参照深度
P.5	命令順序（アンカリング）	P.6	デフォルトオプション優先

モード-ルール マッピング

モード	適用範囲	メモ
Light	C.1-C.6、T.6、R.1-R.3、P.1-P.4	テキストクリーンアップのみ — 再構成なし
Medium	すべてのルール（C + T + S + R + P）	バランスの取れた変換
Deep	すべてのルール + 積極的な言い換え	セクションをマージ、最大圧縮

使用方法

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

ファイル処理

入力解析

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

実行フロー

1. references/rules-review.md を読む — すべての最適化ルールを読み込む
2. ターゲットファイルを読む
3. 分析：タイプ（プロンプト、ドキュメント、エージェント、スキル）を特定し、重要情報とクロスリファレンスをメモ
4. モード別ルール適用（モード-ルール マッピング参照）
5. 最適化されたコンテンツでファイルを編集
6. 最適化レポート生成

品質チェックリスト

前

• テキスト全体を読む
• タイプを特定（プロンプト、ドキュメント、エージェント、スキル）
• 重要情報とクロスリファレンスをメモ

中 — モード別に適用

チェック	Light	Med	Deep
C.1-C.6（Claude動作）	Yes	Yes	Yes
T.6（フィラー削除）	Yes	Yes	Yes
T.1-T.5、T.7-T.8（トークン圧縮）	-	Yes	Yes
S.1-S.8（構造/明確性）	-	Yes	Yes
R.1-R.3（参照整合性）	Yes	Yes	Yes
P.1-P.4（LLM認識）	Yes	Yes	Yes
積極的言い換え	-	-	Yes
情報損失なし	Yes	Yes	Yes

後

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

出力フォーマット

## 最適化レポート: [filename]

| メトリクス | 前 | 後 | 変更 |
|-----------|-----|-----|------|
| 行数 | X | Y | -Z% |
| トークン | ~X | ~Y | -Z% |

### 適用されたルール
- [ルールID]: [変更内容の説明]

### 見つかった問題と修正
- [問題]: [解決方法]

### クロスリファレンス検証
- [x] すべてのファイル参照が有効（R.1）
- [x] すべてのURLを確認（R.2）
- [x] 循環参照なし（R.3）

---

**完全開発プラットフォーム：** [brewcode](https://github.com/kochetkov-ma/claude-brewcode) — 無限フォーカスタスク、14エージェント、定足数レビュー、知識永続化。
インストール：`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）