wilma-triage

Wilma のトリアージ

保護者向けに、Wilma の学校データを毎日自動でトリアージします。不要な情報を除外し、対応が必要な項目を提示して、試験やイベントを家族のカレンダーと同期します。

依存関係

• Wilma へのアクセス — WilmAI MCP ツール（wilma_*）、または wilma スキルと CLI（clawhub install wilma。このスキルのコマンドには wilma-cli 2.0 以降が必要です）。wilma スキルは各 MCP ツールを対応する CLI コマンドに割り当てます。利用できる方を使ってください。
• カレンダー（任意） — エージェントが利用できる任意のカレンダーツール。OpenClaw の gog スキル（clawhub install gog）、またはアシスタント独自のカレンダーコネクターを使えます。カレンダーツールがない場合は、同期せずに新しい日付をレポートに記載します。
• メモ — このスキルはエージェントのメモに設定と好みを保存します。OpenClaw では TOOLS.md と MEMORY.md を使用します。それ以外の場合、このスキルで TOOLS.md または MEMORY.md と記載されている箇所では、アシスタントのメモリまたはプロジェクトの指示を使用してください。

初回実行時のセットアップ

初回利用時に、設定を収集して保存します。

1. 子どもの情報を確認する： wilma_account を呼び出すか、wilma students を実行して、生徒の名前と番号を取得します
2. カレンダー： エージェントのカレンダーツールで利用可能なカレンダーを一覧表示します（例：gog calendar calendars）。学校の予定に使うカレンダーをユーザーに確認します。イベントの命名規則とともに、カレンダー ID を TOOLS.md の ## Wilma Triage セクションに保存します。カレンダーツールを利用できない場合は、この手順を省略します。
3. 好み： 子どもごとのルール（例：宗教の代わりに ET を使うなど、科目の例外設定）があるか尋ねます。Wilma のトリアージに関する情報として MEMORY.md に保存します。

ユーザーは時間の経過とともに、報告する項目や省略する項目についてフィードバックをくれます。こうした好みを MEMORY.md に保存してください。使うほどトリアージの精度が上がります。

ワークフロー

1. データを取得する — since を指定して wilma_summary を呼び出すか、以下の CLI を実行すれば、すべての子どもの新着情報を一度に取得できます。前回実行した日（MEMORY.md に保存されています）、または昨日の日付を使用してください。今日と次の登校日の授業、今後の試験（開始時刻が指定されている場合はその時刻も含む）、宿題、授業メモ（教師からのフィードバックと欠席）、その日以降のお知らせとメッセージ、さらに未読メッセージをすべて返します。

   wilma summary --since <last-run-date-or-yesterday>
   
   # Drill into specifics as needed
   wilma messages <id>                 # full text and every reply
   wilma news <id>                     # full text and linked resources
   wilma exams                         # all upcoming exams
   wilma schedule tomorrow
   wilma notes --from <date>           # lesson notes for a longer period
   

   エージェントが CLI を実行すると、JSON が出力されます。結果は子どもごとに返され（students[].student）、時刻はフィンランド時間です。MCP ツールでは、wilma_read_message、wilma_read_news、wilma_upcoming_exams、wilma_schedule、wilma_lesson_notes が同等の機能を提供します。すべてのツールとコマンドは、デフォルトですべての子どもを対象とします。

2. 重要な添付ファイルをダウンロードして読む — お知らせの多くはリンクのみです。content フィールドが空、または添付ファイルを参照するだけで、対応が必要な情報（日時、締め切り、フォーム、必要な持ち物、スケジュールの詳細）は添付文書に記載されています。これらを見落とすと、トリアージで検出すべき項目そのものを見逃します。

   お知らせまたはメッセージを読んだ後、JSON の resources 配列を確認してください。次の条件をすべて満たす場合は、ダウンロードを試みてください。

   • リソースが文書のように見える（fileName のヒントがある、URL が文書を示している、またはウェブページではなく明らかにファイルである）。
   • お知らせの価値が高い（年間／学期の案内、教師からの手紙、学校事務室のお知らせ、許可書）。
   • お知らせ本文が空、または添付ファイルを参照している。

   wilma news <news-id> download <resource-id> --output <dir>
   

   MCP ツールでは、代わりに wilma_get_news_attachment を呼び出してください。ファイルの内容が直接返されます。

   返された status に応じて対応してください。

   • downloaded（CLI）または fetched（MCP） — ファイルを読み（PDF の場合は PDF リーダーを使用）、対応が必要な項目をレポートにまとめます。
   • not_a_file — リンク先はウェブページであるか、外部サインインが必要です。保護者が自分で開けるよう、URL を報告してください。ループして再試行しないでください。
   • error — メッセージを報告します。

   ダウンロードしないもの：

   • 一般的な情報提供用のウェブリンク、ソーシャルメディアのページ、同じお知らせの多言語版の重複。1 つのお知らせにこれらが多数含まれる場合があります。
   • resources 配列全体を順に処理しないでください。価値が高く、対応が必要なお知らせに添付された、実際の文書だけを対象にしてください。

   サンドボックスに関する注意： 画像／PDF リーダーのツールは、特定の一時パス（システムの一時ディレクトリなど）にあるファイルを受け付けない場合があります。添付ファイルはワークスペース相対ディレクトリ（例：./attachments/）にダウンロードしてから読み取り、必要に応じて後で削除してください。

3. 絞り込む — 以下のトリアージルールと、MEMORY.md に記載された子ども別のルールを適用します。お知らせの一覧には、固定表示のお知らせ（pinned: true。例：学年度のお知らせ）が常に含まれるため、トリアージ期間内の日付のお知らせだけを報告してください。メッセージの replyCount が前回実行時から増えている場合（件数は MEMORY.md に保存します）、新しい返信があるため、スレッドを読んでください。

4. カレンダーを同期する — TOOLS.md に記載されたカレンダーツールで、未登録の試験と対応が必要な予定を追加します（ツールがない場合は省略）。time がある試験は時刻指定の予定にし、それ以外は終日予定にします。

   • 重複を避けるため、必ず追加前に既存の予定を確認してください
   • TOOLS.md に保存された命名規則を使用します
   • 中止になった予定はカレンダーから削除します

5. レポートする — 対応が必要な項目が見つかったら、詳細を伝えます。何もなければ、何も送信しないか、簡潔に確認を伝えます。ユーザーの通知設定を MEMORY.md で確認してください。その後、今日の日付を MEMORY.md に前回実行日として保存します（次回実行時の --since に使用します）。

カレンダーの同期

カレンダー ID、命名規則、使用するカレンダーコマンドまたはツールの詳細については、TOOLS.md を参照してください。

重複させないルール：

1. 予定を追加する前に、その日付範囲のカレンダーを確認します。
2. 一致する予定（日付、子ども、教科のキーワードが同じ）がある場合は、追加を省略します。
3. まだ登録されていない場合に限り、追加します。

Wilma のメッセージを理解する

Wilma のメッセージはさまざまな送信元から届き、シグナルとノイズの比率も大きく異なります。適切に優先順位を判断するには、その違いを把握することが重要です。

• Viikkoviesti／週刊レター（担任から）— 非常に重要です。 担任から毎週届くお知らせです。カジュアルなニュースレターのように見えますが、今後の試験、持参する教材、スケジュール変更、校外学習、締め切りなど、対応が必要な項目が含まれていることがよくあります。必ず全文を読んでください。 件名だけで判断して読み飛ばしてはいけません。
• 教師からのメッセージ（教科担当教師から）— 通常、特定の試験、宿題、授業の行事に関するものです。重要な情報が含まれています。
• 学校事務室／校長からのメッセージ— 事務連絡です。スケジュール変更、行事、方針の更新などが含まれます。重要度は中程度なので、対応が必要な事項がないかざっと確認してください。
• Kuukausitiedote／月刊ニュースレター（学校事務室から）— 必ず読んでください。 休暇、学年の開始日・終了日、行事の日程、入学申し込みの締め切りなど、重要な日付が記載されていることが多いです。一般的な件名だけで判断して読み飛ばしてはいけません。
• 自治体からのお知らせ（市／自治体の教育部門から）— 健康キャンペーン、交通情報、アンケートなどが含まれます。通常、日々の優先順位付けにおいては重要度が低い情報です。件名をざっと確認し、明らかに対応が必要なものでなければ読み飛ばしてください。
• 保護者会／vanhempainyhdistys— 通常は重要度が低い情報です（資金集め、ボランティアの募集など）。ただし、保護者が保護者会に積極的に参加している場合は、MEMORY.md を確認してください。その場合、優先度が高くなります。

目安： 担任または教科担当教師からのメッセージは、必ず読んでください。学校事務室または市からのメッセージは、件名をざっと確認し、明らかに対応が必要なものでなければ読み飛ばしてください。

重要度の高いメッセージやお知らせに文書への参照や添付ファイルがある場合は、ワークフローのステップ 2 に従ってダウンロードし、内容を読んでください。対応が必要な詳細は、添付ファイルにしか記載されていないことがよくあります。

授業メモ（merkinnät）を理解する

授業メモは、教師が Wilma に残す、授業ごとの短いコメントです。いくつかのカテゴリに分かれ、重要度には大きな差があります。

• 行動上の懸念（例：「Sinulta puuttui opiskeluvälineitä」＝「学習用具が不足していました」、「Häiritsi tuntia」＝「授業を妨害しました」）— 報告してください。 保護者は通常この情報を知りたいと考えており、必要に応じて対応することもあります。
• 理由が説明されていない欠席（「Selvittämätön poissaolo」）— すぐに報告してください。 無断欠席の可能性や、保護者が Wilma で欠席理由を届け出るのを忘れた可能性があります。
• 理由が説明されている欠席（「Terveydellinen syy」＝病気、「Muu selvitetty poissaolo」＝その他の説明済み欠席）— 欠席が記録されていることの確認として、簡潔に報告してください。 MEMORY.md に欠席確認は不要と保護者が希望している旨が記載されている場合は、報告を省略してください。
• 肯定的なフィードバック（「Hyvä!」、「Osasit toimia ryhmän vastuullisena jäsenenä」）— 通常は省略してください。 MEMORY.md に肯定的なコメントも知らせてほしいという保護者の希望が記載されている場合は、時折伝えてください。
• 教師自身の言葉（note。例：「Lähti 13.00」＝「13:00 に退出」、または具体的に何が不足していたか）— もっとも役立つ情報であることがよくあります。伝えてください。

typeLabel はフィンランド語のラベル、note は教師自身の言葉（または null）、subject は教科コード（例：MA_8LV。授業に紐づかないメモでは空欄）です。報告する際、同じ教科・同じ種類のメモが連続している場合はまとめてください（欠席 1 回分が複数の授業時間にまたがることがよくあります）。学期全体の概要を確認するには、wilma notes summary（wilma_lesson_notes_summary）で種類ごとのメモ数を集計できます。

優先順位付けのルール

必ず報告する事項（対応が必要）

• フォーム、許可証、返信が必要なもの
• 締め切り（申し込み、支払い、持参する教材）
• スケジュール変更（早退、授業の中止、代講の手配）
• 特別な用具・教材（例：「スキー用具を持参」、「屋外用の服装」）
• 子どもが参加を希望する可能性のある放課後の行事（ディスコ、映画鑑賞会）
• 試験日程の変更または新しい試験
• カレンダーに登録されている中止イベント → 削除してください
• 行動に関する授業メモ、または理由が説明されていない欠席（上記の merkinnät のセクションを参照）

簡潔に報告する（言及する価値あり）

• 遠足、日付情報のあるテーマデー
• 休校、休暇スケジュールの変更
• 健康に関するお知らせ（シラミの注意喚起、感染症の流行）
• 新しい成績（学年とともに簡潔に言及）
• 授業メモに記録された欠席理由（確認のみ）

重要：毎週のおたより（viikkoviesti）は必ず読む

クラス担任からの毎週のおたよりには、試験、持ち物、スケジュール変更、遠足など、対応が必要な項目が本文に埋もれていることがよくあります。viikkoviestiのメッセージは必ず全文を読んでください。件名だけを見て読み飛ばしてはいけません。おたよりで書類（案内資料、スケジュール、フォーム）が参照または添付されている場合は、ワークフローのステップ2に従って、それもダウンロードして読んでください。

前日の準備事項（重要！）

viikkoviestiや教師からのメッセージには、カレンダーの予定には反映されないものの、前日や前夜に保護者が把握しておく必要のある翌日以降の運用上の詳細がよく含まれています。

• 開始時刻／終了時刻の変更（例：通常は8:30のところ「9:30 kouluun」）
• 持参するもの／用意するもの（水筒、屋外用の服、軽食、特定の用具）
• 遠足や行事のために休講になる授業（例：ETや選択科目がない）
• 迎え／帰着時刻の変更（例：「paluu koululle noin klo 15」）
• 当日の進行順（例：「まず試験を受け、その後すぐに遠足」）

**これらの詳細は、試験やスケジュール変更と同じくらい重要です。**遠足があることは知っていても、通常の8:30ではなく9:30に登校することを知らない保護者には、情報が十分に伝わっていません。

ワークフロー：

1. viikkoviestiを読む際は、今後2〜3登校日の、各日に固有の準備事項をすべて抽出します
2. 今日のトリアージで、明日または明後日の準備事項が見つかった場合は、関連する予定（遠足、試験など）がすでにカレンダーに入っていても、必ず報告します
3. 時刻の変更、持ち物、休講になる授業、交通手段の詳細、帰着時刻を含めます
4. カレンダーと同期されていれば対応完了だと思い込まないでください。予定はカレンダーにあっても、準備事項までは記載されていません

**これらを見落とした場合の例：**カレンダーには金曜日の予定として「アクティビティパークへの遠足」と「歴史の試験」が記載されています。しかしviikkoviestiには、登校時刻は8:30ではなく9:30、最初に歴史の試験を受けること、水筒と軽食を持参すること、ETや選択科目はないこと、15:00頃に戻ることが書かれています。前夜に保護者が把握しておくべき重要な情報は、これらすべてです。

報告せずにスキップ

• コンサート、文化公演（参考情報のみ）
• 一般的な「おかえりなさい」や季節の挨拶
• 市全域向けのお知らせ（健康キャンペーン、交通情報、アンケート）
• 保護者団体からのメッセージ（ユーザーが積極的に関わっている場合を除く — MEMORY.mdを確認）
• 良い内容の授業メモ（MEMORY.mdに別の指示がある場合を除く）

ユーザーがこれまでに提供した、追加のスキップ／報告ルール（例：科目ごとの例外、学校固有のフィルタリング）がないか、MEMORY.mdを確認してください。

推奨するCron設定

現地時間の毎日07:00に実行します。OpenClawでは独立したagentTurnジョブとして実行し、ほかのアシスタントでは、利用可能な場合はスケジュールタスク機能を使用します。

Schedule: 07:00 daily
Timeout: 180s
Task: "Read the wilma-triage skill, then run the full triage workflow. Report actionable findings."

APIのレート制限を避けるため、ほかの朝のジョブ（例：07:05のメール確認）とは時間をずらしてください。

出力形式の例

📚 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
• Lesson note (yesterday, MA_8LV): "Sinulta puuttui opiskeluvälineitä" — kirja jäi kotiin

Child B (6th grade)
• No actionable items

📅 Calendar: Added Child A math exam (10 Feb), removed cancelled disco (11 Feb)

簡潔にしてください。項目ごとに1行で記載します。余計な情報を加えるより、何も伝えないほうが適切です。

ユーザーに日付を書く場合は、回答する言語に合わせてください。フィンランド語では ke 7.10.（末尾にピリオド）、英語では Wed 7 Oct とします。Wilmaのメッセージはフィンランド語の形式なので、形式を混在させず、変換してください（Wed 7.10のようにはしないでください）。