Kiroを活用してみた

JAWS-UG 彩の国埼玉支部 AWS製 AIエージェントIDE Kiroの活用事例をキャッチアップしよう
にて使用した登壇資料です。
https://jawsug-sainokuni-saitama.connpass.com/event/364133/

Transcript

1. Kiroを活用してみた しろみ
2. 初めに • 皆さんはこんな経験はありますか？ ◦ 登壇するときに何を話そうか悩んだ ◦ 実際に資料を作ったら話したい内容とそれてしまった
3. 私の場合 • 何度か経験したことがあります • 今回の登壇ではこんな感じで悩んでいました ◦ Kiroの活用例って、何を話したらいいんだ ◦ というかSpec駆動を含めて何がいいのか良くわかっていない ◦ 資料を作ろうと思うものの、伝えたいことって結局なんだっけ
4. その結果どうすることにしたか • 日本には古来より、餅は餅屋という諺があります ◦ Kiroの事を一番知っているのは、 Kiro自身なのではと感じる • 登壇内容をKiroと一緒に作成してみることに • その中で感じたことを今日はお話していきます
5. 自己紹介 名前: しろみ ロール: インフラエンジニア、ペンギン 出身 : 群馬県。翔んで埼玉にも出てきます。「翔んで埼玉 群馬」で検索 最近感じること: 生成AIのアップデートが早い、時間が経つのはもっと早い
6. Spec駆動について • 皆さんKiroが出たときにどんなことを感じましたでしょうか。 • Spec駆動について下記の事を思っていました ◦ 良くわかないけど、なんだか凄そう！ ◦ 実際にドキュメントやブログを読んだけど、何が凄いかよくわからない
7. 何故わからないのか • Spec駆動の良さをわからない理由を深堀することに ◦ Spec駆動で開発をすると下記の工程を順番に実行し、ドキュメントを作成する ▪ 要件定義 ▪ 設計 ▪ 開発に向けてのタスク作成 ◦ そもそも要件定義・設計、ドキュメントについて下記の事が分かっていないからでは？ ▪ 各工程で何をするのか ▪ ドキュメントってなんで必要なのか
8. 要件定義とは • 何のために、どんなシステムを作るかを明確にするための工程 • 例えばオンラインショッピングサイトだと ◦ 目的: お店に直接行かなくても商品を購入できる ◦ お店はそのお陰で売り上げの拡大ができる ◦ ユーザーは商品を検索、購入ができるなど • その工程で作成される成果物 ◦ システムに関連する要件をまとめたドキュメント (要件定義書) • なぜその工程が必要なのか ◦ 「作るもの」を関係者全員で合意するため
9. 設計とは • 何をやるのか: 要件定義で決まった内容(要件)を実現するための構造・方法を決める • 成果物: ◦ システムに対しての設計書 ◦ どんな画面があるかをまとめた図 (アーキテクチャ図) ◦ APIの各メソッドと処理をまとめたドキュメント (API仕様書) • なぜ必要なのか:実装の指針を示し、品質を保つため
10. ドキュメント編に入る前に • 皆さんは次のような経験はありますか ◦ 環境調査をしていて、ドキュメントがない ◦ 特定の人のみ知っている内容があるため、都度その人に確認 ◦ 関わっていた人は既に退職済み、そのため情報が手に入らない ◦ ドキュメントはある (らしい) けどどこにあるかわからない
11. ドキュメントの価値 • ドキュメントの価値 ◦ 思考の整理 - ドキュメントを書く・読むことで頭の中のモヤモヤを言語化 ◦ チーム間の共有 - ドキュメントを通じて認識の統一、知識をほかのメンバーへ移転 ◦ 後から見返せる - 過去にどういった意思決定がされたかの経緯を記録 ◦ 品質の向上 - 定期的な振り返り・レビューによる改善
12. ドキュメントがないと困ること • 認識のズレが発覚 - 完成間近で大幅な仕様変更 • 手戻りの連続 - 実装後に要件変更 • 属人化の問題 - 「特定の人しか知らない」仕様 • 時間の浪費 - 同じ議論の繰り返し
13. Kiroを活用してみて感じたこと • 個人開発や実務上での活用をしていないため活用方法に悩む • 今回は下記の活用法でKiroを触ってみることに ◦ KiroにLT会用の資料を作成してほしいとお願いする ◦ Kiroが作成してくれた内容を基に資料を作成・修正
14. Kiroの良いところ 要件定義・設計を考えてくれるところ 今回のLT会資料を作成する際下記のプロンプトを実行しました
15. その結果できた成果物 要件定義書 requwirements.md
16. その結果できた成果物 設計書 (design.md)
17. その結果できた成果物 実装タスク (tasks.md)
18. Kiroの良いところ • 要件定義・設計を固めてくれる • そのため、下記の改善が出来ました ◦ 実際に話す内容が話したい内容と逸れる ◦ その結果、実際に話したかった事と話している内容にズレが生じる 事前に具体的に登壇で話す内容を固めてくれるため それに沿って資料を作成することで話す内容に乖離が生じない 何を話すかをドキュメント化してくれるため、忘れたときでも見返すことが出来る
19. Kiroではないけれども良いところ • 今回の資料作成に伴い、下記の事を実施しました。 ◦ Kiroに資料作成のプロンプトを渡す ◦ そのプロンプトを基に要件定義・設計等を作成してもらう
20. Kiroではないけれども良いところ • より参加者に喜んでもらうものを作成するために下記のプロンプトをしました ◦ JAWS-UG 彩の国支部の話 ◦ JAWS-UG 彩の国支部の今回の LTの趣旨 ◦ 自分は要件定義・設計を分かっていないから Spec駆動が分かっていない
21. Kiroではないけれども良いところ • その結果、Kiroを含めた生成AIを触って下記の事を感じました ◦ プロンプトを作成する中で背景や満たしたいことを詳細に書く ◦ 良いものを作ってもらうためには下記の事が重要とのこと ▪ 抽象的ではなく具体的な指示 (プロンプト)をする ▪ そのプロジェクトの背景や注意点 (コーディング規約など )を伝える ◦ その過程を経ることで成果物へのイメージを整理できる ◦ 生成AIに限らず、顧客やチーム内の上司・同僚へ伝えるときの伝え方の勉強になる
22. 生成AIと人間の協力 • 下記の事を感じました • 要件定義や設計を具体的に考えるのはKiroのほうが得意 • ただ人間が得意なこともあると感じました ◦ 今回だと、どういったコミュニティなのか、どんな参加者がいるか • 登山や旅行のように、ガイドさん(Kiroちゃん)と旅行者(人間)が • 伴走するような関わり方で共にプロジェクトという山・土地を • 渡るようなイメージで関わっていくのがよいのかなと感じました
23. 最後に • Kiroについてまったくわかっていない状態での登壇申し込みでした • 触っていく中で下記の事を感じました ◦ 初めて出た技術でも触っていく中で学びが深まっていく ◦ 新しい技術が出てきても、大切になるのは基本的な知識 ◦ 生成AIを活用する中でお互いが得意なものの整理が出来た • Steeringやhooks機能を活用できていないため、活用してどうなるかも今後やっていきた いです。
24. ご清聴ありがとうございました ※こちらのイラストとスライドの背景は GPT-4oに描いていただきました