2026-10-10

同じ失敗を二度させないために、Claude に「手順書」を育てさせている

Claude Code に仕事を任せていて、いちばんがっかりするのは、前に一度直した失敗をまた踏まれたときです。

Claude は、会話が長くなると古い部分から忘れていきます。別の日に新しい会話を始めれば、前の会話のことは覚えていません。だから私は、失敗とその直し方を手順書として残させています。

手順書（スキル）とは

Claude Code には、「この作業をするときは、これを読んでから始めて」という手順書を置いておく仕組みがあります。スキルと呼ばれています。私のパソコンでは、1つのテーマにつき1つのフォルダで、いま42本あります。

中身は、たとえばこういうものです。

どれも、最初から書いたものではありません。失敗するたびに、1行ずつ足していったものです。

手順書を書けば終わり、ではありませんでした。

ある時期、対処法が手順書にちゃんと書いてあるのに、Claude が読まずに作業を始めて、同じ失敗を踏みました。アプリの起動の空振りが2回、文字列の中の記号が消える失敗が5回です。「知っている」と「読んだ」は別でした。

そこで、失敗しやすい操作の前には、手順書を読んでから手を動かすように決めました。

手順書が育つと、今度は長くなりすぎます。1本の手順書を呼ぶたびに全文が読み込まれ、それだけで Claude の作業の枠を大きく使ってしまうようになりました。

いまは、手順書の先頭には「目次」だけを置き、本文は別のファイルに分けています。Claude は目次で必要な節を見つけて、その節だけを読みます。42本のうち25本が、この形になっています。いちばん大きい手順書は、目次の部分が54KB、分けた本文が228KBあります。

Claude は、会話をまたぐと前のことを忘れます。手順書は、その忘れた分を毎回取り戻すための置き場です。