依頼を出すとき、何を書けば相手が迷わず動けるか、決めていますか。このページでは、依頼の「型」を先に決めておくという考え方を扱います。コンピュータの世界で「API設計」と呼ばれる作業から、そのヒントを借ります。
API とは何の約束か
API とは、あるプログラムが別のプログラムに機能を提供するときの、窓口の仕様のことです。「何を渡せば、何が返ってくるか」を先に決めて、公開しておくものだと考えてください。例えば、地図アプリの裏側では、住所を渡すと緯度と経度が返ってくる窓口が用意されています。この窓口を使うプログラムは、地図の計算方法を知る必要がありません。渡すべき情報の形と、返ってくる情報の形さえ知っていれば、正しく依頼できます。
裏側の計算方法が、後からまったく別のやり方に作り替えられたとしても、窓口に渡すものと返ってくるものの形さえ変わらなければ、利用する側は何も変更せずに済みます。ここで重要なのは、API 設計とは「機能そのもの」の設計ではなく、「依頼の形」の設計だという点です。中身の処理がどれほど優れていても、依頼の形が毎回ばらばらなら、使う側は疲弊します。逆に言えば、中身の処理がまだ荒削りでも、窓口の形さえ一定であれば、利用する側は安心して使い続けられます。窓口の設計と、中身の完成度は、別の軸にあります。
もう1つ大事な性質は、API が「一度決めたら、そう簡単には変えない約束」だという点です。多くのプログラムが同じ窓口に依頼を送るようになった後で窓口の形を変えると、その窓口を使っている全てのプログラムを、一斉に修正しなければならなくなります。だからこそ、開発者は窓口を公開する前に、何度も形を見直してから固定します。依頼の型も同じで、一度チームに定着した型を頻繁に変えると、覚え直しのコストが発生します。型を変えたくなったときは、いきなり全体に周知するのではなく、まず1つのチームで試し、うまくいってから他のチームへ広げる進め方が安全です。
仕事の依頼に翻訳する
これを仕事の依頼に当てはめると、次のようになります。依頼を出す人は、窓口の利用者です。依頼を受ける人は、窓口の提供者です。窓口の提供者があらかじめ「この形式で依頼してください」と決めておけば、利用者は毎回迷わずに依頼を出せます。
具体的には、依頼に含めるべき項目を型として固定します。例えば、目的、期限、優先度、完成の形、確認してほしい相手、の5点です。
目的とは、その依頼が最終的に何のために使われるかです。期限とは、いつまでに欲しいかという締切です。優先度とは、他の依頼と比べてどれだけ急ぐかという位置づけです。完成の形とは、資料なのか、口頭の報告なのか、数字だけなのかという成果物の姿です。確認してほしい相手とは、出来上がったものを誰にチェックしてもらうべきかという情報です。この5点が揃っていない依頼は、受け手が聞き返す前提で出されている依頼だと考えられます。
型を決めるのは、依頼する側だけの仕事か
ここまで、依頼を出す側が型を用意する前提で話してきました。しかし、API の窓口を用意するのは、依頼を受け取る側、つまり機能を提供する側です。これを仕事に置き換えると、実は依頼を受け取る側にも、型を用意する余地があります。例えば、よく依頼を受ける立場の人が、「依頼するときはこの5項目を埋めてください」という簡単なフォーマットを先に用意し、周囲に共有しておく、という動き方です。
依頼が来るたびに受け身で聞き返すのではなく、窓口の形を先回りして提示するのは、受け手にもできる工夫です。窓口を用意する側が積極的に形を示すことで、依頼者は迷わず情報を揃えられるようになります。これは、依頼が集中しやすい役割ほど、有効な工夫です。例えば、複数のチームから資料作成を頼まれる立場の人であれば、「依頼テンプレート」を1枚用意して共有フォルダに置いておくだけで、依頼のたびに口頭で確認していた項目を、あらかじめ埋めてもらえるようになります。
段階を踏んで型を固める
いきなり5点すべてを毎回書くのは、慣れないうちは負担に感じるかもしれません。そこで、型を固める作業を、3段階に分けて考えてみます。
第1段階は、期限だけを必ず書く、という最小限の約束です。これだけでも、「いつまでか分からず着手を後回しにする」という事故は防げます。第2段階は、期限に加えて、目的と優先度を書く約束に広げます。これにより、受け手は「何のためにやるのか」「他の仕事より先にやるべきか」を、自分で判断できるようになります。
第3段階で、完成の形と確認相手まで含めた5点を揃えます。ここまで来ると、受け手は聞き返すことなく、最初から完成形をイメージして着手できます。型は一度に完成させる必要はなく、段階を踏んで育てていくものだと考えてください。
具体場面で見る
架空の場面を3つ考えます。1つ目は、資料作成の依頼です。「例の資料、お願いします」とだけ伝えるのではなく、「来週火曜の会議用に、A案の比較表をスライド1枚で。想定読み手は部長です」と伝える形です。依頼者が実際に口にする言葉に置き換えると、次のようになります。「目的は火曜の会議での意思決定、期限は月曜17時、優先度は最優先、形式はスライド1枚の比較表、確認は私が最終チェックします」という一言を添えるだけです。渡す情報の型を決めておけば、受け手は一度で意図を掴めます。
この一言があるかないかで、受け手が着手までにかかる時間は大きく変わります。無い場合、受け手はまず「比較表とはA案とB案どちらを軸にするのか」を確認しに行きます。ある場合、受け手は確認の手間を挟まず、そのまま作業に入れます。
2つ目は、問い合わせ対応の引き継ぎです。引き継ぎメモに「顧客名」「問い合わせ内容」「対応履歴」「次に必要なアクション」の4項目を必ず埋める型を決めておけば、担当者が変わっても対応の質が落ちません。例えば、「顧客名: 架空商事の田中様。問い合わせ内容: 請求書の再発行依頼。対応履歴: 8月20日に一次受付、経理に確認中。次に必要なアクション: 経理からの回答を待って返信」という4行が埋まっていれば、初めて対応する担当者でも、そのまま引き継げます。これは窓口の形を固定することで、担当者という中身を交換可能にする発想です。
3つ目は、他部署への確認依頼です。「これで大丈夫か確認してください」という依頼だけでは、何を基準に確認すればよいか分かりません。確認する側は「大丈夫」の基準を自分で作り出さねばならず、思わぬ観点まで調べてしまうこともあります。「この数値が前提条件と矛盾していないかを確認してください」と、確認の窓口を絞ります。確認する側が迷う余地を減らすほど、返答は早く正確になります。
落とし穴 — 型を固めすぎる罠
ただし、型を決めることには落とし穴もあります。1つ目は、型を細かくしすぎて、依頼を出す側の負担が増えてしまうことです。5項目あれば十分な依頼に、20項目の入力を求めれば、依頼すること自体が面倒になります。API 設計でも、窓口を複雑にしすぎると、誰も使わなくなるという同じ問題が起きます。窓口の項目を1つ増やすたびに、「本当にこの項目は必要か」を自問する習慣が、歯止めになります。
架空の例で言えば、「目的・期限・優先度・完成の形・確認相手」に加えて、「想定コスト」「関連する過去案件」「代替案の有無」まで毎回求める型を作ったとします。依頼者は入力欄を埋めるだけで疲れてしまい、結局は簡易な口頭依頼に逆戻りしてしまいます。型は、守られて初めて意味を持ちます。守られない型は、無い型と同じ効果しか生みません。
2つ目は、型を作った後、実際の使われ方に合わせて見直さないことです。最初に決めた型が、半年後の業務に合っているとは限りません。型は一度決めたら終わりではなく、使われ方を見ながら調整するものだと捉えてください。
3つ目は、窓口の形だけを整えて、中身の質を確認した気になることです。依頼の型が整っていても、受け手が期限内に対応できる余力を持っているとは限りません。型の設計と、実行力の確保は、別の問題として扱う必要があります。架空の場面で言えば、5項目がきちんと埋まった完璧な依頼書が届いても、受け手がすでに他の締切に追われていれば、依頼は結局こなせません。型を整えることは、依頼の意図を正しく伝える手段であって、受け手の手が空いていることまで保証するものではない、という点は分けて考える必要があります。
よくある反論 — 「毎回書くのは手間が増える」
型を提案すると、「依頼のたびに5項目も書くのは、かえって手間が増える」という反論をよく受けます。この反論には一理あり、実際に依頼を出す側の入力の手間は、確かに少し増えます。ただし、比べるべきは「依頼を出す側の手間」だけではありません。型が無い依頼では、受け手が聞き返し、依頼者が答え、その往復を待つ時間が発生します。依頼を出す側の数十秒の手間と、受け手の聞き返しと待機の時間を比べれば、多くの場合、最初に数十秒かける方が、全体としては短く済みます。負担が増えるように見えるのは、負担の場所が「出す側の最初」に移っただけで、総量としては減っている、という点を見落としやすいのです。
もう1つ付け加えると、型を書く手間は、慣れるほど小さくなります。最初の数回は5項目を意識して書く必要がありますが、型が定着すれば、依頼の際に自然と目的や期限を先に考える癖がつき、書く行為そのものにかかる時間は、次第に短くなっていきます。つまり、型を書く負担は一時的なもので、聞き返しをなくす効果は継続的なものです。短期のわずかな負担と、長期の継続的な削減を、同じ天秤で比べないことが大切です。
持ち帰り
- 依頼の型とは、目的・期限・優先度・完成の形・確認相手など、渡す情報の形を固定することである
- 型を決めておくと、担当者が変わっても依頼と対応の質が落ちにくくなる
- 型は一度決めて終わりではなく、細かくしすぎず、使われ方に合わせて見直す
やってみる
明日、誰かに依頼を出すときに、目的・期限・優先度・完成の形の4点を箇条書きで添えて送ってみてください。