Ringo Srs Quiz

Usage

/ringo-srs-quiz [count]

• count: (optional) Number of items to quiz (default: 5, max: 20)

Implementation

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

Step 1: Get Due Items

./bin/ringo-srs list --due --limit <count>

Response:

{"ok": true, "data": {"count": 3, "items": [
  {"id": "item_001", "front": "implement", "back": "実装する", "type": "word", "context": "...", "context_ja": "..."}
]}}

If count is 0 or no items returned, show "No items due" message.

Step 2: Conduct Quiz

Present each item to the user interactively (see Quiz Flow below).

Step 3: Record All Results at Once

./bin/ringo-srs review <<'EOF'
[
  {"id":"item_001","result":"correct","difficulty":"good"},
  {"id":"item_002","result":"incorrect"},
  {"id":"item_003","result":"correct","difficulty":"easy"}
]
EOF

Response:

{"ok": true, "data": {"results": [
  {"id": "item_001", "result": "correct", "next_review": "2026-02-09T00:00:00Z", "interval_days": 3, "status": "learning"}
], "summary": {"total": 3, "correct": 2, "incorrect": 1}}}

Quiz Flow

1. Question Display

CRITICAL: Never show the answer in the question. Choose display based on item type:

For word/phrase/idiom items (Japanese → English):

【クイズ #{current}/{total}】
タイプ: {type}
意味: {back}

英語で書いてください:

For grammar items:

【クイズ #{current}/{total}】
タイプ: grammar
文法ポイント: {front}
日本語の意味: {context_ja}

この文法を使って英語で書いてください:

IMPORTANT: For grammar items, NEVER display the back field or context field in the question — they contain the English answer.

2. Answer Evaluation

After user responds:

Correct Answer:

【結果】✓ 正解！

例文: {context sentence if available}

難易度を選んでください:
1. Easy (簡単だった)
2. Good (普通)
3. Hard (難しかった)

Incorrect Answer:

【結果】✗ 不正解

正解: {correct answer}
例文: {context sentence if available}

次回は1日後に復習します。

3. Difficulty Selection (Correct answers only)

User selects 1, 2, or 3 to indicate difficulty. Map to: easy, good, hard.

Session Summary

After all questions answered, use the review response data:

【セッション完了】

結果: {correct}/{total} 正解 ({percentage}%)

## 今回の復習
| アイテム | 結果 | 次回復習 |
|---------|------|---------|
| {item1} | ✓/✗ | {next_date} |
| {item2} | ✓/✗ | {next_date} |

For overall progress, run:

./bin/ringo-srs stats

Edge Cases

No Items Due:

【復習アイテムなし】

次回の復習予定: {next_review_date} ({item_count}件)

💡 新しいアイテムを追加するには `/ringo-srs-add` を使用してください。

Empty Database (no_data_file error):

【学習アイテムなし】

まだ学習アイテムが登録されていません。

アイテムを追加するには:
- `/ringo-srs-add implement 実装する` で直接追加
- `/ringo-learning` で添削時に自動追加

Answer Matching Rules

1. Case-insensitive: "Implement" matches "implement"
2. Trim whitespace: " implement " matches "implement"
3. Accept minor typos: Levenshtein distance <= 1 for words > 4 characters (prompt for confirmation)
4. Exact match for short words: Words <= 4 characters require exact match

Near-Match Handling:

【結果】惜しい！

あなたの回答: "implment"
正解: "implement"

これは正解としてカウントしますか？
1. はい (正解として記録)
2. いいえ (不正解として記録)