Claude Codeへの依頼書を書く｜作りたい画面と動作を説明する

どの仕事で何に困っているかを伝える

相談のたびに作業範囲や追加条件を紙へ書き、後で見積もりを作っているとします。聞き忘れへの対応なら、必要な質問が表示され、不明な項目を残せる画面が候補になります。正式価格の確定や請求書の発行まで含む「見積もりアプリ」とは、引き受ける仕事が異なります。

現状、困る場面、欲しい結果が分かる依頼なら、何を作らないかにも理由があります。相談メモを受け取るところまでが今回の範囲なら、完成後もその流れを通して確かめられます。

表は横にスクロールできます。

Claude Codeへ渡す情報を六つに分ける

Claude Codeはコードを読み、ファイルを編集し、コマンドを実行する開発用ツールです。ただし既存コードだけから、現在の業務条件をすべて把握できるわけではありません。利用者、守る条件、変更してよい範囲は、依頼する側が伝える情報として残ります。

電話中にスマートフォンで使う担当者と、顧客が直接入力する場合では、項目の言葉や説明量も変わります。下の六欄は、端末や仕事の事情を開発の相談へ持ち込むためのメモで、制作会社や協力者にも共有できます。

表は横にスクロールできます。

画面の動きを、操作と結果で書く

「作業種類を選ぶと、その作業の確認項目が現れる」には、操作と結果の両方があります。「使いやすく」だけの場合と異なり、実装後に同じ操作をして仕様と比べられます。

広さの単位、追加料金、対象外作業などの基準は、事業者の業務ルールです。不明な内容をもっともらしく補わせると、試作の仮定が実際の価格条件に見えてしまいます。サンプルを使う場合は、その表示も含めて試作と分かる扱いになります。

通常の操作を一つ通して書く

画面を開き、作業種類と広さを入力し、注意事項から相談メモを受け取るまでが一連の利用です。最後のメモにも入力した内容が正しく載って初めて、この流れを通せたと言えます。

広さが分からない相談もある

「要確認」を選べるなら、分からない広さを無理に数字へ変える必要がありません。次の担当者は、不明だったこと自体を引き継げます。誤った確定値を増やさずに相談を進めるための仕様です。

変更する場所と確認方法を計画で確かめる

既存の構成を調べた後、変更する場所と確認方法を計画として出してもらえば、編集前にも依頼範囲を相談できます。公式にはplan modeも案内されています。操作方法は利用環境によるため、現在の環境での使い方に沿います。

聞き忘れに対応する試作へ会員登録や決済まで含まれていたら、その追加が今回の仕事に要るかを聞けます。計画の段階なら、不足している確認項目も実装前の依頼へ戻せます。

訪問清掃の相談で使う確認メモの画面を作りたいです。
目的は担当者の聞き忘れを減らすことです。正式な価格確定・請求・外部送信は今回の対象にしません。
まず現状を調べ、足りない業務条件を質問してください。
目的／利用者／入力／出力／変更範囲／確認方法を短い仕様にまとめ、その後に実装計画を示してください。
業務ルールが不明な箇所は仮定で確定せず、未決定として残してください。

完成の条件は、依頼時に用意する

見た目が仕上がっても、空欄がある相談や途中の変更で使えなければ、仕事の目的には合いません。主要な操作と、そうした例外の動きを依頼時に共有しておくと、「完成」の意味を双方で比べられます。

• 作業種類を選ぶと、必要な確認項目が現れる。
• 未確認の条件が、確定した情報と区別される。
• 入力内容を変えた後のメモに、古い条件が残らない。
• スマートフォンで項目名と入力欄の関係を読める。
• この試作が正式な見積もりではないことを説明できる。

よくある質問

専門知識がなくても仕様を書けますか？

仕事を操作と結果で説明することに、専門用語は必須ではありません。技術上の選択が出てきたときは、その理由と、担当者の仕事へどう影響するかを質問できます。分からない語を残したまま承認する必要はありません。

細部がまだ固まっていない場合はどうしますか？

試作して初めて分かる内容もあります。今回使う範囲と完成を判断する項目を共有し、それ以外の不明点を残す進め方なら、すべて確定したふりをせずに開発を相談できます。