AI があなたのやりたいことをできないとしたら、それはおそらく要件が明確にされていないからです。
この記事はもともと Vista 電子ニュースレター第 148 号に掲載されたものです、元の電子ニュースレターをお読みください（新しいタブで開く）。
こんにちは、こんにちは！
前回の号では、vista.tw のリビジョンにおける私の経験についてお話しました。送信後、たくさんの返信をいただきました。 今年、私が何十回も聞かれたある種の質問があり、同じことをいくつかの異なる言い方で言います。
「私も AI に何か作ってもらおうとしましたが、できあがったものは思っていたものと全く違っていました。何度か変更しているうちにどんどん汚くなってしまい、ついには諦めざるを得ませんでした。」
今回のメルマガでは、この疑問に本気で答えていきたいと思います。 そうですね、最初に私自身の観察を述べさせてください。ほとんどの場合、問題は AI が十分に賢くないことではなく、AI に与えられた文が推測するには空白が多すぎることです。 これを改善する方法はありますが、プログラミングの仕方を知っているかどうかは関係ありません。
レターの後半では、11月末から始まった新たな試み「7日間で初めてのAIガジェットを作ろう」チャレンジキャンプ（新しいタブで開く）についてもご紹介します。
たった 1 つの文でも何かを行うことができますが、その多くは AI によって行われます。
さて、非常に一般的なオープニングから始めましょう。
毎日飲む水の量を記録する小さなツールを作成したいとします。そのため、Claude や ChatGPT などのツールを開いて、次の文を入力するとします。
「私を水の飲み記録ツールにしてください。」
AI が何かを作ってくれると思いますが、たいていはかなり良いものになります。 問題は、この文には、自分で決定しなければならないことが少なくとも 7 つまたは 8 つ隠されていることです。
- カップは何ミリリットルですか?自分で設定しますか?
-1日何杯飲むのが目標ですか？
-
ボタンを使用してカップを追加しますか、それとも番号を入力しますか?
-
画面上にグラフ、履歴、リマインダーを表示する必要がありますか?
-
翌日自動的にゼロにリセットしますか?
-
それはあなただけのためですか、それとも家族全員のためですか?
もちろん、実際にはすでに答えが心の中にありますが、それを声に出して言っていないだけです。 AI はユーザーの心を読み取ることができないため、平均的な人が望むものに基づいてユーザーに代わって決定を下す必要があります。 その結果、一生懸命働いているのに、何もうまくいかないように感じてしまいます。
次に、ほとんどの人は、「ボタンを大きくする」、「グラフを表示しない」、「毎日最初からやりたい」など、少しずつ修正を開始します。 修理するたびにAIが他の場所を変更する可能性があります。 5回目になると、もともと良かった機能が壊れて、最初に何が欲しかったのか忘れてしまっていませんか？
初めて Vibecoding（新しいタブで開く） を学び始めたとき、私は長い間このサイクルにはまってしまいました。 その後、後でずっと修正するのではなく、話す前に 5 分かけて頭の中に浮かんだことを書き留めたほうがよいことに徐々に気づきました。
5 段落の説明: あなたの頭の中にあるイメージを AI に与えてください
ここ数か月で、非常にシンプルなフォーマットを整理しました。 AIにガジェットの作成を依頼する前に、私はほぼ必ずそれを書き留めます。 全部で 5 つの段落があり、各段落に 2 ～ 3 文あれば十分です。
第 1 項: 誰がいつ使用するか
例: 「私自身も使っています。毎朝、起床時と就寝前に一度開きます。」
このセクションでは、ツールの基本的な音質を決定します。 自分で使用する場合は、インターフェイスが多少クールであっても問題ありません。お客様に見せる場合はレイアウトや説明文にも気を配る必要があります。 1 日に数回開く場合、操作は非常に高速でなければなりません。月に 1 回しか使用しない場合は、さらにいくつかの手順を実行しても問題ありません。
第 2 項: やるべきこと
最も重要な機能を最初に 3 ～ 5 つ挙げてください。
例: 「1. クリックして飲み物を追加します。 2. 画面には今日飲んだ飲み物の数が表示されます。 3. 毎日午前 0 時に自動的にゼロにリセットされます。 4. 過去 7 日間の記録を表示できます。」
順序は重要です。 AIはこれまでのプロジェクトに最も力を入れるだろう。この順序を使用して、どの機能が受け入れられないか、どの機能が後で追加できるかを判断することもできます。
段落 3: 写真はどのように見えますか
デザイン専門用語は必要なく、自分の言葉で説明してください。
例: 「上部は大きなフォントで今日のカップ数です。中央は大きな丸いボタンです。下部は 7 日間の記録です。シンプルな長いバーを使用してください。」
お気に入りのアプリやウェブページが手元にある場合は、「全体的な雰囲気が某アプリと同じくらいすっきりしている」と言うだけでも、AI が方向性を示してくれることがほとんどです。
第 4 段落: 不要なもの
この段落はほとんどの場合無視されますが、最も役立ちます。
例: 「ログイン不要、リマインダー通知なし、共有機能なし、アニメーションなし」
AI はユーザーのために機能を追加することを好みます。これは、物事をうまくやり遂げたいという意思の表れですが、ガジェットにとって、機能が 1 つ増えるということは、壊れる可能性のある機能が 1 つ増えることを意味します。 何が望ましくないのかを最初に伝えることで、何度も繰り返す修正作業の半分を節約できます。
段落 5: 上手に行う方法
チェックする基準を与えてください。
例: 「録音は 3 秒で完了しますが、携帯電話で開いても実行されません。」
このセクションでは、AI が完成した後、感情で良いか悪いかを判断する必要はなく、この基準に従ってチェックするだけで済みます。
これら 5 つの段落を書いても、仕様全体はわずか 200 ～ 300 ワード程度になります。 AIに段落全体を貼り付け、「この仕様に従ってください。完了したら、各機能がどこで行われるかを一つずつ教えてください。」という文を追加します。最初のバージョンがあなたが考えていたものにかなり近いことがわかるでしょう。
完全なデモ: ケースを受け入れるための見積計算ツール
形式を見るだけでは少し抽象的になるかもしれないので、完全な例を見てみましょう。
あなたがグラフィックデザイナーで、ある事件を担当していると仮定してください。 クライアントから「名刺とチラシのセットを作るのにいくらかかりますか?」と尋ねられるたびに、スプレッドシートを開いて項目を1つずつ追加し、テキストの段落を切り取って相手に貼り付ける必要があります。 これを 1 分で実行できる小さなツールを作成したいと考えています。
一文バージョン
「設計見積計算ツールの作成を手伝ってください。」
AI はすぐにそれを実現しました。画面上には十数個のサービス項目があり、各項目には単価の列があり、合計金額に占める各項目の割合を示す美しい円グラフもあります。 非常にプロフェッショナルに見えますが、2 分後に何かが間違っていることに気づきます。
- プロジェクトは想像したものであり、実際に取り組んでいるケースではありません
・単価を毎回自分で入力する必要があり、スプレッドシートと同じくらい面倒
-
緊急品の値上げはありませんが、これは最も一般的な状況です。
-
円グラフは見栄えがしますが、顧客にはまったく見えません。
-
計算が完了したら、さらに段落を書いて顧客に投稿する必要があります。
次に、見直しを始めます。 ４次改定では円グラフが削除され、緊急品の値上げ分が追加されるが、当初の小計が誤算されるようになる。
5 つの段落で書き直されたバージョン
5 分間かけて、同じ要件を 5 つの段落に分けて書き留めます。
-
誰がいつ使用するか: 私自身も使用します。顧客がLINEで価格を問い合わせる場合、携帯電話でLINEを開いて1分以内に返信できる必要がある。
-
やるべきこと： 1. サービス項目（名刺デザイン 3,000、チラシデザイン 4,500、ポスターデザイン 6,000、ロゴデザイン 12,000）を確認し、最初にプログラムに価格を書き込みます。 2.「お急ぎ」にチェックを入れて、合計金額に30％を追加してください。 3. 税抜合計金額と税込合計金額を自動計算します。 4. 直接コピーできる引用テキストを生成します。
-
画面の外観: 1 行に 1 つの項目、左側にチェック ボックス、右側に価格が表示されます。緊急は下部にあるスイッチです。合計金額は下部に大きな文字で表示されます。 下部には「引用テキストをコピー」ボタンがあります。
-
望まないもの: グラフなし、ログインなし、顧客データベースなし、メール送信機能なし。
-
上手な計算方法：お客様から金額を聞いてもらったら、1分以内に確認してコピーしてLINEに貼り付けます。見積文の形式は「こんにちは、名刺デザインとチラシデザイン、合計NT\7,500（税抜）、税込NT\7,875、約5営業日でお届け致します。」です。
この段落を AI に貼り付けると、最初のバージョンは希望どおりのものになります。 4 つの項目、ラッシュ スイッチ、コピー ボタンがあり、余分なものは何もありません。 配送日をオプションに変更するなど、微調整する必要があるのは 1 つまたは 2 つだけです。
2 つのバージョンの違いは何ですか
よく比べてみると、5段落版では専門用語が一切使われていないことがわかります。実際のサービス項目と価格、最も一般的な緊急事態、実際に使用するシナリオ、最終的なテキストの内容など、すでに頭の中にあるものを書き留めるだけです。
この中で最も重要なのは 2 つのことです。 まず、価格と見積文の例はすべて独自の実際のデータであり、AI はそれらを編集する必要がありません。 次に、「不要なもの」セクションは、円グラフなどの強力そうに見えてもまったく使用しない機能を直接ブロックします。
AIに物を作ってもらうときに最も重要な能力はテクノロジーではなく、自分の仕事を理解することだ、と私がよく言うのはこのためです。 毎日の仕事のやり方が明確であればあるほど、自分のニーズを明確に伝えることができます。
最も一般的な 3 つのスタック レベルとその対処方法
仕様がどれほど明確に書かれていても、プロセスには障害が依然として存在します。 以下の 3 つの状況は、私が最も頻繁に遭遇し、学生からよく質問されるものです。
状況 1: A は変更されましたが、B は壊れていました
これが最も一般的なものです。 ボタンを大きくするように要求しましたが、記録ロジックも変更されました。
対処法としては、言葉をより正確に「先ほどの修正により録音機能が壊れてしまいました。ボタンを大きくする修正はそのままにして、録音機能を元の状態に修復してください。」と伝えることです。どれを保持し、どれを復元するかを明確に伝えることは、単に「また壊れた」と言うよりもはるかに効果的です。
これを防ぐもう 1 つの方法は、一度に 1 つずつ変更することです。 3 か所を変更したい場合は、3 回言います。変更するたびに、次の変更を行う前に確認してください。 遅くなっているように見えますが、実際にはより多くの時間を節約できます。
状況 2: 変更が加えられると、事態はさらに混乱し、元に戻すことはできなくなります
変更後は、どちらのバージョンが優れているのかわかりません。
Web バージョンでは、クロードは前のメッセージに戻り、[編集] を押して再送信すると、そこから会話が分岐します。これは、過去に戻って最初からやり直すことに相当します。 端末のクロード コードを使用すると、「ファイルを最後に使用可能なバージョンに復元してください」と直接言うことができます。
より良い習慣は、満足のいくステージを完了するたびに、「ここがセーブポイントだ」と自分に言い聞かせることです。 Web バージョンは応答を保存でき、Claude Code はバージョン レコードを作成するように要求できます。
状況 3: 画面が空白になる、または理解できないエラーがポップアップ表示される
このとき、自分で理解しようとする必要はありません。 画面上のエラー メッセージをすべてコピーして AI に貼り付け、「このエラーが発生しました。修正して、理由を 1 文で教えてください。」と伝えます。
最後の「理由を一言で言え」は私のちょっとした口癖です。 エンジニアになる必要はありませんが、毎回少しずつ理解していれば、次回は問題をよりよく説明できるようになります。
最初の質問を選択し、条件を 1 つだけ調べます
最後の情報は、トピックの選択に関するものです。
多くの人が最初にやりたいと思うプロジェクトは、通常、非常に大規模なものです。 それは、完全な電子商取引 Web サイトや、会社のシステムを置き換えることができるアプリです。 どれもとても良いのですが、初めての作品なので3日目は失敗しやすいです。
たとえば、前の授業中に、生徒が手を挙げて私に「先生、AI を使って Shopee を作ってもいいですか?」と尋ねました。
したがって、次の 1 つの条件のみに基づいてトピックを選択することをお勧めします。
来週本当に開けますか?
帳簿の付け方、飲料水と睡眠の記録、クライアントの見積計算の手伝い、授業のくじ引き、読書会の出席記録、家庭での固定費の月末まとめの作成など、何でも構いません…これらのトピックは大したものではありませんが、共通点が 1 つあります。それは、毎日または毎週使用するということです。
使い方を知って初めて、何がうまく機能しないのかがわかります。それがうまく機能しないことがわかったら、変更したくなるでしょう。それを変えることで、自分のニーズを表現する能力が養われます。 このサイクルは、どのような説明ビデオを見るよりも効果的です。
一人でやる場合、最も難しいのは 3 日目を生き抜くことです
この時点で、何をすべきかすでにわかっているかもしれません。 しかし、一つだけ正直に言っておきたいのは、今年を見てみると、ほとんどの人が行き詰まっているということですが、それはテクノロジーの問題ではありません。
むしろ、人は途中で諦めてしまいます。
初日はとても興奮しましたが、2日目になってもそれを覚えています。 3日目は仕事が忙しかったので脇に置きました。 再び開いたのはすでに2か月後でしたが、どこでやったのかすでに忘れていました。 多くの読者から反響をいただいていますが、だいたいこんな感じの話です。
そこで、今回は新しい手法を試して、最初の作品を完成させるのに同行したいと思います。
7 日間のチャレンジ キャンプ: 7 日間で最初の AI ガジェットを作成する
チャレンジキャンプのデザインはシンプルです。
・期間：2026年11月30日（月）～12月6日（日）
-
毎日タスクレター: 午前中にメールボックスに送信されます。毎日のタスクは 30 ～ 60 分で完了する必要があります。
-
LINE学習グループ：毎日終了後にグループにチェックインしてください。行き詰まったら、聞いてください。毎晩返信しますし、クラスメイト同士で助け合うこともできます。
-
受け入れ7日目のライブ配信：12月6日午後8時、私は数人の学生の作品を選択してライブで視聴し、それらをより役立つ方法について一緒に話し合います。参加できなかった方も後日再放送をご覧いただけます。
-
料金: NT$999、数に限りがございます 7 日間の進行状況は次のように構成されています。1 日目はトピックを選択して開始します。 2日目は、今日紹介した5段階の公式を使って要件を明確に説明します。 3日目は実際に使用します。 4日目は携帯電話でも使いやすくする。 5日目に、誰かを見つけて試してみて、どこでつまずいているかを確認します。 6 日目に、オンラインで公開し、最初の URL を取得します。 7日目は合格ライブ中継。
7 日後には、毎日使用する小さなツールが作成され、インターネット上に公開され、URL が設定され、友人と共有できるようになります。
各タスク レターには 2 つの方法が付属します。claude.ai Web バージョンまたは Claude アプリを使用する場合は、何もインストールする必要はありません。すでにターミナル Claude Code を使用している人も、同じ進行状況をたどることができます。
最初に明確にしておきたいことが 1 つあります。クロードの無料アカウントではさまざまなことができますが、制限は非常に限られています。 7日連続でやるとほぼ確実に限界に達します。クロードコードは有料プランでのみご利用いただけます。 したがって、チャレンジ期間中に 1 か月間 (US$20) クロード プロに登録することをお勧めします。チャレンジキャンプ自体は参加費を支払いません。
登録料は Portaly を通じて支払われ、電子請求書を発行できます。
全体の手法を体系的に学びたい場合は、Webサイトやアプリから作業の自動化までを網羅した「基礎ゼロから学ぶVibeコーディング」がおすすめです。完全な例とデバッグ方法が含まれています。チャレンジキャンプが終わった後も読み続けるのに非常に適しています。
キャンプを始める前にウォームアップしたい場合は、無料の電子書籍「Your First Vibecoding Project」を読んでクロードの操作に慣れることができます。キャンプの初日がよりスムーズになります。
はっきりと話すことは練習できる能力です
今年を振り返ると、Vibecoding（新しいタブで開く） が私に最も教えてくれたことは、ウェブサイトの作り方ではなく、漠然としたアイデアを他の人が理解して実行できる方法で表現する方法だったと思います。
正直に言うと、この問題は物を書く人にとっては馴染みのないものではありません。 記事を書く前に、まず読者が誰なのか、彼らが何を言いたいのか、何を言わないのかを明確に考える必要があります。 AI にツールとしての役割を求める前に、同じ一連の質問について考える必要があります。 唯一の違いは、今度はあなたの話を聞いているのは AI であり、あなたの発言をすぐに押して使用できるものに変換します。
今回紹介した5部構成の議論は、チャレンジキャンプ（新しいタブで開く）に登録しなくてもすぐに利用できます。 次回、AI に何かを頼む前に、5 分かけてメモして試してみてください。何を思いつくか知りたいです。 直接返信して、一番作りたい最初のガジェットは何ですか? と教えていただくこともできます。
次回お会いしましょう！
ビスタ
※本記事は「Vista 電子報」第148号〈AI が思いどおりのものを作れないのは、たいてい要件を伝えきれていないから（新しいタブで開く）〉からの転載です。ニュースレターの無料購読（新しいタブで開く）もぜひどうぞ。
