PaPoo
cover

長い依頼の冒頭で前提を 1 行に圧縮する

長い依頼をそのまま投げる人は多いが、いちばん先に削るべきなのは本文ではなく冒頭だ。
Claude Code に何をしてほしいのか、対象は何か、制約は何か。この3つを最初の1行に圧縮しておくと、あとの説明がずっと通る。前提の一行化、と呼んでいい。冒頭サマリとも言える。

これをサボると、会話の最初の数ターンがほぼ「確認」に消える。こちらは説明したつもりでも、モデル側はまだ対象の輪郭をつかみ切れていない。結果、出だしで余計な修正が入る。筆者は以前、フォルダ整理の依頼で「どのディレクトリを触るか」を冒頭に置かず、途中で条件がずれて手戻りしたことがある。後から見返すと、依頼文の本題はちゃんとしていたのに、入口が長すぎて肝心の前提が埋もれていた。

まずは、こういう形にする。

目的: 既存の請求書フォルダを整理し、重複ファイル候補を見つけて、削除せずに一覧化する。
前提: 触ってよいのは /Users/you/Documents/invoices 配下だけ。
制約: ファイル削除はしない。結果は日本語で、実行したことと見つけた候補を分けて出す。

この3行があるだけで、Claude Code はかなり楽になる。最初に「何をするか」を持たせ、次に「どこまで触ってよいか」を固定し、最後に「何をしないか」を縛る。順番が大事だ。制約だけ先に並べると、肝心の目的がぼやける。逆に目的だけだと、危ない操作を平気で提案される。
長い依頼ほど、入口は短く、太く、わかりやすくしておくのが正解である。

非エンジニアの作業でも同じだ。たとえば、弁護士が案件ごとの書面整理をさせるなら、最初にこう置く。

目的: 案件Aの資料を、提出用・参考用・不要候補に分けて整理する。
前提: 対象は /Users/you/Desktop/案件A だけ。
制約: ファイル名の変更はしない。内容の要約だけでよい。

ここで効くのは、難しい命令ではなく、前提の固定だ。Claude Code は賢いが、勝手に「たぶんこれだろう」と広げると普通にずれる。特にフォルダが複数あるとき、対象範囲を明示しないと、似た名前の別案件に手を出しかねない。人間でもやらかすやつである。

実務では、1行に全部を詰め込む必要はない。
「前提の一行化」は、長文を圧縮して雑にすることではない。最初の1行に、依頼の背骨だけを置くことだ。そこに入れるべきなのは、だいたい次の3点で足りる。

たとえば、ダウンロードフォルダの掃除ならこうなる。

目的: ダウンロードフォルダ内の重複候補と不要になった一時ファイルを洗い出す。
前提: 対象は Downloads 配下だけ。
制約: 削除はしない。候補一覧と理由を出すだけにする。

この書き方のいいところは、あとから条件を足しやすいことだ。
たとえば「最終更新日が30日以上前のものだけ見たい」「PDFだけに絞りたい」「同名でも中身が違うものは除外したい」みたいな条件は、2行目以降に積めばよい。最初の1行まで長くしすぎないのがコツで、あれもこれも詰め込むと、冒頭サマリの意味が消える。

ここで一つ、よくある失敗を挟んでおく。
筆者は昔、最初から細かい条件を全部書こうとして、冒頭が「目的」「背景」「補足」「例外」で四方八方に膨らんだことがある。読む側からすると親切そうに見えるが、Claude Code にとっては情報の洪水だ。最初の数行で軸をつかませたいのに、説明の枝葉が多すぎて、何が本筋か見えにくくなる。長文の依頼ほど、最初の1行に骨格、それ以降に肉付け。順番を逆にすると詰まる。

依頼文の実例としては、こういう並べ方が使いやすい。

目的: 既存のMarkdown文書を読みやすく整える。
前提: 対象は /Users/you/notes/articles 配下の .md ファイルだけ。
制約: 内容は変えず、見出しの重複や表現のゆれだけ直す。要約は勝手に追加しない。
補足: 出力は、修正したファイル名と変更点の要約を分けて示す。

この形だと、Claude Code は「何を変えてよくて、何を変えてはいけないか」をすぐ掴める。文書作成の用途でもかなり効くし、ファイル整理でもそのまま流用できる。特に「内容は変えず」「削除しない」「移動先を確認してから」といった禁止条件は、最初に置く価値が高い。後ろに回すと、そもそも読まれないことがあるからだ。

やってはいけないのは、前提を一行化したつもりで、実は抽象語だけ並べることだ。
「効率よく整理してください」「わかりやすくまとめてください」では弱い。何を整理するのか、どのフォルダなのか、削除してよいのか。そこがないと、指示としてはかなり曖昧である。Claude Code は雑に見えても、こういう曖昧さには案外素直に揺れる。揺れた結果、こちらが後で直す羽目になる。手戻りがだるいなら、最初の1行をケチらないことだ。

少し進めるなら、前提の一行化をテンプレ化しておくといい。毎回ゼロから書かず、先頭だけ差し替える形にする。

目的: [何をするか]
前提: [対象範囲]
制約: [してはいけないこと]

これをベースにして、必要なときだけ「出力形式」「優先順位」「判断基準」を足す。
この順序で書くと、長い依頼でも迷いにくい。Claude Code にとっても、こちらにとっても見通しがよくなる。結局のところ、長文の強さは情報量ではなく、最初の1行で迷わせないことにある。依頼の入口を短く整えるだけで、会話全体の質がかなり変わる。

関連 TIPS

同じ著者の記事