Caldav Calendar

• AIエージェントに、一般的なCalDAVプロバイダー（iCloud、Google、Fastmail、Nextcloud）のカレンダーイベントを読み取り、作成、または検索させたい場合。
• GUIのないLinuxマシンで、スクリプトによるカレンダーアクセスや自動化されたカレンダーアクセスが必要な場合。
• 後続の処理やレポート作成のために、構造化されたイベント出力（日付、タイトル、UID、説明）が必要な場合。
• リモートのCalDAVサーバーに新しいイベントをプッシュし、ローカルストアとの同期を維持する必要がある場合。

• Linuxを使用していない場合 — このスキルは明示的にLinux環境を必要とします。
• リアルタイムのカレンダーストリーミングやプッシュ通知が必要な場合 — vdirsyncerはプルベースの同期ツールです。
• 完全に自動化された（非TTY）パイプラインでインタラクティブなTTYベースのイベント編集が必要な場合 — khal editはターミナルを必要とします。

vdirsyncer を使用して、iCloud、Google、Fastmail、Nextcloud、または任意の標準 CalDAV サーバーからカレンダーを同期します。イベントはオフラインでの高速アクセスのために、.ics ファイルとしてローカルに保存されます。

khal list を使用して、今日のイベント、次のN日間、特定の日付範囲、または特定の名前のカレンダーを表示します。today、tomorrow、7d などの自然言語の短縮表記をサポートしています。

khal search を使用して、同期済みのすべてのイベントをキーワードで横断検索できます。カスタムの --format 文字列を指定することで、必要なフィールド（タイトル、日付、UID、場所など）を正確に抽出できます。

khal new を使用して、任意のカレンダーに時間指定またはオールデイのイベントを作成できます。オプションで説明の追加や対象カレンダーの選択も可能です。作成後、vdirsyncer sync によって変更がリモートサーバーに送信されます。

{title}、{start-date}、{uid}、{calendar}、{location} などのプレースホルダーを使用してイベントの出力をフォーマットできます。これにより、カレンダーデータを他のツールやエージェントにパイプで渡すことが簡単になります。

khalは~/.local/share/khal/khal.dbにローカルキャッシュを保持しています。同期後にイベントが古い状態で表示される場合、キャッシュをクリアすることで、ローカルの.icsストアから強制的に再読み込みを行うことができます。

エージェントは毎朝 vdirsyncer sync を実行した後、khal list today 7d を実行して1週間のイベントを取得し、ユーザー向けに自然言語で要約します。

エージェントが自然言語で会議リクエストを受け取り、khal new でイベントを作成し、iCloud または Nextcloud に同期します — カレンダーアプリを手動で操作する必要はありません。

エージェントは、空き時間スロットの提案や新しい作業のスケジュール設定を行う前に、khal search と khal list を使用して既存の予定をカレンダーで検索します。

カスタムの --format 文字列を使用することで、エージェントは構造化されたイベントデータ（UID、タイトル、カレンダー、タイムスタンプ）を抽出し、ログ記録、レポート作成、または外部システムへの同期に活用できます。