FRL 自由研究ラボ

AIエージェントことはじめ — LAB 009

最初の道具を1つ作る

最初の道具は、自分が毎日困っていることから1つだけ選び、困っている場面をそのまま AI に話して作ってもらいます。 足したくなった機能は、作らずにメモへ回します。この4つの手順で、30分ほどで最初に動くものが出てきます。

この記事を読むとできること

  • 毎日の困りごとの中から、最初に作る道具を1つ選べます
  • 仕様書(作るものの設計メモ)を書かず、場面を話すだけで AI に頼めます
  • 機能を足したくなったとき、「足さずにメモしておく」ことができます

想定している使い方

ターミナル(文字で命令を打ち込むアプリ)で Claude Code を開き、日本語で頼んで、自分の Mac の中で動く小さな道具を作ります。 LAB 001〜LAB 008 を終えている前提です。

この記事の道順

  1. はじめに — 「作りたいもの」ではなく「困りごと」から
  2. part 1 — 困りごとを書き出す
  3. part 2 — 1つに絞る
  4. part 3 — 場面を話して、作ってもらう
  5. part 4 — 足したくなったら、メモに回す
  6. つまずき集
  7. 次の一歩

読む目安:約8分 ・ 手を動かす目安:約30分(part 1〜4)

INTRO

「作りたいもの」ではなく「困りごと」から

準備が整っても、ここで止まる人がいちばん多くいます。最大の壁は技術ではなく、「何を作るか」です。

「作りたいもの」から考えると、家計簿アプリのような大きすぎるものを思いつき、終わりが見えません。 「困っていること」から考えると、小さく、終わりが見える道具になります。 困りごとは毎日体験しているので、探す必要はなく、思い出すだけです。

✕ 「作りたいもの」から考える 「家計簿アプリを作ろう」 大きすぎて、終わりが見えない ○ 「困りごと」から考える 「レシートの金額と店名を、 毎回メモに書き写すのが面倒」 写真から読み取って、メモに残すだけの道具 小さい・終わりが見える・毎日使う

図の見方:上の段は「作りたいもの」から考えた場合で、大きすぎて終わりません。下の段は「困りごと」から考えた場合で、 困りごと → それだけを片付ける小さな道具、と上から下へ1本でつながります。 この記事では、例として「レシートの書き写し」を最後まで使います。読むときは、自分の困りごとに置き換えてください。

HOW TO

4つの手順で、最初の1つを作る

1

part 1 — 目安 10分

困りごとを書き出す

AI に質問してもらい、ここ1週間の「面倒だった場面」を一緒に思い出します。1人で考えるより、対話にした方が数が出ます。 次の文を、LAB 003 の part 4 のやり方で開いた Claude Code の会話画面に貼ります。この記事の文はすべて同じ画面に貼り、これから作る道具も code フォルダの中に置かれます。

ここ1週間で「面倒だな」「毎回同じことをしているな」と
思った場面を、一緒に思い出したい。
質問を1つずつして、私が答える形で進めて。
最後に、出てきたものを箇条書きにまとめて。
会話画面(イメージ) ここ1週間で「面倒だな」と思った場面を、 一緒に思い出したい。質問を1つずつして。 毎朝、いちばん最初にやることは何ですか? レシートを家計簿に書き写す… 先週、同じ作業を2回以上したことは? まとめ:面倒だと思ったこと ・レシートの金額と店名を書き写す ・毎朝、同じサイトを順に開く ・ファイル名を1つずつ付け直す

図1 会話の流れ(画面はイメージです)

上の文を貼って送ったら、AI の質問に1つずつ短く答えます。大きさや、作れるかどうかは気にしません。最後に、面倒だったことが箇条書きにまとまります。

✓ ここまでの確認:面倒だったことが5〜10個、箇条書きで手元にある。

2

part 2 — 目安 5分

1つに絞る

箇条書きの中から、1つだけ選びます。2つ同時に作り始めると、たいてい両方とも終わりません。 候補を、次の3つのふるい(条件に合わないものを落とすしくみのたとえ)に上から順に通します。

出てきた候補を、3つのふるいに上から通す 候補A 候補B 候補C 候補D 週に3回以上起きる B が落ちる ✕ 1文で説明できる C が落ちる ✕ 使うのは自分だけでいい D が落ちる ✕ 候補A これに決定

図2 3つのふるい

ふるいは上から順に3つです。最初は週に3回以上起きることで、月に1回のことは作る手間の方が高くつきます。次は1文で説明できることで、「〜すると、〜になる」と一息で言えなければ、まだ大きすぎます。最後は使うのは自分だけでいいことで、人に見せる・公開するは後回しにします。最初の1個は自分専用で十分です。

3つとも通る候補が無ければ、いちばん惜しいものを選べば十分です。選び直しは、いつでもできます。

✓ ここまでの確認:作る道具が1つに決まり、「〜すると、〜になる道具」と1文で言える。

3

part 3 — 目安 10分

場面を話して、作ってもらう

仕様書(作るものの細かい設計メモ)は要りません。仕様書は書かずに、会話で頼むだけで足ります。困っている場面をそのまま話せば十分で、細かい判断は AI に任せます。 会話は図3のように、上から順に進みます。

会話画面(イメージ) 作る前に、いまの状態をコミットして 困っていること:レシートの写真を見て、 金額と店名を書き写すのが面倒。 写真は code の中の「レシート」フォルダ。 小さな道具を作って。まず動くものを見せて。 ファイルを作ってもいいですか?(許可の表示) 場所: /code/ レシート読み取り/… 許可する やめる 作りました。動かした結果を見せます。 店名がうまく読めないことがある。 金額の近くに書いてある店名も見て。

図3 頼んでから動くまでの流れ(画面はイメージです)

始める前に、道具が使うファイルを code フォルダの中に置きます。レシートの例なら、iPhone で撮った写真を AirDrop(近くの Apple 機器どうしでファイルを送る機能)で Mac に送り、 code フォルダの中に作った「レシート」フォルダへ入れます。そのうえで、図3の上から順に進めます。

まず、いまの状態を記録(コミット)してもらいます。失敗しても、この時点まで元に戻せます(仕組みは LAB 005)。

次に、困っている場面をそのまま話します。レシートの写真は個人のデータなので、記録(git)に入れないことも一緒に伝えます。実際に貼る文は、これくらいの短さで足ります。

こういうことに困っている:レシートの写真を見て、
自分で金額と店名をメモに書き写していて面倒。
写真は code フォルダの中の「レシート」フォルダに入れてある。
このフォルダは個人のデータなので、記録(git)には入れないで。

これを解決する小さな道具を作って。
まずは動くものを見せて。細かい仕様は、
動かしながら一緒に決めていきたい。

作業の途中で許可を求める表示が出たら、/code/ という文字が入っているかだけを見ます。入っていれば許可して構いません。新しいファイルを作るだけなら、間違えて許可してもゴミ箱に入れれば戻ります。ファイルを消す・上書きするときだけは手を止め、内容を読んでから許可します。

できあがったら、結果を見て、思っていたのと違う所を言葉にして伝えます。ここからは LAB 001 のループ(書く・動かす・読む・直す)が回る番です。使い方は、AI に「使い方を教えて」と聞けば教えてくれます。

✓ ここまでの確認:自分の Mac の中で、その道具が動いている。 本物のレシートで1回試してください。「動いた ≠ 正しい」は、LAB 001 でも触れた通りです。思った通りに動くまで直すやり取りは、道具が小さければ1〜2時間ほどで落ち着くことが多く、何日も悩むなら大きすぎるサインです。

4

part 4 — 目安 5分

足したくなったら、メモに回す

道具が動くと「グラフも出したい」「家族も使えたら」と欲が出ます。 機能が増えるほど直す所も壊れる所も増えます。ここで要るのが「育てない勇気」で、「これで完成」と決めることも立派な設計です。 思いついたことは消さず、作らずに、ノートへ1行書いておきます。

✕ 思いつくたびに足す 最初の道具 + グラフ表示 + 家族と共有 + スマホ対応(ここで力尽きる) 直す所が増え続け、完成しない ○ 1つで完成と決め、思いつきはメモへ 最初の道具 これで完成、と決める 今日から毎日使う 壊れる場所が増えない 思いついた機能は ノート「いつかやること」 - グラフ表示 - 家族と共有

図4 足し続ける道と、完成と決める道

上の段は、思いつくたびに足して力尽きる道です。下の段は、最初の道具で完成と決め、思いついた機能はノートへ回す道です。

part 1 と同じ会話画面で、次の文を貼ります。LAB 003 でつないだ Obsidian(ノートアプリ)に、「いつかやること」というノートができて1行書き足されます。

「いつかやること」というノートに、今思いついた機能を
1行だけ書き足して(そのノートがまだ無ければ、
新しく作ってから書き足して)。いま作るのではなく、
あとで見返すためのメモとして残したい。

このときの許可の表示には、/code/ ではなく /brain/(LAB 003 で渡したノート用のフォルダ)が入ります。/brain/ が入っているのを確かめてから許可します。

何日か経って見返し、また欲しくなった機能だけを作ります。一度も思い出さなかった機能は、そもそも要らなかった機能です。

✓ ここまでの確認:足したくなった機能をノートに1行書いた。無ければ「これで完成」と決めた。

TROUBLE

つまずき集

困りごとが1つも出てこない

慣れすぎて、面倒だと気づいていないことがあります。家族や同僚に「何が面倒?」と聞くと出やすくなります。

候補がどれも大きすぎる

「アプリ」を作ろうとしています。「作業を1つ減らす」だけに絞ります。

AI が勝手に機能を増やしてくる

AI は良かれと思って広げがちです。「今はそれを足さないで。まず動くものを見せて」とはっきり伝えます。

完成する前に飽きてしまった

機能を足しすぎています。part 4 に戻り、今ある機能だけで一度「完成」と決めます。

作ったのに、1回しか使っていない

「週に3回以上」を満たしていなかったのかもしれません。気にせず、次はその条件で選び直します。1個目はそのための練習でもあります。

NEXT

次の一歩

今日困ったことを AI と書き出し、1つだけ道具にしてみてください。 完成させることより、「困りごとから道具が生まれる」感覚を1回体験することが目的です。 何かを壊しても、作る前に記録しておけば戻せます。

LAB 010

AIの「できました」を信じない

道具を1つ作ると、次に困るのは「本当に直っているか」です。合否を人ではなく、機械に決めさせる話です。

※ 作る道具の内容によって、かかる時間は変わります。この記事は実際に試している進め方をもとにしていますが、結果を保証するものではありません。