1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Museのトークンが減る話 — URLを投げてメモリ圧縮Skillにした

1
Last updated at Posted at 2026-11-15

はじめに

Muse を使っていると、会話の「返事」より、裏側の読み直しで枠が減っていく感じがあります。

今週は コンテキスト(メモリ)圧縮 と Skills に絞った話です。設定マップ編の続きとして書いています。

きっかけは、次の2本です。この URL をそのまま Muse に投げて、カスタム Skill にしてもらいました。

この記事でわかること

  • トークンが減る主因は「出力」より「毎ターンの読み直し(入力)」側に寄りやすい
  • メモリ圧縮 Skill は、だいたい 別ファイル参照型。区分けや承認の有無は好みで調整してよい
  • 自分の環境では、コピー上のドラフトで MEMORY.md が約 −21.7%(項目はほぼ残す)
  • AGENTS.md に全部積むより、手順は Skills、常時守る約束は短く、が扱いやすい

想定読者

  • Muse の無料枠が、思ったより早く減る方
  • MEMORY.md や AGENTS.md が長くなってきた方
  • Cursor の Skills 感覚で、Muse 側も整理したい方

なぜトークンが減るのか

Qiita 記事では、約5日で記録上の総トークンが約9.5億、うち 入力が約99.5% だった、という棚卸しが書かれています。理由の芯はシンプルで、AI は返事を書くたびに履歴や常駐ファイルを読み直す、という構造です。

自分側で毎回読まれるもの(MEMORY / AGENTS / TOOLS など)が太いほど、1ターンあたりの「固定費」が増えます。だから節約の方向は「会話をやめる」より、

  • 毎回読む場所には 今の結論 だけ残す
  • 長い手順や仕様は 必要なときだけ読むファイル へ逃がす
  • 終わった詳細は、毎ターン目にする一覧から外す

という 置き場所の設計 になります。記事でも「ドライブに退避しただけでは節約にならない(開かない限り毎ターン入力に入らない)」と整理されていて、納得でした。

URLを投げて、メモリ圧縮Skillにした

必須の note は、まさにその整理を カスタム Skill として配っている 記事です。「メモリ・トークンダイエット」という名前で、ホット/ウォーム/コールドの3層に分け、いきなり本物を書き換えず、コピー上で実験→数字を見てから採用、という安全設計が入っています。

私は記事の中身を手で写すより、URL をそのまま Muse に渡して「カスタム Skill にして」 と頼みました。配布指示文を読ませて Skill 化してもらう、がいちばん早かったです。

Muse 自身にも周辺のやり方を調べてもらいましたが、みなさん似たような 別ファイル参照型 が多い印象でした。違いは、区分けの名前や、書き換え前に承認を挟むかどうか、くらいです。共通の正解を探し切るより、自分の運用に合わせて調整するのがよさそうです。

Skill 名は memory_token_cleanup です。作成後は「メモリ整理して」で同じ手順が回ります。

自分の環境で監査〜ドラフトまで回した

Skill を入れたあと、本物の MEMORY.md は触らず、監査 → 分類 → コピー上のドラフト まで進めました。数字はすべて文字数ベースです。

監査(常駐ファイル)

ファイル 文字数(おおよそ) メモ
MEMORY.md 約9,029字(43項目) いちばん太い。Facts が大半
AGENTS.md 約1,092字 小さめ
SOUL.md 約795字 小さめ
USER.md 約396字 小さめ

裏側で自動生成される関係性サマリーはさらに長いですが、仕組み側の生成物なので、今回の整理対象からは外しました。

分類(A〜F)の感触

note の Skill どおり分類すると、山はだいたいこうでした。

  • A(履歴→現在形) … いちばん効く。長い経緯の項目がここに集まる
  • B(参照化) … 仕様の詳細は、別の正本(シート・ページ・Drive の資料)へ。メモリ側は1行ポインタ
  • C(重複) … 同じルールが Facts と Preferences に二重、など
  • D(削除候補) … 一時的な観測など少数
  • E(矛盾) … 勝手に直すべき矛盾は見つからず
  • F(落とせない) … 呼称・禁止・チャット使い分け・未決の約束など、全体の半分前後。ここが厚いのは正常、という感触でした

見込みでは「約9,029字 → 6,400字前後(−27〜30%)」くらいまで痩せられる計算でした。

ドラフト結果(コピーのみ・本物は未反映)

比較レポートの数字です。

項目 結果
削減 約9,029字 → 約7,067字(−21.7%)
項目数 43 → 42(ほぼ消していない)
主因 Facts の履歴現在形化+参照化。Preferences/Commitments は安全のためほぼ維持
消した項目 一時的な端末観測の記録 1件だけ

見込みより削減が小さかったのは、意図的に残した部分があるためです。たとえば、

  • 再提案を防ぐためのリスト(理由つき)を削ると、以前やめた提案がまた出てくる事故につながる
  • あとで使う試験・対策用の結果メモも残した

圧縮で落ちた細かいニュアンスは、シートや台帳など正本側に残っている前提です。自己テスト(「いまの既定は?」「落とさない約束は?」など)も、ドラフトだけで答えられることを確認してから止めています。

採用(本物への反映)は、まだこのあとです。まずは数字とリスク欄を見てから、と決めています。

Skillsの置き場

組込(最初から入っている)Skills と、自分用のカスタムは場所が違います。Muse に聞いたところ、だいたい次の整理でした。

種類 場所(実機で聞いた内容) メモ
組込 /opt/muse/skills/ 件数は環境による。更新で差し替わる前提の説明あり
カスタム ~/workspace/custom-skills/ 自分用。URL投げで作った圧縮 Skill などもここ側

Screenshot_20261115-230959.png

AGENTS.md と Skills の使い分け

全部を AGENTS.md に書きたくなりますが、長くすると埋もれやすいです。Muse 側の説明では、独立した「rules」置き場は無く、効き方が違う2層、という整理でした。

  • AGENTS.md/メモリ … 毎回読み込まれる。「常に守る約束」向き。長いと埋もれやすい
  • Skills … タスクの種類に応じて手順書として読み込まれる。「生成したら必ずこの手順」向き

私は、生成まわりのエビデンス保存のような作業ルールを、カスタム Skill に切り出しました。AGENTS.md は要点だけ残し、詳細の正本は Skill 側、という分け方です。

Screenshot_20261111-195958.png

Cursor で Skills を育てている感覚に近いです。常時全部を頭に入れさせず、必要なときだけ厚い手順を読ませる、がトークンとも相性が良い、という体感です。

意識していること

  • 圧縮の目的は「短くすること」自体ではなく、行動が変わらない範囲で読み込み量を減らすこと
  • いきなり本番の MEMORY を削らず、コピーで Before/After を見てから採用する(note の Skill と同じ)
  • 識別子や禁止事項は、長いからといって雑に消さない
  • 似た Skill が世の中にあっても、区分けと承認フローは自分好みでよい

まとめ

Muse の枠が減る話は、出力の派手さより、毎ターンの読み直し側を見ると筋が通ります。必須の2本を読んで方針を借り、URL を投げてメモリ圧縮 Skill にし、監査〜コピー上ドラフトまで回したのが今回の流れです。

手順の厚い話は Skills、毎回守る約束は短く、が今の運用です (´▽`)

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?