雑に頼むと、Claude Code はちゃんと働くのに、返ってきたものが使いにくい、という事故が起きる。中身は合っているのに、Markdown で欲しかったのに段落の羅列だったり、表で一発整理したかったのに長文で返ってきたりするやつだ。
ここで先にやるべきなのは、出力形式を先に決めることだ。Markdown か表かを指定しておく。たったそれだけで、返答の形が安定するし、あとからコピペして文書に流し込みやすい。
Claude Code は、指示があいまいだと、だいたい「それっぽい」形で返す。人間の側が読みやすい形式を頭の中で決めていないと、見出しだけ立派で中身が散らばる。筆者も最初のころ、要約を頼んだのに箇条書きと段落が混ざった出力をそのまま受け取り、あとで整形し直して手戻りした。中身を作る前に、器を決めておくほうが速い。
たとえば、議事録の整理、手順書の作成、ファイル一覧の棚卸し、比較表の作成では、最初の一文で形式を固定しておくといい。実際の頼み方はこんな感じだ。
以下をMarkdownで出力してください。
見出しは「概要」「手順」「注意点」の3つにしてください。
箇条書きは必要最小限にして、説明は段落で書いてください。
対象: Claude Codeの初期設定メモ
表にしたいなら、こう切る。
次の内容を表で整理してください。
列は「項目」「内容」「補足」の3列にしてください。
行は増やしすぎず、比較しやすさを優先してください。
対象: 3つの候補フォルダの違い
Markdown と表は、似ているようで役割が違う。Markdown は、少し長い説明や段階的な手順に向く。見出しを切って、必要なところだけ箇条書きにすれば、そのまま文書になる。表は、違いを並べて見たいときに強い。たとえば「どのフォルダを残すか」「どの書類を保管するか」「どの案を採るか」を比べる場面だ。長文を表に押し込めると読みにくくなるので、表に向くのは短い情報だけだと割り切ったほうがいい。
ここで大事なのは、「いい感じに整えて」ではなく、「Markdown で」「表で」と言い切ることだ。曖昧な指定は、曖昧な出力を呼ぶ。出力形式を先に決める、つまり Markdown か表かを指定する、という順番を固定しておくと、後工程がかなり楽になる。
実務では、形式指定は本文より先に置いたほうが効く。Claude Code は、最初に受けた条件を強く引きずる。だから、途中で「やっぱり表にして」と言い直すと、すでに作った文章を崩してやり直すことになる。これが地味にだるい。最初から決めておけば、無駄な出力を減らせる。
こういう頼み方も使いやすい。
回答はMarkdownでお願いします。
最初に結論、そのあとに手順、最後に注意点を入れてください。
コードやコマンドが出る場合は、必ずコードブロックにしてください。
回答は表でお願いします。
各行は1項目1行にし、説明は長くしすぎないでください。
必要なら最後に短い補足を1段落だけ付けてください。
ただし、表にしろとだけ言って、複雑な説明まで全部押し込むのはよくない。表は便利だが、万能ではない。段階を追う説明、理由の説明、注意点の補足は、Markdown のほうがずっと読みやすい。逆に、冗長な文章をそのままMarkdownで返させると、要点が埋もれる。形式は見た目の好みではなく、情報の性質で決めるのが正しい。
筆者が一度やらかしたのは、ファイル整理の相談で、一覧を作ってほしいのに形式を言わなかったことだ。結果、説明文が先に来て、肝心のファイル候補が埋もれた。あとから「表で再出力して」と頼み直したが、最初から表を指定していれば済んだ話だ。こういう手戻りは小さいようで、積み重なると時間を食う。
非エンジニアの使い方でも、この癖はかなり効く。たとえば、案件ごとの書類一覧を整理したいなら、まず表を指定する。各書類の名前、用途、保管先、不要かどうか、みたいな列を切れば、眺めるだけで判断しやすい。逆に、手順書や案内文を作りたいなら Markdown を指定する。見出しを付けて、段落で説明してもらったほうが、そのまま配布資料に流し込める。
少し応用すると、形式指定とあわせて「何を優先するか」も一緒に決めるとさらに安定する。表なら「比較しやすさ優先」、Markdown なら「そのまま読めること優先」と伝える。これで、無駄に凝った装飾や、逆に味気ない出力を避けやすい。
回答はMarkdownで、社内共有用としてそのまま読める形にしてください。
専門用語は少なめにし、見出しは多すぎないようにしてください。
回答は表で、あとからExcelに貼りやすい形にしてください。
列名は固定し、セル内の文章は短めにしてください。
形式を先に固定するのは、Claude Code を縛るためではない。読みやすさとやり直しの少なさを先に確保するためだ。Markdown にするか、表にするか。ここを先に決めるだけで、返答はかなり扱いやすくなる。曖昧なまま走らせると、あとで整える時間がふくらむ。そこを避けるのが、いちばん安い時短だ。