calendar (v4)

重要 — 開始する前に、../lark-shared/SKILL.md を必ず Read ツールで読み込んでください。これには認証と権限処理に関する情報が含まれています。 重要 — すべての Shortcuts は、実行する前に必ず対応する説明ドキュメントを Read ツールで読み込んでください。コマンドを直接盲目的に呼び出すことは禁止されています。

コアシナリオ

カレンダースキルには、以下のコアシナリオが含まれています。

1. スケジュールの予約

これはカレンダースキルの最も重要なシナリオであり、ユーザーが低コストでスケジュールを予約できるようにすることが核となります。

💡 コア原則：スマートアシスタントとして、補助的な意思決定を提供し、フォーム入力機やユーザーの代理人にならないでください。

時間と日付の推論規範： 時間の推論に関わる場合、正確性を確保するために以下の規則を厳守してください。

• 週の定義：月曜日が週の最初の日、日曜日が週の最後の日です。「来週の月曜日」などの相対的な日付を計算する際は、現在の実際の日付と曜日の基準に基づいて推論し、日付の計算間違いを避けてください。
• 一日の範囲：ユーザーが「明日」や「今日」など、特定の日を漠然と指す場合、時間範囲はデフォルトで一日全体をカバーするようにしてください。夜の時間帯の予定を見落とさないように、検索範囲を自己判断で縮小することは絶対に避けてください。
• 過去の時間制約：完全に過ぎ去った時間を予約することはできません。唯一の例外は「現在時刻をまたぐ」スケジュールです。つまり、スケジュールの開始時刻が過去であっても、終了時刻が未来である場合です。

スケジュールの予約ワークフロー：

1. スマートなデフォルト値の推論

   • タイトル、参加者、所要時間にはすべてデフォルト値が存在するため、ユーザーに頻繁に確認する必要はありません。
   • 参加者：他の参加者が明確に指定されていない場合、デフォルトの参加者はユーザー自身のみとなります。特定の参加者（人、グループ、会議室）を検索して複数の結果が表示され、一意に特定できない場合は、ユーザーに選択を確認し、その設定を長期記憶として記録して、以降の自動識別を可能にする必要があります。
   • 会議室：現在、会議室の能動的な予約はサポートされていません。ただし、現在のコンテキストに会議室ID（omm_ プレフィックス）が存在し、それをスケジュールに追加する必要がある場合は除きます。
   • タイトル：会話のコンテキストに基づいて自動生成されます（例：「コミュニケーション調整」や「要件議論」）。推論できない場合は、デフォルトで「会議」となります。
   • 所要時間：会議の種類とコンテキストに基づいて動的に推論されます（例：「レビュー/報告」は60分と推論されるなど）。推論できない場合は、デフォルトで30分となります。

2. 時間の提案と補助的な意思決定（コア体験）

   • 明確な時間点がある場合（例：明日の午前10時）：関連ツール（例：lark-cli calendar +freebusy lark-calendar-freebusy）を呼び出し、まずその時間帯の参加者の空き状況を照会します（注：参加者のスケジュールのRSVPステータスが拒否の場合、その時間帯は空きとみなされます）。競合がない場合は、次の確認と作成ステップに直接進みます。競合がある場合は、ユーザーに競合状況を提示し、作成を続行するか、時間を再選択するかを尋ねます。
   • 時間帯がある場合（例：明日、午後、今週）：関連ツール（例：lark-cli calendar +suggestion lark-calendar-suggestion）を呼び出し、その時間帯におけるすべての参加者の複数の時間推奨案をユーザーに提示して選択させます。ユーザーが案を確認した後でなければ、スケジュール作成操作を実行することはできません。また、ユーザーが推奨案を選択した場合、再度空き状況を照会する必要はありません。
   • 時間情報が全くない場合：合理的な時間帯（例：「今日」または「ここ2日間」）をデフォルトで推論し、同様に複数の時間推奨案を取得してユーザーが迅速に選択できるようにします。
   • 生活系のニーズ（例：フィットネス、水泳、散歩、食事の約束、タピオカミルクティーなど。「コーヒーの約束」は仕事のシナリオとみなされます）：suggestion ツールを呼び出さないことが期待されます。適切な非勤務時間を自己推論し、ユーザーに確認を求めます。推論できない場合は、ユーザーに積極的に尋ね、ユーザーからのフィードバックを記憶として形成し、以降直接適用できるようにしてください。
   • 曖昧な意味の解消と長期記憶の構築 (Aha Moment)：ユーザー固有の時間表現習慣（例：「仕事の後」、「仕事の前」）や、午前/午後が指定されていない12時間制のような曖昧な時間シナリオに対して、主観的な憶測は厳禁です。積極的に明確化することで真の意図を明確にし、このような個別定義を長期的な好みとして蓄積し、システム認識能力の継続的な進化を促進し、最終的に「次回は理解できる」というインテリジェントな体験を実現してください。

3. 非ブロッキング実行

   • ユーザーが具体的な時間オプションを確認した後、lark-cli calendar +create --summary "..." --start "..." --end "..." --attendee-ids ... を実行します。

4. 友好的なフィードバック

   • 結果の報告：作成に成功したスケジュールの概要情報を返します。

コアコンセプト

• カレンダー（Calendar）：スケジュールのコンテナです。各ユーザーはメインカレンダー（primary calendar）を持ち、共有カレンダーを作成または購読することもできます。
• スケジュール（Event）：カレンダー内の個々のイベントエントリで、開始時刻、終了時刻、場所、タイトル、参加者などの属性を含みます。単発スケジュールと繰り返しスケジュールをサポートし、RFC5545 iCalendar国際標準に準拠しています。
• 終日スケジュール（All-day Event）：日付のみを占有し、具体的な開始/終了時刻がないスケジュールです。終了日はスケジュール時間内に含まれます。
• スケジュールインスタンス（Instance）：スケジュールの具体的な時間インスタンスで、本質的にはスケジュールの展開です。通常スケジュールと例外スケジュールは1つのInstanceに対応し、繰り返しスケジュールはN個のInstanceに対応します。時間帯で照会する際、インスタンスビューを通じて繰り返しスケジュールを個別のインスタンスに展開して返し、タイムライン上で正確に表示および管理できるようにします。
• 繰り返しルール（Rrule/Recurrence Rule）：繰り返しスケジュールの繰り返しルールを定義します。例えば、FREQ=DAILY;UNTIL=20230307T155959Z;INTERVAL=14 は14日ごとに繰り返すことを意味します。
• 例外スケジュール（Exception）：繰り返しスケジュールの中で、元の繰り返しスケジュールと一致しないスケジュールです。
• 参加者（Attendee）：スケジュールの参加者で、ユーザー、グループ、会議室リソース、外部メールアドレスなどがあります。各参加者は独立したRSVPステータスを持ちます。
• 応答ステータス（RSVP）：参加者によるスケジュール招待への返信ステータス（承諾/拒否/未定）。
• 空き時間（FreeBusy）：指定された時間帯におけるユーザーの空き状況を照会し、会議時間の調整に使用します。

リソース関係

Calendar (カレンダー)
└── Event (スケジュール)
    ├── Attendee (参加者)
    └── Reminder (リマインダー)

Shortcuts（優先的に使用することを推奨）

Shortcut は、一般的な操作を高度にカプセル化したものです（lark-cli calendar +<verb> [flags]）。Shortcut がある操作は優先的に使用してください。

+suggestion の使用

+suggestion を呼び出す前に、必ず lark-calendar-suggestion の使用説明を読み込んでください。コマンドを直接呼び出すことは禁止されています。

lark-cli calendar +suggestion --start "2026-03-10T00:00:00+08:00" --end "2026-03-10T11:00:00+08:00" --attendee-ids "ou_xxx,oc_yyy" --duration-minutes 30 # ユーザーou_xxxとグループoc_yyyのメンバーに空き時間を推奨する

API Resources

lark-cli schema calendar.<resource>.<method>   # API を呼び出す前に必ずパラメータ構造を確認してください
lark-cli calendar <resource> <method> [flags] # API を呼び出す

重要：ネイティブ API を使用する際は、schema を実行して --data / --params パラメータ構造を必ず確認してください。フィールド形式を推測しないでください。

calendars

• create — 共有カレンダーを作成する
• delete — 共有カレンダーを削除する
• get — カレンダー情報を照会する
• list — カレンダーリストを照会する
• patch — カレンダー情報を更新する
• primary — ユーザーのメインカレンダーを照会する
• search — カレンダーを検索する

event.attendees

• batch_delete — スケジュール参加者を一括削除する
• create — スケジュール参加者を追加する
• list — スケジュール参加者リストを取得する

events

• create — スケジュールを作成する
• delete — スケジュールを削除する
• get — スケジュールを取得する
• instance_view — スケジュールビューを照会する
• patch — スケジュールを更新する
• search — スケジュールを検索する

freebusys

• list — メインカレンダーのスケジュール空き状況を照会する

権限表

注意（必須）：

• 日付（時間）文字列とタイムスタンプの相互変換に関わる場合、変換の絶対的な正確性を確保するために、必ずシステムコマンドやスクリプトコードなどの外部ツールを呼び出して処理してください。違反すると深刻な論理エラーにつながります！