SRT 予約

このスキルが実行すること

SRTrain ライブラリ上で SRT の座席を検索し、条件が合えば予約と取消まで進行します。

使用する場合

• 「ソウル駅から釜山へ向かう SRT を見つけて」
• 「明日の午前に SRT の空き席があれば予約してほしい」
• 「予約内容を確認して」
• 「この SRT 予約をキャンセルして」

使用しない場合

• 支払いまで自動的に完了させる必要がある場合
• パスワードをチャットに直接送信しようとする場合
• SRT ではなく KTX/Korail の予約の場合

前提条件

• Python 3.10+
• python3 -m pip install SRTrain

必須環境変数

• KSKILL_SRT_ID
• KSKILL_SRT_PASSWORD

認証情報の解決順序

1. 環境変数に既にあれば そのまま使用します。
2. エージェントが独自のシークレットボルト（1Password CLI、Bitwarden CLI、macOS Keychain など）を使用している場合 そこから取得して環境変数に注入してもかまいません。
3. ~/.config/k-skill/secrets.env（デフォルトのフォールバック）— プレーン dotenv ファイル、パーミッション 0600。
4. 何もない場合 ユーザーに確認して 2 または 3 に保存します。

デフォルトパスに保存することはフォールバックのみで、強制ではありません。

入力

• 出発駅
• 到着駅
• 日付：YYYYMMDD
• 希望開始時刻：HHMMSS
• 乗客数と乗客タイプ
• 座席選好：一般室 / 特室

ワークフロー

0. パッケージが見つからない場合はグローバルにインストール

python3 -c 'import SRT' が失敗した場合、別の実装で回避せず、まず グローバル Python パッケージのインストールを試みます。

python3 -m pip install SRTrain

1. 認証情報が利用可能であることを確認

KSKILL_SRT_ID、KSKILL_SRT_PASSWORD 環境変数が設定されているか確認します。なければ上記の認証情報解決順序に従って確保します。

シークレットがないという理由でウェブサイトを直接スクレイピングしたり、他の非公式ルートを探しません。

2. 最初に検索

まず検索して候補を要約します。

python3 - <<'PY'
import os
from SRT import SRT

srt = SRT(os.environ["KSKILL_SRT_ID"], os.environ["KSKILL_SRT_PASSWORD"])
trains = srt.search_train("수서", "부산", "20260328", "080000", time_limit="120000")

for idx, train in enumerate(trains[:5], start=1):
    print(idx, train)
PY

3. 副作用前にオプションを要約

予約前には常に以下を簡潔にまとめます。

• 出発/到着時刻
• 一般室/特室の利用可否
• 予想運賃

4. 列車が確定した後でのみ予約

予約は副作用があるため、正確な列車を選択した後にのみ進行します。

python3 - <<'PY'
import os
from SRT import Adult, SRT, SeatType

srt = SRT(os.environ["KSKILL_SRT_ID"], os.environ["KSKILL_SRT_PASSWORD"])
trains = srt.search_train("수서", "부산", "20260328", "080000", time_limit="120000")
reservation = srt.reserve(
    trains[0],
    passengers=[Adult(1)],
    special_seat=SeatType.GENERAL_FIRST,
)
print(reservation)
PY

5. 確認または取消

取消前に対象予約を再び識別します。

python3 - <<'PY'
import os
from SRT import SRT

srt = SRT(os.environ["KSKILL_SRT_ID"], os.environ["KSKILL_SRT_PASSWORD"])
reservations = srt.get_reservations()
print(reservations)
PY

完了したと見なす場合

• 検索リクエストの場合、候補列車がまとめられている
• 予約リクエストの場合、予約結果、運賃、購入期限が確認されている
• 取消リクエストの場合、どの予約を取消したかが明確である

失敗モード

• ログインエラー：アカウント情報または SRT サイトポリシー変更の可能性を確認
• 完売：別の時間帯または座席タイプで再検索
• ネットワークエラー：短く再試行しますが、積極的なポーリングは避けます

注釈

• SRTrain は SRT 専用ライブラリのため、スキル意図がより明確です
• 支払い完了までは自動化しません
• 自動再試行ループはアカウント保護の観点から短く保守的に維持します