booking-config

予約設定

CLI で Cal.com のイベントタイプ、スケジュール、予約可能時間帯を設定します。

自己進化型スキル：このスキルは使用するたびに改善されます。手順が誤っている、パラメーターが変化している、または回避策が必要だった場合は、先送りせず、このファイルをすぐに修正してください。実際に再現可能な問題がある場合のみ更新してください。

必須の事前確認

ステップ 1：CLI バイナリを確認する

ls -la "$HOME/.claude/plugins/marketplaces/cc-skills/plugins/calcom-commander/scripts/calcom-cli/calcom" 2>/dev/null || echo "BINARY_NOT_FOUND"

ステップ 2：環境を確認する

echo "CALCOM_OP_UUID: ${CALCOM_OP_UUID:-NOT_SET}"
echo "CALCOM_API_URL: ${CALCOM_API_URL:-NOT_SET}"

すべて SET である必要があります。 NOT_SET のものがある場合は、まずセットアップコマンドを実行してください。

ステップ 3：API アクセスをテストする

CALCOM_CLI="$HOME/.claude/plugins/marketplaces/cc-skills/plugins/calcom-commander/scripts/calcom-cli/calcom"
$CALCOM_CLI event-types list 2>&1 | head -3

イベントタイプの管理

イベントタイプを作成する

AskUserQuestion を使用して必須項目を収集します。

AskUserQuestion({
  questions: [{
    question: "What type of booking page do you want to create?",
    header: "Event Type",
    options: [
      { label: "30-min Meeting", description: "Standard 30-minute meeting slot" },
      { label: "60-min Interview", description: "Full hour interview session" },
      { label: "15-min Quick Call", description: "Brief check-in call" },
      { label: "Custom", description: "Specify custom duration and details" }
    ],
    multiSelect: false
  }]
})

CALCOM_CLI="$HOME/.claude/plugins/marketplaces/cc-skills/plugins/calcom-commander/scripts/calcom-cli/calcom"

# Create event type with collected details
$CALCOM_CLI event-types create \
  --title "30min Interview" \
  --slug "interview-30" \
  --length 30 \
  --description "Screening interview for VA candidates"

イベントタイプを更新する

# Update title
$CALCOM_CLI event-types update <id> --title "Updated Title"

# Update duration
$CALCOM_CLI event-types update <id> --length 45

# Disable event type
$CALCOM_CLI event-types update <id> --hidden true

スケジュールの管理

スケジュールを一覧表示する

$CALCOM_CLI schedules list

スケジュールを作成する

# Create a weekday schedule (9am-5pm)
$CALCOM_CLI schedules create \
  --name "Business Hours" \
  --timezone "America/New_York" \
  --availability '[
    {"days": [1,2,3,4,5], "startTime": "09:00", "endTime": "17:00"}
  ]'

予約可能状況を確認する

# Check available slots for a specific date range
$CALCOM_CLI availability check \
  --event-type-id <id> \
  --start "2026-02-15" \
  --end "2026-02-20"

予約ページのよくあるパターン

候補者の選考面接

$CALCOM_CLI event-types create \
  --title "VA Screening Interview" \
  --slug "va-screening" \
  --length 30 \
  --description "BruntWork virtual assistant candidate screening" \
  --requires-confirmation true

オープンオフィスアワー

$CALCOM_CLI event-types create \
  --title "Office Hours" \
  --slug "office-hours" \
  --length 15 \
  --description "Drop-in office hours for team questions"

Webhook の管理

Webhook リレー経由でリアルタイムの Pushover 通知を受け取るために、Cal.com の Webhook を管理します。

Webhook を一覧表示する

CALCOM_API_KEY=$(op item get "$CALCOM_OP_UUID" --vault "Claude Automation" --fields password --reveal)

curl -s "https://api.cal.com/v1/webhooks?apiKey=$CALCOM_API_KEY" | python3 -m json.tool

Webhook を登録する

curl -s -X POST "https://api.cal.com/v1/webhooks?apiKey=$CALCOM_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"subscriberUrl\":\"$WEBHOOK_RELAY_URL\",\"eventTriggers\":[\"BOOKING_CREATED\",\"BOOKING_RESCHEDULED\",\"BOOKING_CANCELLED\"],\"active\":true}"

Webhook を削除する

curl -s -X DELETE "https://api.cal.com/v1/webhooks/<webhook-id>?apiKey=$CALCOM_API_KEY"

前提条件：環境内で WEBHOOK_RELAY_URL が設定されている必要があります（デーモンの場合は ~/gh/<org>/<automation-repo>/.env.launchd に設定するか、シェルでエクスポートしてください）。まず infra-deploy スキルを使用してリレーをデプロイしてください。

変更後のチェックリスト

• YAML のフロントマターが有効（description にコロンがない）
• トリガーキーワードが最新
• パスパターンでハードコードされたパスではなく $HOME を使用

実行後の振り返り

このスキルの実行後、タスクを完了する前に振り返ってください。

0. 現在の場所を確認する。 — 編集する前に、この SKILL.md の正規のパスを見つけます。
1. 何が失敗したか？ — 原因となった手順を修正します。
2. 期待以上にうまくいったことは？ — 推奨プラクティスとして追加します。
3. 何が変化したか？ — 現状に合わなくなったスクリプト、参照先、依存関係を修正します。
4. 記録する。 — 発生のきっかけ、修正内容、根拠を含む進化ログを記録します。

先送りしないでください。次回の実行では、ここに残した内容が引き継がれます。