mirrors/k-skill
2
0
Fork 0
mirror of https://github.com/NomaDamas/k-skill.git synced 2026-06-24 02:04:11 +00:00
Code Issues Projects Releases Packages Wiki Activity
k-skill/docs/roadmap.md
Jeffrey (Dongkyu) Kim b8ea339446
 Feature/#58 (#70) 
* Add an official KIPRIS patent-search skill for Korean IP lookups

Issue #58 adds a bundled stdlib Python helper plus install/setup/docs coverage
for KIPRIS Plus keyword search and application-number detail lookup. The
implementation keeps auth explicit via KIPRIS_PLUS_API_KEY -> ServiceKey and
locks the repo contract with doc/install and regression tests.

Constraint: KIPRIS Plus requires a per-user ServiceKey and no valid key was available for live success-path runs
Constraint: No new dependencies allowed for bundled skill helpers
Rejected: Add a new npm/python workspace | docs+helper pattern already fits repo and keeps install payload lighter
Confidence: high
Scope-risk: moderate
Reversibility: clean
Directive: Keep the helper aligned with official KIPRIS Plus XML fields and ServiceKey naming before widening the skill surface
Tested: python3 scripts/patent_search.py --help; python3 scripts/patent_search.py --query '배터리' --service-key dummy; python3 scripts/patent_search.py --application-number 1020240001234 --service-key dummy; PYTHONPATH=.:scripts python3 -m unittest scripts.test_patent_search; node --test scripts/skill-docs.test.js; npm run lint; npm run typecheck; npm test
Not-tested: Successful live KIPRIS search with a valid production ServiceKey
Related: #58

* Accept copied KIPRIS portal keys without request corruption

KIPRIS Plus users commonly paste the percent-encoded ServiceKey shown by the
portal. The helper now normalizes that key once before query serialization,
adds regression coverage for explicit and env-driven inputs, and clarifies the
documentation so copied portal keys remain valid instead of being double-
encoded on the wire.

Constraint: KIPRIS Plus still expects the standard ServiceKey query parameter contract
Rejected: Preserve raw percent signs during urlencode only for ServiceKey | more brittle than normalizing once at the boundary
Confidence: high
Scope-risk: narrow
Reversibility: clean
Directive: Keep ServiceKey normalization at the input boundary so future request-building changes do not reintroduce double-encoding
Tested: python3 scripts/patent_search.py --help; python3 scripts/patent_search.py --query '배터리' --service-key dummy; python3 scripts/patent_search.py --application-number 1020240001234 --service-key dummy; PYTHONPATH=.:scripts python3 -m unittest scripts.test_patent_search; node --test scripts/skill-docs.test.js; npm run lint; npm run typecheck; npm test
Not-tested: Live KIPRIS Plus lookup with a real KIPRIS_PLUS_API_KEY

* Record fresh verification for the approved KIPRIS key fix

The approved ServiceKey normalization fix is already present on feature/#58, so no further code edits were necessary. This empty follow-up commit records the requested rerun verification and keeps PR #70 moving without reopening a settled implementation path.

Constraint: Existing branch head already contains the approved code and docs fix
Rejected: Invent an extra code/doc change just to produce a non-empty diff | unnecessary risk after approval
Confidence: high
Scope-risk: narrow
Reversibility: clean
Directive: Do not change ServiceKey handling again without reproducing the percent-encoded portal-key path
Tested: python3 scripts/patent_search.py --help; python3 scripts/patent_search.py --query '배터리' --service-key dummy; python3 scripts/patent_search.py --application-number 1020240001234 --service-key dummy; PYTHONPATH=.:scripts python3 -m unittest scripts.test_patent_search; node --test scripts/skill-docs.test.js; npm run lint; npm run typecheck; npm test
Not-tested: Live KIPRIS request with a real KIPRIS_PLUS_API_KEY

* Record fresh Issue #58 verification without reopening the approved fix

The approved KIPRIS ServiceKey normalization change was already present on
feature/#58, so this follow-up records a fresh verification point for the
existing implementation instead of reopening the code path.

Constraint: User requested commit/push + PR follow-up on the existing issue branch
Rejected: Reopen the already-approved implementation | no new blocker or code defect remained
Confidence: high
Scope-risk: narrow
Reversibility: clean
Directive: If this helper changes again, preserve support for percent-encoded portal keys and keep the URL serialization regression coverage intact
Tested: patent helper smoke commands, patent/doc regression tests, lint, typecheck, full npm test suite, encoded-key reproduction, architect review
Not-tested: Live KIPRIS success path with a real KIPRIS_PLUS_API_KEY

* fix: decode percent-encoded ServiceKey in build_search_params and build_detail_params

The low-level helper functions still double-encoded percent-encoded
KIPRIS portal keys when callers bypassed resolve_service_key(). Apply
unquote() at the param-builder boundary so copied portal keys work
regardless of call path.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* chore: trigger GitHub merge-status recalculation

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 18:30:03 +09:00

6 KiB
Raw Blame History

Roadmap

v1 shipped first

빠르게 만들 수 있고, 공개 패키지나 공식 Open API 위에 얹을 수 있는 스킬부터 넣는다.

  • SRT
  • KTX
  • KBO 경기 결과
  • K리그 경기 결과 조회 스킬 출시
  • LCK 경기 분석 스킬 출시
  • 토스증권 조회 스킬 출시
  • 로또 당첨번호
  • 서울 지하철 도착 정보
  • 한국 날씨 조회 스킬 출시
  • 사용자 위치 미세먼지 조회 스킬 출시
  • 한강 수위 정보 조회 스킬 출시
  • 한국 법령 검색 스킬 출시
  • 한국 부동산 실거래가 조회 스킬 출시
  • 한국 주식 정보 조회 스킬 출시
  • 조선왕조실록 검색 스킬 출시
  • 한국 특허 정보 검색 스킬 출시
  • 근처 가장 싼 주유소 찾기 스킬 출시
  • 우편번호 검색
  • 근처 블루리본 맛집 스킬 출시
  • 근처 술집 조회 스킬 출시
  • 택배 배송조회 스킬 출시 (CJ대한통운 / 우체국)
  • 다이소 상품 조회 스킬 출시
  • 올리브영 검색 스킬 출시
  • 쿠팡 상품 검색 스킬 출시 (coupang-mcp 기반)
  • 번개장터 검색 스킬 출시
  • 중고차 가격 조회 스킬 출시
  • 한국어 맞춤법 검사 스킬 출시

v1.5 candidates

진짜 우선순위 높은 후보

정부24 조회/발급/신청

  • 장점: 등본·초본, 전입신고, 자동차등록원부, 건축물대장, 토지대장, 각종 사실확인, 보조금24까지 한 축으로 묶을 수 있다
  • 이유: “한국 생활 운영체제”에 가장 가까운 범용 허브 후보다

홈택스/손택스 도우미

  • 장점: 세금 납부, 종합소득세·양도소득세 신고 보조, 연말정산 계산, 각종 세무 증명까지 커버할 수 있다
  • 이유: 사용 빈도는 낮아도 필요할 때 고통이 커서 만족도가 높다

토스 생활금융 스킬

  • 장점: 계좌·카드 모아보기, 송금, 사기계좌 조회, 자동이체 예약, 신용점수 확인, 세금 납부, 등초본 발급까지 이어질 수 있다
  • 이유: 금융 + 생활 민원을 한곳에서 묶는 허브 포지션이 좋다

카카오페이 송금/결제/청구서

  • 장점: 송금, 결제, 멤버십, 자산관리, 청구서 등 생활 결제 액션이 넓다
  • 이유: 카톡과 연결되는 체감 가치가 커서 대중성이 높다

카카오 T 이동 허브

  • 장점: 택시, 대리, 주차, 기차, 시외버스, 퀵·택배까지 이동 관련 수요를 넓게 묶을 수 있다
  • 이유: 이동/귀가/주차/예약을 하나의 생활 축으로 만들기 좋다

네이버지도 / TMAP 길찾기·장소저장·교통

  • 장점: 길찾기에서 출발해 장소 저장, 리뷰, 추천, 대중교통, 주차, 대리까지 확장 폭이 넓다
  • 이유: 네이버 생활 서비스와 TMAP 이동 서비스 모두로 확장 가능한 교통 베이스다

배달의민족 / 요기요 주문

  • 장점: 음식배달뿐 아니라 장보기·쇼핑·선물까지 붙여서 즉시 생활구매 축으로 키울 수 있다
  • 이유: “배달”보다 넓은 실사용 구매 액션으로 이어진다

병원 접수/예약 스킬

  • 장점: 사전 접수, 주변 병원 찾기, 지금 문 연 병원 찾기 흐름이 명확하다
  • 이유: 실사용 가치가 높고 특히 부모층 체감이 크다

택배 예약 / 추가 택배사 확장

  • 장점: 기본 배송조회는 delivery-tracking 으로 선출시했고, 다음 단계는 예약/반품/추가 택배사 확장으로 자연스럽게 이어진다
  • 이유: 한국 생활에서 반복 빈도가 높은 작업이라 조회 다음 액션까지 묶을 가치가 크다

미세먼지/황사 예보·알림 확장

  • 장점: 오늘/내일/모레 대기정보와 예보, 하루 4회 수준의 예보 갱신 같은 한국형 수요에 잘 맞는다
  • 이유: 한국 로컬 생활 스킬로 차별화가 쉽다

그다음으로 좋은 후보

모바일 신분증 발급/재발급/분실 가이드

  • 장점: 모바일 주민등록증·운전면허증 발급 흐름 정리에 특화할 수 있다
  • 이유: 한국 특화성이 강하고 가이드형 스킬로 출발하기 좋다

버스/지하철 도착정보 조회

  • 장점: 주변 정류소, 지하철, 공항버스, 버스정보 조회까지 출퇴근 수요가 강하다
  • 이유: 이미 검증된 반복 조회 패턴이라 확장하기 쉽다

네이버 생활 허브

  • 장점: 날씨, 뉴스, 스포츠, 네이버페이, 가격비교, 배송, 지도, QR, 전자증명서까지 한 축으로 확장 가능하다
  • 이유: 네이버 한 축만 잘 잡아도 생활 플랫폼 허브가 된다

공과금/청구서 납부 정리

  • 장점: 카카오페이/토스와 연결해 전기·가스·통신·카드 청구서 조회/납부/알림으로 묶을 수 있다
  • 이유: 생활 결제 자동화의 실용성이 높다

네이버페이/포인트/가격비교

  • 장점: 결제/포인트/배송/가격비교를 묶는 쇼핑형 허브 후보가 된다
  • 이유: 스마트스토어와 별도의 큰 축으로 키울 수 있다

한국 기상청 특보/중기예보 확장

  • 장점: 이미 선출시한 한국 날씨 조회 스킬에 특보/중기예보를 붙여 생활 정보 깊이를 늘릴 수 있다
  • 이유: 단기예보 다음 단계로 자연스럽게 확장 가능하다

기존 탐색 후보

네이버 스마트스토어

  • 장점: 실제 수요가 크다
  • 보류 이유: 공식 Commerce API auth/setup이 가볍지 않다

다나와 가격 비교

  • 장점: 검색 수요가 명확하다
  • 보류 이유: 안정적인 공개 CLI를 아직 못 찾았다

카카오톡 조회/전송

  • 장점: 어그로가 매우 강하다
  • 보류 이유: 계정/정책 리스크가 크다

HWP 고급 편집 자동화

  • 장점: 기본 변환/추출은 이미 hwp 스킬로 다루고 있어 확장 가치가 높다
  • 보류 이유: 고급 양식, 배포용 서식, 보안 모듈까지 포함한 Windows 직접 제어는 추가 검증이 더 필요하다

당근 자동 거래

  • 장점: 바이럴 포텐셜이 높다
  • 보류 이유: 계정 제재 리스크와 UI automation 의존도가 높다