コードを読んで覚える ─ AIに書かせたAndroidアプリで始めるコーディング入門

# 🧠 逆アキネーター（AI有名人当てゲーム）仕様書

## 🎯 概要

ユーザーが質問を投げ、AIが「はい / いいえ」などで回答しながら、
AIが内部で決めた「有名人」を当てる推理ゲーム。

---

## 🎮 ゲームフロー

1. カテゴリ選択（初期は「有名人」固定）
2. AIが有名人を1人決定（非公開）
3. ユーザーが質問（最大20回）
4. AIが5択＋理由で回答
5. ユーザーは任意のタイミングで回答可能
6. 正解 or 不正解で終了

---

## 📊 ゲームルール

### ■ 質問制限

* 最大20問

### ■ 回答形式

AIは必ず以下のいずれかで回答：

* はい
* いいえ
* どちらかといえばはい
* どちらかといえばいいえ
* わからない

＋1文の理由を付ける

---

### ■ 回答方法（ユーザー）

* 「回答する」ボタンから入力
* 例：イチロー、マイケル・ジャクソン など

---

### ■ 勝敗判定

* 正解：ゲームクリア
* 不正解：ゲームオーバー（正解表示）

---

### ■ スコア（任意）

* 5問以内：S
* 10問以内：A
* 20問以内：B

---

## 🖥 UI構成

### ■ メイン画面（チャット）

* 残り質問数表示（例：残り 13 / 20）
* チャット履歴
* 入力フィールド
* ボタン

  * 質問する
  * 回答する

---

### ■ 回答ダイアログ

* テキスト入力欄
* 決定ボタン

---

### ■ 初期ヒント表示

以下を初期表示：

* 人間ですか？
* 日本人ですか？
* 男性ですか？
* 存命ですか？

---

## 🧠 AI設計

### ■ 役割

AIは「キャラ」ではなく「判定役」として振る舞う。「なりきり」させず、ユーザーへの回答は常に5択＋理由の形式を厳守する。

---

### ■ 内部保持情報

* 名前
* 職業
* 国籍
* 性別
* 生死

※ユーザーには非公開

---

### ■ 運用上の注意点

* 正解情報（人物名）は必ずゲーム開始時に固定し、変更しない
* プロンプト設計で一貫性を強制する（過去回答との矛盾を禁じる）
* ユーザーの入力に予期しない内容が含まれる場合はAIに再入力を促す（エラーフェイルセーフ）

---

## 🤖 プロンプト設計

### ■ SYSTEM_PROMPT

```
あなたは推理ゲームの判定AIです。

# ゲーム設定
- 有名人を1人選び、内部で保持する
- この人物は絶対に変更しない

# 回答ルール
質問には必ず以下のいずれかで答える：
- はい
- いいえ
- どちらかといえばはい
- どちらかといえばいいえ
- わからない

# 追加ルール
- 必ず1文の短い理由を付ける
- 過去の回答と矛盾しない
- 曖昧な質問には「どちらかといえば」か「わからない」
- 名前や答えを直接・間接的に示さない
- 同じ質問には同じ意味で答える

# 出力形式（厳守）
「回答（理由）」
例：
はい（人間です）
いいえ（スポーツ選手ではありません）
```

---

## ⚙️ 技術構成

### ■ フロント

* Kotlin
* Jetpack Compose

### ■ 状態管理

```kotlin
data class GameState(
    val remainingQuestions: Int = 20,
    val messages: List<Message>,
    val isLoading: Boolean
)
```

---

### ■ API

* **エンドポイント:** `POST https://api.openai.com/v1/chat/completions`
* OpenAI Chat Completions API を使用

#### 推奨設定

```json
{
  "model": "gpt-5.4-nano",
  "temperature": 0.3
}
```

#### 💰 料金の目安

`gpt-5.4-nano` で20問プレイした場合、入出力合計で概ね3,000〜5,000トークン（約0.1〜0.2円）程度が目安です。ただし **会話履歴をそのまま送り続けるとトークン数は線形に増加します**。要約機能（下記）を実装しない場合、20問目頃には初期の3〜4倍のトークンが必要になり、コスト増・レスポンス遅延・コンテキスト超過のリスクがあります。

---

## 🔄 会話管理

### ■ 履歴

* 全履歴 or 要約保持

### ■ 要約（推奨）

5〜10ターンごとに以下のプロンプトで要約し、古い履歴を圧縮する：

```
これまでの会話（質問と回答のペア）を、ゲームの一貫性を保てる形で簡潔に箇条書きで要約してください。
確定した情報（例：男性である、日本人でない）を列挙すること。
```

---

## 🧪 判定ロジック

### ■ 方法①（簡易）

* 文字列一致 or 類似一致

### ■ 方法②（推奨）

AIに判定させる

```
ユーザーの回答「{user_answer}」と正解「{correct_answer}」が一致しているか判定してください。
表記ゆれや読み方の違いも考慮してください。「一致」または「不一致」のみ返答してください。
```

> **⚠️ 重要:** 判定は**ゲーム進行用とは独立したコンテキスト（別のAPIリクエスト）** で実行してください。ゲーム進行用の会話履歴に正解（人物名）を含めてしまうと、AIが質問への回答の中で先読みして答えを漏らす設計バグが起こる可能性があります。

---

## 🚀 MVP範囲

### ■ 必須機能

* チャットUI
* AI応答（5択）
* 質問回数制限
* 回答機能
* 正誤判定

---

## 💡 今後の拡張

* カテゴリ追加（アニメ、動物など）
* 難易度調整
* ランキング
* SNSシェア
* 音声入力

---

## ⚠️ 注意点（運用時）

* ユーザー発話のサニタイズ（予期しない文字列・プロンプトインジェクション対策）
* エラー時のフェイルセーフ（API障害時はエラーメッセージを表示し、ゲームを継続可能にする）

---

## 🎯 コンセプトまとめ

* シンプル
* 短時間で遊べる
* 繰り返しプレイ可能
* AIの曖昧さを"面白さ"に変える

---

// ViewModel.kt（AIが生成したコードの抜粋）
class GameViewModel : ViewModel() {

    private val _state = MutableStateFlow(
        GameState(remainingQuestions = 20, messages = emptyList(), isLoading = false)
    )
    val state: StateFlow<GameState> = _state.asStateFlow()

    // OpenAI APIに渡す会話履歴（system + user/assistant のリスト）
    private val history = mutableListOf(
        mapOf("role" to "system", "content" to SYSTEM_PROMPT)
    )

    fun sendQuestion(text: String) {
        viewModelScope.launch {
            _state.update { it.copy(isLoading = true) }
            history.add(mapOf("role" to "user", "content" to text))

            val reply = callOpenAiApi(history) // ← ここでAPIを叩く

            history.add(mapOf("role" to "assistant", "content" to reply))
            _state.update { s ->
                s.copy(
                    remainingQuestions = s.remainingQuestions - 1,
                    messages = s.messages
                        + Message(role = "user", content = text)
                        + Message(role = "assistant", content = reply),
                    isLoading = false
                )
            }
        }
    }
}

# local.properties（.gitignore に追加されていることを確認）
openai.api.key=sk-proj-xxxxxxxxxxxxxxxx

// app/build.gradle.kts
android {
    buildFeatures { buildConfig = true }
    defaultConfig {
        val key = project.findProperty("openai.api.key")?.toString() ?: ""
        buildConfigField("String", "OPENAI_API_KEY", "\"$key\"")
    }
}

// 使用箇所（Kotlin コード内）
val apiKey = BuildConfig.OPENAI_API_KEY

質問フィールドが空欄のまま「質問する」ボタンをタップすると、
空の文字列がAPIに送信されてしまいます。
入力が空（スペースのみも含む）の場合はボタンを非活性にしてください。

Button(onClick = { viewModel.sendQuestion(inputText) }) {
    Text("質問する")
}

Button(
    onClick = { viewModel.sendQuestion(inputText) },
    enabled = inputText.isNotBlank()  // 空欄・スペースのみなら非活性
) {
    Text("質問する")
}