【非エンジニア編第9回】エンジニアへの依頼文をClaude Codeで整える

※Claude Codeを使用して記事を作成しています。

前回までの記事では、職種別の具体的な活用法を紹介してきました。

今回からは第3部「コミュニケーション編」に入ります。

最初のテーマは、

エンジニアへの依頼文

です。

依頼したつもりが、意図と違う対応をされた
何度もやり取りが往復してしまう
急ぎだと伝えたつもりが、伝わっていなかった

こうした行き違いの多くは、依頼文の書き方を少し変えるだけで防げます。

Claude Codeを使って、依頼文を整える方法を紹介します。

なぜ依頼文で行き違いが起きるのか

依頼文がうまく伝わらない原因は、主に3つに分けられます。

背景が省略されている
何のための依頼なのかがわからず、受け取った側が適切な判断をできない
求めるアウトプットが曖昧
「確認してほしい」だけでは、何をもって完了とするのかがわからない
優先度・緊急度が伝わっていない
依頼した側は急いでいるつもりでも、文章からはそれが読み取れない

これらは、文章を書くこと自体が苦手というより、

「自分にとって当たり前の情報を、書き忘れている」

ことが原因であるケースが多くあります。

Claude Codeは依頼文の「抜け」を見つける

依頼文を整える上でのClaude Codeの役割は、

自分では気づけない書き漏らしを指摘してもらうこと

です。

背景が足りているか確認する
求めるアウトプットを明確にする
優先度・緊急度を適切に伝える表現にする

コードの知識がなくても、文章の推敲として活用できます。

実例:バグ調査を依頼する

ここでは、以下のような下書きの依頼文を例にします。

【最初の下書き】
検索結果がおかしいので確認をお願いします。

この文章を、Claude Codeと一緒に整えていきます。

ステップ1:下書きの依頼文を確認してもらう

まず、下書きをそのまま渡し、不足している情報を指摘してもらいます。

【質問例】
エンジニアに送る依頼文の下書きです。
情報として不足している点があれば指摘してください。

「検索結果がおかしいので確認をお願いします。」

Claude Codeが、以下のように指摘してくれます。

【指摘例】
以下の情報が不足していると考えられます。

- 「おかしい」の具体的な内容
  (検索結果が表示されない、件数が違う、順番がおかしい、など)
- 発生条件
  (どんなキーワードで検索したか、いつから発生しているか)
- 影響範囲
  (すべてのユーザーで発生しているか、特定の環境のみか)
- 確認してほしい内容
  (原因調査をしてほしいのか、修正までしてほしいのか)
- 希望する対応期限

指摘を受けることで、自分が何を書き漏らしていたかに気づけます。

ステップ2:不足情報を補って依頼文を作り直す

指摘された項目を埋めて、Claude Codeに整理を依頼します。

【質問例】
以下の情報をもとに、エンジニアに伝わりやすい依頼文を作成してください。

【状況】
- 検索窓に「りんご」と入力すると、りんご以外の商品も表示される
- 昨日のリリース以降に発生している
- 社内の複数人で確認済み
- 原因調査と、可能であれば修正までお願いしたい
- 今週中に対応してもらえると助かる

Claude Codeが、以下のような依頼文を作成してくれます。

【依頼文の例】
件名:検索結果の不具合について確認をお願いします

お疲れ様です。
検索機能について、以下の不具合を確認しましたのでご連絡します。

【事象】
検索窓に「りんご」と入力すると、りんご以外の商品も検索結果に表示されます。

【発生時期】
昨日のリリース以降に発生していることを確認しています。

【確認状況】
社内の複数人で同様の事象を確認済みです。

【お願いしたいこと】
原因の調査と、可能であれば修正まで対応いただけますと幸いです。

【希望対応期限】
今週中に対応いただけますと助かります。
難しい場合は、目処だけでもお知らせいただけますでしょうか。

よろしくお願いいたします。

最初の一文だけだった依頼が、必要な情報を含んだ形に整理されました。

ステップ3:優先度・緊急度を適切に伝える

依頼文でつまずきやすいのが、優先度・緊急度の伝え方です。

【質問例】
今回の依頼は、他の依頼より優先して対応してほしいと考えています。
ただし、強く命令する印象にはしたくありません。
そのニュアンスを伝える表現を考えてください。

Claude Codeが、以下のように提案してくれます。

【表現例】
- 「恐れ入りますが、優先度高めでご対応いただけますと助かります」
- 「他の対応中の作業がある場合は差し込みで恐縮ですが、
   影響が大きい事象のため、優先してご確認いただけますと幸いです」
- 「緊急度が高いと考えておりますが、
   状況に応じてご判断いただければと思います」

一方的に「最優先で」と伝えるのではなく、相手の状況にも配慮した表現を選べるようになります。

ステップ4:依頼文を送る前に読み手目線でチェックする

送信前に、受け取る側の目線でチェックしてもらいます。

【質問例】
以下の依頼文を、
受け取ったエンジニアの立場で読んだ場合、
わかりにくい点や質問したくなる点があれば指摘してください。

(作成した依頼文を貼り付ける)

Claude Codeが、以下のような指摘を返すことがあります。

【指摘例】
- 「複数人で確認済み」とありますが、
  具体的な環境(端末やOSバージョンなど)の記載がないため、
  再現条件を確認したくなる可能性があります
- 「可能であれば修正まで」という表現は、
  修正の優先度が曖昧に伝わる可能性があります。
  必須なのか、状況次第でよいのかを明確にすると親切です

自分では気づかなかった曖昧さを、送信前に発見できます。

依頼文でよくある失敗

依頼と情報共有を混同する

「一応共有しておきます」なのか、「対応してほしい」なのかが曖昧な依頼文は、受け取った側を迷わせます。

【質問例】
以下の文章は、「共有のみ」なのか「対応依頼」なのかが
曖昧になっていないか確認してください。

と聞くことで、自分の依頼文の性質を客観視できます。

全ての依頼を同じ熱量で書いてしまう

緊急度の低い依頼まで、強い言葉で書いてしまうと、本当に緊急な依頼が埋もれてしまいます。

依頼のたびに、

「この依頼は、本当に急ぎかどうか」

を一度立ち止まって考える習慣が大切です。

感情的な表現が混ざる

急いでいたり困っていたりすると、無意識に強い言葉が混ざることがあります。

【質問例】
以下の文章から、感情的に受け取られる可能性がある表現があれば
指摘し、中立的な表現に修正してください。

このような使い方で、冷静な依頼文に整えることができます。

依頼文作成テンプレート

日常的に使えるテンプレートをまとめます。

【依頼文作成テンプレート】

1. エンジニアに送る依頼文の下書きです。
   情報として不足している点があれば指摘してください。
   (下書きを書く)

2. 以下の情報をもとに、
   エンジニアに伝わりやすい依頼文を作成してください。
   (背景・事象・お願いしたいこと・希望期限などを書く)

3. 今回の依頼の優先度・緊急度を、
   相手に配慮しつつ伝える表現を考えてください。

4. 以下の依頼文を、受け取ったエンジニアの立場で読んだ場合、
   わかりにくい点があれば指摘してください。
   (依頼文を貼り付ける)