PaPoo
cover

一度にやることを減らして、見失いを防ぐ

雑にまとめて一気に投げると、Claude Code はわりと簡単に見失う。人間のほうもだが、出力のほうもだ。
ここで効くのが、単一タスク化、あるいは集中実行という考え方である。やることを一度に1個に絞る。すると、指示が短くなり、差分が小さくなり、途中で何を直しているのか分からなくなる事故が減る。

これはコード修正だけの話ではない。ファイル整理でも、不要ファイルの削除でも、文書作成でも同じだ。
「このフォルダを片付ける」「この文章の冗長さだけ削る」「この1本のスクリプトの失敗原因だけ追う」と分けるだけで、かなり安定する。

筆者は最初、欲張って「このディレクトリの整理、重複削除、README更新、ついでに不要な設定も見て」と一気に頼んで手戻りした。返ってきた結果は悪くないのに、どこに何を置いたか、何を触ったか、こちらが追えない。差分がでかくなると、レビューもつらい。Claude Code は優秀でも、曖昧で広い依頼を丸ごと飲み込ませると、だいたい散る。

要は、作業を「目的」で切るのではなく、「一回の実行単位」で切ることだ。
たとえば次のようにする。

この作業は3段階に分けたい。
1. まず対象フォルダの中身を把握する
2. 次に不要ファイル候補だけを列挙する
3. 最後に削除してよいものだけ実行する

今回は1だけやってください。削除はまだしないでください。

この頼み方のいいところは、Claude Code が勝手に先回りしにくい点にある。
「全部やって」と言うと、調査と提案と実行をまとめて進めがちだ。そこで事故が起きる。削除していいものと、残すべきものの境目が曖昧なまま進むからだ。特にファイル整理では、キャッシュや一時ファイルと、あとで必要になる資料が見た目だけ似ていることがある。ここを一気に片付けると、あとで痛い目を見る。

コード作業でも同じで、最初から修正とリファクタリングとテスト追加を全部まとめると、diff が肥大化する。
だから、こう分けるのが扱いやすい。

この修正は分割して進めたいです。

最初に、原因の候補を3つに絞ってください。
次に、そのうち最も可能性が高い1つだけを直してください。
最後に、必要ならテストを1本追加してください。

今回は原因の整理だけで止めてください。

この言い方だと、Claude Code に「今は何をしないか」も伝わる。ここが大事だ。
一度にやることを減らすコツは、やることを減らすだけでなく、やらないことを明示することにある。削除しない、編集しない、実行しない。これを先に固定すると、出力の暴走がかなり抑えられる。

文書作成でも使える。たとえば長い提案書や議事録なら、いきなり全文を直させない。段落単位で詰める。

この文章は、まず見出し構成だけ整えてください。
本文の書き換えはまだしないでください。

見出しの粒度がそろっているか、重複がないかだけ見たいです。

こうすると、内容の吟味と文章の整形を同時にやらずに済む。
人間もそうだが、構成をいじりながら表現までいじると、どこで何を壊したのか分からなくなる。Claude Code にもそれは起きる。だから順番を切る。

非エンジニアの使い方でも、単一タスク化はかなり効く。たとえば大量の書類フォルダを整理するとき、次のように頼むといい。

このフォルダの中で、重複していそうなファイル名を拾ってください。
削除はしないで、候補だけ一覧にしてください。

これなら、いきなり消される心配がない。
次の段階で、候補を見ながら「これは残す」「これは消してよい」を自分で決めればいい。ディスク削減でも同じだ。いきなり掃除させるより、まず不要候補の洗い出しに限定したほうが、失敗しにくい。

気をつけたいのは、「1個ずつ」と言いながら、実は依頼文の中に3個4個入れてしまうことだ。
たとえば「このフォルダを整理して、重複を消して、命名規則も直して、READMEも更新して」と書くと、見た目は1つのお願いでも、中身は4つだ。Claude Code はそこをちゃんと分解するが、こちらの確認コストは減らない。むしろ増える。だから、一回の指示は一回の成果物に絞る。成果物が1つなら、レビューも1つで済む。

もうひとつ大事なのは、終わったら次の一手を出すことだ。
単一タスク化は、何でも細切れにしろという話ではない。手順を分けて、各段階で止めるのが本筋である。たとえば、

次はAだけやってください。終わったら止まって、結果を要約してください。

この「止まって」が効く。自動で続けてしまうと、意図しない編集や削除まで進むことがあるからだ。特にファイル操作は、勢いでやると戻すのがだるい。

実務でいちばん使いやすい型は、こうだ。

1. 調べる
2. 候補を出す
3. 1件だけ適用する
4. 結果を確認する
5. 次に進む

今回は2まで。

この順番にしておくと、Claude Code の出力が読みやすい。こちらも判断しやすい。
しかも、途中で方針を変えやすい。1回ごとの差分が小さいからだ。大きな変更を一気に通すより、細かく区切ったほうが結局速い。手戻りが減るので、総時間も短くなりやすい。

やりがちなのは、「全部まとめてやったほうが早い」と思い込むことだ。短距離ならそう見えるが、実際は逆になりやすい。
依頼が広いほど、確認も修正も重くなる。Claude Code の出力が長くなり、どこで意図がずれたのか追いにくくなる。単一タスク化は地味だが、これをやるだけで見失いはかなり減る。雑に回しているときほど効く。

必要なら次にやるべきことは、作業の分割ルールを自分の中で決めることだ。
「調査と実行を同時にしない」「削除は別指示にする」「1回の依頼で成果物は1つまで」。この3つを守るだけで、Claude Code はだいぶ扱いやすくなる。
派手さはないが、実務ではこういう地味な制御がいちばん効く。

関連 TIPS

同じ著者の記事