mirror of
https://github.com/NomaDamas/k-skill.git
synced 2026-09-14 16:37:18 +08:00
Jeffrey (Dongkyu) Kim
ef2c69b81c
Agent environments (OpenClaw, Claude Code, Codex) assume users delegate credentials to the agent. sops+age added setup friction without real security benefit since the agent decrypts on every call anyway. New model: skills declare required env var names; how they are supplied is up to the agent (own vault, shell env, or ~/.config/k-skill/secrets.env as the default fallback with 0600 permissions). Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
151 lines
4.1 KiB
Markdown
151 lines
4.1 KiB
Markdown
---
|
|
name: srt-booking
|
|
description: Search, reserve, inspect, and cancel SRT tickets in Korea with the SRTrain library. Use when the user asks for SRT seat availability, booking, canceling, or sold-out retry plans.
|
|
license: MIT
|
|
metadata:
|
|
category: travel
|
|
locale: ko-KR
|
|
phase: v1
|
|
---
|
|
|
|
# SRT Booking
|
|
|
|
## What this skill does
|
|
|
|
`SRTrain` 위에서 SRT 좌석을 조회하고, 조건이 맞으면 예약과 취소까지 진행한다.
|
|
|
|
## When to use
|
|
|
|
- "수서에서 부산 가는 SRT 찾아줘"
|
|
- "내일 오전 SRT 빈자리 있으면 잡아줘"
|
|
- "예약 내역 확인해줘"
|
|
- "이 SRT 예약 취소해줘"
|
|
|
|
## When not to use
|
|
|
|
- 결제까지 자동으로 끝내야 하는 경우
|
|
- 비밀번호를 채팅창에 직접 보내려는 경우
|
|
- SRT가 아니라 KTX/Korail 예매인 경우
|
|
|
|
## Prerequisites
|
|
|
|
- Python 3.10+
|
|
- `python3 -m pip install SRTrain`
|
|
|
|
## Required environment variables
|
|
|
|
- `KSKILL_SRT_ID`
|
|
- `KSKILL_SRT_PASSWORD`
|
|
|
|
### Credential resolution order
|
|
|
|
1. **이미 환경변수에 있으면** 그대로 사용한다.
|
|
2. **에이전트가 자체 secret vault(1Password CLI, Bitwarden CLI, macOS Keychain 등)를 사용 중이면** 거기서 꺼내 환경변수로 주입해도 된다.
|
|
3. **`~/.config/k-skill/secrets.env`** (기본 fallback) — plain dotenv 파일, 퍼미션 `0600`.
|
|
4. **아무것도 없으면** 유저에게 물어서 2 또는 3에 저장한다.
|
|
|
|
기본 경로에 저장하는 것은 fallback일 뿐, 강제가 아니다.
|
|
|
|
## Inputs
|
|
|
|
- 출발역
|
|
- 도착역
|
|
- 날짜: `YYYYMMDD`
|
|
- 희망 시작 시각: `HHMMSS`
|
|
- 인원 수와 승객 유형
|
|
- 좌석 선호: 일반실 / 특실
|
|
|
|
## Workflow
|
|
|
|
### 0. Install the package globally when missing
|
|
|
|
`python3 -c 'import SRT'` 가 실패하면 다른 구현으로 우회하지 말고 전역 Python 패키지 설치를 먼저 시도한다.
|
|
|
|
```bash
|
|
python3 -m pip install SRTrain
|
|
```
|
|
|
|
### 1. Ensure credentials are available
|
|
|
|
`KSKILL_SRT_ID`, `KSKILL_SRT_PASSWORD` 환경변수가 설정되어 있는지 확인한다. 없으면 위 credential resolution order에 따라 확보한다.
|
|
|
|
시크릿이 없다는 이유로 웹사이트를 직접 긁거나 다른 비공식 경로를 찾지 않는다.
|
|
|
|
### 2. Search first
|
|
|
|
먼저 조회해서 후보를 요약한다.
|
|
|
|
```bash
|
|
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. Summarize options before side effects
|
|
|
|
예약 전에는 항상 아래를 짧게 정리한다.
|
|
|
|
- 출발/도착 시각
|
|
- 일반실/특실 가능 여부
|
|
- 예상 운임
|
|
|
|
### 4. Reserve only after the train is fixed
|
|
|
|
예약은 부작용이 있으므로 정확한 열차를 고른 뒤에만 진행한다.
|
|
|
|
```bash
|
|
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. Inspect or cancel
|
|
|
|
취소 전에는 대상 예약을 다시 식별한다.
|
|
|
|
```bash
|
|
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
|
|
```
|
|
|
|
## Done when
|
|
|
|
- 조회 요청이면 후보 열차가 정리되어 있다
|
|
- 예약 요청이면 예약 결과, 운임, 구입기한이 확인되어 있다
|
|
- 취소 요청이면 어떤 예약을 취소했는지 명확하다
|
|
|
|
## Failure modes
|
|
|
|
- 로그인 오류: 계정 정보나 SRT site policy 변경 가능성 확인
|
|
- 매진: 다른 시간대나 좌석 타입으로 재조회
|
|
- 네트워크 오류: 짧게 재시도하되 aggressive polling은 피하기
|
|
|
|
## Notes
|
|
|
|
- `SRTrain`은 SRT 전용 라이브러리라서 스킬 의도가 더 선명하다
|
|
- 결제 완료까지는 자동화하지 않는다
|
|
- 자동 재시도 루프는 계정 보호 차원에서 짧고 보수적으로 유지한다
|