콘텐츠로 이동

Learn by playing

이 가이드에서는 Spirit of Kiro라는 샘플 비디오 게임의 코드베이스에서 작업을 완료하여 Kiro 사용 방법을 배웁니다.

Spirit of Kiro의 코드 95%는 Kiro에 프롬프트를 제공하여 작성되었습니다. 여러분은 Kiro를 사용하여 게임의 버그를 수정하고 기능을 추가하여 완성할 것입니다.

A cartoon ghost stands in front of a large industrial lever labeled "PULL"
and a workbench with tools. The ghost is next to a glowing card and a prompt
showing the "E" key.

Spirit of Kiro는 다음을 수행할 수 있는 무한 크래프팅 게임입니다:

  1. 독특하고 무작위로 생성된 객체 발견
  2. "cut", "paint", "glue", "enchant"와 같은 시뮬레이션된 상호작용을 통해 서로에게 이러한 아이템 활용. 아이템은 이러한 상호작용에 대한 응답으로 결합되고, 분해되고, 변경됩니다.
  3. 결과물을 AI 감정사에게 판매

게임의 모든 객체는 AI에 의해 생성됩니다. 객체 간의 상호작용도 AI에 의해 시뮬레이션됩니다. 이것은 Spirit of Kiro에 무한한 재생 가능성과 잠재력을 제공합니다.

다음 다이어그램에서 게임의 핵심 크래프팅 메커니즘이 어떻게 작동하는지 볼 수 있습니다. 플레이어는 두 가지 아이템을 발견했습니다: 스푼과 야채가 담긴 유리병. 플레이어는 스푼을 사용하여 야채 샘플을 추출할 수 있습니다.

A crafting workbench interface from a game, showing a grid of unique items
and pop-up descriptions for items like a botanical extraction spoon, and jar of vegetables,
Purple arrows connect the workbench to detailed item info
panels, with the text 'Discover Unique Items' and 'Add items to workbench',
and "Freeform crafting outcomes" above.

게임의 핵심 루프는 완성되었지만 게임은 아직 완전히 완료되지 않았습니다. 게임에 대한 광범위한 로드맵이 있으며, 구축할 추가 아이디어로 가득 차 있고, Kiro를 사용하여 해결할 수 있도록 의도적으로 남겨진 몇 가지 버그가 있습니다.

이 가이드에서는 이 게임의 오픈 소스 코드의 challenge 브랜치에서 일련의 작업을 완료하여 Kiro를 사용하는 방법을 배웁니다. 시작할 준비가 되셨나요? 시작해봅시다!

1

설정

먼저 AWS 계정이 있는지 확인합니다. 인증을 위한 Cognito 사용자 풀을 설정하고, Docker Compose 파일을 사용하여 게임 스택을 빌드 및 시작한 다음, DynamoDB 테이블을 부트스트랩합니다. 그런 다음 로컬 머신에서 게임이 실행되는지 확인합니다:

2

작업: 게임 홈페이지 개선

Kiro가 프로젝트를 이해하는 데 도움이 되도록 스티어링 파일을 설정합니다. 프로젝트를 완전히 이해한 상태에서 Kiro를 활용하여 게임의 홈 랜딩 페이지를 개선합니다.

3

버그 수정: 물리 결함

게임에서 탭을 전환하면 다시 탭을 전환할 때 물리가 이상해집니다. Kiro가 수정할 수 있을까요?

4

버그 수정: 상호작용 누락

게임 상호작용에 대한 원래 접근은 "vibe coding"이었습니다. 하지만 AI가 뭔가를 놓친 것 같습니다. Kiro가 자신의 실수를 수정할 수 있을까요?

5

리팩토링: Kiro로 코드 DRY화

vibe coding뿐만 아니라 여기서는 vibe 리팩토링도 수행합니다.

6

새 기능: 복잡한 기능 구현

게임에는 현재 이메일 인증 및 비밀번호 재설정이 누락되어 있습니다. 클라이언트와 서버 전체에 걸쳐 이 비교적 복잡한 새 기능을 구현합니다.

7

자동화: 에이전트 훅으로 자산 관리

오류가 발생하기 쉬운 일부 보일러플레이트 자산 관리 작업을 식별합니다. 다행히 Kiro 에이전트 훅이 이를 자동화하는 데 도움이 될 수 있습니다.

8

MCP로 Kiro 확장

이 게임을 자신만의 것으로 만들 수 있을 뿐만 아니라 Model Context Protocol(MCP)로 컨텍스트와 동작을 확장하여 Kiro도 자신만의 것으로 만들 수 있습니다.

9

결론

학습 여정을 마무리하고 다음 단계를 탐색합니다.