Skills × External Memory
新しい会話を開くたび、AI は何もかも忘れている。
覚えてくれないなら、覚えさせるのをやめればいい。
AI が毎回「読みに行く」置き場を、育てる話。
AI に、覚えさせない。
AI が読みに行く置き場を、
育てる。
AI との作業には、静かな税金がかかっている。毎回の説明だ。会話が変わるたび、モデルが変わるたび、同じ背景・同じ好み・同じ手順を、また最初から伝え直す。この税金は、AI の記憶力の進歩を待たなくても、いま消せる——という話を、手元の実物を並べながら書いていく。
この記事の問い
なぜ AI には、毎回同じ説明を
する羽目になるのか?
そして、教えたことをモデルの世代交代の
先まで持ち越すには、どうすればいい?
先に答えを置く。AI の中に、覚えさせないこと。手順はスキルに、好みはメモリに、規範は CLAUDE.md に——AI が起動のたびに読みに行く、外部の置き場に書く。置き場はぜんぶ、自分で開いて直せるただのテキストファイルだ。だからモデルが入れ替わっても持ち越せる。ただし記憶は、放っておくと腐る。書くだけでなく、棚卸しするまでが運用になる。
ざっくり言うと
毎朝、記憶がまっさらな新人が出勤してくる職場を想像してほしい。腕は確かだが、昨日のことを何も覚えていない。毎朝口頭で教え直すのは、もう限界だ。だからその職場では、机の上に手順書(スキル)と申し送りノート(メモリ)と職場の決まり(CLAUDE.md)を置いておく。新人は出勤すると、まずそれを読んでから働き始める。そして——人が入れ替わっても、机の上の紙は残る。
Chapter 01
ざっくり言うと——AI は会話が終わるたびに、すべて忘れる。だから毎回、同じ背景・同じルール・同じ好みの説明から始まる。この「毎回の説明」こそ、仕組みで消すべきコストだ、という問題提起。
AI との作業で、地味にいちばん重いのは何か。コードを書かせることでも、文章を直させることでもない。説明だ。新しい会話を開くたび、AI はこちらの事情を何ひとつ覚えていない。プロジェクトの構成。守ってほしいルール。先週ようやく伝わった、あの微妙な好み。全部、初対面からやり直しになる。
以前の記事で、AI エージェントを「記憶喪失の天才バイト」と呼んだ。腕は抜群にいい。ただし毎朝、記憶がまっさらな状態で出勤してくる。だから雇い主は、朝いちばんに仕事の背景を渡してやる必要がある——そう書いた。
で、実際に毎朝説明していた。「この記事は読み物スタイルで」「装飾は控えめに」「その言い回しは強すぎるからやめて」。どれも、一度は伝えたことだ。二度目は少し疲れる。十度目には、はっきり思う。これは自分が繰り返す仕事ではなく、どこかに書いておく仕事だと。
書いておく場所は、実はもう用意されている。しかも一種類ではない。手順を書く場所、好みを書く場所、規範を書く場所——それぞれ別にあって、AI に読み込まれるタイミングも違う。この記事では、自分が実際に育てているその置き場を、実物ベースで開いていく。
Chapter 02
ざっくり言うと——繰り返す作業の手順書は「スキル」というテキストファイルに書く。合致する話題が出ると AI が自分で読み込んで、同じ段取りを再現する。9回繰り返した図解依頼が、一言で走るようになった。
まず、手順の置き場から。Claude Code にはスキルという仕組みがある。名前は仰々しいが、実体は SKILL.md というただのテキストファイル——つまり手順書だ。冒頭の数行に「どんな話題が出たらこの手順書を開くか」を書いておくと、AI が会話の流れからそれを察して、自分で読みに行く。
実例がいちばん早い。コードベースを学ぶとき、構成図やクラス図つきの図解レポートを AI に作ってもらう——これが習慣になっていて、気づけば4つのプロジェクトで9回以上、同じ趣旨の依頼を繰り返していた。手作業のころは、毎回 AI への説明から始まった。どの図を何枚、どんな体裁の HTML で、読む順序はどう示すか。段取りの説明だけで、毎回それなりの時間が溶けた。
2026年7月、過去の作業記録からこの定型を掘り出して、スキルにした。以来、「コードの図解よろしく」と一言頼めば、調査から単一HTMLのレポート生成までが、毎回同じ段取りで走る。手順書には、繰り返しの中で固まった注文——UML・構成図・シーケンス図を入れる、読む順序を示す、設計の良い点も悪い点も正直に書く——まで畳み込んである。説明ゼロで、これまでの注文が全部効いた状態から始まるのだ。
スキルの書き方で、効いた工夫が2つある。まず、骨格はこうだ。
SKILL.md の骨格(先頭部分)
--- name: スキル名 description: >- 目的の1行。トリガー例:「◯◯の準備をして」「◯◯を調べて」。 この話題が出たら、明示的に「スキルを使って」と 言われなくても使うこと。 --- # ここから下は、ふつうの手順書(段取り・表・落とし穴)
冒頭の description に、「トリガー例」と「言われなくても使うこと」という一文を必ず入れる。これがないと、せっかくの手順書が棚で眠る。書いておけば、こちらがスキルの存在を忘れていても、AI のほうが話題に反応して取りに行く。手元の4本すべてに、この一文が入っている。
手順書の本体は、どれもこの順番で書いている。機械的に見つけ、一覧で報告し、こちらの承認を待ってから、手を動かす。ファイルの削除や外部への送信を含む作業ほど、この型が効く。手順を任せることと、判断を任せることは、別なのだ。
手元のスキルは、いま4本。図解の code-diagram のほかに、リポジトリを公開する前の総点検 publish-check、ノート置き場の月次掃除 vault-gardening、それに私的な定例作業用が1本。別枠で、このサイトの記事生成用に、もう少し軽い「スラッシュコマンド」という置き場の手順書が2本ある。共通点はひとつ——どれも「二度以上やった作業」の手順書だということ。一度きりの作業はスキルにしない。三度目が見えたら、書く。
これで、手順の説明は消えた。ただ、毎回の説明には、手順ではないものも混ざっている。「その言い回しはやめて」——ああいう、好みの類だ。
Chapter 03
ざっくり言うと——ダメ出しや好みは「メモリ」に落ちる。経緯・Why・How to apply の3段で1枚のカードになり、次の会話では最初から効いている。ただし読むたびに「これは N 日前の記憶だ」と釘を刺される設計になっている。
スキルが手順書なら、メモリは申し送りノートだ。Claude Code は、会話の中で学んだこと——指摘されたこと、決まったこと、うまくいったやり方——を、プロジェクトごとの置き場に書き残していく。索引のファイル(MEMORY.md)が1枚あって、個別のメモが本体としてぶら下がる。手元では、10個のプロジェクトがこの置き場を持っている。
メモには型がある。feedback(ダメ出し・好み)、project(案件の構成や判断)、reference(資料の所在)、user(本人の環境)。このサイトのプロジェクトにはいま、feedback が7枚、project が13枚ある。
いちばんの働き者は、feedback 型だ。実物をひとつ開いてみる。「装飾は気配レベルに」というメモがある。生まれたきっかけは、ある日のダメ出しだった。記事に添える図解として、本文の比喩をそのまま絵にした案を出したら、「ダサい」と却下された——それだけの出来事が、こういう1枚になった。
メモリの実物(feedback 型)——「装飾は気配レベルに」の3段構造
いつ、どの提案が却下されたか。日付と、そのとき出した案(比喩をそのまま図解にする)を具体的に残す
なぜ NG だったのか、の言語化。「ダサい」の一言を、次も使える理由に翻訳しておく
次からどう動くか。比喩は文章の中にとどめ、絵にはしない——行動の形まで落とす
効き方は単純で、強い。次のセッションでは、このカードが最初から効いている。同じ提案は、もう出てこない。口頭のダメ出しはその場で蒸発するが、カードになったダメ出しは残る。フィードバックが、その場かぎりの指摘ではなく再利用できる資産に変わる——メモリの価値は、ここにある。
ただし、この仕組みには、よくできた釘が打ってある。メモリを読み込むたび、ハーネス(AI を走らせる土台側)が自動で注意書きを添えるのだ。「このメモリは N 日前のものだ。いまも合っているかは、現物で確かめよ」(意訳)。外部記憶は、その時点のスナップショットであって、真実の保証ではない。古い記憶を鵜呑みにさせない設計が、仕組みの側に最初から入っている。
この釘は、後の章への伏線でもある。N 日前の記録は、N が大きくなるほど現実とずれていく。書きっぱなしの外部記憶に何が起きるか——その話の前に、いったん全体の地図を描いておきたい。
Chapter 04 — 図で見る
ざっくり言うと——置き場は1つではない。横軸に「規範・手順・知識」、縦軸に「どのプロジェクトでも・プロジェクトごと」。どこに何を書き、AI がいつ読むのか、を1枚にまとめた。
ここまでで、手順はスキルへ、好みはメモリへ、と置き場が2つ出てきた。実際にはもう1種類、規範を書く CLAUDE.md がある。作業場そのものの区切り方は「混ざらない設計」の記事に書いたが、今回はその上に載る、記憶の配置の話だ。下の図が全体——どこに書き、いつ読まれるかの地図になる。
横軸は中身の性質だ。左へ行くほど「毎回必ず」読み込まれ、右へ行くほど「必要なときだけ」開かれる。規範(CLAUDE.md)は起動のたびに必ず入るから、薄く・強く保つ。手順(スキル)は話題が合ったときだけ本体が読まれるから、詳しく書いてよい。知識(メモリ・一次データ)は索引だけが毎回入り、本体は要るときに開かれる。縦軸は効く範囲——どのプロジェクトでも効かせるか、その場所だけか。「どこに書くか」は、「いつ・どこで効かせたいか」の言い換えだ。
この地図には、設計上の急所がひとつある。図の下に書いたとおり、すべての置き場が、自分で開いて編集できるただのテキストファイルだということだ。AI の中に埋まった記憶は、検査も、修正も、引っ越しもできない。ファイルなら、全部できる。そしてこの「検査できる」が、次の章で効いてくる。
Chapter 05
ざっくり言うと——外部記憶は書けば増えるが、勝手には整わない。2026年7月2日に全置き場を棚卸ししたら、重複・矛盾・陳腐化・配置不良が28件出た。バックアップの上、1件ずつ承認して22件を直した。
置き場が育ってくると、別の不安が生まれる。あちこちに書いたルールは、いまも全部正しいのか。互いに食い違っていないか。もう使っていない道具の説明が、残っていないか。書いた記憶は、書いた瞬間から古びはじめる——メモリのたびに釘を刺してくる「N 日前」の警告は、伊達ではないのだ。
2026年7月2日、全部の置き場を棚卸しした。対象は CLAUDE.md・スキル・メモリ・設定ファイルの一式。進め方は、スキルの章で書いた型と同じ「検出→レポート→承認→処置」だ。まず対象の91ファイル(500KB)を丸ごとバックアップし、変更前の行数を記録する。それから AI に全ファイルを読ませ、問題をファイルパスと該当行の引用つきで挙げさせる。処置案は1件ずつ出させて、そこで必ず止める。承認したものだけ、直させる。
結果、検出28項目。内訳は重複7・矛盾5・陳腐化12・配置不良2。そこから22件を適用(削除9・統合2・移動2・書き換え9)し、判断の割れそうな5件は保留にした。どれも自分で書いた(書かせた)覚えのあるものばかりなのに、揃えて読むと、これだけ出る。
· 配置不良——全部に効いてしまう置き場
ホームフォルダの直下に CLAUDE.md を置いてしまっていた(正しい置き場は一段深い ~/.claude/ の中)。特定アプリ専用のルール75行が、無関係な全プロジェクトに毎回読み込まれ続けていた。中身を該当プロジェクトへ移して、0行に。
· 矛盾——応答言語が3箇所で食い違う
ある場所には「応答は英語で」、別の設定には「日本語」、さらに別のファイルには「Japanese」。同じことを3箇所に書いて、3箇所ともズレていた。日本語に統一。
· 矛盾——スキルの手順書 vs メモリの実測
手順書は「4秒待って空なら、未発言と判断してよい」。一方メモリの実測は「約6秒+スクロール+5秒待たないと誤判定する」。新しい実測のほうでスキルを上書きした。
· 重複——設定の丸写し
ある設定ファイルは、41行のうち37行がグローバル設定の丸写しだった。差分の5行だけ残して削除。
· 陳腐化と孤児——もう指していないもの
旧ツール名の残存、一回きりのデバッグ用に許可した設定13行、そして存在しないパスに紐づいたメモリ置き場が4つ——現役とほぼ同じ内容のまま化石化していた。まとめて削除し、メモリの置き場は11から7へ。
食い違ったら、どちらが勝つか
手順書(スキル)と申し送り(メモリ)が矛盾したら、肩書きではなく、日付の新しい実測が勝つ。
そして勝敗が決まったら、負けた側を書き換えて、食い違いそのものを消す。
棚卸しを終えて分かったのは、「書く」と同じくらい「捨てる・直す」が運用の本体だということだ。外部記憶は冷蔵庫に似ている。入れるのは一瞬。だが入れっぱなしの記憶は静かに腐り、ある日 AI の出力を変な方向へ曲げる。定期的に開けて、匂いを確かめるしかない。
なお、この棚卸しが掃除したのは「ルールの置き場」だが、対になる話がもうひとつある。AI との作業履歴——セッションログという一次記録のほうから、逆に知見を掘り出して資産にする話だ。そちらは姉妹記事に分けた。
Chapter 06
ざっくり言うと——棚卸しのタスク文には「整理した結果は、モデルを切り替えたあとも効き続ける」と書いた。直後に、常用モデルが使えなくなる局面が来て、これが実地テストになった。原則は5部構成のカードにして、見直しの条件まで書いておく。
そもそも、なぜ棚卸しまでするのか。几帳面だからではない。棚卸しを AI に頼んだときのタスク文に、動機がそのまま残っている。
棚卸しタスク文より
「重複・矛盾・陳腐化したルールを整理し、エージェント出力の土台を整える。整理した結果は、モデルを切り替えたあとも効き続ける。」
書き換えの制約にも、一行入れた。「抽象化・要約による圧縮は禁止。明示的・具体的な記述を保つ(あとで性能の低いモデルに戻しても誤読しないように)」。賢いモデルは行間を読んでくれる。だが外部記憶は、行間に頼らず書く。この文章を将来どのモデルが読むかは、書く時点では選べないからだ。
そして、この想定は冗談で済まなかった。棚卸しと同じセッションの中で、常用していたモデル(Fable 5)が、使っているプランではしばらく使えなくなることを確認したのだ。書いたばかりの一文が、その日のうちに実地テストになった。もし AI の中に覚えさせる運用をしていたら、ここで蓄積はリセットされていた。実際には、失うものはなかった——覚えさせたものが、そもそも AI の中にない。CLAUDE.md も、スキルも、メモリも、ただのファイルとして手元に残っている。乗り換え先には、それを読ませればいい。
この経験は、2026年7月4日に1枚のノートにした。題は「引き継がれるのは外部記憶と原則だけ」。中身は5部構成にしてある。
原則カード「引き継がれるのは外部記憶と原則だけ」(2026-07-04)
原則
モデルは交代する。乗り換えても引き継がれるのは、自分で編集できる外部記憶と、そこに書いた原則だけ。AI の自動メモリに覚えさせるのではなく、AI が読みに行ける置き場を育てる
適用場面
複数の AI(ChatGPT・Claude・Codex)を使い分ける実作業。2026年7月、常用モデルが使えなくなった局面が、この原則の実地テストになった
結果
毎回の構成説明がほぼゼロに。朝にスマホで放り込んだネタが、夕方には PC で構成案になっている。別の AI でも出力のブレが減り、乗り換えコストはほぼゼロ
例外・注意
個人情報・家族の情報・固有名は外部記憶に入れない。フォルダの大移動や削除を AI に広く任せない(対象範囲を毎回明示する)
前提——崩れたら見直すシグナル
この原則は「AI がファイルを読みに行ける」仕様と、端末間の同期基盤に依存している。AI がファイル参照を廃して完全な内部記憶に移行したら、「置き場を育てる」の部分は組み直す
気に入っているのは⑤だ。原則のノートに、「どうなったらこの原則を見直すか」という賞味期限の条件まで書いておく。原則そのものも外部記憶の一部で、つまり、腐りうる。前提が崩れたら書き直す——そこまで含めて、1枚のカードだ。
正直な注記
このカードの「結果」欄には、未記入の TODO がひとつ残っている——モデル交代で実際どう困った/困らなかったか、の具体例をあとで書き足す、というものだ。外部記憶には、こういう「書きかけ」も日付ごと残る。完成してから書くのではなく、書きかけを置いて、あとで育てる。それでいい、と思っている。
Chapter 07
ざっくり言うと——hooks が「やってはいけないこと」を自動で止める守りなら、スキルとメモリは「やるべきこと」を毎回言わずに済ませる攻め。両輪が揃うと、「説明ゼロ・事故ゼロ」に近づいていく。
最後に、全体をひとつの絵に畳む。以前、hooks で防御設計する記事を書いた。AI がやってはいけない操作を、人間の注意力ではなく機械のルールで止める仕組み——あれは、言ってみれば「守り」の仕組み化だった。
今回の話は、その対になる。スキル・メモリ・CLAUDE.md は「攻め」の仕組み化だ。AI がやるべきこと、知っているべきこと、汲んでほしい好み——毎回口で説明していたものを、起動のたびに読みに行ける置き場へ移す。
2つの仕組み化
守りの仕組み化:hooks——やってはいけないことを、自動で止める(事故ゼロへ)
攻めの仕組み化:スキル・メモリ・CLAUDE.md——やるべきことを、毎回言わずに済ます(説明ゼロへ)
断っておくと、この「守り/攻め」という整理は公式の用語ではなく、自分の見立てだ。ただ、両輪が揃ってからの変化は、体感としてはっきりしている。会話の最初にやっていた背景説明がほぼ消え、見張っていなければならない場面が減った。毎回ゼロから指示する相手だった AI が、置き場を読んでから働き始める相手に変わった。
そして、この置き場はモデルの寿命より長い。バイトは入れ替わる。これからは、もっと頻繁に入れ替わる。覚えさせない、と決めたものだけが、入れ替わりの先へ持ち越せる。記憶喪失の天才バイトは、記憶喪失のままでいい。覚えるのは AI の仕事ではなく、置き場の仕事だ。
Coda
覚えさせるな、
読みに行かせろ。
手順はスキルに。好みはメモリに。規範は CLAUDE.md に。
そして棚卸しまでが、運用だ。
「AI に覚えさせるのをやめる」という考え方そのものは、以前、参加しているコミュニティの中で入門向けに書いたことがある。当時は「自分で編集できる置き場を作る」だけの話だった。今回はその続きで、置き場を育てる(スキル・メモリ)と、腐らせない(棚卸し)を足した。モデルは、これからも交代していく。そのたびに手元へ残るのは、AI の中の記憶ではなく、机の上の紙だけだ。だから、紙を育てる。
Fact-check
主要な事実は、手元の実ファイルと記録にあたっている:スキル・メモリ・CLAUDE.md の構成と数(スキル4本+スラッシュコマンド2本、メモリを持つプロジェクト10個、このサイトのメモリは feedback 7・project 13、グローバル CLAUDE.md 約1.9KB・プロジェクト CLAUDE.md 約9.5KB)は2026-07-09時点の実ファイルを数えたもの。棚卸しの数値(対象91ファイル・500KB、検出28件=重複7・矛盾5・陳腐化12・配置不良2、適用22件=削除9・統合2・移動2・書き換え9、保留5件、ホーム直下 CLAUDE.md の75行→0行、孤児メモリ4箇所の削除で置き場11→7)は、2026-07-02の棚卸しセッションのログとメモリの記録による。適用件数はログ内に22と23の表記揺れがあり、内訳の合計と一致する22を採用した。本文で引用したタスク文2箇所も、同セッションの実際の文面。code-diagram スキルは2026-07-02に、過去の作業記録に繰り返し現れた定型(4プロジェクト・9回超の図解依頼)から起こしたもの。原則カード「引き継がれるのは外部記憶と原則だけ」は2026-07-04作成の実ノートで、5部構成も「結果」欄の未記入TODOも実物のまま。メモリに付く「N日前」の注意書きは、ハーネスが自動付与する英文リマインダーの意訳。一方、「hooks が守り・スキルとメモリが攻め」という整理は筆者の見立てで、公式の分類ではない。事実の誤りには、反論を歓迎する。