
「記事を読みたかっただけなのに…」|生成AIとの壁打ちでいろいろ生えた話
僕は
ソフトウェアエンジニア
をしています
普段のお仕事では
プログラムを書いたり
設計書を読んだり
いろいろなことをしています
そんな僕ですが
ここ数日生成AIと
壁打ちしていたら
ちょっと不思議なことが
起きました
コードを一行も
書いていないのに
Pythonのスクリプトが2本
シェルスクリプトが1本
合計3本のプログラムが
できあがりました
それだけではありません
その3本をまとめて動かす
仕組みができて
設計資料ができて
とうとう新人エンジニア向けのOJT教材まで
生えてしまいました
…どーしてこーなった(^^;;
今日はそんなお話です
🌱 最初は自分の記事を
読みたかっただけ
僕はnoteで
日々いろいろな記事を
書いています
日常のこと
生成AIのこと
散歩で見つけたこと
空想のお話…
気がつけば記事も
蓄積ができてきました
せっかくだから
これまでの記事を
生成AIの皆さんにも
読んでもらいたい
タイトルや
記事一覧だけではなく
本文をきちんと
読んでもらって
感想を聞いてみたい
最初の動機はそれだけでした
そこで記事の一覧を取得するJavaScriptを
生成AIに見てもらいました
動作を確認してもらい
必要なところを直してもらう
次に記事の本文も
取得できないか
相談してみました
さらに取得した記事を
月ごとにPDFに
まとめてもらう
ことにしました
ここで少しだけ
お願いを追加しました
「本文は要約しないでね」
「勝手に書き換えないでね」
「日本語が文字化け
しないようにしてね」
「取得できなかった記事は
分かるように残してね」
そんな感じです
結果として対象となった
記事のうち大半の記事が
取得され
7月から10月までの
月別PDFができあがりました
合計457ページ
…ずいぶん育ったなあ😀
🌿 できることとやることは別
途中でメンバーシップ
限定の記事が
取得できないことが
分かりました
技術的には
取得する方法も
考えられるそうです
でも今回は
そこまでしなくてもいいかな
そう判断しました
もともとの目的は
自分の記事をまとめて
読めるようにすることです
公開記事がきちんと
取得できて
取得できなかったものが
分かればそれで十分
無理に全部取得しようとする
必要はありません
僕は昔から何かを作るときに
「できること」
と
「やること」
を分けて考えるように
しています
できるからといって
全部実装する必要は
ありません
機能が増えれば
その分だけ考えることも
面倒を見ることも増えます
必要になったら
そのとき考えればいい
今回はここまで😊
🌱 そしてスクリプトが
3本生えた
月別PDFができたところで
ふと思いました
これ毎回同じお願いを
するのは面倒だなあ
せっかく手順が
できているのだから
まとめて動かせるように
したら楽かもしれない
そこで生成AIに相談しました
すると
記事を取得するPython
PDFを生成するPython。
できあがったファイルを
まとめるシェルスクリプト
3本のスクリプトと
それらを動かすための
手順書ができあがりました
しかもAIが一連の処理を
再現できる
「スキル」
という形にまとめてくれました
動作確認の途中では
PDFに画像が
うまく埋め込まれない
問題も発生したそうです
そこもAIが原因を調べ
修正してもう一度確認
してくれました
もちろん最終的な成果物が
意図したものになっているかは
人間が確認する必要があります
でもコードを書くところから
動作確認まで
かなりの部分をAIに
任せられるように
なっているんですね
ちなみに
僕は今回コードを
一行も書いていません
ソフトウェアエンジニアなのに🤣
🌳 せっかくだから
中を見てみよう
仕組みができあがると
今度は中身が
気になってきました
どんな構成に
なっているんだろう
どこで何を
処理しているんだろう
エラーが起きたら
どうなるんだろう。
僕は昔から
プログラム構造図や
フローチャートを
眺めるのが好きです
ソースコードを一行ずつ
追いかけるのも
よいのですが
全体の形が見えると
ずいぶん理解しやすくなります
そこで生成AIに
お願いしてみました
「プログラム構造図と
フローチャートを
作ってもらえるかな」
するとスクリプトの
構成や処理の流れを
整理した資料が
できあがりました
さらに自然言語で
書かれたスキルの手順書とシェルスクリプトの処理を比較できるようになりました
同じ目的を実現するものでも
書き方や抽象度が
違うんですよね
自然言語の手順書には
「取得できなかった記事を
勝手に補完しない」
と書けます
一方シェルスクリプトには
"set -euo pipefail"
のように処理が
失敗したときの振る舞いを
具体的に指定する
記述があります
どちらも大切ですが
役割が違います
こういう違いを
読み比べるのは
なかなか面白いものです
…あれ?
これ新人さんに
説明するときの教材にも
使えるんじゃないかな?
🌲 とうとうOJT教材まで生えた
そんなことを考えて
また生成AIと壁打ち
してみました
すると今度は
新人エンジニア向けの
OJT教材ができあがりました
プログラム構造図
フローチャート
詳細設計
さらに段階的な
演習課題まで
最初は図を見ながら
処理の流れを説明してみる
次に実際のコードと
図を読み比べてみる
最後はプログラムを
少しだけ変更して
どこに影響が出るか
考えてみる
なるほど
これなら単に
コードの書き方を
覚えるだけではなく
プログラム全体を
理解する練習にも
なりそうです
その後60〜90分の
ワークショップ案や
理解度チェッククイズ10問
プレゼンテーションの
構成案までできあがりました
最終的にはそれらをまとめた
15ページのPDFに
…ちょっと待って🤣
僕は自分の記事を
生成AIの皆さんと
読みたかった
だけなんだけど(^-^;
🍀 AIが書いたコードをどう読むか
今回の出来事で
ひとつ面白いと
思ったことがあります
生成AIがプログラムを
書いてくれるようになっても
そのプログラムを
理解する必要が
なくなるわけでは
ないんですよね
何をするプログラムなのか
どんな入力を受け取るのか
どこまでできれば成功なのか
失敗したときには
何を残すのか
変更したらどこに影響するのか
そうしたことを考えるのは
やっぱり大切です
むしろコードを書く作業を
AIに任せられるからこそ
こうした部分を落ち着いて
考えられるのかもしれません
もっともこれは僕の今回の
体験から感じたことであって
どんな開発でも
同じように進められるとは
限りません
生成されたコードを
そのまま信用してよいわけでも
ありません
だからこそ構造図や
フローチャートを使って
処理を理解する練習には
意味があると思います
新人さんと一緒に
「この1行を変更したら
どうなると思う?」
なんて話をするのも
楽しそうです
🌼 作らないつもりで作っている
僕は以前から何かを
便利にしたいと思ったとき
「新しく作らなくても
いいんじゃないかな」
と考えることがあります
すでにある道具で済むなら
それを使えばいい
新しいものを作れば
あとから面倒を見る
必要もあります
だから作らずに
済ませられるなら
それも立派な選択肢です
今回も最初から
プログラムを開発するつもりは
ありませんでした
自分の記事を
生成AIの皆さんと読みたい
まとめておきたい
同じ作業を繰り返すのは
面倒だから少し楽にしたい
ただそれだけです
でもその小さなお願いを
重ねていたら
いつの間にか
仕組みができあがっていました
さらにその仕組みを
眺めていたら
教材としての使い道まで
見えてきました
不思議ですね
作ろうとしていなかった
ものが必要に応じて
少しずつ形になってゆく
僕がよく言っている
「なんか生えた😀」
というのは
こういうこと
なのかもしれません
🌷 おわりに
生えたものを眺めてみる
振り返ってみると
今回の出来事は
ずいぶん遠くまで
来てしまったように見えます
記事の一覧が欲しかった
本文を読みたかった
PDFにまとめたかった
毎回同じ作業をするのが
面倒だった
できあがった仕組みの
中身が気になった
図にして眺めてみた
新人さんの教材にも
使えそうだと思った
ひとつひとつは
それほど大げさなことでは
ありません
そのとき気になったことを
生成AIと一緒に
考えてみただけです
そして今回もうひとつ
気づいたことがあります
できあがったものだけでなく
そこに至るまでのやり取りも
教材になるんですね
何をお願いしたのか
どこで困ったのか
何を採用して
何を見送ったのか
どうやって確認したのか
そうした過程を
振り返ることで
プログラムそのものとは
別の学びが見つかります
完成品だけでは
分からないことも
途中の寄り道を眺めると
見えてくる
これはちょっと
楽しい発見でした
さて…
今回生えたOJT教材が
実際の研修でどこまで
役に立つかは
これから試してみないと
分かりません
でも少なくとも
僕自身にとっては
面白い体験になりました
何かを作ることだけが
開発の楽しさではない
できあがったものを
眺めたり読み解いたり
別の使い道を見つけたり
するのもなかなか
楽しいものです
そしてそんな寄り道の途中で
また何かが生えるかも
しれません
まあそのときはそのときで
面白そうなら
ちょっと覗いてみましょう😊
…それにしても。
記事を読みたかった
だけなのに
新人研修の教材に
なりそうなものまで生えた
どーしてこーなった(^^;;
なんか生えた😀🌱
