メインコンテンツへスキップ
見出し画像

AIに作らせる前に決める「成果物の条件」──仕様を先に書く考え方と手順

    AIに「こんなものを作って」と頼む前に、決めておきたいことがあります。何ができたら完成なのか、どこまで作るのかです。

    ここが曖昧だと、出来上がったものを見ても、何を直すべきか判断しにくくなります。

    私もAiで何かを作る時、最終的に上手くいかなかったり、完成しないことが多々あります。

    先に書くべきなのは、長くて立派な指示文ではありません。目的、作る範囲、必要な機能、そして動き方です。この記事では、それらを「成果物の条件」として整理します。

    「成果物の条件」は、完成を判断するための約束

    成果物の条件とは、出来上がったものを確認するときの基準です。

    たとえば「使いやすいプロンプト保管庫を作って」だけでは、完成の形が見えません。保存できればよいのか、検索や共有まで必要なのかが決まっていないからです。

    そこで、依頼する側が先に、必要な状態を言葉にします。

    • 誰が、何のために使うのか

    • 今回は、どこまで作るのか

    • どの機能を付けるのか

    • 操作したとき、どう動くのか

    • 何を確かめれば、完成と言えるのか

    このうち、動き方や満たすべき条件を具体化したものが「仕様」です。

    今制作中のAiの講座企画でも、制作前の条件定義が主軸に置かれています。冒頭と仕様を考えるパートで、この考え方を明示しています。

    作り始める前に、完成を判断する言葉を用意する。これが記事全体の出発点です。

    条件は「目的→範囲→動き→確認」の順で書く

    最初から細部を埋めようとせず、次の順番で考えてみてください。

    1. 目的を書く。 誰が、何をするためのものかを短く書きます。「便利にする」で止めず、利用者の行動まで言葉にします。

    2. 今回作る範囲を決める。 目的に必要な機能を選び、後で考えるものも明記します。

    3. 機能の動き方を書く。 何を入力し、どこを操作すると、何が起こるかを決めます。

    4. 完成の確認方法を書く。 実際に操作して、条件を満たしたと判断できる形にします。




    画像

    ここからは、AIプロンプト保管庫を題材に、仮の条件を書いてみます。

    講座企画は、この保管庫を新しく作り、制作の全記録を講座化するものです。構成はAIコーディング支援、Next.js、Vercel、Supabase、GitHubです。開発環境にはVS Codeを使います。

    これらは、開発や公開、データ保存、コード管理を担う道具です。ただし、道具の名前だけでは、成果物の条件は決まりません。

    まずは、目的をこう置きます。

    自分が使うAIプロンプトを保存し、必要なときに内容を開いて再利用できるようにする。

    技術の話に進む前に、利用者が何をできればよいかをそろえます。

    機能は「今回作る範囲」までセットで決める

    目的が書けたら、必要な機能を選びます。

    仮の保管庫では、プロンプトの保存、一覧表示、内容の確認を今回の範囲にします。共有、検索、分類は、後で検討することにします。

    ここで大切なのは、思いついた機能を、そのまま全部採用しないことです。「あると便利か」だけでなく、「今回の目的に必要か」で判断します。


    画像

    範囲を決めるときは、次の順に確認します。

    1. その機能で、利用者は何をできるようになるか。

    2. その機能がなくても、今回の目的を達成できるか。

    3. 今回必要なら、どこまで動けば十分か。

    たとえば「一覧表示」も、名前だけでは仕様が足りません。保存したタイトルを並べるのか、本文まで表示するのかを決める必要があります。

    機能名と、今回どこまで作るかを一緒に書く。これで依頼する範囲が見えるようになります。

    仕様は「操作と結果」を確かめられる形にする

    次に、選んだ機能の動きを具体化します。基本は、「何をしたら、どうなるか」です。

    仮の保管庫なら、「プロンプトを保存できる」を次のように分解します。

    • タイトルと本文を入力できる。

    • 保存ボタンを押すと、入力内容が保存される。

    • 保存したタイトルが一覧に表示される。

    • 一覧のタイトルを選ぶと、保存した本文を読める。

    • ページを開き直しても、保存した内容が残る。

    通常の操作に加えて、入力が足りないときの動きも決めます。たとえば「タイトルか本文が空なら保存せず、入力を促す表示を出す」と書けます。

    「きちんと保存する」「適切に処理する」では、確認する基準が曖昧です。画面やデータがどうなるかまで書きましょう。

    大学の映画アンケートアプリにも、機能を先に決めてから実装した事例があります。仕様は、上映中の作品から3作品を選び、各作品に評価などを付けるものです。

    このように、対象、選ぶ数、行う操作が決まると、作るものを具体的に伝えられます。

    完成の確認も、仕様と対応させます。

    1. タイトルと本文を入力して保存する。

    2. 一覧から開き、入力した内容と一致するか確かめる。

    3. ページを開き直し、内容が残っているか確かめる。

    4. 空欄のまま保存を試し、決めた表示が出るか確かめる。

    確認方法を書けない条件は、もう少し具体化する余地があります。

    AI で壁打ち


    こう言った仕様書を作るのめんどくさいと思う方もいるかもしれません。なんとこれを効率良く行う方法があります。
    それがAiに壁打ちし、仕様書を作る方法です。

    壁打ちでは、AIの質問に答えながら、作るものの条件を決めていきます。最初から全部を考えておく必要はありません。一度に決めず、1つずつ答えるのがポイントです。

    まずは、次のように送ってみてください。

    自分用の「AIプロンプト保管庫」を作りたいです。
    まだ制作は始めず、先に成果物の条件を整理する手伝いをしてください。
    目的、今回作る範囲、動き方、完成の確認方法について、1つずつ質問してください。
    私が答えてから、次の質問に進んでください。

    質問には、難しい言葉を使わず、自分がどう使いたいかを答えます。プロンプト保管庫なら、たとえば次のようなやり取りです。

    AI:この保管庫で、何ができるようになりたいですか?

    自分:自分のAIプロンプトを保存して、必要なときに開いて再利用したいです。

    AI:最初の版には、どこまでの機能を入れますか?

    自分:保存、一覧表示、内容の確認までにします。共有、検索、分類は後で考えます。

    AI:プロンプトを保存してから開くまで、どう動いてほしいですか?

    自分:タイトルと本文を入力して保存すると、一覧にタイトルが出てほしいです。そのタイトルを選ぶと、保存した本文を確認できるようにしてください。

    AI:完成したことは、何を試して確かめますか?

    自分:試しに1件保存して、一覧に表示されるか確かめます。一覧から開いて、入力した本文と同じ内容が見られれば大丈夫です。

    答えに迷ったら、「まだ決めていません。選択肢を出してください」と返して構いません。AIの案を見て、自分の使い方に合うものを選びましょう。

    入力が足りないときの動きなども、同じように質問してもらいます。提案された機能を全部入れる必要はありません。今回必要かどうかを考え、後回しにするものも決めます。

    ひと通り決まったら、最後に次の文を送ります。

    ここまでに決まったことを、「目的・今回作る範囲・動き方・完成の確認方法」の4つに整理して書き出してください。
    今回作らないことも明記してください。
    まだ決まっていないことは、勝手に補わず、確認が必要な項目として残してください。

    書き出された内容を読み、意図と違うところを直します。この整理結果が、次の節でAIへ渡す依頼文になります。

    条件をひとまとめにしてAIへ渡す

    整理した条件は、そのまま依頼文にできます。仮の保管庫なら、次のような形です。

    目的
    自分のAIプロンプトを保存し、必要なときに開いて再利用できる保管庫を作ってください。
    今回作る範囲
    プロンプトの保存、一覧表示、内容の確認を作ってください。共有、検索、分類は後で検討します。
    動き方
    入力項目はタイトルと本文です。保存後はタイトルを一覧に表示し、選ぶと本文を読めるようにしてください。ページを開き直しても、保存内容が残るようにしてください。
    入力が足りない場合
    タイトルか本文が空なら保存せず、入力を促す表示を出してください。
    完成の確認
    保存、一覧表示、内容の確認、開き直した後の保持、空欄時の動作を確かめてください。確認結果と、確認できなかった項目を報告してください。
    判断に迷う場合
    条件だけでは決められない点は、実装前に質問してください。追加機能の案は、実装前に提案してください。

    画面の見た目に希望がある場合も、確認できる言葉を足します。たとえば「入力欄に項目名を表示する」のような指定です。

    「見やすく」「いい感じに」という希望を出発点にしても構いません。その後で、どんな状態なら希望を満たすのかまで掘り下げます。

    生成後も、最初の条件を基準に見直す

    出来上がったら、見た目の印象だけで判断せず、最初に書いた条件を確認します。

    1. 条件に沿って、実際に操作する。

    2. 期待した結果と、実際の結果を記録する。

    3. 違いがあれば、その条件を示して修正を依頼する。

    修正の依頼も、具体的に書きます。

    保存直後は一覧に表示されますが、ページを開き直すと内容が消えます。「開き直しても保存内容が残る」という条件を満たすように修正してください。

    途中で欲しい機能が増えたら、条件を書き直してから追加します。その際は、関連する動き方と確認方法も更新しましょう。

    仕様は、作り始めるためだけでなく、修正の判断にも使うものです。

    まとめると、AIに頼む前に決めるのは、目的、今回の範囲、機能の動き、完成の確認方法です。まずは、作りたいものについて「何ができたら完成か」を短く書いてみてください。そこから、依頼と確認の両方に使える仕様を育てていきましょう。

     
     

    Rain

     
     
    Aiに関する情報を発信しています。また、Aiでこういった使い方をしているなど、Aiの面白い使い方を募集してます。良かったらコメントしてください。

    あなたへのおすすめ