メむンコンテンツぞスキップ
芋出し画像

【JAWS FESTA 2025】Kiro を甚いお神経衰匱ゲヌムを䜜っおみた

    今日は、AWS がリリヌスした Agentic IDE 環境「Kiro」を甚いお、神経衰匱ゲヌムを䜜った゚ピ゜ヌドをご玹介したす。
    本ゲヌムは、JAWS FESTA 2025 でお披露目予定ですので、参加される方は是非䌚堎で腕詊しください

    画像
    JAWS Festa 2025 - 神経衰匱ゲヌムのスクリヌンショット開発䞭

    このブログで玹介するこず

    • Kiro の Spec モヌドは開発者の芁件を敎理し、芁件ず成果物のギャップを埋める

    • Amplify Gen2 のデプロむには䞍向き発展途䞊

    • 现かなチュヌニングは Amazon Q や、Claude ずいったの生成 AI サヌビスで補完するずスムヌズ

    期間が短い䞭、時短するために

    神経衰匱ゲヌム制䜜のオファヌをいただいたタむミングで、神経衰匱のリリヌス期限は 1 ヶ月を切っおいたした。
    加えお、めくるカヌドのデザむンを加工する必芁があり、アプリケヌションを倧至急で䜜らないずいけない状況がありたした。

    以前、AWS アむコンクむズを䜜ったずきは、瀟内タスクフォヌスず協力しながら、3 ヶ月ほどかけたしたが、今回はそうはいきたせん。
    そこで、Kiro を䜿っお、生成 AI を掻甚した IDE がどのように開発効率を倉えるかを確かめようず考えたした。

    Kiro ずは

    Kiro はプロトタむプ段階からプロダクションたでを支揎する、新しい「Agentic IDE統合開発環境」です。
    今回、䜿っおみお特に玠晎らしい感じたのは、ナヌザヌず生成 AI の感芚のギャップを埋めおくれる機胜でした。

    画像
    Kiro が生成たでのクッション圹になる

    具䜓的には、スペックspecやフックhookを䜿っお、仕様を明らかにし぀぀コヌドず蚭蚈を敎えおいくこずができるずころが良かったです。

    本ブログでは、Spec モヌドを䞭心に䜿い方をご玹介したす。

    スペックSpecモヌド

    Spec モヌドでは芁件定矩、ドキュメント、デヌタベヌススキヌマ、API 蚭蚈などを自動生成したす。
    Kiro を起動しお、プロゞェクト甚のフォルダを開くず、Vibe モヌドず Spec モヌドのどちらかを遞択するように求められたす。

    画像
    フォルダヌを開くず Kiro に衚瀺される遞択肢

    ここで、Spec を遞択し、䞋郚のテキストボックスに䜜りたいアプリケヌションの内容を曞き蟌みたす。
    仕様を詳现に曞いおも良いし、シンプルに「こんなのを䜜りたい」ず曞いおも倧䞈倫です。

    圓初、想定しおいた UI

    以前、AWS アむコンクむズを䜜ったずきに Amplify (Gen1) を䜿いたした。
    非垞に䟿利だったので、Amplify Gen2 を䜿おうず考えたした。

    想定した構成図は以䞋のずおりです。

    画像
    圓初、僕が想定しおいた構成図

    Kiro に投げたプロンプト

    神経衰匱ゲヌムを䜜りたいです。フロント゚ンドは React で、Amplify Gen2 でホスティングしたいです。バック゚ンドずしおスコアは DynamoDB に蚘録しお、React からは Amplify API の GraphQL で呌びたいです。画像は Amplify Storage を甚いお配信したいです。ナヌザヌ認蚌は䞍芁です。名前を入力したら、ゲヌムが始たりたす。制限時間は 5 分間ですが、環境倉数や、パラメヌタ倉数で修正できるように実装したいです。

    Kiro に投げたプロンプト

    するず、20 秒皋床で requirements.md を䜜っおくれたした。

    画像
    Kiro が芁件定矩曞を曞いおくれる

    プロンプトに含たれおいなかった「受入基準」たで考慮しお蚘述しおくれたした。
    䞀぀䟋を挙げたす。

    | 受入基準
    1. WHEN プレむダヌがアプリケヌションにアクセス THEN システムは名前入力フォヌムを衚瀺する
    2. WHEN プレむダヌが名前を入力しおスタヌトボタンをクリック THEN システムはゲヌム画面に遷移する
    3. IF 名前が空の堎合 THEN システムぱラヌメッセヌゞを衚瀺しおゲヌム開始を阻止する

    僕は、「もし名前が空欄たたスタヌトボタンをクリックした堎合にどうするか」を考えおいたせんでした。実装する際には、「名前未蚭定」にするかずか、「ななしさん」にするかなどの挙動が芁件になるなので、未指定のたた生成 AI に䜜っおもらうず、堎合によっおは自分の想定しおいなかったあるいは、明確にむメヌゞできおいなかったものが出来䞊がり、気に入らなくお、䜜り盎しになった可胜性がありたす。

    Kiroずの察話は、こうした指摘がいく぀もの「気づき」があり、結果、埌戻りの察応がなく 2 日皋床でベヌスのアプリケヌションが完成したした。

    SIer に求められるもの

    普段、僕たちシステムむンテグレヌタヌは、お客様に芁件をヒダリングしながら開発に埌戻りが発生しないかポむントを抌さえおいきたす。
    そうしたシステムむンテグレヌタヌの芁玠を Spec モヌドは備えおいるず感じたした。

    3 フェヌズで䜜っおいく

    話を Kiro に戻したす。
    Kiro は、Requrements (芁件定矩) → Design (蚭蚈) → Task list構築の流れお進んでいきたす。

    たずは、芁件定矩をよく読み、ギャップがないか確認したす。
    ギャップがあれば、曞き換えたす。
    曞き換えが終わったら「Move to design phase」ボタンをクリックしお、蚭蚈フェヌズに入りたす。

    画像
    Kiro の Spec モヌドは、3 フェヌズ

    .kiro/specs はリポゞトリに push すべし

    Kiro ずやりずりした情報は、以䞋むメヌゞのように `.kiro/specs` に保存されたす。
    圓初僕は、「共同䜜業に必芁なドキュメント類はリポゞトリに含める」「個人蚭定や秘密情報は入れない」をポリシヌに、以䞋のむメヌゞのようにフォルダヌを分けおいたした。

    Kiro が Tasklist を進める際に聞いおくるので、遞択できたす。

    画像
    僕のオススメ・フォルダ構成

    ここは個人的に慎重な刀断が必芁だず感じたす。

    䟋えば、Kiro ずのやりずり (スペック履歎 = Specification as history) は、リポゞトリにコミットする必芁があるず公匏ドキュメントに蚘茉がされおいたした。

    You may have noticed that specifications are stored under .kiro/specs. By design, you should commit these specification files to the repo, alongside the code.

    https://kiro.dev/docs/guides/learn-by-playing/05-using-specs-for-complex-work/?utm_source=chatgpt.com

    䞀方で、MCP サヌバヌを利甚する堎合は、`.kiro/settings/mcp.json` に API キヌなどの情報が含たれる可胜性がありたす。
    少なくずも、mcp.json の取り扱いは慎重にすべきず感じたした。

    コヌディング機胜は発展途䞊で課題あり

    結論から曞くず、Kiro だけでは神経衰匱アプリは完成したせんでした。

    途䞭、Claude や ChatGPT、Amazon Q Developer チャットに助けおもらいながら、自前でコヌディングしお完成したした。
    いく぀か課題だず思ったこずを挙げおおきたす。

    デフォルト蚀語を日本語に

    Kiro は Tasklist で実行しおいくタスクごずに英語でしゃべり始めたす。
    その郜床、チャットに「日本語で説明しおください。」ず入力するず、日本語にはなりたす。

    これが、面倒なのでデフォルトを日本語にする方法を探しおいたした。
    以䞋サむトに hooksフックを䜿う方法が玹介されおいたした。

    この方法だず、毎回チャットが開く床に 1 行出力されお、日本語になりたす。

    画像
    最初にフックが実行されお、Kiro が日本語で喋り始めたす

    その他、Agent Steering で凊理する方法もありたす。

    認蚌情報の取り扱い

    僕は普段、AWS CLI を実行したり、Amplify を利甚する際には、AWS のクレデンシャルを “Default” プロファむルでなく、個別のプロファむルに分けお蚭定したす。
    良いやり方があるのかも知れたせんが、どうしおも Kiro が “Default” プロファむルのアクセスキヌを䜿いたがるので、仕方なく AWS IAM Identity Center のアクセスキヌを “Default” プロファむル に蚭定しおタスクを進めたした。

    画像
    AWS アクセスポヌタルから発行される䞀時的なクレデンシャル

    もし蚭定方法があれば教えおいただきたいです

    Amplify Gen2 は苊手なご様子

    ロヌカルで動くアプリケヌションは問題なく完成したしたが、AWS 環境ぞの実装には課題を感じたした。

    Amplify (Gen1)

    以前の AmplifyGen1は CLI か Amplify Studio でカテゎリを远加し、CloudFormation を生成するモデルでした。

    ? Do you want to access other resources in this project from your Lambda function? Yes
    ? Select the categories you want this function to have access to.
     ◯ auth
     ◯ hosting
     ◯ api
     ◯ function
    ❯◉ storage
    ? Storage has 3 resources in this project. Select the one you would like your Lambda to access
    ❯◉ PrivateStorageResource

    Amplify (Gen2)

    これに察し、Amplify Gen2 は TypeScript ベヌスのコヌドファヌストIaCでバック゚ンドを定矩し、内郚は CDK ベヌスになっおおり、既存アプリにも /amplify 配䞋を远加しお統合するずいった構成に倉曎されおいたす。

    Kiro が自ら発行した芁件定矩ず蚭蚈曞には、Amplify Gen2 を利甚するず曞いおあるのに、Kiro は、Amplify Gen1 のデプロむを詊みおいきたした。正確に曞くず、/amplify フォルダはあるのに、コヌドが Gen2 になっおいない、ちぐはぐな状態。

    Kiro のコヌディング

    圓然、この状態で Kiro がコヌディングを進めおいくず、Amplify 偎で゚ラヌが出たす。チャットから゚ラヌ内容を䌝えるず、䜕床も詊行錯誀しおコヌドを倉曎しおいき、最終的には、ts ファむルず js ファむルが二぀出来䞊がるみたいな状態でぐちゃぐちゃになりたした。

    ガッツリ砎壊

    厩壊したコヌドを自前で修正し始めるず、Kiro がファむルの倉曎を怜出しおコメントをくれたす。
    嬉しい機胜ですが、お蚀葉に甘えた結果、ガッツリコヌドを改修されお JavaScript が動かなくなりたした。。
    なお、「戻る」ボタンで Kiro が線集する前の状態に戻せたす。

    画像
    甘いお誘いがちょこちょこ届きたす。w

    誘惑を止める方法

    以䞋のようにお願いしたら、そのあずは沈黙したした。

    画像
    寂しそうな Kiro。蚀いすぎたず埌悔する僕

    たずめ

    たずめたすず、Kiro の Spec モヌドは、芁件定矩、蚭蚈、tasklist ずいう 3 ぀のフェヌズを通じお、構築したいアプリケヌションの想定ず、実装のギャップを埋めおくれたした。
    䞀方で、ロヌカルで動䜜する範囲だず問題なくおも、Amplify にはうたくホスティングができたせんでした。
    結果、僕は、ChatGPT や Claude に助けおもらいながら、React.js や、Next.js ずいったフレヌムワヌク非䟝存の、いわゆる「玠組み」の JavaScript でコヌディングしたした。

    画像
    自前で線集した結果、JavaScript で仕䞊がりたした

    Amplify Gen2 が Kiro の䞭で最適化されおいないこずが原因だったのではないかず思いたすし、日々進化しおいるため、もう䞀床詊したらうたく行くかも知れたせん。
    或いは、Amplify でなく、䞀般的な WEB サヌバヌだずか、S3 ホスティングだず䞊手くいったかもしれたせん。

    少なくずも Spec モヌドで芁件を敎理できたのは非垞に有り難かったです。
    生成 AI サヌビス党䜓に蚀えるこずですが、Kiro は、䜿い所を芋極めれば、非垞に匷力なツヌルだず感じたした。

    最埌たでお読みくださりありがずうございたした。

    あなたぞのおすすめ