修正した説明を、そのまま長文で押しつけるのはだいたい失敗する。読む側は「で、何が変わったのか」だけ知りたいのに、前提や経緯まで全部読む羽目になるからだ。ここで効くのが、要約だ。さらに引き継ぎメモとしてそのまま使える形に落としておくと、次の人が拾いやすい。
Claude Code は、長い説明を短く圧縮するのが得意だ。ただし、雑に投げると要点まで薄まる。修正後の内容を、誰に渡しても同じ理解になる粒度に削るには、最初に「何のための要約か」を言い切るのがコツになる。単なる短縮ではなく、引き継ぎ用のメモにする。ここを外すと、ふわっとした文章が返ってきて終わる。
たとえば、修正した文章がこれだとする。
この機能は、重複したファイル名をまとめて整理できる。対象フォルダを選ぶと、同名ファイルを一覧化し、最後にまとめて確認してから処理を実行する。誤削除を避けるため、最初はプレビューだけ表示する。
これを Claude Code にそのまま丸投げするより、次のように頼むほうが使える出力になる。
次の説明を、引き継ぎメモとして使えるように短く要約してください。
条件:
- 3行以内
- 何をする機能かが一目で分かる
- 実行前の注意点を1つ入れる
- そのまま他人に渡せる文体にする
本文:
この機能は、重複したファイル名をまとめて整理できる。対象フォルダを選ぶと、同名ファイルを一覧化し、最後にまとめて確認してから処理を実行する。誤削除を避けるため、最初はプレビューだけ表示する。
こうしておくと、返ってくる文が「何をする」「どう使う」「何に気をつける」の3点に寄る。引き継ぎではここが大事だ。背景説明を削りすぎると雑になるが、細かい事情を残しすぎると読まれない。短くするとは、単語数を減らすことではなく、次の人が必要な判断をできる形に整えることだ。
実務で使うなら、要約の前に少し役割を与えると安定する。たとえば「Slack に貼る」「会議後に共有する」「引き継ぎメモに入れる」で文体が変わる。Claude Code にもそのまま伝えていい。
次の修正内容を、引き継ぎメモ向けに要約してください。
- 読み手はこの件を初めて見る人
- 口頭説明の補助として使う
- 専門用語は残してよいが、説明を省略しすぎない
- できれば箇条書き2点にする
本文:
……
この指定が効くのは、要約の失敗がだいたい「短すぎる」か「前提が抜ける」のどちらかだからだ。筆者も最初は、単に「短くして」とだけ頼んでいた。すると、見た目は整っているのに、肝心の修正点が消える。たとえば「命名を統一した」が「整理した」になってしまう。これでは引き継げない。短くなっただけで、意味は薄い。
逆に、無理に全部残そうとすると今度は要約にならない。長文の言い換えにしかならず、読む側の負担が減らない。だから、先に残す軸を決めておくといい。多くの場合、残すのはこの3つで足りる。何を直したか、なぜ直したか、次に何を見ればよいかだ。修正後の説明を引き継ぎやすくしたいなら、この3つから外れる情報はかなり削ってよい。
ファイル整理や文書作成に使うなら、さらに実用的な形にできる。たとえば案件フォルダごとの作業記録を、最後に一行要約へ変える運用だ。
次の作業記録を、引き継ぎ用の一行メモにしてください。
条件:
- 変更点が分かる
- 次に確認すべき点を含める
- 200文字以内
作業記録:
……
このやり方だと、「修正後の説明」がそのまま引き継ぎメモになる。あとで自分が見返すときも強い。人間は数日たつと、何を直したかより「なぜそうしたか」を忘れる。そこで短い要約があると、再説明の手間がかなり減る。
注意したいのは、要約を作らせるときに「正確さの優先順位」を曖昧にしないことだ。Claude Code は文章を自然に整えるのがうまいぶん、曖昧な依頼だと、もっともらしい言い回しに寄せてしまう。これが地味に危ない。引き継ぎ用途では、きれいな文章より、事実に忠実な文のほうがずっと価値がある。少し不格好でもいいから、固有名詞や数字、対象範囲は残せと指示しておくべきだ。
次の説明を要約してください。
ただし、ファイル名、数量、対象範囲は省略しないでください。
曖昧な言い換えは避け、修正点がそのまま分かる形にしてください。
この一手間で、後から「結局どこを触ったのか分からない」という事故が減る。筆者は以前、要約を軽く見て、最終版の説明から数字を落としてしまったことがある。あとで別の人が見たとき、どのフォルダを対象にした修正か判別できず、結局元の作業ログまで掘り返す羽目になった。短いメモほど、事実が一個抜けるだけで使えなくなる。ここはケチらないほうがいい。
少し進めるなら、要約と引き継ぎメモを分けずに一発で作らせると楽だ。修正後の説明を渡したら、そのまま「他人が見て次の行動を取れる文」に整える。
次の説明を、引き継ぎやすい短いメモにしてください。
条件:
- 最初の1文で変更内容が分かる
- 次に確認すべきことを1つ入れる
- 冗長な前置きは削る
- 読み手は関係者だが、元の経緯を知らない
本文:
……
こうしておくと、修正報告、作業ログ、引き継ぎノートの三役を同じ下書きから回せる。長い説明を毎回手で削るのはだるいし、削り方にムラが出る。Claude Code に要約させるときは、ただ短くするのではなく、「誰に渡すか」「何を残すか」「どこまで削るか」を先に決める。そこまでやって、やっと使える要約になる。