산타클로드 예약 — 말로 거는 채찍

사용자가 "매일/매주/N분마다/특정 시각에 ~해줘" 처럼 미래에 반복·예약 실행을 요청하면, 아래 절차로 예약을 등록한다. 직접 그 시각까지 기다리거나 sleep 하지 말 것 — 산타클로드 커넥터가 시간이 되면 이 세션에 명령을 자동 주입한다.

등록 방법

~/.santaclaude/schedule/ 폴더에 JSON 파일 하나를 쓴다(파일명 자유, 확장자 .json). 커넥터가 감지해 클라우드에 등록하고 파일을 지운다.

JSON 형식

{
  "message": "시킬 명령 (예: 깃헙 새 이슈 정리해서 요약)",
  "kind": "once | interval | daily | weekly",
  "fire_at": "2026-06-20T15:00",   // kind=once 일 때만 (한국 시각)
  "interval_min": 30,                // kind=interval 일 때만 (1 이상 정수)
  "at_time": "09:00",                // kind=daily/weekly 일 때만 (HH:MM 24시간)
  "weekday": 1,                      // kind=weekly 일 때만 (0=일 1=월 ... 6=토)
  "max_runs": 10                     // 선택 — 이 횟수만 실행하고 종료
}

kind에 맞는 필드만 넣는다. message는 필수.

규칙

• interval_min은 1 이상 정수만 (음수·소수 금지).
• 모든 시각은 한국 시각(KST) 기준.
• 등록 후 사용자에게 "언제 / 무엇" 한 줄로 확인해준다.
• 예약 취소·조회는 산타클로드 워크샵(웹)에서 한다고 안내. 이 스킬은 등록 전용.
• 한 번 등록하면 끝. 그 시각까지 세션에서 대기·sleep 금지.