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

非エンジニアがClaude Codeで業務効率化ツールを作ってみた。使い方でつまずいた話

    noteの記事を書く準備を、1画面で終わらせるツールを作りました。

    画像

    わたしはnoteで「AIで作ってみた」という記事を書いています。1本書くたびに、決めることがたくさんあります。タイトルにどの言葉を入れるか。どのタグを付けるか。今回はどこでつまずいたか。

    そのたびに自分用のメモを開いて、過去に決めたルールを思い出して、AIに「わたしはこういう発信をしていて、読者はこういう人で、こういうタイトルは避けていて」と最初から説明し直していました。記事を書くたび、毎回です。

    作ったのは、その説明をしなくて済むようにする道具です。画面は6つあります。

    画像

    上から埋めていって、いちばん下のボタンを押すだけです。出てきた文章をAIに貼ると、記事の下書きが返ってきます。この記事も、そうやって書いています。

    使ったのはClaude Codeという、パソコンの中でAIに作業をお願いできる道具です。かかった時間は4時間20分でした。

    いまのところ自分用に使っています。できあがった画面は記事の最後のほうに載せているので、よかったら最後まで見ていってくださいね。

    でも、この記事で伝えたいのはそこではありません。

    4時間のあいだ、エラーで止まったことが一度もなかったんです。 それなのに、わたしは3回つまずきました。それは、何故か?
    実は… 全部「使い方」に問題があったんです。

    画像

    動くところまでは、あっという間だった

    設計をまとめた文書だけが入ったフォルダ。ここから始まりました。

    画像

    わたしはコードが書けません。やったことは「こういうものを作ってください」と日本語で伝えただけでした。

    先に、作りたいものの仕様をまとめた文書を1つ用意して、フォルダに置いておきました。それを読ませてから、1画面ずつ作ってもらいます。

    最初の画面は20分でできました。次の画面は15分。エラーは出ません。「できました」と報告が返ってきて、確認してくださいと言われる。その繰り返しです。

    日本語で書いた指示を貼ると、勝手にファイルを読み始めます。

    画像

    正直、拍子抜けしました。AIに作らせたら、動かないものが出てきて、そこから直す作業が始まるんだろうと思っていたので。

    つまずいたのは、そのあとでした。

    開いてみたら、何をすればいいのか分からなかった

    できあがった画面をブラウザで開きました。表が出ています。入力欄も判定欄もある。設計したとおりです。

    それなのに、何をすればいいのか分かりませんでした。

    画像

    表と入力欄はある。でも何を入れるのか、どこにも書いていません。

    表があるだけなんです。この欄に何を入れるのか、その数字をどこから持ってくるのか、画面のどこにも書いていない。作った本人が、自分のツールの前で止まりました。

    原因ははっきりしています。わたしが渡した仕様書に「画面に使い方を書く」と書いていなかったからです。AIは書かれていないことはしません。判定のルールはあれだけ細かく指定したのに、いちばん最初に読者の目に入る部分を、まるごと忘れていました。

    そこで、画面のいちばん上に手順を4行だけ足してもらいました。あわせて「例を入れて試す」というボタンも付けました。押すと数字が入って、判定が出るところまで一気に見られるボタンです。

    画像

    同じ場所です。上に4行足しただけで、迷わなくなりました。

    これで、開いた瞬間に何をすればいいか分かるようになりました。

    押せないボタンの理由が、2回わからなかった

    同じことが、もう2回起きました。

    1回目は、ボタンが灰色になっていて押せない場面です。これはすぐ解決しました。ボタンのすぐ下に「先にこちらを埋めてください」と文字が出ていたからです。読んで、そのとおりにしたら押せるようになりました。

    2回目は、別の画面で同じようにボタンが灰色でした。押しても何も起きません。今度は理由が書いていませんでした。

    画像

    マウスを乗せると説明が出る作りにしていたんです。 でもわたしは、押しても反応しないボタンにマウスを乗せ続けたりしません。押して、何も起きなくて、そこで止まりました。

    原因は別の画面の選択を1つもしていなかったことでした。分かってしまえば10秒で終わる話です。でも分かるまでは、何も進みませんでした。

    情けないのは、同じ設計を、同じ日に2回間違えたことです。1回目は理由が書いてあったから助かった。2回目は書き忘れた。まったく同じ性質の抜けを、数時間の間に繰り返していました。

    修正をお願いしたあと、Claude Codeから報告が返ってきました。押せなくなる箇所をコード全体から探して、4か所あったこと、そのうち1か所がまだ理由を表示していないことを、こちらが聞く前に見つけて教えてくれました。

    画像

    わたしが「同じ問題がほかにもあるかも」と気づく前に、向こうが数えてくれていた形です。

    質問を10個ならべて、自分で答えられなくなった

    もうひとつ、作り直した部分があります。

    このツールには、記事のもとになる体験を書き留める画面を作りました。どこで詰まったか、何分かかったか、何をやり直したか。ここが埋まっていない記事はうすくなる、というのが今までの実感だったので、いちばん力を入れたかった部分です。

    質問を10個ならべて、全部自由記入にしてみました。

    開いてみたら、空欄が10個ならんでいました。「うっ、となりました。」

    何を書けばいいか分からない、というのとは少し違います。なによりも、めんどくさいと思ってしまったんです。

    自分で「ここが大事だから」と言って作った画面なのに、自分が最初にめんどくさがっている。これは他の人ならもっと書かないだろうな、と思いました。もっと簡単にしよう、と。

    画像

    そして、選べるようにしてもらいました。「エラーが出た」「動いたけれど使い方が分からなかった」のように、あらかじめ選択肢を用意しておいて、選んだ内容に応じて短い記入欄がひとつ出る形です。

    ただし3つだけは、自由記入のまま残しました。何を作ったか、同じことをやる人に伝えたいこと、そして記事の締めになる一文です。ここを選択肢にしてしまうと、誰が書いても同じ文章になります。この記事でいえば、いちばん最後の一行がそれにあたります。あれは選択肢からは絶対に出てきません。

    画像

    選ぶだけで進むようにしました。自由記入は3つだけ残しています。
    作り直しに40分かかりました。今日いちばん時間を使った修正です。

    AIが自分で見つけた、たったひとつの不具合

    4時間のうち、コードの不具合が見つかったのは1回だけでした。しかも、わたしが見つけたのではありません。

    日付を入力する欄を作ってもらったときのことです。Claude Codeが自分でテストして、こう報告してきました。

    実装中に自分のコードのバグを1つ見つけて直しました。
    測定日の日数計算 daysSince() に、壊れた日付を通してしまう穴がありました。
    テストの出力がこれです。
    不正な日付 -> -2857
    2026-99-99 を渡すと null(読み取れない)を返すつもりが、-2857日 という数字を返していました。
    原因は JavaScript の new Date(2026, 98, 99) がエラーにならず、
    月と日を繰り上げて別の日付を作ってしまうことです。
    isNaN() で確かめても有効な日付なので素通りします。
    日付入力欄からは不正な値は来ませんが、localStorage の中身が壊れていたときに素通りするので、
    作った日付を元に戻して同じ年月日になるかを確かめる方式に直しました。
    
    修正後:
    2026-99-99: null
    2026-02-30: null
    2026-02-28: 164
    
    あわせて、測定日に未来の日付が入ったとき「測定から-3日」と表示されてしまう問題も直し、
    「測定日が未来の日付になっています」と出るようにしました。

    ここに出てくる言葉の意味は、正直よく分かりません。ただ、壊れているのに壊れていないふりをして通ってしまう、ということらしいです。

    わたしはこの報告を読むまで、こんな挙動があることを知りませんでした。テストしてほしいと頼んでもいません。向こうが勝手に試して、勝手に見つけて、直してから報告してきました。

    これが、今日唯一の本物の不具合です。

    これは道具の話ではなく、仕事術の話かもしれない

    画像

    ふりかえってみると、今日つまずいたところに共通点がありました。

    どれも「動くかどうか」の問題ではなく、「使う人に伝わっているか」の問題でした。判定の中身は正しい。計算も合っている。それでも、開いた人が何をすればいいか分からなければ、そのツールは使われません。

    これは業務効率化のツールを作るときだけの話ではない気がします。手順書を書くときも、引き継ぎ資料を作るときも、同じことが起きているはずです。中身は正しいのに、受け取った人が最初の一歩でつまずく。

    AI活用の話としてまとめるなら、たぶんこうです。AIは書かれていることは正確にやってくれるけれど、書き忘れたことは絶対にやってくれません。 そして、何を書き忘れているかは、自分では気づきにくい。

    今日わかったのは、動くものができても、使えるとは限らないということでした。作り終わったら、何も知らない人のつもりで開いてみて、最初の10秒で何をすればいいか分かるかどうかを、自分で確かめたほうがいいです。わたしは3回それを怠りました。

    できあがったのは、こういう画面です

    画像
    画像
    画像
    画像
    画像
    画像

    上から順に埋めていく形にしました。記事に入れる言葉を判定して、タイトル案を見て、タグを選んで、今回の体験を書き留めて、画像の指示文を作る。いちばん下でボタンを1回押すと、AIに渡す文章が1個できあがります。

    いちばん変わったのは、説明しなくてよくなったことでした。

    これまでは、記事を書くたびにAIへ「読者はこういう人で、こういう書き方は避けていて」と最初から伝えていました。毎回です。忘れていた条件を思い出しては、あとから付け足していました。

    いまは、画面を埋めるとその条件が全部入った状態で文章ができます。書き忘れることがなくなりました。 これが4時間かけていちばん良かったところです。

    もうひとつ、判定を画面がやってくれるようになりました。避けたほうがいい書き方が混ざっていると、入力した瞬間に赤くなります。自分では気づけないので、機械に見張ってもらう形です。

    入力した内容はブラウザの中だけに残ります。閉じても消えないので、続きから書けます。書きかけの記事のネタを、どこかに送っているわけではありません。

    正直に書くと、まだ完成とは言えません。この記事を書きながらも「ここが足りない」と気づいて、何度か直しています。ただ、それはこの道具に限った話ではない気もします。

    おわりに

    かかった時間は4時間20分。画面は6つ。エラーで作業が止まった回数はゼロ。やり直しをお願いしたのは2、3回でした。

    できあがったツールは、いまも自分で使っています。入力していくと、最後にAIへ渡す文章が1個できあがります。この記事も、そこから出てきた文章をもとに書いています。とても便利で快適です。

    今回思ったことは、

    コードは一度も間違えなかった。間違えていたのはわたしの設計書だった。

    フルア
    画像

    ▼「LINEスタンプ作ってみた」の記事もおすすめです。

    ▼「業務効率化やってみた」の記事もおすすめです。

    ▼「動画制作」の記事もおすすめです。

    ▼「ゲーム制作」の記事もおすすめです。

    ▼「LINEスタンプ」も販売してます!


    この記事が参加している募集

    あなたへのおすすめ