Synthesize the past week's task history, self-ratings, and mistake patterns into a compressed weekly summary with weak areas, strong areas, and a recommended focus for the next week.
Invoke this skill when the learner runs /jp-weekly. It reads from storage/progress.json and storage/reviews.json, and produces a weekly retrospective. During speaking+review weeks (17–24), this summary also feeds back into generate-daily-tasks to inform the next week's plan.
| Parameter | Type | Required | Description |
|---|---|---|---|
user_id | string | yes | References users.id |
weekly_task_history | object[] | yes | Array of daily_state records for the past 7 days (from storage/daily_state.json) |
weak_points | string[] | yes | Aggregated weak_points[] from all daily sessions this week |
| Field | Type | Description |
|---|---|---|
summary | string | 2–4 sentence narrative of the week's learning in Chinese |
completion_rate | number | Percentage of assigned tasks completed (0.0–1.0) |
average_self_rating | number | Mean self-rating across all completed tasks (1.0–5.0) |
weak_areas | object[] | Patterns or skills that showed low ratings or repeated mistakes |
strong_areas | object[] | Patterns or skills where performance was consistently high |
next_week_focus | string | Specific recommended focus for the coming week |
items_to_retire | string[] | Vocab/grammar IDs that are mastered and can be removed from rotation |
items_to_add | string[] | New vocab/grammar IDs to introduce next week |
| Field | Type | Description |
|---|---|---|
area | string | Skill area or specific pattern (e.g., "particle usage", "listening comprehension") |
evidence | string | Brief summary of what data supports this classification |
action | string | Recommended action: "repeat", "drill", "introduce_next_pattern", "celebrate" |
daily_state records for the past 7 days matching user_id.completion_rateself_ratings[] → average_self_ratingweak_points[] → frequency mapstorage/reviews.json for this week → mistake type frequencyA pattern is classified as weak if:
weak_points[] 2+ times across the week, ORself_rating average is below 3.0, ORrecurring_mistakes with occurrence_count >= 2A pattern is strong if:
self_rating average is 4.0 or above across 3+ sessions, ORmastered this weekCombine signals:
completion_rate < 0.6: recommend reducing task count and slowing pace.average_self_rating < 2.5: recommend repeating current content before advancing.weak_areas contain grammar: recommend grammar+shadowing focus next week.weak_areas contain listening: recommend adding one extra listening drill per day.Write 2–4 sentences in Chinese covering:
Output:
{
"summary": "這週你完成了5天的學習，重點練習了打招呼詞彙和聽力。すみません的用法已經進步很多！助詞「は」和「が」的區別還需要多練習，下週我們會專門加強這個。繼續保持，你的連續學習已經達到6天了！",
"completion_rate": 0.8,
"average_self_rating": 3.2,
"weak_areas": [
{ "area": "は vs が particle usage", "evidence": "Appeared in weak_points 3 times; review mistake count: 2", "action": "drill" }
],
"strong_areas": [
{ "area": "Greeting vocabulary", "evidence": "Average self-rating 4.5 across 4 sessions", "action": "celebrate" }
],
"next_week_focus": "Focus on grammar+shadowing with emphasis on は vs が distinction. Add one grammar drill per session.",
"items_to_retire": ["vocab_001", "vocab_002"],
"items_to_add": ["grammar_003", "grammar_004"]
}