@nomadamas/k-skill 0.2.3 → 0.2.4

package/skills/catchtable-sniper/instruction.md

@@ -1,270 +0,0 @@
-# catchtable-sniper
-
-## 📋 기본 정보
-
-- **스킬명**: catchtable-sniper
-- **라이선스**: MIT
-- **단계**: v1
-- **카테고리**: lifestyle / food
-- **로케일**: ko-KR
-- **요구사항**: Chrome MCP, 캐치테이블 로그인된 Chrome 세션
-
----
-
-## 🎯 주요 기능
-
-캐치테이블에서 원하는 식당의 빈자리(취소 슬롯)를 30초 간격으로 감시하다가 발견하는 즉시 자동 예약합니다.  
-멀티 타겟 동시 감시, 예약 오픈런 모드, 인원 유연 매칭, Dry-run 알림 전용 모드를 지원합니다.
-
----
-
-## ✅ 적합한 사용 사례
-
-- `"온지음 5월 토요일 저녁 2인 빈자리 나오면 예약해줘"`
-- `"온지음, 밍글스, 라연 중 5월 주말 2인 아무데나 먼저 뜨는 거 잡아줘"` ← 멀티 타겟
-- `"라연 5월 예약 오픈이 4월 30일 오전 10시야, 그때 맞춰서 잡아줘"` ← 오픈런 모드
-- `"스시야마 이번달 안에 2인 — 못 잡으면 4인 있으면 알려줘"` ← 인원 유연
-- `"밍글스 빈자리 뜨면 예약은 내가 할게 알림만 줘"` ← Dry-run 모드
-- `"https://app.catchtable.co.kr/ct/shop/mingles 토요일 4명 자동예약"`
-
----
-
-## ❌ 부적합한 사용 사례
-
-- 로그인 자동화 (카카오/네이버 로그인은 직접 해야 함)
-- 선결제 식당의 결제 정보 자동 입력 (결제 단계는 사람이 직접)
-- 캐치테이블 외 플랫폼 예약 (네이버 예약, 식신 등)
-- 30초 미만 폴링 간격 (서버 부하 방지)
-
----
-
-## 🔧 기술 요구사항
-
-- **Chrome MCP** 연결 필수
-- 캐치테이블(`app.catchtable.co.kr`)에 **로그인된 Chrome 세션** 필요
-- 별도 API 키, 패키지 설치 불필요
-
----
-
-## 🔐 인증 처리
-
-이 스킬은 이미 Chrome에 로그인된 세션을 그대로 사용합니다.  
-로그인 정보를 스킬에 전달하지 않습니다.
-
-로그인 안 된 경우:
-```
-"캐치테이블에 로그인되어 있지 않습니다.
- Chrome에서 캐치테이블에 카카오/네이버 로그인 후 다시 실행해주세요."
-```
-→ 스킬 중단. 로그인 자동화 없음.
-
----
-
-## 🗂️ 입력 파싱
-
-사용자 입력에서 다음을 추출한다:
-
-| 항목 | 예시 | 필수 여부 |
-|------|------|----------|
-| 식당명 또는 URL | `"온지음"` / `app.catchtable.co.kr/ct/shop/onjium` | 필수 (복수 가능) |
-| 날짜 | `"5월 3일"`, `"이번 주 토요일"`, `"5월 주말 전체"` | 필수 |
-| 인원 | `"2명"`, `"4인"` | 필수 |
-| 시간대 | `"저녁"`, `"19시 이후"` | 선택 (없으면 전체) |
-| 모드 | `"알림만"`, `"dry-run"` | 선택 (없으면 자동예약) |
-| 인원 유연 | `"2인 없으면 4인도 괜찮아"` | 선택 |
-| 오픈 시간 | `"4월 30일 오전 10시 오픈"` | 선택 (오픈런 모드) |
-| 폴링 간격 | `"30초마다"` | 선택 (기본: 30초) |
-
-**멀티 타겟 감지**: 식당명이 쉼표/슬래시로 구분되거나 "중 아무데나", "먼저 뜨는 거" 표현이 있으면 멀티 타겟 모드로 전환.
-
----
-
-## 📊 실행 플로우
-
-### STEP 1 — 브라우저 준비 및 로그인 확인
-
-Chrome MCP로 캐치테이블 접속:
-```
-navigate: https://app.catchtable.co.kr
-```
-MY 탭에서 로그인 상태 확인. 미로그인 시 중단.
-
----
-
-### STEP 2 — 모드 분기
-
-```
-입력 파싱 완료
- ├─ 오픈 시간 명시됨 → STEP 2-A (오픈런 모드)
- └─ 오픈 시간 없음  → STEP 2-B (취소 스나이핑 모드)
-```
-
-#### STEP 2-A: 오픈런 모드
-
-예약 오픈 시간까지 대기:
-```
-[10:00:00 오픈 예정] 현재 09:58:42 — 77초 후 오픈
-[10:00:00] ✅ 오픈 시각 도달 — 즉시 예약 시도
-```
-오픈 시각 정각에 날짜 선택 → 슬롯 클릭 → 예약 폼 진입.  
-슬롯이 이미 마감이면 → 취소 스나이핑 모드(STEP 2-B)로 자동 전환.
-
-#### STEP 2-B: 취소 스나이핑 모드 (폴링 루프)
-
-```
-while 빈자리 없음:
-    {폴링 간격}초 대기
-    페이지 새로고침 또는 날짜 재클릭
-    슬롯 파싱
-    빈자리 발견 → STEP 3
-```
-
----
-
-### STEP 3 — 멀티 타겟 처리
-
-**단일 타겟**: 해당 식당 슬롯 확인.
-
-**멀티 타겟**: 지정된 식당들을 순차 순회하며 슬롯 확인.
-```
-[14:23:15] 온지음 5/3 확인 중... 없음
-[14:23:17] 밍글스 5/3 확인 중... 없음
-[14:23:19] 라연 5/3 확인 중... 없음 (30초 후 재시도)
-[14:23:49] ✅ 밍글스 5/3 19:30 빈자리 발견! — 예약 시작
-```
-한 곳에서 슬롯 발견 시 나머지 감시 즉시 중단 → 발견된 식당 예약 진행.
-
----
-
-### STEP 4 — 인원 유연 매칭
-
-지정 인원(예: 2인) 슬롯이 없을 경우:
-
-```
-if 인원_유연 == True:
-    대안_인원(예: 4인) 슬롯 확인
-    발견 시:
-        "2인 슬롯은 없지만 4인 슬롯(19:00)이 있습니다.
-         4인으로 예약할까요? (예/아니오)"
-    → 사용자 확인 후 진행
-```
-
----
-
-### STEP 5 — 예약 진행 (모드 분기)
-
-**Dry-run 모드** (`"알림만"` / `"dry-run"` 입력 시):
-```
-✅ 빈자리 발견! 예약은 진행하지 않습니다.
-식당: 밍글스
-날짜: 5월 3일(토)
-시간: 19:30
-인원: 2명
-→ 지금 바로 예약하시겠습니까? (예/아니오)
-```
-→ 예약 여부는 사람이 결정.
-
-**자동예약 모드** (기본):
-
-빈 슬롯 버튼 즉시 클릭 → 예약 폼 진입.
-
-폼 자동 입력:
-- 인원수: 지정한 인원 선택
-- 방문 목적: "식사" (기본값)
-- 주의사항 동의: 전체 동의 체크
-- 예약자 정보: 앱 저장 정보 자동 사용
-
-**선결제 식당인 경우**:
-```
-"빈자리를 발견했습니다! 결제가 필요합니다.
- 결제 금액: {금액}원
- 지금 결제를 진행할까요? (예/아니오)"
-```
-→ 결제 정보 자동 입력 없음. 사용자 확인 후 결제 진행.
-
-**무료 예약**: "예약하기" 최종 확인 버튼 클릭.
-
----
-
-### STEP 6 — 완료 확인
-
-```
-🎉 예약 완료!
-
-식당: {식당명}
-날짜: {날짜}
-시간: {시간}
-인원: {인원}명
-모드: {자동예약 / Dry-run}
-예약번호: {예약번호}
-
-캐치테이블 앱 > MY > 예약내역에서 확인 가능합니다.
-```
-
----
-
-## 💡 중간 상태 출력 형식
-
-```
-[14:23:15] 밍글스 5/3 저녁 슬롯 확인 중... 빈자리 없음 (30초 후 재시도)
-[14:23:45] 온지음 5/3 저녁 슬롯 확인 중... 빈자리 없음
-[14:24:15] ✅ 밍글스 5/3 19:30 (2인) 빈자리 발견! — 예약 시작
-```
-
----
-
-## ⚙️ 설정값
-
-| 항목 | 기본값 | 범위 |
-|------|--------|------|
-| 폴링 간격 | 30초 | 30초 이상 |
-| 최대 감시 시간 | 2시간 | — |
-| 멀티 타겟 최대 수 | 5개 | — |
-
-2시간 초과 시:
-```
-"2시간 동안 빈자리가 없었습니다. 계속 시도할까요? (예/아니오)"
-```
-
----
-
-## 🚨 에러 핸들링
-
-| 상황 | 대응 |
-|------|------|
-| 식당 페이지 404 | "식당을 찾을 수 없습니다. 이름을 다시 확인해주세요." |
-| 예약 오픈 전 | 오픈 일정 안내 후 오픈런 모드로 전환 제안 |
-| 슬롯 클릭 후 이미 마감 | 즉시 재폴링 재개 |
-| 네트워크 오류 | 10초 후 재시도, 3회 연속 실패 시 사용자 알림 |
-| 멀티 타겟 중 일부 404 | 해당 식당 제외, 나머지 계속 감시 |
-| 2시간 초과 | "계속 시도할까요?" 확인 후 연장 또는 종료 |
-
----
-
-## ✨ 완료 기준
-
-다음 중 하나:
-- 예약 완료 화면 확인 + 예약번호 수집
-- Dry-run 모드에서 빈자리 발견 및 사용자 알림 완료
-- 사용자가 명시적으로 중단 요청
-
----
-
-## 사용 예시
-
-```
-"온지음 5월 10일 저녁 2인 빈자리 나오면 예약해줘"
-"온지음, 밍글스, 라연 5월 토요일 저녁 2인 중 아무데나 먼저 뜨는 거 잡아줘"
-"라연 5월 예약이 4월 30일 오전 10시 오픈이야, 그때 맞춰 2인 잡아줘"
-"스시야마 이번달 2인 — 없으면 4인도 괜찮아, dry-run으로"
-"https://app.catchtable.co.kr/ct/shop/mingles 토요일 4명 자동예약"
-```
-
----
-
-## ⚠️ 주의사항
-
-- Chrome에 캐치테이블 로그인 세션이 있어야 동작합니다.
-- 선결제 식당의 결제 정보는 직접 입력해야 합니다.
-- 폴링 간격은 최소 30초를 유지합니다 (서버 부하 방지).
-- 캐치테이블 이용약관을 준수하는 범위에서 사용하세요.

package/skills/catchtable-sniper/references/TRADEMARK-LEGAL-STATEMENT.md

@@ -1,9 +0,0 @@
-# 상표 사용 법적 고지 — `catchtable-sniper`
-
-이 스킬에서 `캐치테이블` 및 `Catchtable` 명칭은 예약 가능 시간 조회와 공식 예약 흐름의 **대상 서비스**를 식별하기 위해 사용한다. k-skill의 출처나 운영주체를 캐치테이블 운영사로 표시하려는 사용이 아니다.
-
-대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
-
-따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 저작권, 데이터베이스권, 부정경쟁방지법, 약관·계약, 개인정보 또는 접근 방식의 적법성을 판단하지 않는다.
-
-전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)

package/skills/catchtable-sniper/skill.json

@@ -1,9 +0,0 @@
-{
-  "name": "catchtable-sniper",
-  "description": "Monitor Catchtable for open reservation slots and attempt booking using a logged-in Chrome session. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.",
-  "profiles": [
-    "browser",
-    "action:booking"
-  ],
-  "frontmatter": "name: catchtable-sniper\ndescription: Monitor Catchtable for open reservation slots and attempt booking using a logged-in Chrome session. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.\nlicense: MIT\nmetadata:\n  category: lifestyle\n  subcategory: food\n  locale: ko-KR\n  phase: v1\n  requires:\n    - Chrome MCP\n    - Logged-in Catchtable Chrome session"
-}

package/skills/hipass-receipt/instruction.md

@@ -1,97 +0,0 @@
-# 하이패스 영수증 발급
-
-## What this skill does
-
-공식 하이패스 홈페이지(`https://www.hipass.co.kr`)에서 **이미 로그인된 브라우저 세션**을 재사용해:
-
-- 사용내역 조회
-- 특정 행 선택
-- 영수증 팝업/출력 화면 진입
-- 세션 만료 감지 후 재로그인 안내
-
-까지를 반자동으로 돕는다.
-
-## Hard limits
-
-- **로그인은 반드시 사용자가 직접 해야 한다.**
-- 이 스킬은 **로그인된 세션에서만** 동작한다.
-- ID/PW, 인증코드, OTP, 공동인증서 절차를 자동 입력하지 않는다.
-- `JSESSIONID` 쿠키만 저장해 장시간 재사용하는 방식은 지원하지 않는다.
-- 권장 세션 형태는 **Playwright persistent context** 또는 Chrome `user-data-dir` / remote-debugging 재사용이다.
-- **세션이 만료되면 즉시 중단하고 다시 로그인**해야 한다.
-
-## Why this design
-
-현재 공개 페이지 기준으로:
-
-- 로그인 페이지와 메인 페이지에 `session_time=1200` 이 노출된다.
-- 세션 연장은 `/comm/sessionCheck.do`
-- 세션 종료는 `/comm//sessionout.do`
-- 미로그인/세션 종료 보호 응답은 `mgs_type 11/12` 후 `/comm/lginpg.do` 로 이동한다.
-- 사용내역 조회는 `/usepculr/InitUsePculrTabSearch.do` → `hpForm` submit → `/usepculr/UsePculrTabSearchList.do` 흐름이다.
-- 영수증은 `/usepculr/UsePculrReceiptPrint.do` 팝업 진입으로 이어진다.
-
-즉 v1은 **“로그인된 Chrome 세션 재사용”** 이 가장 현실적이다.
-
-## Prerequisites
-
-- macOS 또는 Chrome 실행 가능한 환경
-- `npm install hipass-receipt` 또는 이 레포에서 `npm install` (`playwright-core` 포함)
-- Chrome 원격 디버깅 포트 사용 가능
-- 사용자가 직접 하이패스 로그인 가능
-
-## Workflow
-
-### 1. 전용 Chrome 프로필로 로그인 브라우저를 띄운다
-
-```bash
-hipass-receipt chrome-command --profile-dir "$HOME/.cache/k-skill/hipass-chrome" --debugging-port 9222
-```
-
-위 명령이 출력한 Chrome 실행문으로 브라우저를 띄운 뒤, 사용자가 직접 `https://www.hipass.co.kr/comm/lginpg.do` 에 로그인한다.
-
-### 2. 사용내역을 조회한다
-
-```bash
-hipass-receipt list \
-  --cdp-url http://127.0.0.1:9222 \
-  --start-date 2026-04-01 \
-  --end-date 2026-04-07 \
-  --page-size 30
-```
-
-- 카드사/암호화 카드번호를 알고 있으면 `--encrypted-card-number` 등으로 더 좁힐 수 있다.
-- `--encrypted-card-number` 는 CLI의 기존 `--ecd-no` 별칭이다.
-- 결과 JSON에서 `rowIndex` 를 확인한다.
-
-### 3. 특정 row의 영수증 팝업을 연다
-
-```bash
-hipass-receipt receipt \
-  --cdp-url http://127.0.0.1:9222 \
-  --start-date 2026-04-01 \
-  --end-date 2026-04-07 \
-  --row-index 1
-```
-
-- 선택한 행의 `영수증`/`출력` control 을 클릭한다.
-- 팝업이 열리면 URL/title 을 반환한다.
-
-## Response policy
-
-- “로그인 필수”, “세션 만료 시 재로그인 필요”를 항상 명확히 적는다.
-- 하이패스 계정 비밀번호를 받아 저장하거나 새 env var를 만들지 않는다.
-- 세션이 만료됐으면 즉시 실패시키고 `/comm/lginpg.do` 재로그인만 안내한다.
-- v1 범위를 넘어서는 완전 무인 로그인 유지/백그라운드 재인증은 약속하지 않는다.
-
-## Verification
-
-- 자동 검증: fixture 기반 query/parser/session-detection 테스트
-- smoke 검증: `hipass-receipt fixture-demo --fixture ...`
-- 최종 실서비스 검증: **로그인된 세션으로 수동 smoke test**
-
-## Done when
-
-- 로그인된 세션으로 사용내역 조회가 가능하다.
-- 특정 row를 선택해 영수증 팝업 진입을 시도할 수 있다.
-- 세션 종료 응답을 감지하면 재로그인을 요구한다.

package/skills/hipass-receipt/references/TRADEMARK-LEGAL-STATEMENT.md

@@ -1,9 +0,0 @@
-# 상표 사용 법적 고지 — `hipass-receipt`
-
-이 스킬에서 `하이패스` 및 `Hi-Pass` 명칭은 통행료 사용내역·영수증 조회의 **대상 공식 서비스**를 식별하기 위해 사용한다. k-skill의 출처나 운영주체를 하이패스 운영기관으로 표시하려는 사용이 아니다.
-
-대법원 2005. 6. 10. 선고 [2005도1637 판결](https://www.law.go.kr/LSW/precInfoP.do?precSeq=83920)은 타인의 표장을 출처표시가 아니라 상품 기능 또는 적용 기종을 밝히기 위해 사용하고 상표 사용으로 인식될 수 없는 경우 침해가 아니라고 판시했다. [상표법 제2조](https://www.law.go.kr/법령/상표법/제2조), [제89조](https://www.law.go.kr/법령/상표법/제89조), [제90조](https://www.law.go.kr/법령/상표법/제90조), [제108조](https://www.law.go.kr/법령/상표법/제108조)와 대법원 [2011다18802](https://www.law.go.kr/LSW/precInfoP.do?precSeq=167457), [2019후10418](https://law.go.kr/LSW/precInfoP.do?mode=0&precSeq=230725) 판결에 따라 실제 거래계에서 출처표시로 기능하는지는 표시 태양과 사용 경위 등을 종합해 판단해야 한다.
-
-따라서 이 명칭은 필요한 범위의 평문으로만 사용하고, 별도 근거 없이 로고, 공식·제휴·후원·인증·파트너 표현을 사용하지 않는다. 각 상표의 권리는 해당 권리자에게 있다. 이 문서는 저작권, 데이터베이스권, 부정경쟁방지법, 약관·계약, 개인정보 또는 접근 방식의 적법성을 판단하지 않는다.
-
-전체 검토: [제3자 상표의 기능 설명·호환 대상 표시 검토](https://github.com/NomaDamas/k-skill/blob/dev/docs/legal/trademark-use-review.md)

package/skills/hipass-receipt/skill.json

@@ -1,10 +0,0 @@
-{
-  "name": "hipass-receipt",
-  "description": "공식 하이패스 홈페이지에서 사용자가 직접 로그인한 Chrome 세션을 재사용해 사용내역 조회와 영수증 팝업 진입을 돕는다. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.",
-  "profiles": [
-    "vault",
-    "browser",
-    "action:account"
-  ],
-  "frontmatter": "name: hipass-receipt\ndescription: 공식 하이패스 홈페이지에서 사용자가 직접 로그인한 Chrome 세션을 재사용해 사용내역 조회와 영수증 팝업 진입을 돕는다. 돌쇠에서는 공식 표면을 통한 후속 액션까지 진행한다.\nlicense: MIT\nmetadata:\n  category: transport\n  locale: ko-KR\n  phase: v1"
-}