diff --git a/.changeset/housing-subscription-reference-710.md b/.changeset/housing-subscription-reference-710.md new file mode 100644 index 00000000..6aa20018 --- /dev/null +++ b/.changeset/housing-subscription-reference-710.md @@ -0,0 +1,5 @@ +--- +"@nomadamas/k-skill": patch +--- + +민영주택 청약가점·예치금 참고 스킬(`housing-subscription-reference`)을 번들 참고 CSV 기반으로 정리한다. 런타임 외부 GitHub/개인 저장소 CSV URL과 GitHub `/blob/` fallback을 제거하고, 「주택공급에 관한 규칙」 별표 1·별표 2 값을 2026-10-30 검토일로 스킬에 번들한다. 지역 등급(서울·부산 / 인천·대구·광주·대전·울산 / 그 외), 신청자 주민등록상 거주지역 기준, 반개구간 점수·면적 경계, 배우자 가입기간 50%·최대 3점·합산 상한 17점, 미성년자 최대 5년 규칙을 명시하고, 설명·문서·소스·감사 표·스킬 목록·플러그인 매니페스트를 갱신한다 (#710) diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 4996efc1..5756b754 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -55,6 +55,7 @@ "./hola-poke-yeoksam", "./household-waste-info", "./housing-official-price", + "./housing-subscription-reference", "./hwp", "./intercity-bus-booking", "./iros-registry-automation", diff --git a/README.md b/README.md index 5ad2b2b9..5131da9d 100644 --- a/README.md +++ b/README.md @@ -73,6 +73,7 @@ npx -y @nomadamas/k-skill@0 update | --- | --- | --- | | [한국 부동산 실거래가 조회](docs/features/real-estate-search.md) | `real-estate-search` | 아파트/오피스텔/빌라/단독주택 실거래가·전월세·지역코드 조회 | | [한국 주택 공시가격 조회](docs/features/housing-official-price.md) | `housing-official-price` | realtyprice.kr 공개 웹 데이터 표면에서 공동주택·개별주택 정부 공시가격 이력을 직접 조회 (공식 문서화된 OpenAPI 아님) | +| [민영주택 청약가점·예치금 기준 조회](docs/features/housing-subscription-reference.md) | `housing-subscription-reference` | 「주택공급에 관한 규칙」 별표 1·별표 2 기준 청약가점(무주택기간·부양가족·가입기간 84점)과 지역·면적별 청약 예치금 조회 (외부 CSV 의존 없이 번들 참고값) | | [개별공시지가 조회](docs/features/gongsijiga-search.md) | `gongsijiga-search` | realtyprice.kr 공개 API에서 지번 단위 개별공시지가(원/㎡) 다년도 추이·전년 대비 변동률 조회 | | [건축물대장 표제부 조회](docs/features/building-register-search.md) | `building-register-search` | 주소·PNU·법정동 코드와 필지로 주용도·연면적·층수·사용승인일 조회 (공공데이터포털 15134735, 프록시 경유) | | [LH 청약 공고문 조회](docs/features/lh-notice-search.md) | `lh-notice-search` | 한국토지주택공사(LH) 임대/분양/주거복지(신혼희망타운)/토지/상가 공고를 지역·상태·공고유형·키워드로 조회하고 마감 여부를 KST 기준으로 표시 | diff --git a/docs/features/housing-subscription-reference.md b/docs/features/housing-subscription-reference.md new file mode 100644 index 00000000..5d73eefd --- /dev/null +++ b/docs/features/housing-subscription-reference.md @@ -0,0 +1,43 @@ +# 민영주택 청약가점·예치금 참고 (housing-subscription-reference) + +민영주택 일반공급의 청약가점 기준표(무주택기간 32점 + 부양가족수 35점 + 청약통장 가입기간 17점 = 84점)와 지역·전용면적별 청약 예치금 기준을 정적으로 조회하는 read-only 참고 스킬이다. 이슈 [#696](https://github.com/NomaDamas/k-skill/issues/696)에서 제안됐다. + +## 값의 출처 + +값은 「주택공급에 관한 규칙」(국토교통부령, 시행 2026-06-15) 별표 1(가점제 적용기준, 개정 2024-12-18)과 별표 2(민영주택 청약 예치기준금액, 개정 2023-05-10)를 옮긴 정적 참고값이다. 1차 권위는 법제처 국가법령정보센터(law.go.kr)이며, 검토일은 2026-10-30이다. 최신 법령과 입주자모집공고가 항상 우선한다. + +스킬에 함께 번들된 참고 파일을 CLI `read`로 읽는다(런타임에 외부 GitHub·개인 저장소·CSV URL에 의존하지 않는다). + +- 가점 CSV: `npx -y @nomadamas/k-skill@0 read housing-subscription-reference references/housing_subscription_score.csv` +- 예치금 CSV: `npx -y @nomadamas/k-skill@0 read housing-subscription-reference references/private_housing_deposit.csv` +- 지역·면적 규칙: `npx -y @nomadamas/k-skill@0 read housing-subscription-reference references/region-and-area-rules.md` + +## 입력 + +- score: `category`(`homeless_period`·`dependents`·`subscription_account_period`)와 `condition`(정확한 키). 키 전체 목록은 스킬 지침에 열거돼 있다. +- deposit: `region`(`seoul_busan`·`other_metropolitan`·`other_city_county`)과 `housing_area`(`85sqm_or_less`·`102sqm_or_less`·`135sqm_or_less`·`all_areas`). + +## 지역 구분 + +- `seoul_busan`: 서울특별시, 부산광역시. +- `other_metropolitan`: 그 밖의 광역시 — 인천광역시, 대구광역시, 광주광역시, 대전광역시, 울산광역시(정확히 이 5개). +- `other_city_county`: 특별시 및 광역시를 제외한 지역 — 세종특별자치시, 제주특별자치도, 강원특별자치도, 전북특별자치도 및 도 관할 시·군 등. + +구분 기준은 **입주자모집공고일 현재 신청자의 주민등록표상 거주지역**이며, 공급(분양) 사업지 소재지가 아니다. + +## 면적 구간과 점수 구간 + +- 면적: `(0, 85]`, `(85, 102]`, `(102, 135]`, `(135, ∞)`의 반개구간으로 해석한다. 예: 84.9㎡는 85㎡ 이하, 85.01㎡는 102㎡ 이하. +- 점수: 모든 구간이 반개구간 `[이상, 미만)`이다. 무주택기간 10년 = 22점, 청약통장 가입기간 1년 = 3점. + +## 계산 예시 + +- 서울, 85㎡ 이하: 300만원 (`seoul_busan` + `85sqm_or_less`). +- 세종, 84.9㎡: 200만원 (`other_city_county` + `85sqm_or_less`). +- 서울, 85.01㎡: 600만원 (`seoul_busan` + `102sqm_or_less`). +- 무주택 10년 + 부양가족 2명 + 가입 1년: 22 + 15 + 3 = 40점. +- 만 30세 미만 미혼 무주택자(및 유주택자): 무주택기간 0점. 최대 합계: 32 + 35 + 17 = 84점. + +## 범위와 주의 + +정적 참고자료이며, 현재 청약Home 공고·개인 자격 판정·법률 자문이 아니다. 특정 단지의 당첨 커트라인·경쟁률·당첨 확률과 국민주택(공공주택) 청약은 이 스킬의 범위가 아니다. 실제 청약은 항상 최신 입주자모집공고문과 청약Home, 최신 「주택공급에 관한 규칙」을 확인한다. diff --git a/docs/runtime-action-audit.md b/docs/runtime-action-audit.md index 1530ce2d..0451a7a2 100644 --- a/docs/runtime-action-audit.md +++ b/docs/runtime-action-audit.md @@ -64,6 +64,7 @@ top-level `SKILL.md` 전체를 돌쇠 우선 실행 계약으로 전수 검토 | `heyyumi` | `booking` | 예약 가능한 매장 검색 → `clarify` 후 `reserve` 전송 → `cli.next`로 매장 수락/거절 확인 | | `household-waste-info` | `lookup` | 요청한 조회를 완료하고, 별도 후속 행동 요청 시 지원되는 공식 표면으로 연결 | | `housing-official-price` | `lookup` | 요청한 조회를 완료하고, 별도 후속 행동 요청 시 지원되는 공식 표면으로 연결 | +| `housing-subscription-reference` | `lookup` | 요청한 조회를 완료하고, 별도 후속 행동 요청 시 지원되는 공식 표면으로 연결 | | `hwp` | `local` | 요청 산출물을 로컬에서 실제 생성·변환·정리 | | `intercity-bus-booking` | `booking` | 공식 일정/좌석 선택 → 예약·선점 → `clarify` 후 필요한 결제 | | `iros-registry-automation` | `legal` | 공식 등기 표면에서 로그인·서류 준비를 진행하고 `clarify` 후 허용된 신청·수수료 결제 | diff --git a/docs/sources.md b/docs/sources.md index 67aa825b..91f2a55c 100644 --- a/docs/sources.md +++ b/docs/sources.md @@ -91,6 +91,7 @@ - real-estate-mcp: https://github.com/tae0y/real-estate-mcp/tree/main - realtyprice.kr 개별주택가격 검색 화면: https://www.realtyprice.kr/notice/hpindividual/search.htm — `housing-official-price`가 공개 read-only web data surface로 관측한 개별주택가격 진입점. 가격 목록 JSON은 browser-visible `https://www.realtyprice.kr/notice/search/hpiSearchListApi.search` 형태를 직접 호출하며, 공식 문서화된 OpenAPI 계약으로 취급하지 않는다. - realtyprice.kr 공동주택가격 모바일 검색 화면: https://www.realtyprice.kr/notice/m/town/search.do — `housing-official-price`가 공개 read-only web data surface로 관측한 공동주택가격 진입점. 후보/상세/동/호/가격 이력은 `/notice/m/town/getApt.do`, `/notice/m/town/detail.do`, `/notice/m/town/getHo.do`, `/notice/m/town/getPriceYear.do` 흐름으로 직접 호출하며, 응답은 `model.list` 또는 `modelMap.list` 형태가 모두 가능하다. +- 「주택공급에 관한 규칙」(국토교통부령 제1592호, 시행 2026-06-15) 별표 1·별표 2: https://www.law.go.kr/법령/주택공급에관한규칙 — `housing-subscription-reference`의 1차 권위. 별표 1(가점제 적용기준, 개정 2024-12-18)은 무주택기간·부양가족수·주택청약종합저축 가입기간 점수표, 별표 2(민영주택 청약 예치기준금액, 개정 2023-05-10)는 지역 3등급 × 전용면적 4구간 예치금(단위 만원)이다. 별표 2 비고는 “지역”을 입주자모집공고일 현재 신청자의 주민등록표상 거주지역으로 정의한다. 법제처 국가법령정보센터에서 2026-10-30 검토한 값을 스킬에 번들 CSV(`housing-subscription-reference/references/housing_subscription_score.csv`, `housing-subscription-reference/references/private_housing_deposit.csv`)로 고정해 런타임에 외부 GitHub/개인 저장소 CSV URL에 의존하지 않는다. 질문의 ‘지역’은 광역시 등급에 따라 `seoul_busan`(서울·부산), `other_metropolitan`(인천·대구·광주·대전·울산 5곳), `other_city_county`(세종특별자치시·제주특별자치도·강원특별자치도·전북특별자치도 및 도 관할 시·군 등)로 나뉜다. - 한국장학재단 학자금 지원구간 산정절차: https://www.kosaf.go.kr/ko/tuition.do?pg=tuition04_09_01&type=tuition - 한국장학재단 학자금 지원구간 경곗값 확인: https://www.kosaf.go.kr/ko/tuition.do?naviParam=JH%2C01%2C01%2C03&pg=tuition04_09_07 - 한국장학재단 푸른등대 기부장학금: https://www.kosaf.go.kr/ko/scholar.do?pg=scholarship05_11_01 diff --git a/housing-subscription-reference/SKILL.md b/housing-subscription-reference/SKILL.md new file mode 100644 index 00000000..0c7c723f --- /dev/null +++ b/housing-subscription-reference/SKILL.md @@ -0,0 +1,41 @@ +--- +name: housing-subscription-reference +description: 민영주택 일반공급 청약가점(무주택기간·부양가족수·청약통장 가입기간 합계 84점)과 지역·전용면적별 청약 예치금 기준을 「주택공급에 관한 규칙」 별표 1·별표 2 값으로 조회한다. 청약가점, 청약 예치금, 민영주택, 무주택기간, 부양가족 질문에 사용한다. +license: MIT +metadata: + category: real-estate + locale: ko-KR + phase: v1 +--- + +# housing-subscription-reference + + + +## Get the full instructions (required first step) + +Run this and follow its output as the primary instructions for this skill: + +```bash +npx -y @nomadamas/k-skill@0 instruct housing-subscription-reference +``` + +The CLI detects the current runtime (Dolshoi vault/CloakBrowser vs generic) and prints only the applicable instructions, always up to date. Helper files bundled with the CLI are listed by: + +```bash +npx -y @nomadamas/k-skill@0 files housing-subscription-reference +``` + +Keep the CLI and every coding-agent skill install current (including Vercel Agent Skills) with: + +```bash +npx -y @nomadamas/k-skill@0 update +``` + +If `npx` is unavailable, install Node.js 18+ or follow https://github.com/NomaDamas/k-skill#readme, or read the source instructions at https://github.com/NomaDamas/k-skill/blob/main/housing-subscription-reference/instruction.md. + +## Hard rules even without the CLI + +- Never execute payment, message/email delivery, final submission, cancellation, or public posting without the user's explicit approval immediately beforehand. +- Never ask for, print, or store plaintext credentials in chat, files, or shell arguments. +- Never bypass legal, physical-presence, CAPTCHA, identity-proofing, or electronic-signature boundaries. diff --git a/housing-subscription-reference/instruction.md b/housing-subscription-reference/instruction.md new file mode 100644 index 00000000..4ee6a197 --- /dev/null +++ b/housing-subscription-reference/instruction.md @@ -0,0 +1,115 @@ +# 민영주택 청약가점·예치금 참고 + +## 이 스킬이 하는 일 + +민영주택 일반공급의 청약가점 항목별 기준표(무주택기간 32점 + 부양가족수 35점 + 청약통장 가입기간 17점 = 총 84점)와 지역·전용면적별 청약 예치금 기준을 정적으로 조회한다. 값은 「주택공급에 관한 규칙」 별표 1(가점제 적용기준)과 별표 2(민영주택 청약 예치기준금액)를 옮긴 것이며, 스킬에 함께 번들된 참고 CSV를 읽어서 답한다. + +실시간 공고 검색, 개인별 청약 자격 판정, 당첨 커트라인 예측은 하지 않는다. + +## 사용 시점 + +- "청약가점 84점은 어떻게 나뉘어?" +- "청약 예치금 얼마나 넣어야 해?" +- "민영주택 무주택기간 10년이면 몇 점이야?" +- "부양가족 2명이면 가점 얼마야?" +- "청약통장 1년이면 몇 점이야?" +- "세종에서 전용 84㎡ 청약하려면 예치금 얼마야?" / "서울 85㎡ 초과는?" + +## 범위 밖 + +- 특정 단지의 당첨 커트라인, 경쟁률, 당첨 확률·가능성은 다루지 않는다. +- 국민주택(공공주택)의 청약 자격·순위·예치금은 별도 규정이며, 이 자료는 민영주택 일반공급 기준만 다룬다. +- 개인의 실제 청약 자격·가점 확정 판정은 청약Home과 입주자모집공고문이 최종이다. 이 자료는 참고값이다. + +## 출처와 접근 + +추가 API 키, 프록시, 로그인, 스크래핑은 필요 없다. 값은 스킬에 번들된 참고 CSV로 읽는다. + +- 1차 권위(법령): 「주택공급에 관한 규칙」(국토교통부령, 국가법령정보센터 law.go.kr). 별표 1은 가점제 적용기준, 별표 2는 민영주택 청약 예치기준금액이다. +- 가점 CSV: `npx -y @nomadamas/k-skill@0 read housing-subscription-reference references/housing_subscription_score.csv` +- 예치금 CSV: `npx -y @nomadamas/k-skill@0 read housing-subscription-reference references/private_housing_deposit.csv` +- 지역·면적 규칙(지역 등급, 면적 반개구간, 계산 예시): `npx -y @nomadamas/k-skill@0 read housing-subscription-reference references/region-and-area-rules.md` + +검토일(checked_date)은 2026-10-30이다. CSV의 `source_basis`/`source_url` 열이 각 값의 법령 근거를 담는다. + +## 입력 + +- `topic`: `score` 또는 `deposit`. +- `category`(score): `homeless_period`, `dependents`, `subscription_account_period` 중 하나. +- `condition`(score): 아래 유효 키 중 정확히 하나. 모호하면 먼저 되묻는다. + - `homeless_period`: `no_eligible_period`, `under_1_year`, `1_to_2_years`, `2_to_3_years`, `3_to_4_years`, `4_to_5_years`, `5_to_6_years`, `6_to_7_years`, `7_to_8_years`, `8_to_9_years`, `9_to_10_years`, `10_to_11_years`, `11_to_12_years`, `12_to_13_years`, `13_to_14_years`, `14_to_15_years`, `15_years_or_more` + - `dependents`: `0`, `1`, `2`, `3`, `4`, `5`, `6_or_more` + - `subscription_account_period`: `under_6_months`, `6_months_to_1_year`, `1_to_2_years`, `2_to_3_years`, `3_to_4_years`, `4_to_5_years`, `5_to_6_years`, `6_to_7_years`, `7_to_8_years`, `8_to_9_years`, `9_to_10_years`, `10_to_11_years`, `11_to_12_years`, `12_to_13_years`, `13_to_14_years`, `14_to_15_years`, `15_years_or_more` +- `region`(deposit): `seoul_busan`, `other_metropolitan`, `other_city_county` 중 하나. +- `housing_area`(deposit): `85sqm_or_less`, `102sqm_or_less`, `135sqm_or_less`, `all_areas` 중 하나. + +## 청약가점 기준 (별표 1, 검토일 2026-10-30) + +점수 구간은 모두 반개구간 `[이상, 미만)`으로 읽는다(마지막 구간은 이상). + +- 무주택기간(상한 32점): 1년 미만 2점, 1년 이상~2년 미만 4점, 2~3년 6점, 3~4년 8점, 4~5년 10점, 5~6년 12점, 6~7년 14점, 7~8년 16점, 8~9년 18점, 9~10년 20점, 10~11년 22점, 11~12년 24점, 12~13년 26점, 13~14년 28점, 14~15년 30점, 15년 이상 32점. +- 부양가족수(상한 35점): 0명 5점, 1명 10점, 2명 15점, 3명 20점, 4명 25점, 5명 30점, 6명 이상 35점. +- 청약통장 가입기간(상한 17점): 6개월 미만 1점, 6개월 이상~1년 미만 2점, 1년 이상~2년 미만 3점, 이후 1년마다 1점씩 증가, 15년 이상 17점. +- 최대 합계: 32 + 35 + 17 = **84점**. + +무주택기간 산정 규칙: + +- 무주택기간은 주택공급신청자와 그 배우자를 기준으로 하고, 신청자의 연령이 **만 30세가 되는 날**부터 계속 무주택인 기간으로 한다. +- **만 30세가 되기 전에 혼인한 경우**에는 혼인관계증명서에 등재된 **혼인신고일**부터 기산한다. +- 신청자나 배우자가 주택을 소유한 사실이 있으면 그 주택을 처분한 후 무주택자가 된 날(2회 이상이면 최근 무주택자가 된 날)부터 산정한다. +- **유주택자**(입주자모집공고일 현재 1호/1세대 주택을 소유한 세대에 속한 자 등, 별표 1 비고 1·규칙 제28조제6항)와 **만 30세 미만 미혼 무주택자**는 무주택기간 점수가 **0점**이다(CSV 키 `no_eligible_period`, 값 0). + +부양가족·가입기간 관련 규칙: + +- 부양가족은 입주자모집공고일 현재 신청자 또는 배우자와 같은 세대별 주민등록표에 등재된 세대원이며, 자녀(손자녀 포함)는 미혼으로 한정한다. +- 청약통장 가입기간은 종류·금액·명의변경과 무관하게 최초 가입일 기준으로 산정한다. +- **배우자가 주택청약종합저축에 가입한 경우** 신청자 가입기간 점수에 배우자 가입기간의 **50퍼센트**에 해당하는 기간의 점수를 합산할 수 있다. 이때 합산하는 배우자 몫은 **최대 3점**, 합산 후 가입기간 항목 총점은 **최대 17점**을 넘을 수 없다. +- **미성년자 가입기간**은 2023년 12월 31일 이전 미성년 기간(최대 2년 인정)과 2024년 1월 1일 이후 미성년 기간을 합쳐 **최대 5년**만 인정한다(규칙 제10조제6항). + +## 청약 예치금 기준 (별표 2, 검토일 2026-10-30) + +단위는 **만원(KRW 10,000)**이다. “지역”은 **입주자모집공고일 현재 신청자의 주민등록표에 따른 거주지역**이며, 공급(분양) 사업지 소재지가 아니다. + +지역 등급: + +- `seoul_busan`: 서울특별시와 부산광역시. +- `other_metropolitan`: 그 밖의 광역시 — 인천광역시, 대구광역시, 광주광역시, 대전광역시, 울산광역시(정확히 이 5개). +- `other_city_county`: 특별시 및 광역시를 제외한 지역 — 세종특별자치시, 제주특별자치도, 강원특별자치도, 전북특별자치도 및 도 관할 시·군 등. + +전용면적 구간은 반개구간으로 해석한다: `(0, 85]`는 `85sqm_or_less`, `(85, 102]`는 `102sqm_or_less`, `(102, 135]`는 `135sqm_or_less`, `(135, ∞)`은 `all_areas`. + +| 전용면적 | `seoul_busan` | `other_metropolitan` | `other_city_county` | +| --- | ---: | ---: | ---: | +| 85㎡ 이하 (0, 85] | 300 | 250 | 200 | +| 102㎡ 이하 (85, 102] | 600 | 400 | 300 | +| 135㎡ 이하 (102, 135] | 1,000 | 700 | 400 | +| 모든 면적 (135, ∞) | 1,500 | 1,000 | 500 | + +## 계산 예시 (QA 기준) + +- 무주택기간 10년 + 부양가족 2명 + 청약통장 가입기간 1년 → 22 + 15 + 3 = **40점** (84점 만점). +- 만 30세 미만 미혼 무주택자(및 유주택자) → 무주택기간 **0점**. +- 가점 상한 조합 → 32 + 35 + 17 = **84점**. +- 세종특별자치시 거주, 전용 84.9㎡ → `other_city_county` + `85sqm_or_less` → **200만원**. +- 서울특별시 거주, 전용 85.01㎡ → `seoul_busan` + `102sqm_or_less` → **600만원**. + +## 워크플로 + +1. 요청을 score/deposit으로 분류하고, category·condition 또는 region·housing_area를 추출한다. +2. 해당 번들 CSV를 CLI `read`로 읽고 헤더(`category,condition,score,checked_date,source_basis,source_url` 또는 `housing_area,lower_sqm_exclusive,upper_sqm_inclusive,seoul_busan,other_metropolitan,other_city_county,unit,checked_date,source_basis,source_url`)를 확인한다. +3. 정확히 일치하는 행의 값과 단위, 검토일, 법령 근거(`source_basis`)를 함께 돌려준다. +4. 비교 질문은 해당 행/열만 정확히 돌려주고 자격을 추론하지 않는다. +5. 실제 단지·현재 공고 질문이면 최신 입주자모집공고, 청약Home, 최신 법령을 별도로 확인하라고 안내한다. + +## 실패 모드 + +- 번들 CSV가 없거나, 헤더·수치가 예상과 다르면 값을 지어내지 말고 데이터 사용 불가와 근거를 보고한다. +- region·area·기간·부양가족수가 모호하면 먼저 되묻는다. +- 자료의 검토일과 현재 법령·공고가 다를 수 있음을 설명하고, 최신 공식 규정이 우선함을 밝힌다. +- 실제 자격·당첨 확률·커트라인 요청은 범위 밖이며, 이 자료가 결과를 결정하지 않는다. + +## 완료 조건 + +- 요청한 행/기준값을 정확한 단위와 검토일, 법령 근거와 함께 돌려줬다. +- 정적 참고자료와 최신 공식 공고·개인 자격을 명확히 구분했다. +- 출처를 「주택공급에 관한 규칙」 별표 1·별표 2(법제처 국가법령정보센터)로 밝혔다. diff --git a/housing-subscription-reference/references/housing_subscription_score.csv b/housing-subscription-reference/references/housing_subscription_score.csv new file mode 100644 index 00000000..b050cdba --- /dev/null +++ b/housing-subscription-reference/references/housing_subscription_score.csv @@ -0,0 +1,42 @@ +category,condition,score,checked_date,source_basis,source_url +homeless_period,no_eligible_period,0,2026-10-30,주택공급에 관한 규칙 별표 1 제1호가목3) 및 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,under_1_year,2,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,1_to_2_years,4,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,2_to_3_years,6,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,3_to_4_years,8,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,4_to_5_years,10,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,5_to_6_years,12,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,6_to_7_years,14,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,7_to_8_years,16,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,8_to_9_years,18,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,9_to_10_years,20,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,10_to_11_years,22,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,11_to_12_years,24,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,12_to_13_years,26,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,13_to_14_years,28,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,14_to_15_years,30,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,15_years_or_more,32,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +dependents,0,5,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +dependents,1,10,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +dependents,2,15,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +dependents,3,20,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +dependents,4,25,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +dependents,5,30,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +dependents,6_or_more,35,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,under_6_months,1,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,6_months_to_1_year,2,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,1_to_2_years,3,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,2_to_3_years,4,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,3_to_4_years,5,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,4_to_5_years,6,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,5_to_6_years,7,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,6_to_7_years,8,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,7_to_8_years,9,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,8_to_9_years,10,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,9_to_10_years,11,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,10_to_11_years,12,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,11_to_12_years,13,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,12_to_13_years,14,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,13_to_14_years,15,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,14_to_15_years,16,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,15_years_or_more,17,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 diff --git a/housing-subscription-reference/references/private_housing_deposit.csv b/housing-subscription-reference/references/private_housing_deposit.csv new file mode 100644 index 00000000..2a92c6ae --- /dev/null +++ b/housing-subscription-reference/references/private_housing_deposit.csv @@ -0,0 +1,5 @@ +housing_area,lower_sqm_exclusive,upper_sqm_inclusive,seoul_busan,other_metropolitan,other_city_county,unit,checked_date,source_basis,source_url +85sqm_or_less,0,85,300,250,200,KRW_10k,2026-10-30,주택공급에 관한 규칙 별표 2,https://www.law.go.kr/법령/주택공급에관한규칙 +102sqm_or_less,85,102,600,400,300,KRW_10k,2026-10-30,주택공급에 관한 규칙 별표 2,https://www.law.go.kr/법령/주택공급에관한규칙 +135sqm_or_less,102,135,1000,700,400,KRW_10k,2026-10-30,주택공급에 관한 규칙 별표 2,https://www.law.go.kr/법령/주택공급에관한규칙 +all_areas,135,,1500,1000,500,KRW_10k,2026-10-30,주택공급에 관한 규칙 별표 2,https://www.law.go.kr/법령/주택공급에관한규칙 diff --git a/housing-subscription-reference/references/region-and-area-rules.md b/housing-subscription-reference/references/region-and-area-rules.md new file mode 100644 index 00000000..e238802f --- /dev/null +++ b/housing-subscription-reference/references/region-and-area-rules.md @@ -0,0 +1,58 @@ +# 청약 지역·면적 기준 (민영주택 청약 예치금) + +## 출처와 검토일 + +- 1차 권위: 「주택공급에 관한 규칙」 (국토교통부령 제1592호, 시행 2026-06-15) — 국가법령정보센터(law.go.kr). + - 별표 1 「가점제 적용기준」(개정 2024-12-18): 무주택기간·부양가족수·주택청약종합저축 가입기간. + - 별표 2 「민영주택 청약 예치기준금액」(개정 2023-05-10): 지역·전용면적별 예치금. +- 검토일: 2026-10-30. 이 문서의 값은 위 법령 별표를 옮긴 정적 참고값이며, 최신 법령·입주자모집공고가 항상 우선한다. + +## 지역 구분 (별표 2의 “지역” 열) + +별표 2 비고: “지역”은 **입주자모집공고일 현재 주택공급신청자의 주민등록표에 따른 거주지역**을 말한다. 즉 **신청자의 주민등록상 거주지역**으로 구분하며, 공급(분양) 사업지의 소재지가 아니다. + +| 코드(CSV 열) | 정의 | 해당 지역 | +| --- | --- | --- | +| `seoul_busan` | 특별시 및 부산광역시 | 서울특별시, 부산광역시 | +| `other_metropolitan` | 그 밖의 광역시 | 인천광역시, 대구광역시, 광주광역시, 대전광역시, 울산광역시 (정확히 이 5개) | +| `other_city_county` | 특별시 및 광역시를 제외한 지역 | 세종특별자치시, 제주특별자치도, 강원특별자치도, 전북특별자치도 및 도 관할 시·군 등 위 두 등급에 속하지 않는 모든 지역 | + +- `other_metropolitan`은 “광역시”라는 명칭의 5개 도시만 해당한다. 세종특별자치시는 특별자치시이지 광역시가 아니므로 `other_city_county`에 속한다. +- 제주특별자치도·강원특별자치도·전북특별자치도는 특별자치도이지 특별시·광역시가 아니므로 `other_city_county`에 속한다. +- 질문의 지역이 모호하면(예: “광역시”) 어느 도시인지 먼저 확인한다. + +## 전용면적 구간 (반개구간 [이상, 미만)) + +예치금은 “공급받을 수 있는 주택의 전용면적” 구간에 대응한다. 구간은 다음 반개구간으로 해석하며, 경계값은 아래 표와 같이 상한 포함(≤)·하한 초과(>)로 나눈다. + +| 구간 | CSV `housing_area` | 85㎡ | 102㎡ | 135㎡ | +| --- | --- | --- | --- | --- | +| (0, 85] | `85sqm_or_less` | 포함 | | | +| (85, 102] | `102sqm_or_less` | | 포함 | | +| (102, 135] | `135sqm_or_less` | | | 포함 | +| (135, ∞) | `all_areas` | | | | + +예: 85.0㎡는 `85sqm_or_less`, 85.01㎡는 `102sqm_or_less`. + +## 예치금 표 (단위: 만원, KRW 10,000) + +| 전용면적 | `seoul_busan` | `other_metropolitan` | `other_city_county` | +| --- | ---: | ---: | ---: | +| 85㎡ 이하 (0, 85] | 300 | 250 | 200 | +| 102㎡ 이하 (85, 102] | 600 | 400 | 300 | +| 135㎡ 이하 (102, 135] | 1,000 | 700 | 400 | +| 모든 면적 (135, ∞) | 1,500 | 1,000 | 500 | + +## 계산 예시 (QA 기준) + +- 무주택기간 10년 + 부양가족 2명 + 청약통장 가입기간 1년 → 22 + 15 + 3 = **40점** (최대 84점). +- 만 30세 미만 미혼 무주택자(유주택자 포함) → 무주택기간 **0점**. +- 청약가점 최대 합계 → 32 + 35 + 17 = **84점**. +- 세종특별자치시 거주, 전용 84.9㎡ (`85sqm_or_less`, `other_city_county`) → **200만원**. +- 서울특별시 거주, 전용 85.01㎡ (`102sqm_or_less`, `seoul_busan`) → **600만원**. + +## 범위 밖 + +- 실제 단지의 당첨 커트라인·경쟁률·당첨 가능성 판단은 이 참고자료의 범위가 아니다. +- 국민주택(공공주택)의 청약 자격·순위·예치금은 별도 규정이며 이 자료는 민영주택 일반공급 기준만 다룬다. +- 최종 판단은 입주자모집공고문과 청약Home, 최신 법령을 따른다. diff --git a/housing-subscription-reference/skill.json b/housing-subscription-reference/skill.json new file mode 100644 index 00000000..21727f4d --- /dev/null +++ b/housing-subscription-reference/skill.json @@ -0,0 +1,8 @@ +{ + "name": "housing-subscription-reference", + "description": "민영주택 일반공급 청약가점(무주택기간·부양가족수·청약통장 가입기간 합계 84점)과 지역·전용면적별 청약 예치금 기준을 「주택공급에 관한 규칙」 별표 1·별표 2 값으로 조회한다. 청약가점, 청약 예치금, 민영주택, 무주택기간, 부양가족 질문에 사용한다.", + "profiles": [ + "lookup" + ], + "frontmatter": "name: housing-subscription-reference\ndescription: 민영주택 일반공급 청약가점(무주택기간·부양가족수·청약통장 가입기간 합계 84점)과 지역·전용면적별 청약 예치금 기준을 「주택공급에 관한 규칙」 별표 1·별표 2 값으로 조회한다. 청약가점, 청약 예치금, 민영주택, 무주택기간, 부양가족 질문에 사용한다.\nlicense: MIT\nmetadata:\n category: real-estate\n locale: ko-KR\n phase: v1" +} diff --git a/k-skills-list.md b/k-skills-list.md index 3be6f821..e0e5197c 100644 --- a/k-skills-list.md +++ b/k-skills-list.md @@ -1,6 +1,6 @@ # k-skill 스킬 리스트 -한국 특화 검색·조회·자동화 에이전트 스킬 모음 (총 131개) +한국 특화 검색·조회·자동화 에이전트 스킬 모음 (총 133개) ## 쇼핑 · 커머스 - **coupang-product-search** — 쿠팡 Partners API로 상품 검색·로켓배송·가격 후보 비교 @@ -18,6 +18,7 @@ - **daangn-realty-search** — 당근부동산 지역 기반 매물 검색/상세 - **gongsijiga-search** — 개별공시지가(원/㎡) 조회 (세금 산정용, 시세 아님) - **housing-official-price** — 공동주택 공시가격 조회 +- **housing-subscription-reference** — 민영주택 청약가점·청약 예치금 기준 조회 (주택공급에 관한 규칙 별표 1·2) - **building-register-search** — 건축물대장 표제부 조회 (주소·PNU 기준) - **court-auction-notice-search** — 대법원경매정보 부동산 매각공고·사건 조회 - **daangn-cars-search** — 당근중고차 지역·가격 조건 차량 검색/상세 diff --git a/packages/k-skill-cli/skills/housing-subscription-reference/instruction.md b/packages/k-skill-cli/skills/housing-subscription-reference/instruction.md new file mode 100644 index 00000000..4ee6a197 --- /dev/null +++ b/packages/k-skill-cli/skills/housing-subscription-reference/instruction.md @@ -0,0 +1,115 @@ +# 민영주택 청약가점·예치금 참고 + +## 이 스킬이 하는 일 + +민영주택 일반공급의 청약가점 항목별 기준표(무주택기간 32점 + 부양가족수 35점 + 청약통장 가입기간 17점 = 총 84점)와 지역·전용면적별 청약 예치금 기준을 정적으로 조회한다. 값은 「주택공급에 관한 규칙」 별표 1(가점제 적용기준)과 별표 2(민영주택 청약 예치기준금액)를 옮긴 것이며, 스킬에 함께 번들된 참고 CSV를 읽어서 답한다. + +실시간 공고 검색, 개인별 청약 자격 판정, 당첨 커트라인 예측은 하지 않는다. + +## 사용 시점 + +- "청약가점 84점은 어떻게 나뉘어?" +- "청약 예치금 얼마나 넣어야 해?" +- "민영주택 무주택기간 10년이면 몇 점이야?" +- "부양가족 2명이면 가점 얼마야?" +- "청약통장 1년이면 몇 점이야?" +- "세종에서 전용 84㎡ 청약하려면 예치금 얼마야?" / "서울 85㎡ 초과는?" + +## 범위 밖 + +- 특정 단지의 당첨 커트라인, 경쟁률, 당첨 확률·가능성은 다루지 않는다. +- 국민주택(공공주택)의 청약 자격·순위·예치금은 별도 규정이며, 이 자료는 민영주택 일반공급 기준만 다룬다. +- 개인의 실제 청약 자격·가점 확정 판정은 청약Home과 입주자모집공고문이 최종이다. 이 자료는 참고값이다. + +## 출처와 접근 + +추가 API 키, 프록시, 로그인, 스크래핑은 필요 없다. 값은 스킬에 번들된 참고 CSV로 읽는다. + +- 1차 권위(법령): 「주택공급에 관한 규칙」(국토교통부령, 국가법령정보센터 law.go.kr). 별표 1은 가점제 적용기준, 별표 2는 민영주택 청약 예치기준금액이다. +- 가점 CSV: `npx -y @nomadamas/k-skill@0 read housing-subscription-reference references/housing_subscription_score.csv` +- 예치금 CSV: `npx -y @nomadamas/k-skill@0 read housing-subscription-reference references/private_housing_deposit.csv` +- 지역·면적 규칙(지역 등급, 면적 반개구간, 계산 예시): `npx -y @nomadamas/k-skill@0 read housing-subscription-reference references/region-and-area-rules.md` + +검토일(checked_date)은 2026-10-30이다. CSV의 `source_basis`/`source_url` 열이 각 값의 법령 근거를 담는다. + +## 입력 + +- `topic`: `score` 또는 `deposit`. +- `category`(score): `homeless_period`, `dependents`, `subscription_account_period` 중 하나. +- `condition`(score): 아래 유효 키 중 정확히 하나. 모호하면 먼저 되묻는다. + - `homeless_period`: `no_eligible_period`, `under_1_year`, `1_to_2_years`, `2_to_3_years`, `3_to_4_years`, `4_to_5_years`, `5_to_6_years`, `6_to_7_years`, `7_to_8_years`, `8_to_9_years`, `9_to_10_years`, `10_to_11_years`, `11_to_12_years`, `12_to_13_years`, `13_to_14_years`, `14_to_15_years`, `15_years_or_more` + - `dependents`: `0`, `1`, `2`, `3`, `4`, `5`, `6_or_more` + - `subscription_account_period`: `under_6_months`, `6_months_to_1_year`, `1_to_2_years`, `2_to_3_years`, `3_to_4_years`, `4_to_5_years`, `5_to_6_years`, `6_to_7_years`, `7_to_8_years`, `8_to_9_years`, `9_to_10_years`, `10_to_11_years`, `11_to_12_years`, `12_to_13_years`, `13_to_14_years`, `14_to_15_years`, `15_years_or_more` +- `region`(deposit): `seoul_busan`, `other_metropolitan`, `other_city_county` 중 하나. +- `housing_area`(deposit): `85sqm_or_less`, `102sqm_or_less`, `135sqm_or_less`, `all_areas` 중 하나. + +## 청약가점 기준 (별표 1, 검토일 2026-10-30) + +점수 구간은 모두 반개구간 `[이상, 미만)`으로 읽는다(마지막 구간은 이상). + +- 무주택기간(상한 32점): 1년 미만 2점, 1년 이상~2년 미만 4점, 2~3년 6점, 3~4년 8점, 4~5년 10점, 5~6년 12점, 6~7년 14점, 7~8년 16점, 8~9년 18점, 9~10년 20점, 10~11년 22점, 11~12년 24점, 12~13년 26점, 13~14년 28점, 14~15년 30점, 15년 이상 32점. +- 부양가족수(상한 35점): 0명 5점, 1명 10점, 2명 15점, 3명 20점, 4명 25점, 5명 30점, 6명 이상 35점. +- 청약통장 가입기간(상한 17점): 6개월 미만 1점, 6개월 이상~1년 미만 2점, 1년 이상~2년 미만 3점, 이후 1년마다 1점씩 증가, 15년 이상 17점. +- 최대 합계: 32 + 35 + 17 = **84점**. + +무주택기간 산정 규칙: + +- 무주택기간은 주택공급신청자와 그 배우자를 기준으로 하고, 신청자의 연령이 **만 30세가 되는 날**부터 계속 무주택인 기간으로 한다. +- **만 30세가 되기 전에 혼인한 경우**에는 혼인관계증명서에 등재된 **혼인신고일**부터 기산한다. +- 신청자나 배우자가 주택을 소유한 사실이 있으면 그 주택을 처분한 후 무주택자가 된 날(2회 이상이면 최근 무주택자가 된 날)부터 산정한다. +- **유주택자**(입주자모집공고일 현재 1호/1세대 주택을 소유한 세대에 속한 자 등, 별표 1 비고 1·규칙 제28조제6항)와 **만 30세 미만 미혼 무주택자**는 무주택기간 점수가 **0점**이다(CSV 키 `no_eligible_period`, 값 0). + +부양가족·가입기간 관련 규칙: + +- 부양가족은 입주자모집공고일 현재 신청자 또는 배우자와 같은 세대별 주민등록표에 등재된 세대원이며, 자녀(손자녀 포함)는 미혼으로 한정한다. +- 청약통장 가입기간은 종류·금액·명의변경과 무관하게 최초 가입일 기준으로 산정한다. +- **배우자가 주택청약종합저축에 가입한 경우** 신청자 가입기간 점수에 배우자 가입기간의 **50퍼센트**에 해당하는 기간의 점수를 합산할 수 있다. 이때 합산하는 배우자 몫은 **최대 3점**, 합산 후 가입기간 항목 총점은 **최대 17점**을 넘을 수 없다. +- **미성년자 가입기간**은 2023년 12월 31일 이전 미성년 기간(최대 2년 인정)과 2024년 1월 1일 이후 미성년 기간을 합쳐 **최대 5년**만 인정한다(규칙 제10조제6항). + +## 청약 예치금 기준 (별표 2, 검토일 2026-10-30) + +단위는 **만원(KRW 10,000)**이다. “지역”은 **입주자모집공고일 현재 신청자의 주민등록표에 따른 거주지역**이며, 공급(분양) 사업지 소재지가 아니다. + +지역 등급: + +- `seoul_busan`: 서울특별시와 부산광역시. +- `other_metropolitan`: 그 밖의 광역시 — 인천광역시, 대구광역시, 광주광역시, 대전광역시, 울산광역시(정확히 이 5개). +- `other_city_county`: 특별시 및 광역시를 제외한 지역 — 세종특별자치시, 제주특별자치도, 강원특별자치도, 전북특별자치도 및 도 관할 시·군 등. + +전용면적 구간은 반개구간으로 해석한다: `(0, 85]`는 `85sqm_or_less`, `(85, 102]`는 `102sqm_or_less`, `(102, 135]`는 `135sqm_or_less`, `(135, ∞)`은 `all_areas`. + +| 전용면적 | `seoul_busan` | `other_metropolitan` | `other_city_county` | +| --- | ---: | ---: | ---: | +| 85㎡ 이하 (0, 85] | 300 | 250 | 200 | +| 102㎡ 이하 (85, 102] | 600 | 400 | 300 | +| 135㎡ 이하 (102, 135] | 1,000 | 700 | 400 | +| 모든 면적 (135, ∞) | 1,500 | 1,000 | 500 | + +## 계산 예시 (QA 기준) + +- 무주택기간 10년 + 부양가족 2명 + 청약통장 가입기간 1년 → 22 + 15 + 3 = **40점** (84점 만점). +- 만 30세 미만 미혼 무주택자(및 유주택자) → 무주택기간 **0점**. +- 가점 상한 조합 → 32 + 35 + 17 = **84점**. +- 세종특별자치시 거주, 전용 84.9㎡ → `other_city_county` + `85sqm_or_less` → **200만원**. +- 서울특별시 거주, 전용 85.01㎡ → `seoul_busan` + `102sqm_or_less` → **600만원**. + +## 워크플로 + +1. 요청을 score/deposit으로 분류하고, category·condition 또는 region·housing_area를 추출한다. +2. 해당 번들 CSV를 CLI `read`로 읽고 헤더(`category,condition,score,checked_date,source_basis,source_url` 또는 `housing_area,lower_sqm_exclusive,upper_sqm_inclusive,seoul_busan,other_metropolitan,other_city_county,unit,checked_date,source_basis,source_url`)를 확인한다. +3. 정확히 일치하는 행의 값과 단위, 검토일, 법령 근거(`source_basis`)를 함께 돌려준다. +4. 비교 질문은 해당 행/열만 정확히 돌려주고 자격을 추론하지 않는다. +5. 실제 단지·현재 공고 질문이면 최신 입주자모집공고, 청약Home, 최신 법령을 별도로 확인하라고 안내한다. + +## 실패 모드 + +- 번들 CSV가 없거나, 헤더·수치가 예상과 다르면 값을 지어내지 말고 데이터 사용 불가와 근거를 보고한다. +- region·area·기간·부양가족수가 모호하면 먼저 되묻는다. +- 자료의 검토일과 현재 법령·공고가 다를 수 있음을 설명하고, 최신 공식 규정이 우선함을 밝힌다. +- 실제 자격·당첨 확률·커트라인 요청은 범위 밖이며, 이 자료가 결과를 결정하지 않는다. + +## 완료 조건 + +- 요청한 행/기준값을 정확한 단위와 검토일, 법령 근거와 함께 돌려줬다. +- 정적 참고자료와 최신 공식 공고·개인 자격을 명확히 구분했다. +- 출처를 「주택공급에 관한 규칙」 별표 1·별표 2(법제처 국가법령정보센터)로 밝혔다. diff --git a/packages/k-skill-cli/skills/housing-subscription-reference/references/housing_subscription_score.csv b/packages/k-skill-cli/skills/housing-subscription-reference/references/housing_subscription_score.csv new file mode 100644 index 00000000..b050cdba --- /dev/null +++ b/packages/k-skill-cli/skills/housing-subscription-reference/references/housing_subscription_score.csv @@ -0,0 +1,42 @@ +category,condition,score,checked_date,source_basis,source_url +homeless_period,no_eligible_period,0,2026-10-30,주택공급에 관한 규칙 별표 1 제1호가목3) 및 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,under_1_year,2,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,1_to_2_years,4,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,2_to_3_years,6,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,3_to_4_years,8,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,4_to_5_years,10,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,5_to_6_years,12,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,6_to_7_years,14,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,7_to_8_years,16,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,8_to_9_years,18,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,9_to_10_years,20,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,10_to_11_years,22,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,11_to_12_years,24,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,12_to_13_years,26,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,13_to_14_years,28,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,14_to_15_years,30,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +homeless_period,15_years_or_more,32,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +dependents,0,5,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +dependents,1,10,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +dependents,2,15,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +dependents,3,20,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +dependents,4,25,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +dependents,5,30,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +dependents,6_or_more,35,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,under_6_months,1,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,6_months_to_1_year,2,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,1_to_2_years,3,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,2_to_3_years,4,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,3_to_4_years,5,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,4_to_5_years,6,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,5_to_6_years,7,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,6_to_7_years,8,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,7_to_8_years,9,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,8_to_9_years,10,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,9_to_10_years,11,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,10_to_11_years,12,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,11_to_12_years,13,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,12_to_13_years,14,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,13_to_14_years,15,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,14_to_15_years,16,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 +subscription_account_period,15_years_or_more,17,2026-10-30,주택공급에 관한 규칙 별표 1 제2호나목,https://www.law.go.kr/법령/주택공급에관한규칙 diff --git a/packages/k-skill-cli/skills/housing-subscription-reference/references/private_housing_deposit.csv b/packages/k-skill-cli/skills/housing-subscription-reference/references/private_housing_deposit.csv new file mode 100644 index 00000000..2a92c6ae --- /dev/null +++ b/packages/k-skill-cli/skills/housing-subscription-reference/references/private_housing_deposit.csv @@ -0,0 +1,5 @@ +housing_area,lower_sqm_exclusive,upper_sqm_inclusive,seoul_busan,other_metropolitan,other_city_county,unit,checked_date,source_basis,source_url +85sqm_or_less,0,85,300,250,200,KRW_10k,2026-10-30,주택공급에 관한 규칙 별표 2,https://www.law.go.kr/법령/주택공급에관한규칙 +102sqm_or_less,85,102,600,400,300,KRW_10k,2026-10-30,주택공급에 관한 규칙 별표 2,https://www.law.go.kr/법령/주택공급에관한규칙 +135sqm_or_less,102,135,1000,700,400,KRW_10k,2026-10-30,주택공급에 관한 규칙 별표 2,https://www.law.go.kr/법령/주택공급에관한규칙 +all_areas,135,,1500,1000,500,KRW_10k,2026-10-30,주택공급에 관한 규칙 별표 2,https://www.law.go.kr/법령/주택공급에관한규칙 diff --git a/packages/k-skill-cli/skills/housing-subscription-reference/references/region-and-area-rules.md b/packages/k-skill-cli/skills/housing-subscription-reference/references/region-and-area-rules.md new file mode 100644 index 00000000..e238802f --- /dev/null +++ b/packages/k-skill-cli/skills/housing-subscription-reference/references/region-and-area-rules.md @@ -0,0 +1,58 @@ +# 청약 지역·면적 기준 (민영주택 청약 예치금) + +## 출처와 검토일 + +- 1차 권위: 「주택공급에 관한 규칙」 (국토교통부령 제1592호, 시행 2026-06-15) — 국가법령정보센터(law.go.kr). + - 별표 1 「가점제 적용기준」(개정 2024-12-18): 무주택기간·부양가족수·주택청약종합저축 가입기간. + - 별표 2 「민영주택 청약 예치기준금액」(개정 2023-05-10): 지역·전용면적별 예치금. +- 검토일: 2026-10-30. 이 문서의 값은 위 법령 별표를 옮긴 정적 참고값이며, 최신 법령·입주자모집공고가 항상 우선한다. + +## 지역 구분 (별표 2의 “지역” 열) + +별표 2 비고: “지역”은 **입주자모집공고일 현재 주택공급신청자의 주민등록표에 따른 거주지역**을 말한다. 즉 **신청자의 주민등록상 거주지역**으로 구분하며, 공급(분양) 사업지의 소재지가 아니다. + +| 코드(CSV 열) | 정의 | 해당 지역 | +| --- | --- | --- | +| `seoul_busan` | 특별시 및 부산광역시 | 서울특별시, 부산광역시 | +| `other_metropolitan` | 그 밖의 광역시 | 인천광역시, 대구광역시, 광주광역시, 대전광역시, 울산광역시 (정확히 이 5개) | +| `other_city_county` | 특별시 및 광역시를 제외한 지역 | 세종특별자치시, 제주특별자치도, 강원특별자치도, 전북특별자치도 및 도 관할 시·군 등 위 두 등급에 속하지 않는 모든 지역 | + +- `other_metropolitan`은 “광역시”라는 명칭의 5개 도시만 해당한다. 세종특별자치시는 특별자치시이지 광역시가 아니므로 `other_city_county`에 속한다. +- 제주특별자치도·강원특별자치도·전북특별자치도는 특별자치도이지 특별시·광역시가 아니므로 `other_city_county`에 속한다. +- 질문의 지역이 모호하면(예: “광역시”) 어느 도시인지 먼저 확인한다. + +## 전용면적 구간 (반개구간 [이상, 미만)) + +예치금은 “공급받을 수 있는 주택의 전용면적” 구간에 대응한다. 구간은 다음 반개구간으로 해석하며, 경계값은 아래 표와 같이 상한 포함(≤)·하한 초과(>)로 나눈다. + +| 구간 | CSV `housing_area` | 85㎡ | 102㎡ | 135㎡ | +| --- | --- | --- | --- | --- | +| (0, 85] | `85sqm_or_less` | 포함 | | | +| (85, 102] | `102sqm_or_less` | | 포함 | | +| (102, 135] | `135sqm_or_less` | | | 포함 | +| (135, ∞) | `all_areas` | | | | + +예: 85.0㎡는 `85sqm_or_less`, 85.01㎡는 `102sqm_or_less`. + +## 예치금 표 (단위: 만원, KRW 10,000) + +| 전용면적 | `seoul_busan` | `other_metropolitan` | `other_city_county` | +| --- | ---: | ---: | ---: | +| 85㎡ 이하 (0, 85] | 300 | 250 | 200 | +| 102㎡ 이하 (85, 102] | 600 | 400 | 300 | +| 135㎡ 이하 (102, 135] | 1,000 | 700 | 400 | +| 모든 면적 (135, ∞) | 1,500 | 1,000 | 500 | + +## 계산 예시 (QA 기준) + +- 무주택기간 10년 + 부양가족 2명 + 청약통장 가입기간 1년 → 22 + 15 + 3 = **40점** (최대 84점). +- 만 30세 미만 미혼 무주택자(유주택자 포함) → 무주택기간 **0점**. +- 청약가점 최대 합계 → 32 + 35 + 17 = **84점**. +- 세종특별자치시 거주, 전용 84.9㎡ (`85sqm_or_less`, `other_city_county`) → **200만원**. +- 서울특별시 거주, 전용 85.01㎡ (`102sqm_or_less`, `seoul_busan`) → **600만원**. + +## 범위 밖 + +- 실제 단지의 당첨 커트라인·경쟁률·당첨 가능성 판단은 이 참고자료의 범위가 아니다. +- 국민주택(공공주택)의 청약 자격·순위·예치금은 별도 규정이며 이 자료는 민영주택 일반공급 기준만 다룬다. +- 최종 판단은 입주자모집공고문과 청약Home, 최신 법령을 따른다. diff --git a/packages/k-skill-cli/skills/housing-subscription-reference/skill.json b/packages/k-skill-cli/skills/housing-subscription-reference/skill.json new file mode 100644 index 00000000..21727f4d --- /dev/null +++ b/packages/k-skill-cli/skills/housing-subscription-reference/skill.json @@ -0,0 +1,8 @@ +{ + "name": "housing-subscription-reference", + "description": "민영주택 일반공급 청약가점(무주택기간·부양가족수·청약통장 가입기간 합계 84점)과 지역·전용면적별 청약 예치금 기준을 「주택공급에 관한 규칙」 별표 1·별표 2 값으로 조회한다. 청약가점, 청약 예치금, 민영주택, 무주택기간, 부양가족 질문에 사용한다.", + "profiles": [ + "lookup" + ], + "frontmatter": "name: housing-subscription-reference\ndescription: 민영주택 일반공급 청약가점(무주택기간·부양가족수·청약통장 가입기간 합계 84점)과 지역·전용면적별 청약 예치금 기준을 「주택공급에 관한 규칙」 별표 1·별표 2 값으로 조회한다. 청약가점, 청약 예치금, 민영주택, 무주택기간, 부양가족 질문에 사용한다.\nlicense: MIT\nmetadata:\n category: real-estate\n locale: ko-KR\n phase: v1" +} diff --git a/packages/k-skill-cli/test/snapshots/housing-subscription-reference.dolshoi.md b/packages/k-skill-cli/test/snapshots/housing-subscription-reference.dolshoi.md new file mode 100644 index 00000000..81efe8a3 --- /dev/null +++ b/packages/k-skill-cli/test/snapshots/housing-subscription-reference.dolshoi.md @@ -0,0 +1,134 @@ +# housing-subscription-reference — assembled instructions + +Runtime mode: dolshoi (CloakBrowser available) + +## Runtime rules + +- Detect capabilities, not product names. Dolshoi credential mode is active only when `DOLSHOI_ACTION_BROKER_URL` is set and `vault-run` is available; CloakBrowser mode is active when the built-in browser tool identifies CloakBrowser or `CLOAKBROWSER_PEEK_TOKEN` is set. +- When the user asks for an action and the official surface supports it lawfully, continue beyond lookup through reversible preparation and execution. Do not declare completion at a result list, deep link, or handoff when the action can still be carried out. +- Immediately before an irreversible external side effect such as payment, message/email delivery, final submission, cancellation, account mutation, or public posting, call `clarify` with the exact target, amount/payload, and effect. Execute only after approval; do not ask again for already-approved reversible steps. +- Preserve hard boundaries for law, required physical presence, CAPTCHA, identity proofing, electronic signatures, and unsupported official surfaces. In those cases, complete the furthest lawful supported step and open or prepare the exact next official step for the user. +- Before using k-skill CLI tools, run `npx -y @nomadamas/k-skill@0 update` so the CLI and all coding-agent skill installs (including `~/.agents/skills`) are current. +- This skill is lookup-oriented. Completion means the requested data is retrieved, summarized with its source (table/endpoint, period, unit), and any requested follow-up action is connected to the official surface that supports it. + +## Bundled asset access + +- Execute bundled helpers only through `npx -y @nomadamas/k-skill@0 exec housing-subscription-reference scripts/ -- `; do not assume a repository-relative or installed-skill-relative path. +- Resolve an asset path with `npx -y @nomadamas/k-skill@0 path housing-subscription-reference ` only when another tool explicitly requires a filesystem path. +- Read bundled references through `npx -y @nomadamas/k-skill@0 read housing-subscription-reference references/`. + +# 민영주택 청약가점·예치금 참고 + +## 이 스킬이 하는 일 + +민영주택 일반공급의 청약가점 항목별 기준표(무주택기간 32점 + 부양가족수 35점 + 청약통장 가입기간 17점 = 총 84점)와 지역·전용면적별 청약 예치금 기준을 정적으로 조회한다. 값은 「주택공급에 관한 규칙」 별표 1(가점제 적용기준)과 별표 2(민영주택 청약 예치기준금액)를 옮긴 것이며, 스킬에 함께 번들된 참고 CSV를 읽어서 답한다. + +실시간 공고 검색, 개인별 청약 자격 판정, 당첨 커트라인 예측은 하지 않는다. + +## 사용 시점 + +- "청약가점 84점은 어떻게 나뉘어?" +- "청약 예치금 얼마나 넣어야 해?" +- "민영주택 무주택기간 10년이면 몇 점이야?" +- "부양가족 2명이면 가점 얼마야?" +- "청약통장 1년이면 몇 점이야?" +- "세종에서 전용 84㎡ 청약하려면 예치금 얼마야?" / "서울 85㎡ 초과는?" + +## 범위 밖 + +- 특정 단지의 당첨 커트라인, 경쟁률, 당첨 확률·가능성은 다루지 않는다. +- 국민주택(공공주택)의 청약 자격·순위·예치금은 별도 규정이며, 이 자료는 민영주택 일반공급 기준만 다룬다. +- 개인의 실제 청약 자격·가점 확정 판정은 청약Home과 입주자모집공고문이 최종이다. 이 자료는 참고값이다. + +## 출처와 접근 + +추가 API 키, 프록시, 로그인, 스크래핑은 필요 없다. 값은 스킬에 번들된 참고 CSV로 읽는다. + +- 1차 권위(법령): 「주택공급에 관한 규칙」(국토교통부령, 국가법령정보센터 law.go.kr). 별표 1은 가점제 적용기준, 별표 2는 민영주택 청약 예치기준금액이다. +- 가점 CSV: `npx -y @nomadamas/k-skill@0 read housing-subscription-reference references/housing_subscription_score.csv` +- 예치금 CSV: `npx -y @nomadamas/k-skill@0 read housing-subscription-reference references/private_housing_deposit.csv` +- 지역·면적 규칙(지역 등급, 면적 반개구간, 계산 예시): `npx -y @nomadamas/k-skill@0 read housing-subscription-reference references/region-and-area-rules.md` + +검토일(checked_date)은 2026-10-30이다. CSV의 `source_basis`/`source_url` 열이 각 값의 법령 근거를 담는다. + +## 입력 + +- `topic`: `score` 또는 `deposit`. +- `category`(score): `homeless_period`, `dependents`, `subscription_account_period` 중 하나. +- `condition`(score): 아래 유효 키 중 정확히 하나. 모호하면 먼저 되묻는다. + - `homeless_period`: `no_eligible_period`, `under_1_year`, `1_to_2_years`, `2_to_3_years`, `3_to_4_years`, `4_to_5_years`, `5_to_6_years`, `6_to_7_years`, `7_to_8_years`, `8_to_9_years`, `9_to_10_years`, `10_to_11_years`, `11_to_12_years`, `12_to_13_years`, `13_to_14_years`, `14_to_15_years`, `15_years_or_more` + - `dependents`: `0`, `1`, `2`, `3`, `4`, `5`, `6_or_more` + - `subscription_account_period`: `under_6_months`, `6_months_to_1_year`, `1_to_2_years`, `2_to_3_years`, `3_to_4_years`, `4_to_5_years`, `5_to_6_years`, `6_to_7_years`, `7_to_8_years`, `8_to_9_years`, `9_to_10_years`, `10_to_11_years`, `11_to_12_years`, `12_to_13_years`, `13_to_14_years`, `14_to_15_years`, `15_years_or_more` +- `region`(deposit): `seoul_busan`, `other_metropolitan`, `other_city_county` 중 하나. +- `housing_area`(deposit): `85sqm_or_less`, `102sqm_or_less`, `135sqm_or_less`, `all_areas` 중 하나. + +## 청약가점 기준 (별표 1, 검토일 2026-10-30) + +점수 구간은 모두 반개구간 `[이상, 미만)`으로 읽는다(마지막 구간은 이상). + +- 무주택기간(상한 32점): 1년 미만 2점, 1년 이상~2년 미만 4점, 2~3년 6점, 3~4년 8점, 4~5년 10점, 5~6년 12점, 6~7년 14점, 7~8년 16점, 8~9년 18점, 9~10년 20점, 10~11년 22점, 11~12년 24점, 12~13년 26점, 13~14년 28점, 14~15년 30점, 15년 이상 32점. +- 부양가족수(상한 35점): 0명 5점, 1명 10점, 2명 15점, 3명 20점, 4명 25점, 5명 30점, 6명 이상 35점. +- 청약통장 가입기간(상한 17점): 6개월 미만 1점, 6개월 이상~1년 미만 2점, 1년 이상~2년 미만 3점, 이후 1년마다 1점씩 증가, 15년 이상 17점. +- 최대 합계: 32 + 35 + 17 = **84점**. + +무주택기간 산정 규칙: + +- 무주택기간은 주택공급신청자와 그 배우자를 기준으로 하고, 신청자의 연령이 **만 30세가 되는 날**부터 계속 무주택인 기간으로 한다. +- **만 30세가 되기 전에 혼인한 경우**에는 혼인관계증명서에 등재된 **혼인신고일**부터 기산한다. +- 신청자나 배우자가 주택을 소유한 사실이 있으면 그 주택을 처분한 후 무주택자가 된 날(2회 이상이면 최근 무주택자가 된 날)부터 산정한다. +- **유주택자**(입주자모집공고일 현재 1호/1세대 주택을 소유한 세대에 속한 자 등, 별표 1 비고 1·규칙 제28조제6항)와 **만 30세 미만 미혼 무주택자**는 무주택기간 점수가 **0점**이다(CSV 키 `no_eligible_period`, 값 0). + +부양가족·가입기간 관련 규칙: + +- 부양가족은 입주자모집공고일 현재 신청자 또는 배우자와 같은 세대별 주민등록표에 등재된 세대원이며, 자녀(손자녀 포함)는 미혼으로 한정한다. +- 청약통장 가입기간은 종류·금액·명의변경과 무관하게 최초 가입일 기준으로 산정한다. +- **배우자가 주택청약종합저축에 가입한 경우** 신청자 가입기간 점수에 배우자 가입기간의 **50퍼센트**에 해당하는 기간의 점수를 합산할 수 있다. 이때 합산하는 배우자 몫은 **최대 3점**, 합산 후 가입기간 항목 총점은 **최대 17점**을 넘을 수 없다. +- **미성년자 가입기간**은 2023년 12월 31일 이전 미성년 기간(최대 2년 인정)과 2024년 1월 1일 이후 미성년 기간을 합쳐 **최대 5년**만 인정한다(규칙 제10조제6항). + +## 청약 예치금 기준 (별표 2, 검토일 2026-10-30) + +단위는 **만원(KRW 10,000)**이다. “지역”은 **입주자모집공고일 현재 신청자의 주민등록표에 따른 거주지역**이며, 공급(분양) 사업지 소재지가 아니다. + +지역 등급: + +- `seoul_busan`: 서울특별시와 부산광역시. +- `other_metropolitan`: 그 밖의 광역시 — 인천광역시, 대구광역시, 광주광역시, 대전광역시, 울산광역시(정확히 이 5개). +- `other_city_county`: 특별시 및 광역시를 제외한 지역 — 세종특별자치시, 제주특별자치도, 강원특별자치도, 전북특별자치도 및 도 관할 시·군 등. + +전용면적 구간은 반개구간으로 해석한다: `(0, 85]`는 `85sqm_or_less`, `(85, 102]`는 `102sqm_or_less`, `(102, 135]`는 `135sqm_or_less`, `(135, ∞)`은 `all_areas`. + +| 전용면적 | `seoul_busan` | `other_metropolitan` | `other_city_county` | +| --- | ---: | ---: | ---: | +| 85㎡ 이하 (0, 85] | 300 | 250 | 200 | +| 102㎡ 이하 (85, 102] | 600 | 400 | 300 | +| 135㎡ 이하 (102, 135] | 1,000 | 700 | 400 | +| 모든 면적 (135, ∞) | 1,500 | 1,000 | 500 | + +## 계산 예시 (QA 기준) + +- 무주택기간 10년 + 부양가족 2명 + 청약통장 가입기간 1년 → 22 + 15 + 3 = **40점** (84점 만점). +- 만 30세 미만 미혼 무주택자(및 유주택자) → 무주택기간 **0점**. +- 가점 상한 조합 → 32 + 35 + 17 = **84점**. +- 세종특별자치시 거주, 전용 84.9㎡ → `other_city_county` + `85sqm_or_less` → **200만원**. +- 서울특별시 거주, 전용 85.01㎡ → `seoul_busan` + `102sqm_or_less` → **600만원**. + +## 워크플로 + +1. 요청을 score/deposit으로 분류하고, category·condition 또는 region·housing_area를 추출한다. +2. 해당 번들 CSV를 CLI `read`로 읽고 헤더(`category,condition,score,checked_date,source_basis,source_url` 또는 `housing_area,lower_sqm_exclusive,upper_sqm_inclusive,seoul_busan,other_metropolitan,other_city_county,unit,checked_date,source_basis,source_url`)를 확인한다. +3. 정확히 일치하는 행의 값과 단위, 검토일, 법령 근거(`source_basis`)를 함께 돌려준다. +4. 비교 질문은 해당 행/열만 정확히 돌려주고 자격을 추론하지 않는다. +5. 실제 단지·현재 공고 질문이면 최신 입주자모집공고, 청약Home, 최신 법령을 별도로 확인하라고 안내한다. + +## 실패 모드 + +- 번들 CSV가 없거나, 헤더·수치가 예상과 다르면 값을 지어내지 말고 데이터 사용 불가와 근거를 보고한다. +- region·area·기간·부양가족수가 모호하면 먼저 되묻는다. +- 자료의 검토일과 현재 법령·공고가 다를 수 있음을 설명하고, 최신 공식 규정이 우선함을 밝힌다. +- 실제 자격·당첨 확률·커트라인 요청은 범위 밖이며, 이 자료가 결과를 결정하지 않는다. + +## 완료 조건 + +- 요청한 행/기준값을 정확한 단위와 검토일, 법령 근거와 함께 돌려줬다. +- 정적 참고자료와 최신 공식 공고·개인 자격을 명확히 구분했다. +- 출처를 「주택공급에 관한 규칙」 별표 1·별표 2(법제처 국가법령정보센터)로 밝혔다. diff --git a/packages/k-skill-cli/test/snapshots/housing-subscription-reference.generic.md b/packages/k-skill-cli/test/snapshots/housing-subscription-reference.generic.md new file mode 100644 index 00000000..04c72ffd --- /dev/null +++ b/packages/k-skill-cli/test/snapshots/housing-subscription-reference.generic.md @@ -0,0 +1,134 @@ +# housing-subscription-reference — assembled instructions + +Runtime mode: generic + +## Runtime rules + +- Detect capabilities, not product names. Dolshoi credential mode is active only when `DOLSHOI_ACTION_BROKER_URL` is set and `vault-run` is available; CloakBrowser mode is active when the built-in browser tool identifies CloakBrowser or `CLOAKBROWSER_PEEK_TOKEN` is set. +- When the user asks for an action and the official surface supports it lawfully, continue beyond lookup through reversible preparation and execution. Do not declare completion at a result list, deep link, or handoff when the action can still be carried out. +- Immediately before an irreversible external side effect such as payment, message/email delivery, final submission, cancellation, account mutation, or public posting, call `clarify` with the exact target, amount/payload, and effect. Execute only after approval; do not ask again for already-approved reversible steps. +- Preserve hard boundaries for law, required physical presence, CAPTCHA, identity proofing, electronic signatures, and unsupported official surfaces. In those cases, complete the furthest lawful supported step and open or prepare the exact next official step for the user. +- Before using k-skill CLI tools, run `npx -y @nomadamas/k-skill@0 update` so the CLI and all coding-agent skill installs (including `~/.agents/skills`) are current. +- This skill is lookup-oriented. Completion means the requested data is retrieved, summarized with its source (table/endpoint, period, unit), and any requested follow-up action is connected to the official surface that supports it. + +## Bundled asset access + +- Execute bundled helpers only through `npx -y @nomadamas/k-skill@0 exec housing-subscription-reference scripts/ -- `; do not assume a repository-relative or installed-skill-relative path. +- Resolve an asset path with `npx -y @nomadamas/k-skill@0 path housing-subscription-reference ` only when another tool explicitly requires a filesystem path. +- Read bundled references through `npx -y @nomadamas/k-skill@0 read housing-subscription-reference references/`. + +# 민영주택 청약가점·예치금 참고 + +## 이 스킬이 하는 일 + +민영주택 일반공급의 청약가점 항목별 기준표(무주택기간 32점 + 부양가족수 35점 + 청약통장 가입기간 17점 = 총 84점)와 지역·전용면적별 청약 예치금 기준을 정적으로 조회한다. 값은 「주택공급에 관한 규칙」 별표 1(가점제 적용기준)과 별표 2(민영주택 청약 예치기준금액)를 옮긴 것이며, 스킬에 함께 번들된 참고 CSV를 읽어서 답한다. + +실시간 공고 검색, 개인별 청약 자격 판정, 당첨 커트라인 예측은 하지 않는다. + +## 사용 시점 + +- "청약가점 84점은 어떻게 나뉘어?" +- "청약 예치금 얼마나 넣어야 해?" +- "민영주택 무주택기간 10년이면 몇 점이야?" +- "부양가족 2명이면 가점 얼마야?" +- "청약통장 1년이면 몇 점이야?" +- "세종에서 전용 84㎡ 청약하려면 예치금 얼마야?" / "서울 85㎡ 초과는?" + +## 범위 밖 + +- 특정 단지의 당첨 커트라인, 경쟁률, 당첨 확률·가능성은 다루지 않는다. +- 국민주택(공공주택)의 청약 자격·순위·예치금은 별도 규정이며, 이 자료는 민영주택 일반공급 기준만 다룬다. +- 개인의 실제 청약 자격·가점 확정 판정은 청약Home과 입주자모집공고문이 최종이다. 이 자료는 참고값이다. + +## 출처와 접근 + +추가 API 키, 프록시, 로그인, 스크래핑은 필요 없다. 값은 스킬에 번들된 참고 CSV로 읽는다. + +- 1차 권위(법령): 「주택공급에 관한 규칙」(국토교통부령, 국가법령정보센터 law.go.kr). 별표 1은 가점제 적용기준, 별표 2는 민영주택 청약 예치기준금액이다. +- 가점 CSV: `npx -y @nomadamas/k-skill@0 read housing-subscription-reference references/housing_subscription_score.csv` +- 예치금 CSV: `npx -y @nomadamas/k-skill@0 read housing-subscription-reference references/private_housing_deposit.csv` +- 지역·면적 규칙(지역 등급, 면적 반개구간, 계산 예시): `npx -y @nomadamas/k-skill@0 read housing-subscription-reference references/region-and-area-rules.md` + +검토일(checked_date)은 2026-10-30이다. CSV의 `source_basis`/`source_url` 열이 각 값의 법령 근거를 담는다. + +## 입력 + +- `topic`: `score` 또는 `deposit`. +- `category`(score): `homeless_period`, `dependents`, `subscription_account_period` 중 하나. +- `condition`(score): 아래 유효 키 중 정확히 하나. 모호하면 먼저 되묻는다. + - `homeless_period`: `no_eligible_period`, `under_1_year`, `1_to_2_years`, `2_to_3_years`, `3_to_4_years`, `4_to_5_years`, `5_to_6_years`, `6_to_7_years`, `7_to_8_years`, `8_to_9_years`, `9_to_10_years`, `10_to_11_years`, `11_to_12_years`, `12_to_13_years`, `13_to_14_years`, `14_to_15_years`, `15_years_or_more` + - `dependents`: `0`, `1`, `2`, `3`, `4`, `5`, `6_or_more` + - `subscription_account_period`: `under_6_months`, `6_months_to_1_year`, `1_to_2_years`, `2_to_3_years`, `3_to_4_years`, `4_to_5_years`, `5_to_6_years`, `6_to_7_years`, `7_to_8_years`, `8_to_9_years`, `9_to_10_years`, `10_to_11_years`, `11_to_12_years`, `12_to_13_years`, `13_to_14_years`, `14_to_15_years`, `15_years_or_more` +- `region`(deposit): `seoul_busan`, `other_metropolitan`, `other_city_county` 중 하나. +- `housing_area`(deposit): `85sqm_or_less`, `102sqm_or_less`, `135sqm_or_less`, `all_areas` 중 하나. + +## 청약가점 기준 (별표 1, 검토일 2026-10-30) + +점수 구간은 모두 반개구간 `[이상, 미만)`으로 읽는다(마지막 구간은 이상). + +- 무주택기간(상한 32점): 1년 미만 2점, 1년 이상~2년 미만 4점, 2~3년 6점, 3~4년 8점, 4~5년 10점, 5~6년 12점, 6~7년 14점, 7~8년 16점, 8~9년 18점, 9~10년 20점, 10~11년 22점, 11~12년 24점, 12~13년 26점, 13~14년 28점, 14~15년 30점, 15년 이상 32점. +- 부양가족수(상한 35점): 0명 5점, 1명 10점, 2명 15점, 3명 20점, 4명 25점, 5명 30점, 6명 이상 35점. +- 청약통장 가입기간(상한 17점): 6개월 미만 1점, 6개월 이상~1년 미만 2점, 1년 이상~2년 미만 3점, 이후 1년마다 1점씩 증가, 15년 이상 17점. +- 최대 합계: 32 + 35 + 17 = **84점**. + +무주택기간 산정 규칙: + +- 무주택기간은 주택공급신청자와 그 배우자를 기준으로 하고, 신청자의 연령이 **만 30세가 되는 날**부터 계속 무주택인 기간으로 한다. +- **만 30세가 되기 전에 혼인한 경우**에는 혼인관계증명서에 등재된 **혼인신고일**부터 기산한다. +- 신청자나 배우자가 주택을 소유한 사실이 있으면 그 주택을 처분한 후 무주택자가 된 날(2회 이상이면 최근 무주택자가 된 날)부터 산정한다. +- **유주택자**(입주자모집공고일 현재 1호/1세대 주택을 소유한 세대에 속한 자 등, 별표 1 비고 1·규칙 제28조제6항)와 **만 30세 미만 미혼 무주택자**는 무주택기간 점수가 **0점**이다(CSV 키 `no_eligible_period`, 값 0). + +부양가족·가입기간 관련 규칙: + +- 부양가족은 입주자모집공고일 현재 신청자 또는 배우자와 같은 세대별 주민등록표에 등재된 세대원이며, 자녀(손자녀 포함)는 미혼으로 한정한다. +- 청약통장 가입기간은 종류·금액·명의변경과 무관하게 최초 가입일 기준으로 산정한다. +- **배우자가 주택청약종합저축에 가입한 경우** 신청자 가입기간 점수에 배우자 가입기간의 **50퍼센트**에 해당하는 기간의 점수를 합산할 수 있다. 이때 합산하는 배우자 몫은 **최대 3점**, 합산 후 가입기간 항목 총점은 **최대 17점**을 넘을 수 없다. +- **미성년자 가입기간**은 2023년 12월 31일 이전 미성년 기간(최대 2년 인정)과 2024년 1월 1일 이후 미성년 기간을 합쳐 **최대 5년**만 인정한다(규칙 제10조제6항). + +## 청약 예치금 기준 (별표 2, 검토일 2026-10-30) + +단위는 **만원(KRW 10,000)**이다. “지역”은 **입주자모집공고일 현재 신청자의 주민등록표에 따른 거주지역**이며, 공급(분양) 사업지 소재지가 아니다. + +지역 등급: + +- `seoul_busan`: 서울특별시와 부산광역시. +- `other_metropolitan`: 그 밖의 광역시 — 인천광역시, 대구광역시, 광주광역시, 대전광역시, 울산광역시(정확히 이 5개). +- `other_city_county`: 특별시 및 광역시를 제외한 지역 — 세종특별자치시, 제주특별자치도, 강원특별자치도, 전북특별자치도 및 도 관할 시·군 등. + +전용면적 구간은 반개구간으로 해석한다: `(0, 85]`는 `85sqm_or_less`, `(85, 102]`는 `102sqm_or_less`, `(102, 135]`는 `135sqm_or_less`, `(135, ∞)`은 `all_areas`. + +| 전용면적 | `seoul_busan` | `other_metropolitan` | `other_city_county` | +| --- | ---: | ---: | ---: | +| 85㎡ 이하 (0, 85] | 300 | 250 | 200 | +| 102㎡ 이하 (85, 102] | 600 | 400 | 300 | +| 135㎡ 이하 (102, 135] | 1,000 | 700 | 400 | +| 모든 면적 (135, ∞) | 1,500 | 1,000 | 500 | + +## 계산 예시 (QA 기준) + +- 무주택기간 10년 + 부양가족 2명 + 청약통장 가입기간 1년 → 22 + 15 + 3 = **40점** (84점 만점). +- 만 30세 미만 미혼 무주택자(및 유주택자) → 무주택기간 **0점**. +- 가점 상한 조합 → 32 + 35 + 17 = **84점**. +- 세종특별자치시 거주, 전용 84.9㎡ → `other_city_county` + `85sqm_or_less` → **200만원**. +- 서울특별시 거주, 전용 85.01㎡ → `seoul_busan` + `102sqm_or_less` → **600만원**. + +## 워크플로 + +1. 요청을 score/deposit으로 분류하고, category·condition 또는 region·housing_area를 추출한다. +2. 해당 번들 CSV를 CLI `read`로 읽고 헤더(`category,condition,score,checked_date,source_basis,source_url` 또는 `housing_area,lower_sqm_exclusive,upper_sqm_inclusive,seoul_busan,other_metropolitan,other_city_county,unit,checked_date,source_basis,source_url`)를 확인한다. +3. 정확히 일치하는 행의 값과 단위, 검토일, 법령 근거(`source_basis`)를 함께 돌려준다. +4. 비교 질문은 해당 행/열만 정확히 돌려주고 자격을 추론하지 않는다. +5. 실제 단지·현재 공고 질문이면 최신 입주자모집공고, 청약Home, 최신 법령을 별도로 확인하라고 안내한다. + +## 실패 모드 + +- 번들 CSV가 없거나, 헤더·수치가 예상과 다르면 값을 지어내지 말고 데이터 사용 불가와 근거를 보고한다. +- region·area·기간·부양가족수가 모호하면 먼저 되묻는다. +- 자료의 검토일과 현재 법령·공고가 다를 수 있음을 설명하고, 최신 공식 규정이 우선함을 밝힌다. +- 실제 자격·당첨 확률·커트라인 요청은 범위 밖이며, 이 자료가 결과를 결정하지 않는다. + +## 완료 조건 + +- 요청한 행/기준값을 정확한 단위와 검토일, 법령 근거와 함께 돌려줬다. +- 정적 참고자료와 최신 공식 공고·개인 자격을 명확히 구분했다. +- 출처를 「주택공급에 관한 규칙」 별표 1·별표 2(법제처 국가법령정보센터)로 밝혔다.