Amazon Q Developer CLIとは
Amazon Q Developer CLIは生成AIを活用した会話アシスタントでターミナルから自然言語を使ってコーディングや様々なタスクを実行できます。
6/30までTシャツがもらえるキャンペーンを実施中です。
無料利用枠でお金をかけずに試すことができます！
https://aws.amazon.com/jp/blogs/news/build-games-with-amazon-q-cli-and-score-a-t-shirt/
作成したゲーム
今回は以下のようなマッチ3ゲームを作成してみました。
ゲームを作ってもらう
ゲームのアイディア出しから Amazon Q Developer CLIにお願いし候補に含まれていたマッチ3ゲームを作成することにしました。
とりあえず、作ってみてとお願いするとコードが生成されました。
起動してみるとこんな感じになりました。
期待通りブロックを入れ替えて3つそろえると消えており問題なさそうです。
しかし、アニメーションやエフェクトがなくブロックの動きがわかりにくい点などが気になったので修正してもらうことにしました。
Amazon Q Developer CLIとの会話は、次のようなコードの修正と動作確認の繰り返しになりました。
私はコードについてはほとんど見ておらず、実際にゲームをプレイしておかしなところを指摘するだけで改善を進めることができました。
> 以下の修正をお願いします。
1. プログレスバーが残り時間の表示と重なっている
2. スコアのポップアップが表示されたままになる。（1秒程度で消えるようにしてほしい）
指摘された2つの問題を修正します。
## 1. プログレスバーと残り時間表示の重なり問題を修正
まず、現在のUI配置を確認しましょう：
🛠️ Using tool: fs_read (trusted)
⋮
● Reading file: /home/atsaki/q_example/src/amazon_q_match3/match3_game.py, from line 650 to 680
⋮
● Completed in 0.0s
プログレスバーのY座標が85で、時間表示が60の位置にあるため重なっています。プログレスバーの位置を調整しましょ
う：
🛠️ Using tool: fs_write (trusted)
⋮
● Path: src/amazon_q_match3/match3_game.py
662, 662: # Progress bar for time remaining (visual indicator)
663, 663: progress_width = 180
664, 664: progress_height = 8
665, 665: progress_x = WINDOW_WIDTH - 200
- 666 : progress_y = 85
+ 666: progress_y = 140 # 時間表示やベストスコアと重ならないように下に移動
Updating: src/amazon_q_match3/match3_game.py
⋮
● Completed in 0.1s
## 2. スコアポップアップの表示時間を1秒に修正
ScorePopupクラスの定義を確認しましょう：
🛠️ Using tool: fs_read (trusted)
⋮
● Searching: /home/atsaki/q_example/src/amazon_q_match3/match3_game.py for pattern: class scorepopupFound 1 matches for pattern 'class ScorePopup' in src/amazon_q_match3/match3_game.py
⋮
● Completed in 0.0s
🛠️ Using tool: fs_read (trusted)
⋮
● Reading file: /home/atsaki/q_example/src/amazon_q_match3/match3_game.py, from line 100 to 130
⋮
● Completed in 0.0s
ScorePopupクラスは既に1秒間（self.life = 1.0）で設定されています。問題は、スコアポップアップが正しく削除され
ていない可能性があります。
スコアポップアップの更新処理を確認しましょう：
🛠️ Using tool: fs_read (trusted)
⋮
● Reading file: /home/atsaki/q_example/src/amazon_q_match3/match3_game.py, from line 1370 to 1380
⋮
● Completed in 0.0s
スコアポップアップの更新処理は正しく見えます。問題は、dt（デルタタイム）が正しく渡されていない可能性がありま
す。
デバッグのために、スコアポップアップの更新にログを追加しましょう：
🛠️ Using tool: fs_write (trusted)
⋮
● Path: src/amazon_q_match3/match3_game.py
1377, 1377: def _update_score_popups(self, dt):
1378, 1378: """スコアポップアップの更新"""
1379, 1379: try:
+ 1380: old_count = len(self.score_popups)
1380, 1381: self.score_popups = [popup for popup in self.score_popups if popup.update(dt)]
+ 1382: new_count = len(self.score_popups)
+ 1383:
+ 1384: if old_count != new_count:
+ 1385: self.logger.debug(f"Score popups updated: {old_count} -> {new_count}")
1381, 1386: except Exception as e:
1382, 1387: self.logger.warning(f"Error updating score popups: {e}")
1383, 1388: self.score_popups = []
Updating: src/amazon_q_match3/match3_game.py
⋮
● Completed in 0.0s
さらに、ScorePopupクラスのupdateメソッドにもログを追加して、正しく動作しているか確認しましょう：
🛠️ Using tool: fs_write (trusted)
⋮
● Path: src/amazon_q_match3/match3_game.py
112, 112: def update(self, dt):
113, 113: """ポップアップの更新"""
114, 114: self.life -= dt
115, 115: # 上に移動
116, 116: self.y = self.start_y - (1.0 - self.life) * 50
+ 117:
+ 118: # デバッグ用：ライフが0.1秒以下になったらログ出力
+ 119: if self.life <= 0.1 and self.life > 0:
+ 120: print(f"ScorePopup expiring: life={self.life:.3f}, dt={dt:.3f}")
+ 121:
117, 122: return self.life > 0
Updating: src/amazon_q_match3/match3_game.py
⋮
● Completed in 0.0s
また、スコアポップアップの表示時間をより短くするために、ライフタイムを0.8秒に調整しましょう：
🛠️ Using tool: fs_write (trusted)
⋮
● Path: src/amazon_q_match3/match3_game.py
103, 103: def __init__(self, x, y, score, color=(255, 255, 0)):
104, 104: self.x = x
105, 105: self.y = y
106, 106: self.start_y = y
107, 107: self.score = score
108, 108: self.color = color
- 109 : self.life = 1.0 # 1秒間表示
+ 109: self.life = 0.8 # 0.8秒間表示（1秒より少し短く）
110, 110: self.font_size = 24
Updating: src/amazon_q_match3/match3_game.py
⋮
● Completed in 0.0s
さらに、フェードアウト効果を追加して、より自然に消えるようにしましょう：
🛠️ Using tool: fs_write (trusted)
⋮
● Path: src/amazon_q_match3/match3_game.py
124, 124: def draw(self, screen, font):
125, 125: """ポップアップの描画"""
126, 126: if self.life > 0:
+ 127: # フェードアウト効果（残りライフに応じて透明度を調整）
+ 128: alpha = min(255, int(255 * (self.life / 0.8))) # 0.8秒でフェードアウト
+ 129:
+ 130: # 色にアルファ値を適用
+ 131: fade_color = (*self.color[:3], alpha) if len(self.color) == 4 else (*self.color, alpha)
+ 132: shadow_color = (0, 0, 0, alpha // 2) # 影は半透明
+ 133:
127, 134: # スコアテキストを作成
- 128 : score_text = font.render(f"+{self.score}", True, self.color)
- 129 :
- 130 : # 影効果
- 131 : shadow_text = font.render(f"+{self.score}", True, (0, 0, 0))
- 132 : screen.blit(shadow_text, (self.x + 2, self.y + 2))
- 133 : screen.blit(score_text, (self.x, self.y))
+ 135: score_text = font.render(f"+{self.score}", True, fade_color[:3])
+ 136: shadow_text = font.render(f"+{self.score}", True, shadow_color[:3])
+ 137:
+ 138: # 透明度を適用するためのサーフェスを作成
+ 139: if alpha < 255:
+ 140: # 透明度付きサーフェスを作成
+ 141: text_surface = pygame.Surface(score_text.get_size(), pygame.SRCALPHA)
+ 142: shadow_surface = pygame.Surface(shadow_text.get_size(), pygame.SRCALPHA)
+ 143:
+ 144: text_surface.blit(score_text, (0, 0))
+ 145: shadow_surface.blit(shadow_text, (0, 0))
+ 146:
+ 147: text_surface.set_alpha(alpha)
+ 148: shadow_surface.set_alpha(alpha // 2)
+ 149:
+ 150: screen.blit(shadow_surface, (self.x + 2, self.y + 2))
+ 151: screen.blit(text_surface, (self.x, self.y))
+ 152: else:
+ 153: # 通常の描画
+ 154: screen.blit(shadow_text, (self.x + 2, self.y + 2))
+ 155: screen.blit(score_text, (self.x, self.y))
Updating: src/amazon_q_match3/match3_game.py
最終的には上で示したようにアニメーションやエフェクト、スコア表示を実装できました。
ゲームの開発経験がなくても、指示を出していくだけでゲームを作れるのは驚きです。
pytest, ruff, pre-commitを導入してもらう
話は前後しますが、ゲームの開発の途中でpytest、ruff、pre-commitを導入してみました。
導入をお願いすると、依存関係と必要な設定の追加やコードの修正などをほとんど自動で行ってくれました。
以下にruffを導入している様子を示します。pytestやpre-commitについてもほぼ同じような感じでした。
> formatter, linterとしてruffを導入してください
ruffをformatterとlinterとして導入します。ruffは高速なPython用のlinter・formatterです。
まず、ruffを依存関係に追加しましょう：
🛠️ Using tool: execute_bash
⋮
● I will run the following shell command:
cd /home/atsaki/q_example && uv add --dev ruff
⋮
↳ Purpose: ruffを開発依存関係として追加
Allow this action? Use 't' to trust (always allow) this tool for the session. [y/n/t]:
> y
Resolved 11 packages in 600ms
Prepared 1 package in 359ms
Installed 1 package in 32ms
+ ruff==0.11.13
⋮
● Completed in 1.13s
ruffの設定をpyproject.tomlに追加しましょう：
🛠️ Using tool: fs_read (trusted)
⋮
● Reading file: /home/atsaki/q_example/pyproject.toml, all lines
⋮
● Completed in 0.0s
ruffの設定を追加しましょう：
🛠️ Using tool: fs_write
⋮
● Path: pyproject.toml
1, 1: [project]
2, 2: name = "amazon-q-match3"
3, 3: version = "0.1.0"
4, 4: description = "Match3 puzzle game created with Amazon Q Developer"
5, 5: readme = "README.md"
6, 6: requires-python = ">=3.13"
7, 7: dependencies = [
8, 8: "pygame>=2.6.1",
9, 9: ]
10, 10:
11, 11: [dependency-groups]
12, 12: dev = [
13, 13: "pytest>=8.4.0",
14, 14: "pytest-cov>=6.2.1",
15, 15: "ruff>=0.11.13",
- 16 : ]
+ 16: ]
+ 17:
+ 18: [tool.ruff]
+ 19: # Ruff configuration
+ 20: line-length = 100
+ 21: target-version = "py313"
+ 22:
+ 23: # Enable specific rule sets
+ 24: select = [
+ 25: "E", # pycodestyle errors
+ 26: "W", # pycodestyle warnings
+ 27: "F", # Pyflakes
+ 28: "I", # isort
+ 29: "N", # pep8-naming
+ 30: "UP", # pyupgrade
+ 31: "B", # flake8-bugbear
+ 32: "C4", # flake8-comprehensions
+ 33: "PIE", # flake8-pie
+ 34: "SIM", # flake8-simplify
+ 35: "RET", # flake8-return
+ 36: ]
+ 37:
+ 38: # Ignore specific rules
+ 39: ignore = [
+ 40: "E501", # Line too long (handled by formatter)
+ 41: "B008", # Do not perform function calls in argument defaults
+ 42: "N806", # Variable in function should be lowercase (for pygame constants)
+ 43: "N803", # Argument name should be lowercase (for pygame events)
+ 44: ]
+ 45:
+ 46: # Exclude files/directories
+ 47: exclude = [
+ 48: ".git",
+ 49: ".venv",
+ 50: "__pycache__",
+ 51: "*.pyc",
+ 52: ]
+ 53:
+ 54: [tool.ruff.format]
+ 55: # Formatter configuration
+ 56: quote-style = "double"
+ 57: indent-style = "space"
+ 58: skip-magic-trailing-comma = false
+ 59: line-ending = "auto"
+ 60:
+ 61: [tool.ruff.lint.isort]
+ 62: # Import sorting configuration
+ 63: known-first-party = ["amazon_q_match3"]
+ 64: force-single-line = false
+ 65: combine-as-imports = true
+ 66:
+ 67: [tool.ruff.lint.per-file-ignores]
+ 68: # Per-file ignore rules
+ 69: "tests/*" = ["N802", "N803"] # Allow uppercase function names in tests
Allow this action? Use 't' to trust (always allow) this tool for the session. [y/n/t]:
> y
Updating: pyproject.toml
⋮
● Completed in 0.0s
ruffでコードをチェックしてみましょう：
🛠️ Using tool: execute_bash
⋮
● I will run the following shell command:
cd /home/atsaki/q_example && uv run ruff check .
⋮
↳ Purpose: ruffでlintチェックを実行
Allow this action? Use 't' to trust (always allow) this tool for the session. [y/n/t]:
> y
warning: The top-level linter settings are deprecated in favour of their counterparts in the `lint` section. Please update the following options in `pyproject.toml`:
- 'ignore' -> 'lint.ignore'
- 'select' -> 'lint.select'
logging_config.py:5:1: I001 [*] Import block is un-sorted or un-formatted
|
3 | """
4 |
5 | / import logging
6 | | import sys
7 | | from pathlib import Path
| |________________________^ I001
8 |
9 | def setup_logging(level=logging.INFO, log_to_file=True, log_to_console=True):
|
= help: Organize imports
GitHub Actionsを設定してもらう
ローカルだけでなくGitHubでPull Requestが作成された際にもpytestとruffを実行するようGitHub Actionsの設定をお願いすると、これも次のように良い感じに作ってくれました。
> Pull Requestの作成時にpytestとruffのチェックが行われるようにGitHub Actionsの設定を行ってください
Pull Request作成時にpytestとruffのチェックが実行されるGitHub Actionsを設定します。
🛠️ Using tool: execute_bash
⋮
● I will run the following shell command:
cd /home/atsaki/q_example && mkdir -p .github/workflows
⋮
↳ Purpose: GitHub Actionsディレクトリを作成
Allow this action? Use 't' to trust (always allow) this tool for the session. [y/n/t]:
> y
⋮
● Completed in 0.1s
🛠️ Using tool: fs_write
⋮
● Path: /home/atsaki/q_example/.github/workflows/pr-check.yml
+ 1: name: PR Quality Check
+ 2:
+ 3: on:
+ 4: pull_request:
+ 5: branches: [ main ]
+ 6: types: [opened, synchronize, reopened]
+ 7:
+ 8: jobs:
+ 9: quality-check:
+ 10: runs-on: ubuntu-latest
+ 11:
+ 12: steps:
+ 13: - name: Checkout code
+ 14: uses: actions/checkout@v4
+ 15:
+ 16: - name: Install uv
+ 17: uses: astral-sh/setup-uv@v4
+ 18: with:
+ 19: version: "latest"
+ 20:
+ 21: - name: Set up Python
+ 22: run: uv python install 3.13
+ 23:
+ 24: - name: Install dependencies
+ 25: run: uv sync
+ 26:
+ 27: - name: Run Ruff Linter
+ 28: run: |
+ 29: echo "🔍 Running Ruff Linter..."
+ 30: uv run ruff check . --output-format=github
+ 31:
+ 32: - name: Run Ruff Formatter Check
+ 33: run: |
+ 34: echo "🎨 Checking code formatting..."
+ 35: uv run ruff format --check .
+ 36:
+ 37: - name: Run Tests
+ 38: run: |
+ 39: echo "🧪 Running test suite..."
+ 40: uv run pytest tests/ -v --tb=short
+ 41:
+ 42: - name: Run Tests with Coverage
+ 43: run: |
+ 44: echo "📊 Running tests with coverage..."
+ 45: uv run pytest tests/ --cov=src/amazon_q_match3 --cov-report=term-missing --cov-report=xml
+ 46:
+ 47: - name: Comment PR with Coverage
+ 48: if: github.event_name == 'pull_request'
+ 49: uses: actions/github-script@v7
+ 50: with:
+ 51: script: |
+ 52: const fs = require('fs');
+ 53:
+ 54: // Read coverage report if it exists
+ 55: let coverageComment = '## 📊 Test Coverage Report\n\n';
+ 56:
+ 57: try {
+ 58: // This is a simple approach - in a real scenario you might want to parse the XML
+ 59: coverageComment += '✅ Coverage report generated successfully\n';
+ 60: coverageComment += '📈 Check the logs above for detailed coverage information\n\n';
+ 61: } catch (error) {
+ 62: coverageComment += '❌ Could not generate coverage report\n\n';
+ 63: }
+ 64:
+ 65: coverageComment += '## 🔍 Quality Checks\n\n';
+ 66: coverageComment += '- ✅ Ruff Linter\n';
+ 67: coverageComment += '- ✅ Ruff Formatter\n';
+ 68: coverageComment += '- ✅ pytest Test Suite\n';
+ 69: coverageComment += '- ✅ Coverage Analysis\n\n';
+ 70: coverageComment += '🎉 All quality checks passed!';
+ 71:
+ 72: github.rest.issues.createComment({
+ 73: issue_number: context.issue.number,
+ 74: owner: context.repo.owner,
+ 75: repo: context.repo.repo,
+ 76: body: coverageComment
+ 77: });
+ 78:
+ 79: - name: Set PR Status
+ 80: if: success()
+ 81: run: |
+ 82: echo "✅ All quality checks passed!"
+ 83: echo "PR is ready for review 🚀"
+ 84:
+ 85: - name: Fail on Quality Issues
+ 86: if: failure()
+ 87: run: |
+ 88: echo "❌ Quality checks failed!"
+ 89: echo "Please fix the issues before merging."
+ 90: exit 1
実際にPull Requestを作ってみると問題なく動作していました。
今後の改善案を作ってもらう
最後に今後の改善案をGitHub Issuesに登録してもらいました。
個人的には、今回Amazon Q Developer CLIを試していた中で最も感動したポイントがこれです。
サウンドの追加やコンボ表示など私がやりたいと思っていたことが登録されたことに加えて、細かい仕様や実装難易度なども記載されており、最初にやっておくべきだったなと思いました。
残念ながら、改善案を提案した直後に無料利用枠が終了してしまい、その改善案に基づいた開発には着手できなかったのですが、結果を外部に書き出しておくことで、Amazon Q Developer CLIを使って個々のIssue開発を進めたり、Amazon Q Developer CLI以外のAIに読み込ませて評価や開発を行わせたりと、様々な活用方法が考えられると感じています。
> このゲームの改善のアイディアはありますか？
Amazon Q Match3ゲームの改善アイディアをいくつか提案させていただきます！
## 🎮 ゲームプレイの改善アイディア
### 🎯 新しいゲームモード
#### **1. エンドレスモード**
python
# 時間制限なしで高スコアを目指すモード
class EndlessMode:
def __init__(self):
self.difficulty_level = 1
self.blocks_cleared = 0
self.level_threshold = 100 # 100個消去でレベルアップ
• 時間制限なしで永続的にプレイ
• レベルが上がるごとに難易度増加（新しい色追加、特殊ブロック出現）
• 一定数消去でレベルアップ
#### **2. チャレンジモード**
• **爆弾ブロック**: 一定時間で爆発、周囲も巻き込む
• **氷ブロック**: 2回マッチしないと消えない
• **虹ブロック**: どの色ともマッチ可能
### 🎨 視覚・音響効果の強化
#### **1. サウンドシステム**
python
class SoundManager:
def __init__(self):
self.match_sounds = ["match1.wav", "match2.wav", "match3.wav"]
self.combo_sounds = ["combo1.wav", "combo2.wav"]
self.background_music = "bgm.ogg"
• マッチ時の効果音
• 連鎖時の特別音
• 背景音楽
• 設定で音量調整可能
#### **2. 視覚エフェクトの拡張**
• **連鎖表示**: "2 COMBO!", "3 COMBO!" などの表示
• **特殊エフェクト**: 大きなマッチ時の画面震動
• **背景アニメーション**: 動的な背景パターン
### 🏆 プログレッションシステム
#### **1. 実績システム**
python
class Achievement:
def __init__(self, name, description, condition, reward):
self.name = name
self.description = description
self.condition = condition # 達成条件
self.reward = reward # 報酬（称号など）
self.unlocked = False
achievements = [
Achievement("初心者", "初回プレイ完了", lambda stats: stats.games_played >= 1, "🎮"),
Achievement("連鎖マスター", "5連鎖達成", lambda stats: stats.max_combo >= 5, "⛓️"),
Achievement("スピードスター", "30秒で1000点", lambda stats: stats.best_30s_score >= 1000, "⚡"),
]
#### **2. プレイヤーレベル**
• 累積スコアでレベルアップ
• レベルに応じて新機能解放
• プロフィール画面で統計表示
### 🎲 特殊ブロックとパワーアップ
#### **1. 特殊ブロック**
python
class SpecialBlockType(Enum):
BOMB = "bomb" # 3x3範囲を消去
LINE_H = "line_h" # 横一列消去
LINE_V = "line_v" # 縦一列消去
RAINBOW = "rainbow" # 任意の色とマッチ
#### **2. パワーアップアイテム**
• **シャッフル**: グリッド全体をシャッフル
• **ヒント**: 可能なマッチをハイライト
• **時間延長**: +10秒追加
### 📱 UI/UX の改善
#### **1. 設定画面の拡張**
python
class GameSettings:
def __init__(self):
self.sound_enabled = True
self.music_volume = 0.7
self.effects_volume = 0.8
self.show_hints = True
self.animation_speed = 1.0
self.color_blind_mode = False
#### **2. 統計画面**
• 総プレイ時間
• 最高連鎖数
• モード別最高スコア
• 平均スコア推移グラフ
### 🌐 ソーシャル機能
#### **1. ローカルランキング**
python
class LocalLeaderboard:
def __init__(self):
self.daily_rankings = []
self.weekly_rankings = []
self.all_time_rankings = []
def add_score(self, player_name, score, mode):
# 日別、週別、全期間のランキングに追加
pass
#### **2. スコア共有**
• スクリーンショット機能
• スコア結果のテキスト出力
• SNS共有用フォーマット
### 🎨 テーマシステム
#### **1. 複数テーマ**
python
class Theme:
def __init__(self, name, colors, background, sounds):
self.name = name
self.block_colors = colors
self.background_image = background
self.sound_pack = sounds
themes = [
Theme("クラシック", classic_colors, "bg_classic.jpg", "sounds_classic/"),
Theme("ネオン", neon_colors, "bg_neon.jpg", "sounds_electronic/"),
Theme("自然", nature_colors, "bg_nature.jpg", "sounds_nature/"),
]
### 🧩 ゲームバランスの調整
#### **1. 難易度設定**
• **イージー**: 5色のブロック、長い制限時間
• **ノーマル**: 6色のブロック（現在の設定）
• **ハード**: 7色のブロック、短い制限時間、特殊ブロック出現
#### **2. スコアリングの改善**
python
def calculate_score(match_size, combo_count, special_blocks):
base_score = {3: 100, 4: 200, 5: 500, 6: 1000}[min(match_size, 6)]
combo_multiplier = 1 + (combo_count - 1) * 0.5
special_bonus = special_blocks * 50
return int(base_score * combo_multiplier + special_bonus)
### 📊 実装優先度
#### **高優先度（すぐに実装可能）**
1. サウンドシステム - pygame.mixerで簡単に実装
2. 設定画面 - 既存のメニューシステムを拡張
3. 統計画面 - 既存のハイスコアシステムを拡張
#### **中優先度（中期的な実装）**
1. 実績システム - 新しいデータ構造が必要
2. 特殊ブロック - ゲームロジックの拡張
3. テーマシステム - アセット管理の仕組みが必要
#### **低優先度（長期的な実装）**
1. 新ゲームモード - 大幅なアーキテクチャ変更
2. ソーシャル機能 - 外部連携が必要
## 🚀 次のステップの提案
最も効果的で実装しやすい改善から始めることをお勧めします：
1. サウンドシステムの追加 - ゲーム体験が劇的に向上
2. 設定画面の実装 - ユーザビリティの大幅改善
3. 連鎖表示の追加 - 視覚的フィードバックの強化
どの改善アイディアに興味がありますか？具体的な実装方法も詳しく説明できます！
> 各アイディアをGitHubのIssuesに登録して優先度のラベルをつけてください。
各改善アイディアをGitHubのIssuesに登録し、優先度ラベルを付けます。まず、優先度ラベルを作成してから、各Issue
を登録していきます。
まとめ
今回 Amazon Q Developer CLI でゲーム作成をしてみて、想定していたよりも複雑なタスクを雑に頼んでもうまくこなしてくれることがわかりました。
ゲーム以外でも様々な用途に使えそうなので、また使ってみたいです。