それ、たぶん最初にぼかしているせいで詰まる。
Claude Code に「いい感じにまとめて」と投げると、出力形式の指定、つまり成果物の型やフォーマット指定が曖昧なまま進みやすい。すると、文章がほしいのに箇条書きが返ってきたり、表がほしいのに長文の説明が混ざったりする。結果として、こちらが後で整形し直す羽目になる。
先に「Markdown で出す」「表で並べる」「見出し付きの箇条書きにする」と固定しておくと、手戻りが減る。これは開発の話だけではない。ファイル整理でも、議事録でも、契約書のたたき台でも同じだ。最初に成果物の形を決めるだけで、Claude Code が何を優先すべきかがかなりはっきりする。
たとえば、フォルダ内の書類を整理したいなら、こう言えばいい。
このフォルダ内のファイルを整理して、結果を Markdown の表で返してください。
列は「ファイル名」「種類」「処理方針」「理由」にしてください。
本文の説明は最小限でいいです。
これだけで、少なくとも「長い感想文」にはなりにくい。
逆に、あとでそのままメモに貼りたいなら、こう寄せる。
調査結果を Markdown の見出し構成で返してください。
各見出しの下は短い段落にし、表は使わないでください。
そのまま文書に貼れる形にしてください。
ここで大事なのは、内容より先に器を決めることだ。
Claude Code はかなり柔軟だが、柔軟さは放っておくと散らかりやすさでもある。形式を決めないまま頼むと、こちらの頭の中にある「読みやすい形」を勝手に補完してしまう。そこがずれると、修正のために何往復もすることになる。
筆者も最初はここでよく手戻りした。
たとえば、不要ファイルの洗い出しを頼んだのに、説明が長すぎて一覧として見づらい。結局、後から「表にして」「理由は一行で」と追加で指示することになる。最初から表を指定しておけば済む話だが、ここを甘く見ると、コンテキストも時間も無駄に食う。特にファイル一覧や比較表のようなものは、文章で返されると普通にだるい。
出力形式の指定は、単なる見た目の話ではない。
表なら比較しやすい。Markdown ならそのまま文書に流し込める。箇条書きならチェックリストに向く。ここを先に言い切ると、Claude Code はかなり扱いやすくなる。逆に、形式が決まっていない依頼は、毎回「読み手にとって何がよいか」をモデル側が推測することになる。推測に任せると、だいたい期待とズレる。
実際の依頼文では、最初の一文か二文で形を固定してしまえばいい。
たとえば文書作成なら、こういう感じだ。
以下のメモを整えて、Markdown の文章として出力してください。
構成は「結論」「背景」「補足」の3つにしてください。
箇条書きは使いすぎず、読み物として自然な文にしてください。
表にしたいなら、ここまで決める。
以下の情報を、Markdown の表で整理してください。
列は「項目」「状態」「次の作業」にしてください。
1 行 1 項目で、余計な説明は表の外に出さないでください。
この「余計な説明は表の外に出さない」という一文が効く。
Claude Code は親切なので、聞かれていない補足まで入れがちだ。補足自体は悪くないが、一覧がほしい場面ではノイズになる。成果物の型を固定するとは、単に「表にして」と言うことではない。何を外に出してよくて、何を中に閉じ込めるかまで決めることだ。
非エンジニアの使い方でも同じである。
たとえば、家の書類を片づけたいとする。保険、請求書、学校のプリント、契約書みたいに混ざっているとき、まずは「一覧を表で返す」と言っておく。すると、あとで印刷するのか、捨てるのか、保管するのかを見比べやすい。文章でだらだら説明されるより、表のほうが圧倒的に向いている場面は多い。
このフォルダのPDFを分類して、Markdown の表で出してください。
列は「ファイル名」「推定カテゴリ」「要確認点」にしてください。
判断があいまいなものは、あいまいだと分かるように書いてください。
ここで「推定カテゴリ」と「要確認点」を入れておくと、勝手な断定を防ぎやすい。
フォーマット指定は、見た目の指定であると同時に、曖昧さの置き場所を決める作業でもある。
注意したいのは、形式を決めたのに、途中で別の形を混ぜることだ。
「表で」と言ったのに説明文をたくさん足すと、せっかくの指定がぼやける。筆者は以前、表がほしかったのに「補足も厚めに」と欲張って、結局どこを見ればいいのか分からない出力を作ってしまった。あれは失敗だった。形式を固定する意味が消える。まず一つに絞る。必要なら次の依頼で別形式を足せばいい。
応用するなら、最初から複数案を分けて出させる手もある。
たとえば、同じ内容を「Markdown の見出し案」と「表の要約」の2段構成で返させる。こうすると、文書に流し込みたい部分と、比較したい部分を分けて扱える。
次の内容を2つの形式で返してください。
1. Markdown の見出しつき文章
2. 重要点だけをまとめた Markdown の表
文章はそのまま報告書に使える形、表は一目で比較できる形にしてください。
こういう頼み方をすると、Claude Code の出力を後で整える仕事がかなり減る。
出力形式の指定は、見た目の好みではなく、作業の流れを短くするための道具だ。最初に成果物の形を固定しておく。それだけで、後工程が驚くほど軽くなる。