---
name: gooddays-calendar
description: 讀寫 GoodDays 行程與今日吉時資訊。支援登入取得 JWT、查詢 `/api/unified-events`，以及呼叫 `/api/mystical/daily` 取得今日吉時/神祕學資料。
---

# gooddays-calendar

此 skill 用於整合 GoodDays API，讓 agent 可以直接：

1. 登入 GoodDays 取得 JWT
2. 查詢未來事件（`/api/unified-events`）
3. 查詢今日吉時/神祕學資訊（`/api/mystical/daily`）
4. 用自然語言判斷是要查「吉時」還是「行程」

## API 重點
- Base URL：`GOODDAYS_BASE_URL`
- Login：`POST /auth/login`
- Mystical daily：`POST /api/mystical/daily`
- Events：`/api/unified-events`

## Mystical daily 實測格式
必填欄位：
- `year`
- `month`
- `day`

選填欄位：
- `hour`
- `userId`

範例：
```json
{"year":2026,"month":3,"day":13,"hour":9}
```

## 設定來源
從 workspace `.env` 讀取：
- `GOODDAYS_BASE_URL`
- `GOODDAYS_EMAIL`
- `GOODDAYS_PASSWORD`
- `GOODDAYS_USER_ID`

## 後續可擴充
- 新增事件建立/更新/刪除
- 將今日吉時整理成 daily-briefing 可直接引用的格式
- 與 `life-planner` / `daily-briefing` skill 串接
