Ringo Quiz

Usage

/ringo-quiz [easy|normal|hard]

• difficulty: (optional) easy / normal / hard (default: normal)

Difficulty Levels

Quiz Flow

1. Question Generation

• Randomly choose direction: JP→EN or EN→JP
• Generate a sentence matching the difficulty level
• Topics: Daily life, work, travel, technology (varied)

2. Question Display

Japanese to English:

【翻訳クイズ】難易度: {difficulty} 🍎

次の文を英語に訳してください：
「{japanese_sentence}」

あなたの回答:

English to Japanese:

【翻訳クイズ】難易度: {difficulty} 🍎

次の文を日本語に訳してください：
"{english_sentence}"

あなたの回答:

3. Answer Evaluation

Evaluate user's translation for:

• Core meaning accuracy
• Grammar correctness
• Natural expression

Good Answer:

【結果】✓ 良い翻訳です！

あなたの回答: {user_answer}
模範解答: {model_answer}

💡 ポイント: {brief_explanation_if_helpful}

Needs Improvement:

【結果】△ 惜しい！

あなたの回答: {user_answer}
模範解答: {model_answer}

📝 改善点: {specific_feedback}

---
【SRS自動追加】
間違えた表現をSRSに追加しました:
- "{expression}" ({meaning}) - {type}

Incorrect:

【結果】✗ もう一度確認しましょう

あなたの回答: {user_answer}
模範解答: {model_answer}

📚 解説: {explanation_of_key_grammar_or_vocabulary}

---
【SRS自動追加】
間違えた表現をSRSに追加しました:
- "{expression}" ({meaning}) - {type}

Example Sentences by Difficulty

Easy (5 words or less)

• JP→EN: 「今日は暑いです」→ "It's hot today."
• EN→JP: "I like coffee." → 「私はコーヒーが好きです」

Normal (6-10 words)

• JP→EN: 「彼女は毎朝6時に起きます」→ "She gets up at 6 every morning."
• EN→JP: "I've been waiting for an hour." → 「私は1時間待っています」

Hard (11+ words)

• JP→EN: 「もし昨日雨が降っていなかったら、ピクニックに行けたのに」 → "If it hadn't rained yesterday, we could have gone on a picnic."
• EN→JP: "The book that I bought last week turned out to be more interesting than I expected." → 「先週買った本は、思っていたより面白かった」

SRS Auto-Addition

Use the ringo-srs CLI for all SRS operations. Do NOT read or write data/learning-items.json directly.

When to Add

• Incorrect (✗): Always add the key expression/grammar that was missed
• Needs Improvement (△): Add the specific expression that caused the error

Adding Items via CLI

For each item to add, run:

./bin/ringo-srs add --front "<english expression>" --back "<japanese meaning>" --type "<type>" --context "<model answer sentence>" --context-ja "<japanese translation>" --source "ringo-quiz"

• Duplicate detection is handled by the CLI (case-insensitive on --front)
• If duplicate, CLI returns error code duplicate — skip silently

Notes

• Be encouraging regardless of result
• Focus on one or two key learning points per quiz
• Auto-add incorrect items to SRS (no confirmation needed)