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

「記事を読みたかっただけなのに…」|生成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教材が
    実際の研修でどこまで
    役に立つかは
    これから試してみないと
    分かりません

    でも少なくとも
    僕自身にとっては
    面白い体験になりました
    何かを作ることだけが
    開発の楽しさではない

    できあがったものを
    眺めたり読み解いたり
    別の使い道を見つけたり
    するのもなかなか
    楽しいものです
    そしてそんな寄り道の途中で
    また何かが生えるかも
    しれません

    まあそのときはそのときで
    面白そうなら
    ちょっと覗いてみましょう😊

    …それにしても。

    記事を読みたかった
    だけなのに
    新人研修の教材に
    なりそうなものまで生えた

    どーしてこーなった(^^;;

    なんか生えた😀🌱

    画像
     
     
    読書だったり調べ物だったり どうやら文章と向き合うのが好きみたいです どうぞよろしくお願いします

    あなたへのおすすめ