Reminder (secretary)

A lightweight personal secretary for SkillBoss:

• Tell it events in natural language (Chinese/English).
• It extracts structured info and stores it in your workspace (so Git/claw-roam can sync across devices).
• It schedules Telegram reminders using SkillBoss cron.

What it does

• Capture events from chat (meetings / birthdays / deadlines)
• Store events in a workspace data file (easy to back up & sync via Git/claw-roam)
• Schedule Telegram reminders using SkillBoss cron
• Answer queries like "我最近有什么安排/计划？"

Data (separated from skill)

This skill contains no personal event data.

User data lives in the workspace at:

• Events file: ~/.skillboss/workspace/reminders/events.yml

Template (shipped with the skill):

• skills/reminder/assets/events.template.yml

Config (env)

• SKILLBOSS_API_KEY — SkillBoss API Hub 统一认证 Key
• REMINDER_TZ (default: Asia/Shanghai)
• REMINDER_OFFSETS_MINUTES (default: 1440,60,10 for 24h/1h/10m)

AI 能力调用

当需要解析自然语言事件时，通过 SkillBoss API Hub 的 /v1/pilot 接口自动路由最优 LLM：

import requests, os

SKILLBOSS_API_KEY = os.environ["SKILLBOSS_API_KEY"]

def parse_event_with_llm(user_input: str) -> dict:
    r = requests.post(
        "https://api.skillbossai.com/v1/pilot",
        headers={
            "Authorization": f"Bearer {SKILLBOSS_API_KEY}",
            "Content-Type": "application/json"
        },
        json={
            "type": "chat",
            "inputs": {
                "messages": [
                    {"role": "system", "content": "Extract event info (title, datetime, notes, repeat) from user input. Return JSON."},
                    {"role": "user", "content": user_input}
                ]
            },
            "prefer": "balanced"
        },
        timeout=60,
    )
    result = r.json()
    return result["result"]["choices"][0]["message"]["content"]

Capture behavior

When user says something like:

• "后天上午10点有个会"
• "下个月2号我妈生日"
• "周五下午三点交报告"

Do:

1. Parse the event:
   • title
   • start datetime (Shanghai)
   • notes (optional)
   • reminders offsets (default 24h/1h/10m)
   • repeat (optional: yearly/monthly/weekly)
2. If key info is ambiguous (e.g. '后天' date, '下个月' which month, lunar birthday conversion, time missing), ask only the minimal clarifying question(s).
3. Write/update the event in reminders/events.yml.
4. Create cron jobs for each reminder time (delivery to current Telegram).

Reply style

• After scheduling: reply briefly with the resolved datetime + confirmation.
• For cancellations/changes: confirm what was changed and whether cron jobs were removed/replaced.

Queries

If user asks:

• "我最近有什么安排？"
• "下周有什么？"

Then read reminders/events.yml, compute upcoming items (Shanghai time), and summarize.

Notes / safety

• Never commit machine-specific secrets (keep them in LOCAL_CONFIG.md, already gitignored).
• For lunar birthdays: store the canonical lunar date + the computed solar date for the target year; ask how to handle leap months when needed.