やりたい処理を伝えて、動く形にするときに使える指示文です。かっこの中を自分の状況に置き換えれば、そのまま使えます。渡すものはやりたい処理、言語、返ってくるのはコードです。
この用途の概要
| 何をさせるか | やりたい処理を伝えて、動く形にする |
|---|---|
| 渡すもの | やりたい処理、言語 |
| 返ってくるもの | コード |
| 分類 | 開発 |
| 向いているツール | 開発・コーディング |
| 任せ方 | 確かめてから使う（2／3） |
関数を書いてもらう｜そのまま使える指示文
かっこの中を自分の状況に置き換えて、そのままコピーして使えます。
関数を書いてください。
・やりたい処理：
・言語とバージョン：
・入力：（型と、想定される範囲）
・出力：（型）
・想定外の入力が来たときの動き：（エラーにする／既定値を返す）
条件：
・外部のライブラリを使う場合は、なぜ必要かを書いてください
・エラーになりうる箇所を教えてください
・書いたあと、この関数が満たしていない条件があれば挙げてくださいこの形にしている理由。「想定外の入力が来たときの動き」を決めておかないと、あとで挙動が食い違う。
この指示文が何をしているか
指示文を部分ごとに分けると、それぞれ別の役目を持っています。
- 渡す材料の指定
- かっこで示した部分に、やりたい処理、言語を入れます。ここが空のまま送ると、AIが一般論で埋めます。
- 出力の形の指定
- コードという形を指定しています。形を決めておくと、毎回同じ構造で返ってくるので、次の作業につなげやすくなります。
- やってはいけないことの指定
- 「補わない」「推測しない」といった禁止を入れています。これを書かないと、材料にないことが混ざります。
つまずくところ
動くコードが返ると、境界の入力を試さずに使ってしまう。
こうすると直る
空・0・負の数・想定外の型を、必ず自分で試す。
どこまで任せられるか
この用途の任せ方は確かめてから使う（2／3）です。形は任せられますが、中身は確かめる必要があります。事実に関わる部分は元の資料と突き合わせてください。
| 段階 | 意味 | この用途は |
|---|---|---|
| 1 | そのまま任せられる | |
| 2 | 確かめてから使う | ここ |
| 3 | 人が判断する |
段階は「AIの性能」ではなく「間違えたときの影響」で決めています。文章の言い回しを間違えても直せますが、契約や体調に関わる判断を間違えると取り返しがつきません。
どの用途にも効く6つの原則
この6つは、どの指示文にも共通して効きます。うまくいかないときは、まずこのどれかが抜けていないかを見てください。
- 役割を決める
- ただ「書いて」と頼むより、「新人に説明する立場で」「校正者として」のように立場を決めると、出てくる文の前提がそろいます。
- 入力を先に、条件を後に
- 渡す材料と、守ってほしい条件を分けて書きます。混ざっていると、条件が材料の一部として読まれることがあります。
- 出力の形を数で指定する
- 「いくつ」「何字」「どの順」を数で指定します。「簡潔に」は人によって長さが違いますが、「200字で」は揺れません。
- してほしくないことを書く
- 「補わないでください」「推測で書かないでください」は、書かないと必ず補われます。
- 分からないときの言い方を決める
- 「分からない場合は分からないと書いてください」を入れておくと、それらしい答えで埋められずに済みます。
- 例を1つ見せる
- 欲しい形の見本を1つ渡すと、説明を重ねるより早く伝わります。
関数を書いてもらうの指示文では、とくに「出力の形を数で指定する」と「してほしくないことを書く」が効きます。動くコードが返ると、境界の入力を試さずに使ってしまう。
使う前に確かめること
- かっこの中を、自分の状況に置き換えたか
- 渡す材料が揃っているか（足りないまま送ると埋められます）
- 社外に出せない情報が含まれていないか
- 出てきたものを、そのまま使うのか確かめてから使うのか決めたか
とくに3つめは、使うサービスの設定によっては入力した内容が学習に使われることがあります。会社の規定を先に確かめてください。
「開発」の他の用途
同じ分類には12件あります。似た場面で使うものは、指示文の書き方も似ます。
| 用途 | させること | 任せ方 |
|---|---|---|
| エラーの原因を調べる | エラーメッセージから、何が起きているかを絞る | 確かめてから使う（2） |
| コードをレビューしてもらう | 書いたコードの、危ないところを指摘してもらう | 確かめてから使う（2） |
| テストコードを書いてもらう | 書いた関数に対して、確かめるべき入力を出してもらう | 確かめてから使う（2） |
| 既存のコードを読み解く | 他人が書いたコードが何をしているかを把握する | 確かめてから使う（2） |
| 正規表現を作ってもらう | 拾いたい文字列の形を伝えて、パターンにしてもらう | 確かめてから使う（2） |
| 関数を書いてもらう | やりたい処理を伝えて、動く形にする | 確かめてから使う（2） |
| コードを別の言語に移す | 同じ動きを、別の言語で書き直す | 確かめてから使う（2） |
| ログの読み方を聞く | 大量の出力から、原因につながる行を探す | 確かめてから使う（2） |
| 設計を相談する | 作る前に、構造の選択肢を並べる | 確かめてから使う（2） |
| 命名を相談する | 中身が分かる名前を付ける | 確かめてから使う（2） |
| コメントを書く | 後から読む人に必要な説明だけを残す | 確かめてから使う（2） |
| ライブラリを選ぶ | 目的に合うものを、条件を並べて選ぶ | 確かめてから使う（2） |
関数を書いてもらうの他のページ
この用途については、5つの角度でまとめています。
| ページ | 書いていること |
|---|---|
| 関数を書いてもらうの書き方 | この用途で外さないための組み立て方 |
| 関数を書いてもらうの失敗と直し方 | うまくいかないときに、指示文のどこを変えるか |
| 関数を書いてもらうのツール選び | 開発・コーディングのツールの中で、この用途に向くもの |
| 関数を書いてもらうの応用 | 慣れてきたときの進め方と、他の用途との組み合わせ |
関数を書いてもらうを使う場面
やりたい処理を伝えて、動く形にするという作業です。実際に使う場面を押さえておくと、指示文に何を書けばいいかが決まります。
- 出てきたものを誰が見るか
- 自分と、後からコードを読む人
- いつ使うか
- 書く前と、詰まったとき
- 間違えたときに何が起きるか
- 動いているように見えて、境界で壊れる
- かかる時間の目安
- コードは数分。確かめが本番
関数を書いてもらうで渡すのはやりたい処理、言語、返ってくるのはコードです。この2つがはっきりしていないうちに指示文を書くと、一般論しか返ってきません。
使う前に決めておくこと
指示文を書き始める前に、次を決めておいてください。ここが決まっていないと、何度書き直しても結果が安定しません。
- 言語とバージョン
- 入力の型と範囲
- 想定外の入力が来たときの動き
- 既存のコードとの整合
言語とバージョン
これが決まらないうちは、指示文を書いても意味がありません。関数を書いてもらうの場合、ここが曖昧だと出てくるものも曖昧になります。
入力の型と範囲
2つめ以降は、指示文の条件として書き足す部分です。書かなければAIが勝手に決めます。
想定外の入力が来たときの動き
書き忘れると、あとから直すことになります。最初に決めておくほうが速く終わります。
既存のコードとの整合
書き忘れると、あとから直すことになります。最初に決めておくほうが速く終わります。
出てきたものの確かめ方
関数を書いてもらうの出力は、確かめてから使う段階（2／3）です。形は任せられますが、中身は次の観点で確かめてください。
- 境界の入力（空・0・最大・型違い）で試したか
- 外部に影響する処理が含まれていないか
- テストが通るか
境界の入力（空・0・最大・型違い）で試したか
目で追うだけでは見落とします。項目を1つずつ潰す形で確かめてください。
外部に影響する処理が含まれていないか
目で追うだけでは見落とします。項目を1つずつ潰す形で確かめてください。
テストが通るか
目で追うだけでは見落とします。項目を1つずつ潰す形で確かめてください。
期待どおりの答えが返ってきたときこそ確かめてください。自分が望んでいた結論が出ると、検算をしないまま通してしまいます。
関数を書いてもらうの前後にある作業
関数を書いてもらうは、たいてい一連の作業の途中にあります。前後を意識すると、渡す材料と出力の形が決まります。
| 段階 | すること | AIに任せられるか |
|---|---|---|
| 前 | やりたい処理、言語を用意する | 材料集めは自分でやることが多い段階です |
| ここ | やりたい処理を伝えて、動く形にする | 確かめてから使う（2／3） |
| 後 | コードを確かめて使う | 確かめるのは人の仕事です |
同じ流れで使う用途
| 用途 | させること |
|---|---|
| エラーの原因を調べる | エラーメッセージから、何が起きているかを絞る |
| コードをレビューしてもらう | 書いたコードの、危ないところを指摘してもらう |
| テストコードを書いてもらう | 書いた関数に対して、確かめるべき入力を出してもらう |
| 既存のコードを読み解く | 他人が書いたコードが何をしているかを把握する |
| 正規表現を作ってもらう | 拾いたい文字列の形を伝えて、パターンにしてもらう |
| コードを別の言語に移す | 同じ動きを、別の言語で書き直す |
| ログの読み方を聞く | 大量の出力から、原因につながる行を探す |
| 設計を相談する | 作る前に、構造の選択肢を並べる |
前の段階で材料が揃っていないと、この段階で埋め合わせが起きます。埋め合わせられたものは、材料に無かったものです。
105用途の中でどこにいるか
このサイトには105用途を収録しています。関数を書いてもらうがどのあたりに位置するのかを数字で見ます。
| 見るもの | この用途 | 全体 | ||
|---|---|---|---|---|
| 分類 | 開発 | 11分類のうちの1つ | ||
| 同じ分類の用途数 | 12件 | 105件 | ||
| 任せ方 | 確かめてから使う（2） | 1:15件 / 2:84件 / 3:6件 | ||
| 向いているツールの分類 | 開発・コーディング | 10件のツールがある |
分類ごとの用途数
| 分類 | 用途数 | 任せ方の内訳 | |
|---|---|---|---|
| ビジネス文書 | 15 | 1:3 / 2:11 / 3:1 | |
| 資料作成 | 8 | 1:2 / 2:6 / 3:0 | |
| 調べもの | 9 | 1:2 / 2:5 / 3:2 | |
| 文章を書く | 12 | 1:4 / 2:8 / 3:0 | |
| 学習 | 9 | 1:2 / 2:7 / 3:0 | |
| データ・表計算 | 9 | 1:1 / 2:8 / 3:0 | |
| 開発 | 12 | 1:0 / 2:12 / 3:0 | |
| 就職・転職 | 8 | 1:0 / 2:6 / 3:2 | |
| 画像生成 | 7 | 1:0 / 2:6 / 3:1 | |
| 暮らし | 9 | 1:1 / 2:8 / 3:0 | |
| AIとの付き合い方 | 7 | 1:0 / 2:7 / 3:0 |
任せ方の段階は「AIの性能」ではなく「間違えたときの影響」で決めています。3が多い分類は、AIに任せきれない判断が含まれる分野です。
関数を書いてもらうに関わる言葉
このページで使っている言葉のうち、意味を取り違えやすいものをまとめました。
- プロンプト
- AIに渡す指示文のこと。日本語では「指示文」と書きます。長さに決まりはなく、条件を並べた数百字のものが普通です。
- カスタム指示
- 毎回同じことを書かなくて済むよう、あらかじめ登録しておく指示。サービスによって呼び方が違います（システムプロンプト、カスタムインストラクションなど）。
- ハルシネーション
- AIが事実でないことを、事実のように書いてしまうこと。文章としては自然なまま起きるので、読んで違和感を探すだけでは見つかりません。
- コンテキスト
- 一度に渡せる文章の量。これを超えると、前のほうの内容が扱われなくなります。
- トークン
- AIが文章を数える単位。日本語はおおよそ1文字が1トークン前後です。料金がトークン数で決まるサービスがあります。
- スタックトレース
- エラーが起きるまでにどの処理を通ったかの記録。エラーメッセージだけでなく、これも渡すと原因が絞れます。
- リンター
- コードの書き方を機械的に確かめる道具。AIのレビューと併せて使うと漏れが減ります。
関数を書いてもらうについて、よくある質問
指示文をそのままコピーして使えますか？
かっこの中を自分の状況に置き換えれば使えます。置き換えずに送ると、やりたい処理、言語が無い状態になるので、一般的な話しか返りません。
どのAIで使えますか？
開発・コーディングに分類されるツールなら、どれでも基本的な形は通ります。ツールごとの違いは関数を書いてもらうのツール選びにまとめました。
出てきたものをそのまま使っていいですか？
この用途は「確かめてから使う」段階です。形はそのまま使えますが、中身は確かめてください。
毎回結果が違うのですが
出力の形を数で指定し、欲しい形の見本を1つ添えると揺れが減ります。完全に同じにはなりません。詳しくはうまくいかないときを見てください。
社外に出せない情報を渡しても大丈夫ですか？
使うサービスの設定によっては、入力した内容が学習に使われます。固有名詞をA社・B社に置き換える、数字を丸めるなどして渡すか、会社の規定を確かめてください。
間違えたときにどうなりますか？
動いているように見えて、境界で壊れるです。だからこのページでは、確かめ方まで書いています。
どのくらい時間がかかりますか？
コードは数分。確かめが本番です。確かめる時間を見込んでおいてください。
このページで分かったこと
- 関数を書いてもらうは「やりたい処理を伝えて、動く形にする」ための用途
- 渡すのはやりたい処理、言語、返ってくるのはコード
- 任せ方は確かめてから使う（2／3）
- つまずくのは：動くコードが返ると、境界の入力を試さずに使ってしまう。
- 向いているツールは開発・コーディングの分類
動いているように見えて、境界で壊れる。出てきたものは、このページの「確かめ方」を通してから使ってください。
指示文を短くした版
毎回すべてを書くのが面倒なときは、ここまで削れます。削っても外してはいけないのは「材料を渡すこと」と「補わせないこと」の2つです。
関数を書いてください。
（やりたい処理、言語を貼る）この短い版で足りるかどうかは、出てきたものを見て決めてください。形が毎回変わる、材料にないことが混ざる——このどちらかが起きたら、元の長い版に戻します。
丁寧に書きたいとき
大事な場面では、次を足すと精度が上がります。
- 読む人を指定する
- 「（誰）が読む前提で」と書くと、専門用語の量と説明の細かさが変わります。
- 見本を1つ添える
- 欲しい形の見本を1つ渡すと、説明を重ねるより早く伝わります。過去にうまくいった出力を取っておくと使えます。
- 理由も書かせる
- 「そう判断した理由も書いてください」を足すと、判断が妥当かを確かめられます。ただし出力が長くなります。
- 段階を分ける
- 関数を書いてもらうを1回でやらず、「まず観点を出す→選ぶ→本文を作る」と分けると、途中で方向を直せます。
この指示文を自分用に保存する
一度うまくいったら、次から書き直さずに済む形にしておきます。
- 毎回変わる部分（かっこの中）と、変わらない部分を分ける
- 変わらない部分を、カスタム指示やメモに保存する
- 変わる部分は、記入欄の形で残しておく（「相手：＿＿」のように）
- 使うたびに直したところがあれば、保存した側に反映する
4つめを続けると、自分の仕事に合った指示文が育ちます。毎回同じところを直しているなら、それは保存する側に書けます。
コードでAIを使うときに気をつけること
開発の用途に共通して効くことをまとめます。関数を書いてもらうにも当てはまります。
- 境界の入力で試す
- 空・0・負の数・最大値・型違い。バグはここに出ます。うまくいく入力だけで確かめないでください。
- 外部に影響する処理を先に見る
- ファイルの書き込み、通信、データベースの更新。試しに動かす前に、これらが含まれていないか確かめてください。
- 言語とバージョンを必ず書く
- 書き方が違って動かないコードが返ります。
- エラーは全文を貼る
- メッセージを一部だけ貼ると、見当違いの原因が返ります。スタックトレースも省略しないでください。
- 書き直した全体をもらわない
- 差分が追えなくなります。指摘だけもらって、直すのは自分でやってください。
この分類の作業の流れ
- 言語・バージョン・入出力の型を書き出す
- AIにコードや指摘をもらう
- 外部に影響する処理を確かめる
- 境界の入力で試す
- テストを書く
- レビューを受ける
関数を書いてもらうは、この流れの中では「外部に影響する処理を確かめる」のあたりに入ります。前後の段階を自分でやることを前提にしてください。
近い用途の探し方
105用途は、分類のほかに「任せ方」でも並べられます。同じ任せ方の用途は、確かめる手間も似ます。
| 任せ方 | 意味 | 用途数 | この用途 | |
|---|---|---|---|---|
| 1 | そのまま任せられる | 15 | ||
| 2 | 確かめてから使う | 84 | ここ | |
| 3 | 人が判断する | 6 |
同じ「確かめてから使う」の用途
| 用途 | 分類 | させること |
|---|---|---|
| 議事録から決定事項を抜き出す | ビジネス文書 | 会議の文字起こしから、決まったことと持ち帰りだけを取り出す |
| 長い資料を要約する | ビジネス文書 | 読む時間がない資料から、判断に要る部分だけを取り出す |
| 稟議書の理由を書く | ビジネス文書 | 欲しいものと、なぜ要るのかを、決裁者に伝わる形にする |
| 表にまとめる | 資料作成 | ばらばらの情報を、比べられる形に整える |
| 図解の案を出す | 資料作成 | 文章で説明していることを、絵にする方法を考える |
| キャッチコピーを考える | 文章を書く | 商品やサービスを一言で言う |
| 練習問題を作ってもらう | 学習 | 覚えたことを確かめる問題を出してもらう |
| 文章を添削してもらう | 学習 | 書いた文の、直すべきところを指摘してもらう |
| データの集計方法を相談する | データ・表計算 | 手元の数字から、何をどう出せば知りたいことが分かるかを決める |
| SQLを書いてもらう | データ・表計算 | 取りたいデータを日本語で伝えて、クエリにしてもらう |
分類から探す
| 分類 | 用途数 | 中心になる作業 | |
|---|---|---|---|
| ビジネス文書 | 15 | 指示文で下書きを作る | |
| 資料作成 | 8 | 構成を作る | |
| 調べもの | 9 | 一次情報を探す | |
| 文章を書く | 12 | 構成を作る | |
| 学習 | 9 | AIに説明してもらう | |
| データ・表計算 | 9 | 処理の前に件数を数える | |
| 開発 | 12 | 外部に影響する処理を確かめる | |
| 就職・転職 | 8 | 重なる部分を選ぶ | |
| 画像生成 | 7 | 指示文を組み立てる | |
| 暮らし | 9 | AIに候補を出してもらう | |
| AIとの付き合い方 | 7 | 指示文を作る |
場面別の書き換え例
同じ関数を書いてもらうでも、急いでいるときと大事な場面では、書く量が変わります。3つの形を用意しました。
1. 急いでいるとき（最短の形）
やりたい処理を伝えて、動く形にするてください。
出力：コード
材料に無いことは補わないでください。
---
（やりたい処理、言語）材料を渡すことと、補わせないこと。この2つだけは削れません。これ以外を削ったのがこの形です。形が毎回変わってもいい場面で使ってください。
2. 大事な場面（条件を足した形）
やりたい処理を伝えて、動く形にするてください。
・読む人：（誰が見るか）
・使う場面：（どこで使うか）
・分量：（◯◯字／◯項目）
出力の形：コード
守ってほしいこと：
・材料に書かれていないことは補わないでください
・分からない箇所は「分からない」と書いてください
・動くコードが返ると、境界の入力を試さずに使ってしまうという失敗を避けてください
---
（やりたい処理、言語）読む人・場面・分量を足し、この用途で起きやすい失敗を名指しで避けさせています。動くコードが返ると、境界の入力を試さずに使ってしまう。
3. 慣れてきたとき（保存する形）
【固定部分：カスタム指示やメモに保存する】
やりたい処理を伝えて、動く形にするときは、次を守ってください。
・出力は「コード」の形にする
・材料に無いことは補わない
・分からない箇所は「分からない」と書く
【毎回書く部分】
やりたい処理、言語：
読む人：
分量：固定部分をカスタム指示に入れておけば、毎回書くのは下半分だけになります。使うたびに直したところがあれば、固定部分に反映してください。自分の仕事に合った形に育ちます。
3つの使い分け
| 場面 | 使う形 | 確かめる量 |
|---|---|---|
| 下書きが欲しいだけ | 1. 最短 | 固有名詞と数字だけ |
| そのまま人に見せる | 2. 条件つき | このページの確かめ方をひととおり |
| 毎週・毎月やる | 3. 保存する形 | チェックリストにして毎回通す |
関数を書いてもらうの任せ方は確かめてから使う（2／3）です。2か3の形を使い、確かめる工程を必ず通してください。
AIを使うときに、ずっと効くこと
用途が変わっても変わらないことが4つあります。うまくいかないときは、ここに戻ってください。
- 材料が9割
- 指示文をいくら磨いても、渡す材料が足りなければ結果は変わりません。関数を書いてもらうならやりたい処理、言語です。ここを用意する手間を惜しまないでください。
- 書かないことは起きない
- 「補わないでください」「分からないなら分からないと書いてください」。書かなければ、必ず補われます。禁止は明示するものです。
- 一度に1つだけ変える
- 指示文を直すときは1箇所ずつです。まとめて変えると、何が効いたのか分からなくなり、次に活かせません。
- 期待どおりのときこそ確かめる
- 自分が望んでいた結論が返ってくると、検算をしないまま通してしまいます。もっともらしい文章は、内容を確かめずに信じてしまうものです。
4つめが、いちばん見落とされます。うまくいかないときは自然に疑いますが、うまくいったときは疑いません。関数を書いてもらうで出てきたものも、期待どおりだったときほど確かめてください。
この用途に戻るとき
関数を書いてもらうについては、次の5ページにまとめています。困ったときに合うページを開いてください。
関数を書いてもらうで渡す材料の用意
この用途で渡すのはやりたい処理、言語です。ここが揃っていないまま指示文を送ると、AIは足りない部分を埋めます。埋められたものは、元の材料に無かったものです。
材料が足りているかの見分け方
渡そうとしている材料を見て、「この中に答えの元があるか」を自分に聞いてください。無いなら、指示文をどう書いても出てきません。コードを作るのに要る情報が、材料の中にあるかどうかです。
材料が足りないときにできること
- 集めてから渡す
- いちばん確実です。手間はかかりますが、確かめる時間が減るので結局は速く終わります。
- 範囲を狭める
- 材料がある部分だけに絞って頼みます。関数を書いてもらうを一度に全部やらず、分かっている範囲から始めます。
- 分からないと書かせる
- 「材料から分からないことは、分からないと書いてください」を足します。埋められるより、空欄のほうが扱えます。
- AIに何が足りないか聞く
- 「コードを作るのに、この材料で足りない情報は何ですか」と聞くと、集めるものが分かります。
渡してはいけないもの
材料に次が含まれていないか、送る前に見てください。使うサービスの設定によっては、入力した内容が学習に使われます。
| 種類 | どうするか |
|---|---|
| 顧客名・取引先名 | A社・B社に置き換える |
| 個人が特定できる情報 | 削るか、記号に置き換える |
| 未公開の数字 | 桁だけ合わせた仮の数字にする |
| 社外秘の資料 | 構造だけ渡して、中身は渡さない |
一度渡したものは取り消せません。関数を書いてもらうが確かめてから使う段階（2／3）であることとは別に、この判断は毎回必要です。会社の規定を先に確かめてください。
関数を書いてもらうをAIでやらないほうがいい場合
便利な用途を集めたサイトですが、使わない判断も同じくらい大事です。関数を書いてもらうについて、次に当てはまるなら自分でやったほうが速く終わります。
- 1回しかやらない
- 指示文を組み立て、出てきたものを確かめる時間のほうが、やりたい処理を伝えて、動く形にする時間より長くなることがあります。
- 材料を用意する手間が大きい
- やりたい処理、言語を整えるだけで終わってしまうなら、そのまま自分で仕上げたほうが速いことがあります。
- 確かめる時間が作る時間を超える
- この用途は「確かめてから使う」段階です。確かめる工程を飛ばせません。確かめに時間がかかる作業は、最初から自分でやるほうが確実です。
- 判断そのものが仕事
- 材料の整理は任せられますが、決めることは任せられません。決める部分をAIに渡すと、根拠のない結論を受け取ることになります。
- 渡せない情報が中心にある
- 置き換えて渡すと、その作業の意味が無くなることがあります。
このページは指示文について書いていますが、そもそも使うかどうかを先に決めてください。使わない判断も、使い方の一部です。