Back to Details

wilma-triage

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Wilma Triage

Wilma通知分类处理

Automated daily triage of Wilma school data for parents. Filters noise, surfaces actionable items, and syncs exams/events to Google Calendar.
为家长自动每日分类处理Wilma学校数据。过滤无效信息，突出可执行事项，并将考试/活动同步到Google Calendar。

Dependencies

依赖项

  • wilma skill — install from ClawHub (
    clawhub install wilma
    ) for Wilma CLI commands and setup
  • gog skill — install from ClawHub (
    clawhub install gog
    ) for Google Calendar sync
  • wilma skill — 从ClawHub安装（
    clawhub install wilma
    ）以获取Wilma CLI命令和配置功能
  • gog skill — 从ClawHub安装（
    clawhub install gog
    ）以实现Google Calendar同步

First Run Setup

首次运行配置

On first use, collect and store configuration:
  1. Discover kids: Run 
    wilma kids list --json
    to get student names, numbers, and schools
  2. Calendar ID: Run 
    gog calendar calendars
    to list available calendars. Ask the user which calendar to use for school events. Store the calendar ID in TOOLS.md under a 
    ## Wilma Triage
    section along with naming conventions for events.
  3. Preferences: Ask about any kid-specific rules (e.g., subject overrides like ET instead of religion). Store in MEMORY.md as part of the Wilma triage context.
Over time, the user will give feedback on what to report and what to skip — store these preferences in MEMORY.md. The triage gets smarter with use.
首次使用时，需收集并保存配置信息：
  1. 查看子女信息：运行
    wilma kids list --json
    获取学生姓名、学号和学校信息
  2. 日历ID：运行
    gog calendar calendars
    列出可用日历。询问用户将学校事件同步到哪个日历，并将日历ID与事件命名规则一起保存到TOOLS.md的
    ## Wilma Triage
    章节中。
  3. 偏好设置：询问是否有针对特定子女的规则（例如，用ET替代宗教课等科目别名）。将这些设置保存到MEMORY.md的Wilma分类处理上下文部分。
随着使用时间推移，用户会反馈需要报告或忽略的内容——将这些偏好保存到MEMORY.md中，分类处理功能会逐渐变得更智能。

Workflow

工作流程

  1. Fetch data — check TOOLS.md for student details, then start with summary:
    bash
    # Best starting point — returns schedule, exams, homework, news, messages
wilma summary --all-students --json

# Drill into specifics as needed
wilma exams list --all-students --json
wilma schedule list --when today --all-students --json
wilma schedule list --when tomorrow --all-students --json
wilma homework list --all-students --limit 10 --json
wilma grades list --all-students --limit 5 --json
wilma messages list --all-students --limit 10 --json
wilma news list --all-students --limit 10 --json

# Read full content when subject line looks actionable
wilma messages read <id> --student <name> --json
wilma news read <id> --student <name> --json
  2. Filter — apply triage rules below plus any kid-specific rules from MEMORY.md
  3. Calendar sync — add missing exams and actionable events using gog CLI commands from TOOLS.md
    • ALWAYS check for existing events before adding to avoid duplicates
    • Use naming conventions stored in TOOLS.md
    • Remove cancelled events from calendar
  4. Report — if actionable items found, send details. If nothing actionable, stay silent or send a brief confirmation. Check MEMORY.md for the user's notification preference.
  1. 获取数据：查看TOOLS.md中的学生详情，先从汇总信息开始：
    bash
    # 最佳起始命令——返回课程表、考试、作业、新闻和消息
wilma summary --all-students --json

# 根据需要查看具体内容
wilma exams list --all-students --json
wilma schedule list --when today --all-students --json
wilma schedule list --when tomorrow --all-students --json
wilma homework list --all-students --limit 10 --json
wilma grades list --all-students --limit 5 --json
wilma messages list --all-students --limit 10 --json
wilma news list --all-students --limit 10 --json

# 若主题行显示为可执行事项，查看完整内容
wilma messages read <id> --student <name> --json
wilma news read <id> --student <name> --json
  2. 筛选信息：应用以下分类处理规则以及MEMORY.md中针对特定子女的规则
  3. 日历同步：使用TOOLS.md中的gog CLI命令，将缺失的考试和可执行事件添加到日历中
    • 必须先检查现有事件，避免重复添加
    • 使用TOOLS.md中保存的命名规则
    • 从日历中移除已取消的事件
  4. 发送报告：若找到可执行事项，发送详细信息；若无，则保持静默或发送简短确认。查看MEMORY.md中的用户通知偏好。

Calendar Sync

日历同步

Refer to TOOLS.md for the calendar ID, naming conventions, and exact gog CLI commands.
NO DUPLICATES rule:
  1. Before adding any event, check calendar for that date range
  2. If a matching event exists (same date + child + subject keywords), skip it
  3. Only add if not already there
参考TOOLS.md中的日历ID、命名规则和具体gog CLI命令。
禁止重复规则：
  1. 添加任何事件前，检查该日期范围内的日历
  2. 若存在匹配事件（相同日期+子女+科目关键词），跳过添加
  3. 仅添加不存在的事件

Understanding Wilma Messages

理解Wilma消息

Wilma messages come from different sources and have very different signal-to-noise ratios. Knowing the difference is critical for good triage:
  • Viikkoviesti / weekly letter (from class teacher) — HIGH VALUE. These are the class teacher's weekly updates. They look like casual newsletters but frequently contain buried actionable items: upcoming exams, materials to bring, schedule changes, field trips, deadlines. Always read the full content. Never skip based on subject line.
  • Teacher messages (from subject teachers) — Usually about specific exams, homework, or class events. High signal.
  • School office / rehtori messages — Administrative: schedule changes, events, policy updates. Medium signal — skim for actions.
  • Kuukausitiedote / monthly newsletter (from school office) — Read these. They typically contain important dates: holidays, school year start/end, event schedules, enrollment deadlines. Don't skip based on the generic subject line.
  • City-wide notices (from Helsinki/municipality) — Health campaigns, transport info, surveys. Usually noise for daily triage. Skim subject, skip unless clearly actionable.
  • Parent union / vanhempainyhdistys — Low signal by default (fundraising, volunteer calls). However, check MEMORY.md — if the parent is actively involved in the union, these become high priority.
Rule of thumb: If a message is from a teacher (class teacher or subject teacher), always read it. If it's from the school office or city, skim the subject and skip unless it's clearly actionable.
Wilma消息来自不同来源，信号噪声比差异很大。区分这些来源是做好分类处理的关键：
  • Viikkoviesti/每周通讯（来自班主任）——高价值。这是班主任的每周更新，看似随意的通讯，但通常包含隐藏的可执行事项：即将到来的考试、需携带的物品、课程表变更、校外活动、截止日期。务必查看完整内容，不要仅根据主题行跳过。
  • 任课教师消息（来自科目老师）——通常关于特定考试、作业或班级活动，信号值高。
  • 学校办公室/校长消息——行政通知：课程表变更、活动、政策更新。中等信号值——快速浏览寻找可执行事项。
  • Kuukausitiedote/每月通讯（来自学校办公室）——务必查看。通常包含重要日期：假期、学年起止、活动安排、报名截止日期。不要因主题行通用而跳过。
  • 全市通知（来自赫尔辛基/市政当局）——健康宣传、交通信息、调查。通常属于日常分类处理中的无效信息。浏览主题行，除非明确是可执行事项，否则跳过。
  • 家长联合会/vanhempainyhdistys消息——默认信号值低（筹款、志愿者招募）。但需查看MEMORY.md——若家长积极参与联合会，这些消息则变为高优先级。
经验法则： 若消息来自教师（班主任或任课教师），务必查看。若来自学校办公室或市政当局，浏览主题行，除非明确可执行，否则跳过。

Triage Rules

分类处理规则

Always Report (Actionable)

必须报告（可执行事项）

  • Forms, permission slips, replies needed
  • Deadlines (sign-ups, payments, materials to bring)
  • Schedule changes (early dismissal, cancelled classes, substitute arrangements)
  • Special gear/materials needed (e.g., "bring ski gear", "outdoor clothing")
  • After-school events kids might want to attend (discos, movie nights)
  • Exam schedule updates or new exams
  • Cancelled events that are on the calendar → remove them
  • 表格、许可单、需回复的内容
  • 截止日期（报名、缴费、需携带物品）
  • 课程表变更（提前放学、课程取消、代课安排）
  • 需携带的特殊装备/物品（例如：“携带滑雪装备”、“户外服装”）
  • 子女可能感兴趣的课后活动（迪斯科、电影之夜）
  • 考试安排更新或新考试
  • 日历中已取消的事件 → 移除这些事件

Report Briefly (Worth Mentioning)

简要报告（值得提及）

  • Field trips, themed days with date info
  • School closures, holiday schedule changes
  • Health notices (lice alerts, illness outbreaks)
  • New grades (brief mention with grade)
  • 校外活动、带日期的主题日
  • 学校停课、假期安排变更
  • 健康通知（头虱预警、疾病爆发）
  • 新成绩（简要提及成绩）

Important: Always Read Weekly Letters (viikkoviesti)

重要提示：务必查看每周通讯（viikkoviesti）

Weekly letters from class teachers often contain actionable items buried in the text: exams, materials to bring, schedule changes, field trips. Always read the full content of viikkoviesti messages — do not skip based on subject line alone.
班主任的每周通讯通常在文本中隐藏可执行事项：考试、需携带物品、课程表变更、校外活动。务必查看viikkoviesti消息的完整内容——不要仅根据主题行跳过。

Skip Silently

静默跳过

  • Concerts, cultural performances (FYI only)
  • Generic "welcome back" or seasonal greetings
  • City-wide informational notices (health campaigns, transport info, surveys)
  • Parent union messages (unless user is actively involved — check MEMORY.md)
Check MEMORY.md for additional skip/report rules the user has provided over time (e.g., subject overrides, school-specific filtering).
  • 音乐会、文化表演（仅作信息告知）
  • 通用的“欢迎返校”或季节性问候
  • 全市范围的通知（健康宣传、交通信息、调查）
  • 家长联合会消息（除非用户积极参与——查看MEMORY.md）
查看MEMORY.md获取用户提供的额外跳过/报告规则（例如：科目别名、学校特定筛选规则）。

Suggested Cron Setup

建议的Cron配置

Run daily at 07:00 local time as an isolated agentTurn job:
Schedule: 07:00 daily
Timeout: 180s
Task: "Read the wilma-triage skill, then run the full triage workflow. Report actionable findings."
Stagger with other morning jobs (e.g., email check at 07:05) to avoid API rate limits.
作为独立的agentTurn任务，在当地时间每日07:00运行：
Schedule: 07:00 daily
Timeout: 180s
Task: "Read the wilma-triage skill, then run the full triage workflow. Report actionable findings."
与其他晨间任务错开时间（例如：07:05检查邮件）以避免API速率限制。

Output Format Example

输出格式示例

📚 Wilma Update

Child A (8th grade)
• Math exam tomorrow — yhtälöt, kpl 1-8
• Friday short day (9:20-12:35) — kulttuuripäivä, bring laptop + outdoor clothes

Child B (6th grade)
• No actionable items

📅 Calendar: Added Child A math exam (Feb 10), removed cancelled disco (Feb 11)
Keep it brief. One line per item. Silence is better than noise.
📚 Wilma更新

孩子A（8年级）
• 明天数学考试 — yhtälöt, kpl 1-8
• 周五提前放学（9:20-12:35）——文化日，携带笔记本电脑+户外服装

孩子B（6年级）
• 无可执行事项

📅 日历：已添加孩子A的数学考试（2月10日），已移除已取消的迪斯科活动（2月11日）
保持简洁，每项一行。静默优于无效信息。