[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79DBQWQMMYDN863NXEBGMBH":3,"skill-same:01M79DBQWQMMYDN863NXEBGMBH":90},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M79DBQWQMMYDN863NXEBGMBH","sole-search",null,"운영 중인 소상공인(가게·점포·자영업자)을 위한 지원사업 조사 스킬. 소상공인24·기업마당 공고를 전수 수집하고 가게 프로필(업종·지역·업력·직원수·매출)로 자격을 판정해 \"오늘 신청할 것\"부터 보고한다. 보조금·바우처, 정책자금(대출·보증), 교육·컨설팅 전 범위. 사용자가 \"우리 가게 지원사업\", \"소상공인 지원금\", \"정책자금 알아봐줘\", \"가게 시설개선 지원\", \"사장님 지원 뭐 있어\", \"소상공인24 조사\", \"폐업\u002F재기 지원\" 등을 요청하면 이 스킬을 사용한다. 재조사(\"새로 나온 거 있나\", \"지난번 이후 뭐 올라왔나\")는 diff 모드로 사용. 반대로 \"우리 아이템\", \"창업지원\", \"예비창업\", \"K-Startup\", \"TIPS\", \"R&D 과제\", \"입주공간\", \"액셀러레이팅\" 등 아이템·프로젝트 기반 창업지원 탐색은 이 스킬이 아니라 ir-search를 사용한다. 신호가 섞이면(예: \"온라인 셀러 지원금\") 어느 쪽인지 한 번 묻는다. 사용자 신분보다 요청 목적이 우선이다 — 가게 사장이라도 신규 기술 아이템 R&D를 찾으면 ir-search. 한국 전용.","djfksjd\u002Fsole-search","djfksjd","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F214969256?v=4","01M78F0W2YPZX6XKF7BDC40TVT","ALIVE(danny)","01M79DBKVN3WV0H00KRACTP7BW",45,"MIT","https:\u002F\u002Fgithub.com\u002Fdjfksjd\u002Fsole-search\u002Fblob\u002Fmain\u002Fskills\u002Fsole-search\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: sole-search\ndescription: '운영 중인 소상공인(가게·점포·자영업자)을 위한 지원사업 조사 스킬. 소상공인24·기업마당 공고를 전수 수집하고 가게 프로필(업종·지역·업력·직원수·매출)로 자격을 판정해 \"오늘 신청할 것\"부터 보고한다. 보조금·바우처, 정책자금(대출·보증), 교육·컨설팅 전 범위. 사용자가 \"우리 가게 지원사업\", \"소상공인 지원금\", \"정책자금 알아봐줘\", \"가게 시설개선 지원\", \"사장님 지원 뭐 있어\", \"소상공인24 조사\", \"폐업\u002F재기 지원\" 등을 요청하면 이 스킬을 사용한다. 재조사(\"새로 나온 거 있나\", \"지난번 이후 뭐 올라왔나\")는 diff 모드로 사용. 반대로 \"우리 아이템\", \"창업지원\", \"예비창업\", \"K-Startup\", \"TIPS\", \"R&D 과제\", \"입주공간\", \"액셀러레이팅\" 등 아이템·프로젝트 기반 창업지원 탐색은 이 스킬이 아니라 ir-search를 사용한다. 신호가 섞이면(예: \"온라인 셀러 지원금\") 어느 쪽인지 한 번 묻는다. 사용자 신분보다 요청 목적이 우선이다 — 가게 사장이라도 신규 기술 아이템 R&D를 찾으면 ir-search. 한국 전용.'\n---\n\n# sole-search — 소상공인 지원사업 조사\n\n> **스크립트 위치**: `${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002F` (단독 스킬 설치 시 스킬 디렉토리 자체). 미정의 시 폴백: `~\u002F.claude\u002Fskills\u002Fsole-search\u002Fscripts\u002F`. 아래 명령의 경로 변수를 환경에 맞게 치환해 실행한다.\n\n이 스킬은 \"룰베이스 수집 + LLM 판정\" 구조다. 스크립트는 공고를 기계적으로 수집만 하고,\n선별·자격 판정·보고서는 에이전트(너)가 한다.\n\n세 가지 원칙 (위반 금지):\n\n1. **조용한 누락 금지** — 커버하지 못한 소스·읽지 못한 첨부는 보고서에 명시한다. 모든 보고서에 coverage_manifest가 있어야 한다.\n2. **추정 금지** — 공고 원문에 없는 것은 '불명'. 첨부를 읽지 못했으면 `확인됨` 판정 금지.\n3. **허위신청 유도 금지** — \"변형하면 가능\" 식 프레이밍을 쓰지 않는다. 실제 등록업종·영업내용이 뒷받침되는 것만 후보다.\n\n## 0단계 — 프로필\n\n**먼저 현재 작업 폴더에서 `sole-profile.md`를 찾는다.** 있으면 본문 요약을 보여주고\n\"바뀐 것 있나요?\" **한 번만** 묻고 1단계로 간다.\n\n없으면 쉬운 말로, 관공서 용어 없이, **한 번에** 묻는다 (이미 대화·폴더에서 파악된 항목은 제외):\n\n1. 무슨 장사\u002F사업을 하세요? (예: 치킨집, 네일샵, 스마트스토어)\n2. 개인사업자세요, 법인이세요? 지금 정상 영업 중이세요?\n3. 가게는 어느 동네예요? (시·군·구까지. 사업자등록상 주소가 다르면 둘 다)\n4. 사업자 등록은 언제 하셨어요? (년·월)\n5. 직원은 몇 명이에요? (4대보험 가입 기준과, 가족·알바 포함 인원을 구분해서)\n6. 혹시 소상공인확인서(중소기업현황정보시스템 발급) 있으세요? 유효기간은?\n7. (확인서 없으면) 작년 매출이 대략 어느 정도예요? — 3천만 미만 \u002F 3천만~1억 \u002F 1억~5억 \u002F 5억~10억 \u002F 10억~30억 \u002F 30억 이상\n8. 대표님 나이대와 성별은? (건너뛰어도 됨)\n9. 지금 제일 필요한 건? (복수) — 안 갚는 돈 \u002F 빌리는 돈 \u002F 가게 시설 \u002F 온라인 판매 \u002F 홍보 \u002F 배우기 \u002F 정리·재기\n\n확정되면 `sole-profile.md`로 저장한다. **YAML 프론트매터는 원자 필드**로 쓴다:\n\n```markdown\n---\nschema_version: 1\ntype: sole-search-profile\nentity_type: individual | corporation\nbusiness_status: active | suspended | closing | closed\nclosure_date: YYYY-MM            # closed일 때만\nindustry_text: \u003C사용자 표현 그대로>\nindustry_code_candidates:\n  - {code: \u003CKSIC>, label: \u003C업종명>, confidence: high|medium|low}\nregistration_date: YYYY-MM\nregular_employee_count: \u003CN>      # 4대보험 기준\nheadcount: \u003CN>                   # 가족·알바 포함\nemployee_count_as_of: YYYY-MM-DD\nsbiz_certificate: none | valid | expired\nsbiz_certificate_valid_until: YYYY-MM-DD\nsales_band: lt_30m | 30m_100m | 100m_500m | 500m_1b | 1b_3b | gte_3b\nsales_period: \u003CYYYY 연간>\nsales_basis: statutory_average | recent_year_proxy\nsales_vs_industry_threshold: below | near | above | unknown\nthreshold_industry_code: \u003CKSIC>\nsales_threshold_as_of: YYYY-MM-DD\nprovince: \u003C시\u002F도>\ndistrict: \u003C시\u002F군\u002F구>\nhq_district: \u003C본점, 다를 때만>\nowner_age_band: 20s|30s|40s|50s|60s_plus|unspecified\nowner_gender: female | male | unspecified\nneeds: [grant, loan, facility, online_sales, marketing, education, recovery]\nlast_survey_at: YYYY-MM-DD\nlast_survey_dir: \u003C보고서 폴더>\nsurvey_sources: [sbiz24, sbiz24_combine, bizinfo, fanfandaero]  # 서울이면 + seoulshinbo, API 키 등록 시 + gov24\n---\n# sole-search 프로필\n\u003C사람이 읽는 한 줄 요약>\n```\n\n**소상공인 법적 판정 우선순위**: ① 유효한 소상공인확인서 → 확정 ② 법령상 기준기간\n평균매출액(statutory_average) 근거가 있으면 상시근로자 기준(업종별 5인\u002F10인 미만)과\n평균매출액 기준을 함께 판정 ③ **최근 1년 근사치(recent_year_proxy)만 있으면 below라도\n법적 지위는 '확인 필요'** — 이전 연도 매출 때문에 법령상 평균이 기준을 넘을 수 있다.\n\n**개인정보 최소화**: 세금 체납·대출액·신용점수는 묻지 않는다. 정책자금 후보가 나온 뒤\n\"이 요건 해당되세요?\"로만 확인하고, 답을 프로필에 저장하지 않는다. 출생연월도 저장하지 않는다.\n\n## 0.5단계 — 조사 범위 명시 선택\n\n실제 수집 전에 범위 계획기를 실행해 사용자 선택과 커버리지 한계를 고정한다. 계획기는\nPython 표준 라이브러리만 사용하고 **네트워크·LLM을 호출하지 않으므로 모델 토큰은 0**이다.\n\n```bash\n# 빠른 확인: 소상공인24만\npython3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fscope_plan.py\" \\\n    --preset quick -o scope-plan.json\n\n# 특정 출처 하나만\npython3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fscope_plan.py\" \\\n    --preset focused --source sbiz24 -o scope-plan.json\n\n# 프로필 기반 권장 범위\npython3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fscope_plan.py\" \\\n    --preset recommended --need loan --need online_sales \\\n    --province 서울 -o scope-plan.json\n\n# 사용자가 고른 출처만. 자동 어댑터가 없는 출처는 manual_only로 남는다.\npython3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fscope_plan.py\" \\\n    --preset custom --source sbiz24 --source work24 -o scope-plan.json\n```\n\n- `quick`: 소상공인24 하나만 빠르게 본다.\n- `focused`: `--source`로 지정한 정확히 한 출처만 본다.\n- `recommended`: 업종·필요·지역·보유 credential에 맞는 등록 출처를 추천한다.\n- `all_registered`: 현재 저장소에 검증된 자동 어댑터 또는 명시된 수동 계약이 있는 출처를\n  전부 계획한다. 후보 출처를 자동으로 승격하지 않는다.\n- `all_known`: 등록 출처와 프로필 확장 후보를 모두 계획하되 후보는 `manual_only`로\n  유지한다. 자동 수집 전체가 아니다.\n- `custom`: 사용자가 지정한 출처만 계획한다. 후보 출처는 선택돼도 수동 확인이다.\n\n`scope-plan.json`의 모든 출처 상태(`selected \u002F omitted_by_user \u002F not_applicable`,\n`ready \u002F manual_only \u002F unavailable_credential`)와 요청 수·시간 추정을 먼저 보여준다.\n보고서에는 `scope_fingerprint`와 \"선택 범위 기준\" 커버리지를 기록한다. 재조사는 직전과\nfingerprint가 같을 때만 GONE·UNCHANGED 승계를 허용한다. fingerprint가 다르면 출처 제외를\nGONE으로 오판하지 말고 범위 변경으로 표시해 전체 재판정한다. 후보·수동 출처 목록과 등록\n조건은 `references\u002Fsources.md`를 따른다.\n\n## 재조사 (diff 모드)\n\n프로필의 `last_survey_dir`가 있으면 전수 재검토 대신 증분 조사:\n\n1. **직전과 같은 소스 구성으로** 1단계 크롤링을 그대로 실행 (새 보고서 폴더에)\n2. 비교:\n   ```bash\n   python3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fdiff_surveys.py\" \\\n       \u003C직전_폴더> \u003C새_폴더> --out new_items.jsonl \\\n       --old-profile \u003C직전_폴더>\u002Fprofile-snapshot.md --new-profile sole-profile.md \\\n       --incremental-sources fanfandaero,seoulshinbo\n   ```\n   `--incremental-sources`에는 `--since` 컷오프로 수집한 소스를 넣는다 — 그 소스는\n   이전 레코드 부재가 소멸이 아니므로 GONE을 계산하지 않는다\n3. 검토·상세검증은 `new_items.jsonl`(NEW+CHANGED+NEEDS_REHASH)만. GONE은 **별도 파일\n   `gone_new_items.jsonl`**에 기록된다(기회 소멸 알림 재료 — 검토 대상과 섞지 않는다).\n   UNCHANGED는 직전 판정 승계. 단 **프로필 fingerprint가 바뀌었다는 WARNING이 나오면 전체 재판정**\n4. **NEEDS_REHASH** = 직전 조사에 content_hash가 있었는데 새 목록엔 아직 없음. 목록 필드만으로\n   같아 보여도 본문·첨부가 바뀌었을 수 있으니 **상세 재수집(`detail --merge-into`) 후 해시를\n   채우고 재비교**한다 — 그때 같으면 승계, 다르면 변경 처리. **hash_version이 다른 경우**(해시\n   산식 v1↔v2)는 값 비교가 불가능하므로 1회 CHANGED로 분류된다 — 상세 재검증하면 이번\n   조사부터 양쪽 v2로 수렴한다\n5. **정책자금(loan) 전체와 직전 `확인됨` 항목은 diff 결과와 무관하게 접수상태를 재확인**\n6. 보고서: 신규 \u002F 변경(마감·조건 — changed_fields 표기) \u002F 소멸된 확인됨 항목(기회 소멸 알림) \u002F 승계 요약.\n   WARNING(미갱신 소스)은 coverage_manifest에 \"미갱신\" 명시\n\n## 1단계 — 수집\n\n```bash\nmkdir -p survey-$(date +%Y%m%d)\u002Fdetails && cd survey-$(date +%Y%m%d)\n\n# 소상공인24: 소진공 공고 + 통합조회(지자체·유관기관 포함) — 필수\npython3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fsbiz_crawl.py\" list all -o sbiz24.jsonl\n\n# 기업마당: 모집중 전체 전 페이지 (~96p, 2~3분) — 필수\npython3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fsources_crawl.py\" list -o bizinfo.jsonl\n\n# 판판대로: 온라인판로 사업목록 + 세부·수시 모집공고 게시판 — 권장\n#   (--since: 첫 조사는 1년 전, 재조사는 직전 조사일)\npython3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fregion_crawl.py\" list fanfan \\\n    -o fanfandaero.jsonl --since \u003CYYYY-MM-DD>\n\n# 서울신보: 프로필 province가 서울일 때만 — 권장 (서울시 사업 공고 원출처)\npython3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fregion_crawl.py\" list seoulshinbo \\\n    -o seoulshinbo.jsonl --since \u003CYYYY-MM-DD>\n\n# 보조금24: 선택 소스 (API 키 등록 시에만 — 상시 수혜 제도 커버)\npython3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fgov24_crawl.py\" list \\\n    -o gov24.jsonl --filter-target 소상공인\n\n# 프로필 스냅샷 (필수, 수집 직후) — 다음 diff의 --old-profile 재료\ncp ..\u002Fsole-profile.md profile-snapshot.md\n```\n\n게시판형 소스(판판대로 공지·서울신보)는 접수기간이 목록에 없어 status가 `불명`으로\n수집된다 — 선별에서 제목·게시일로 1차 거르고, candidate는 상세에서 접수 여부를 확인한다.\n`--since` 컷오프를 쓴 조사는 coverage_manifest에 컷오프 날짜를 명시한다 (전수 아님을 표기).\n\n**보조금24는 선택 소스**: 종료 코드 4(미활성)면 coverage_manifest에\n`미활성(선택 소스, API 키 미등록)`으로 기록하고 보고서 한계에 활성화 방법\n(data.go.kr 15113968 활용신청 → `DATA_GO_KR_API_KEY` 또는 `~\u002F.config\u002Fsole-search\u002Fapi_key`)을\n한 줄 안내한다. 활성 시 상시 제도는 보고서에 **\"상시 혜택(보조금24)\" 별도 섹션**으로\n다룬다 — 마감 기준 정렬인 \"오늘 신청할 것\"과 섞지 않는다. 키를 프로필·보고서 폴더에\n저장하지 않는다.\n\nstderr의 `TOTAL\u002FCOLLECTED\u002FDUPLICATES`·`PAGES\u002FCRAWLED`를 기록한다 — coverage_manifest 재료다.\n종료 코드 2는 부분 수집(partial)이다. **소스별 계약·수동확인 절차는 `references\u002Fsources.md`**,\n지역신보·지자체 포털은 `references\u002Fregion-registry.md` 참조.\n\n**중복 제거**: ① `(발행기관, 공고번호)` ② 정규화 canonical URL — 특히 sbiz24_combine의\n`PBLN_*` ID는 bizinfo의 pblancId와 같은 공고다 ③ 제목+기관+접수기간 전부 일치.\n애매하면 삭제하지 말고 묶어서 \"동일 사업 추정 N건\"으로 표기.\n\n## 1.5단계 — 전수 선별 (screening)\n\n100% 수집해도 일부만 읽으면 전수조사가 아니다:\n\n- 수집된 **모든** 레코드를 배치(예: 100건씩)로 나눠 빠짐없이 읽는다. 제목 키워드로 자동 제외 금지\n- 각 레코드에 `screening: candidate | excluded | needs_detail` + 제외 사유를 붙여 `screening.jsonl`로 저장\n- 프로필의 needs·업종·지역과 명백히 무관해도 \"excluded + 사유\"로 기록하고 넘어간다 (조용히 버리지 않는다)\n- 중단되면 어디까지 검토했는지 기록하고 coverage를 partial로 보고\n- **모델 분기(비용 최적화)**: 선별은 거친 1차 통과라 서브에이전트를 **저비용 모델**(Claude Code면\n  `model: haiku`)로 돌려도 된다 — 실수는 2단계 판정에서 걸러진다. 단 방향이 중요하다:\n  **애매하면 excluded가 아니라 `candidate`\u002F`needs_detail`로** (과소 선별은 2단계가 못 되살린다).\n  2단계 자격 판정은 원문·첨부 해석이 필요하므로 세션 기본 모델을 유지한다\n\n## 2단계 — 자격 판정\n\ncandidate와 needs_detail 레코드는 상세 원문을 확인한다:\n\n```bash\n# 소상공인24 상세+첨부 (첨부 자동 다운로드 + 목록 jsonl에 content_hash 병합)\npython3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fsbiz_crawl.py\" detail \u003CpbancSn> \\\n    --download-dir details -o details\u002F\u003CpbancSn>.json --merge-into sbiz24.jsonl\n# 기업마당 상세 (본문 해시 v2·첨부 링크를 목록에 병합 — 레코드에 hash_version: 2)\n#   --download-dir details 를 붙이면 첨부까지 다운로드·추출하고, 전부 성공 시\n#   해시 v3(본문+정렬된 첨부 sha256, hash_version: 3)를 스탬프한다 — v2↔v3 전환은\n#   diff가 1회 CHANGED로 흡수. 첨부 일부가 실패·생략되면 본문만의 v2 해시를 유지하고\n#   attachments_complete: false + exit 2로 첨부 미검증을 표현한다\npython3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fsources_crawl.py\" detail \"\u003CURL>\" \\\n    -o details --merge-into bizinfo.jsonl\n# 판판대로·서울신보 상세 (canonical_url로 소스 자동 판별, 소스별 jsonl에 병합)\n#   --download-dir details 를 붙이면 첨부까지 다운로드·추출한다 (bizinfo와 동일 계약:\n#   전부 성공 시 hash v3, 일부 실패·생략 시 본문 v2 유지 + attachments_complete: false\n#   + exit 2). 서울신보는 연속 다운로드 시 서버가 http 리다이렉트로 막는 경우가 있다 —\n#   blocked_redirect로 남으면 재실행하거나 수동 확인\npython3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fregion_crawl.py\" detail \\\n    \"\u003Ccanonical_url>\" -o details --merge-into \u003C해당소스>.jsonl [--download-dir details]\n# 첨부 텍스트 추출 (HWP는 hwp5txt→PrvText 미리보기 폴백 — 부분 추출\u002F실패 후보는 '확인 필요')\npython3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fattach_extract.py\" \\\n    details\u002F\u003C파일> -o details\u002F\u003C파일>.txt\n```\n\n**sbiz24_combine 레코드의 상세 분기** (계약: references\u002Fsources.md §1):\n- ID가 `PBLN_*` → 기업마당 공고 — `sources_crawl.py detail \u003Cbizinfo URL>`로 검증\n- 비PBLN·비대출(`raw.pbancGubun`이 A(공단)\u002FD(지방정부)) → `sbiz_crawl.py detail \u003Csn>\n  --source sbiz24_combine --merge-into sbiz24.jsonl` — pbanc 상세 API를 공유한다\n  (2026-07-23 실호출 검증). **--merge-into 필수**: 목록 레코드의 pbancGubun 게이트 +\n  상세 응답 sn·제목 대조를 통과해야 병합한다(불일치 시 exit 2, 조용한 오독 금지)\n- `raw.pbancGubun`이 C(대출상품)·미지 코드·부재(구버전 목록) → 별도 네임스페이스\u002F계약\n  미확인이라 exit 2로 거부(fail-closed) — canonical_url로 수동 확인.\n  bizType=`대출상품` 문자열도 보조 검사로 거부된다\n\n판정 상태 5단계:\n\n| 상태 | 의미 |\n|---|---|\n| `확인됨` | 공고 원문(첨부 포함)에서 모든 필수 신청자격 충족 확인 |\n| `조건부` | 구체 요건 충족 시 가능 (예: 교육 이수 후) — 요건 명시 |\n| `확인 필요` | 프로필 또는 원문 부족 — 부족한 항목 명시 |\n| `신청 불가` | 필수요건 불충족 — 근거 문구 인용 |\n| `사업전환 후보` | 실제 사업전환 전제 — 별도 섹션, 기본 비표시 |\n\n검증 축: 업종 제한(제외 업종), 업력(공고 기준일로 산정), 상시근로자 수, 매출액 기준,\n소재지(본점\u002F사업장 구분), 기수혜 제외, 영업상태.\n\n규칙:\n- **판정 상태는 위 5개 중 정확히 하나** — '정보성', '조건부\u002F확인 필요' 같은 비표준·복합 상태 금지.\n  직접 신청 대상이 아닌 통합·메타 공고는 선별 단계에서 `excluded`(사유: 메타 공고, 세부공고로 신청) 처리\n- **접수 마감이 확정된 후보는 상세검증을 생략할 수 있다** — 단 보고서에 건수·대표 목록·\n  \"차기 재조사 우선확인 대상\"을 명시한다 (조용한 생략 금지)\n- **첨부를 읽지 못한 후보(`attachments_complete: false` 포함)는 `확인됨` 금지** → `확인 필요` + \"첨부 미확인(사유)\".\n  HWP의 PrvText 미리보기 추출(`extract_reason: hwp_preview_only`)은 **부분 추출**이라 여기에 해당한다\n- **status가 `불명`인 레코드는 접수 여부부터 상세에서 확인** — 크롤러는 낙관 추정하지 않는다\n- 크롤러 종료 코드 3(MANUAL)은 차단 신호다 — 재시도하지 말고 해당 소스를 manual로 기록\n- 각 판정에 근거 출처(문서·문구)를 기록\n- `확인됨` = 공고상 신청자격 확인일 뿐, 선정·대출심사 통과 예측이 아님 — 보고서에 명시\n- 연락처는 `contacts: [{kind: phone|email|url, value}]`, 없으면 \"연락처 미기재\"\n- 유형은 `primary_type`(grant|loan|advisory) + tags. loan에는 한도·금리(기준일)·기간·\n  거치·상환방식·보증기관을 채우고, 회차 접수상태는 sources.md의 수동확인 절차를 따른다\n\n## 3단계 — 보고서\n\n`survey-YYYYMMDD\u002Freport.md`. 사장님이 읽는 문서 — 관공서 용어에 괄호 해설. 구조:\n\n1. **오늘 신청할 것** — 전 유형 통합 `확인됨` 목록. 정렬: 마감 D-day 오름차순 →\n   예산소진 시까지(\"서두르세요\") → 상시 → 회차예정(예정일). 각 항목: 제목, 한 줄 요약,\n   금액\u002F혜택, 마감, 신청 방법·링크, 연락처. `확인됨` 목록 **뒤에** 남은 조건이 1개뿐인\n   `조건부`를 별도 하위 목록(🔶 \"조건 1개만 채우면 됨\")으로 붙일 수 있다 — 확인됨과\n   섞지 말고, 각 항목 첫 줄에 남은 조건을 명시하며, 정렬 규칙은 동일 적용\n2. **coverage_manifest** — 소스별 `collection_status`와 `screening_status`\n   (`success|partial|failed|manual`), collected\u002Fscreened\u002Fcandidate\u002Fdetail_verified 카운트.\n   **카운트는 소스별로 기재 — \"(합산)\" 뭉개기 금지**. 중복 제거 시 어느 소스에 귀속했는지\n   설명해 수집→선별 합계가 재검산 가능해야 한다. partial·manual·미갱신은 사유 명시.\n   **partial인 소스를 \"전수 수집 완료\"로 표현 금지**. 미커버 영역(미등록 지자체 포털 등) 한계 고지\n3. **유형별 상세** — 💰 받는 돈 \u002F 🏦 빌리는 돈 \u002F 🎓 배우고 돕기 순, 각 유형 안에서 판정 상태순.\n   🏦에는 \"갚아야 하는 돈입니다\" 문구 + 한도·금리(기준일)·기간·취급기관 필수\n4. **사업전환 후보** — 해당 시에만. 그 외 부가 정보(공통 준비물, 마감 후보 목록 등)는\n   번호 없는 \"비고\"로 붙인다\n\n**보고서 자가 점검** — 작성 직후 아래를 전부 확인하고, 어긋난 항목은 고친 뒤 완료 선언:\n\n- 판정 상태에 5개 enum 외 값·복합 표기 없음 (항목당 정확히 하나)\n- \"오늘 신청할 것\"에서 확인됨\u002F🔶조건부가 구분돼 있고 정렬 규칙(D-day 오름차순 → 예산소진 → 상시 → 회차예정) 준수\n- coverage_manifest 카운트가 소스별로 채워져 있고 수집→선별 합계가 재검산됨\n- 첨부 미추출 항목 전부가 상세 표에 `확인 필요`로 존재 (coverage 언급과 상세 표 판정 일치)\n- `확인 필요` 판정에 \"실무상 문제 가능성 낮음\" 류의 추정 보완 문구 없음 — 부족한 항목과 확인 방법만 적는다\n- 사장님용 본문에 내부 식별자(idx, candidate, needs_detail 등) 노출 최소화 — 감사 정보는 산출 파일에 있다\n\n완료 후 프로필의 `last_survey_at`·`last_survey_dir`를 갱신하고, **갱신된 현재\n`sole-profile.md`를 조사 폴더에 `profile-snapshot.md`로 복사(cp)한다** (필수 —\n다음 diff의 `--old-profile` 재료, 1단계에서 만든 스냅샷을 덮어써 최종본으로 남긴다).\n\n## 중단선\n\n403·CAPTCHA·로그인 요구를 만나면 우회(TLS 지문 변경, 내부 API 반복 재시도)하지 않는다.\n해당 소스를 manual로 전환하고 sources.md의 수동확인 절차를 보고서에 첨부한다.\n","# sole-search — 소상공인 지원사업 조사\n\n> **스크립트 위치**: `${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002F` (단독 스킬 설치 시 스킬 디렉토리 자체). 미정의 시 폴백: `~\u002F.claude\u002Fskills\u002Fsole-search\u002Fscripts\u002F`. 아래 명령의 경로 변수를 환경에 맞게 치환해 실행한다.\n\n이 스킬은 \"룰베이스 수집 + LLM 판정\" 구조다. 스크립트는 공고를 기계적으로 수집만 하고,\n선별·자격 판정·보고서는 에이전트(너)가 한다.\n\n세 가지 원칙 (위반 금지):\n\n1. **조용한 누락 금지** — 커버하지 못한 소스·읽지 못한 첨부는 보고서에 명시한다. 모든 보고서에 coverage_manifest가 있어야 한다.\n2. **추정 금지** — 공고 원문에 없는 것은 '불명'. 첨부를 읽지 못했으면 `확인됨` 판정 금지.\n3. **허위신청 유도 금지** — \"변형하면 가능\" 식 프레이밍을 쓰지 않는다. 실제 등록업종·영업내용이 뒷받침되는 것만 후보다.\n\n## 0단계 — 프로필\n\n**먼저 현재 작업 폴더에서 `sole-profile.md`를 찾는다.** 있으면 본문 요약을 보여주고\n\"바뀐 것 있나요?\" **한 번만** 묻고 1단계로 간다.\n\n없으면 쉬운 말로, 관공서 용어 없이, **한 번에** 묻는다 (이미 대화·폴더에서 파악된 항목은 제외):\n\n1. 무슨 장사\u002F사업을 하세요? (예: 치킨집, 네일샵, 스마트스토어)\n2. 개인사업자세요, 법인이세요? 지금 정상 영업 중이세요?\n3. 가게는 어느 동네예요? (시·군·구까지. 사업자등록상 주소가 다르면 둘 다)\n4. 사업자 등록은 언제 하셨어요? (년·월)\n5. 직원은 몇 명이에요? (4대보험 가입 기준과, 가족·알바 포함 인원을 구분해서)\n6. 혹시 소상공인확인서(중소기업현황정보시스템 발급) 있으세요? 유효기간은?\n7. (확인서 없으면) 작년 매출이 대략 어느 정도예요? — 3천만 미만 \u002F 3천만~1억 \u002F 1억~5억 \u002F 5억~10억 \u002F 10억~30억 \u002F 30억 이상\n8. 대표님 나이대와 성별은? (건너뛰어도 됨)\n9. 지금 제일 필요한 건? (복수) — 안 갚는 돈 \u002F 빌리는 돈 \u002F 가게 시설 \u002F 온라인 판매 \u002F 홍보 \u002F 배우기 \u002F 정리·재기\n\n확정되면 `sole-profile.md`로 저장한다. **YAML 프론트매터는 원자 필드**로 쓴다:\n\n```markdown\n---\nschema_version: 1\ntype: sole-search-profile\nentity_type: individual | corporation\nbusiness_status: active | suspended | closing | closed\nclosure_date: YYYY-MM            # closed일 때만\nindustry_text: \u003C사용자 표현 그대로>\nindustry_code_candidates:\n  - {code: \u003CKSIC>, label: \u003C업종명>, confidence: high|medium|low}\nregistration_date: YYYY-MM\nregular_employee_count: \u003CN>      # 4대보험 기준\nheadcount: \u003CN>                   # 가족·알바 포함\nemployee_count_as_of: YYYY-MM-DD\nsbiz_certificate: none | valid | expired\nsbiz_certificate_valid_until: YYYY-MM-DD\nsales_band: lt_30m | 30m_100m | 100m_500m | 500m_1b | 1b_3b | gte_3b\nsales_period: \u003CYYYY 연간>\nsales_basis: statutory_average | recent_year_proxy\nsales_vs_industry_threshold: below | near | above | unknown\nthreshold_industry_code: \u003CKSIC>\nsales_threshold_as_of: YYYY-MM-DD\nprovince: \u003C시\u002F도>\ndistrict: \u003C시\u002F군\u002F구>\nhq_district: \u003C본점, 다를 때만>\nowner_age_band: 20s|30s|40s|50s|60s_plus|unspecified\nowner_gender: female | male | unspecified\nneeds: [grant, loan, facility, online_sales, marketing, education, recovery]\nlast_survey_at: YYYY-MM-DD\nlast_survey_dir: \u003C보고서 폴더>\nsurvey_sources: [sbiz24, sbiz24_combine, bizinfo, fanfandaero]  # 서울이면 + seoulshinbo, API 키 등록 시 + gov24\n---\n# sole-search 프로필\n\u003C사람이 읽는 한 줄 요약>\n```\n\n**소상공인 법적 판정 우선순위**: ① 유효한 소상공인확인서 → 확정 ② 법령상 기준기간\n평균매출액(statutory_average) 근거가 있으면 상시근로자 기준(업종별 5인\u002F10인 미만)과\n평균매출액 기준을 함께 판정 ③ **최근 1년 근사치(recent_year_proxy)만 있으면 below라도\n법적 지위는 '확인 필요'** — 이전 연도 매출 때문에 법령상 평균이 기준을 넘을 수 있다.\n\n**개인정보 최소화**: 세금 체납·대출액·신용점수는 묻지 않는다. 정책자금 후보가 나온 뒤\n\"이 요건 해당되세요?\"로만 확인하고, 답을 프로필에 저장하지 않는다. 출생연월도 저장하지 않는다.\n\n## 0.5단계 — 조사 범위 명시 선택\n\n실제 수집 전에 범위 계획기를 실행해 사용자 선택과 커버리지 한계를 고정한다. 계획기는\nPython 표준 라이브러리만 사용하고 **네트워크·LLM을 호출하지 않으므로 모델 토큰은 0**이다.\n\n```bash\n# 빠른 확인: 소상공인24만\npython3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fscope_plan.py\" \\\n    --preset quick -o scope-plan.json\n\n# 특정 출처 하나만\npython3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fscope_plan.py\" \\\n    --preset focused --source sbiz24 -o scope-plan.json\n\n# 프로필 기반 권장 범위\npython3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fscope_plan.py\" \\\n    --preset recommended --need loan --need online_sales \\\n    --province 서울 -o scope-plan.json\n\n# 사용자가 고른 출처만. 자동 어댑터가 없는 출처는 manual_only로 남는다.\npython3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fscope_plan.py\" \\\n    --preset custom --source sbiz24 --source work24 -o scope-plan.json\n```\n\n- `quick`: 소상공인24 하나만 빠르게 본다.\n- `focused`: `--source`로 지정한 정확히 한 출처만 본다.\n- `recommended`: 업종·필요·지역·보유 credential에 맞는 등록 출처를 추천한다.\n- `all_registered`: 현재 저장소에 검증된 자동 어댑터 또는 명시된 수동 계약이 있는 출처를\n  전부 계획한다. 후보 출처를 자동으로 승격하지 않는다.\n- `all_known`: 등록 출처와 프로필 확장 후보를 모두 계획하되 후보는 `manual_only`로\n  유지한다. 자동 수집 전체가 아니다.\n- `custom`: 사용자가 지정한 출처만 계획한다. 후보 출처는 선택돼도 수동 확인이다.\n\n`scope-plan.json`의 모든 출처 상태(`selected \u002F omitted_by_user \u002F not_applicable`,\n`ready \u002F manual_only \u002F unavailable_credential`)와 요청 수·시간 추정을 먼저 보여준다.\n보고서에는 `scope_fingerprint`와 \"선택 범위 기준\" 커버리지를 기록한다. 재조사는 직전과\nfingerprint가 같을 때만 GONE·UNCHANGED 승계를 허용한다. fingerprint가 다르면 출처 제외를\nGONE으로 오판하지 말고 범위 변경으로 표시해 전체 재판정한다. 후보·수동 출처 목록과 등록\n조건은 `references\u002Fsources.md`를 따른다.\n\n## 재조사 (diff 모드)\n\n프로필의 `last_survey_dir`가 있으면 전수 재검토 대신 증분 조사:\n\n1. **직전과 같은 소스 구성으로** 1단계 크롤링을 그대로 실행 (새 보고서 폴더에)\n2. 비교:\n   ```bash\n   python3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fdiff_surveys.py\" \\\n       \u003C직전_폴더> \u003C새_폴더> --out new_items.jsonl \\\n       --old-profile \u003C직전_폴더>\u002Fprofile-snapshot.md --new-profile sole-profile.md \\\n       --incremental-sources fanfandaero,seoulshinbo\n   ```\n   `--incremental-sources`에는 `--since` 컷오프로 수집한 소스를 넣는다 — 그 소스는\n   이전 레코드 부재가 소멸이 아니므로 GONE을 계산하지 않는다\n3. 검토·상세검증은 `new_items.jsonl`(NEW+CHANGED+NEEDS_REHASH)만. GONE은 **별도 파일\n   `gone_new_items.jsonl`**에 기록된다(기회 소멸 알림 재료 — 검토 대상과 섞지 않는다).\n   UNCHANGED는 직전 판정 승계. 단 **프로필 fingerprint가 바뀌었다는 WARNING이 나오면 전체 재판정**\n4. **NEEDS_REHASH** = 직전 조사에 content_hash가 있었는데 새 목록엔 아직 없음. 목록 필드만으로\n   같아 보여도 본문·첨부가 바뀌었을 수 있으니 **상세 재수집(`detail --merge-into`) 후 해시를\n   채우고 재비교**한다 — 그때 같으면 승계, 다르면 변경 처리. **hash_version이 다른 경우**(해시\n   산식 v1↔v2)는 값 비교가 불가능하므로 1회 CHANGED로 분류된다 — 상세 재검증하면 이번\n   조사부터 양쪽 v2로 수렴한다\n5. **정책자금(loan) 전체와 직전 `확인됨` 항목은 diff 결과와 무관하게 접수상태를 재확인**\n6. 보고서: 신규 \u002F 변경(마감·조건 — changed_fields 표기) \u002F 소멸된 확인됨 항목(기회 소멸 알림) \u002F 승계 요약.\n   WARNING(미갱신 소스)은 coverage_manifest에 \"미갱신\" 명시\n\n## 1단계 — 수집\n\n```bash\nmkdir -p survey-$(date +%Y%m%d)\u002Fdetails && cd survey-$(date +%Y%m%d)\n\n# 소상공인24: 소진공 공고 + 통합조회(지자체·유관기관 포함) — 필수\npython3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fsbiz_crawl.py\" list all -o sbiz24.jsonl\n\n# 기업마당: 모집중 전체 전 페이지 (~96p, 2~3분) — 필수\npython3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fsources_crawl.py\" list -o bizinfo.jsonl\n\n# 판판대로: 온라인판로 사업목록 + 세부·수시 모집공고 게시판 — 권장\n#   (--since: 첫 조사는 1년 전, 재조사는 직전 조사일)\npython3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fregion_crawl.py\" list fanfan \\\n    -o fanfandaero.jsonl --since \u003CYYYY-MM-DD>\n\n# 서울신보: 프로필 province가 서울일 때만 — 권장 (서울시 사업 공고 원출처)\npython3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fregion_crawl.py\" list seoulshinbo \\\n    -o seoulshinbo.jsonl --since \u003CYYYY-MM-DD>\n\n# 보조금24: 선택 소스 (API 키 등록 시에만 — 상시 수혜 제도 커버)\npython3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fgov24_crawl.py\" list \\\n    -o gov24.jsonl --filter-target 소상공인\n\n# 프로필 스냅샷 (필수, 수집 직후) — 다음 diff의 --old-profile 재료\ncp ..\u002Fsole-profile.md profile-snapshot.md\n```\n\n게시판형 소스(판판대로 공지·서울신보)는 접수기간이 목록에 없어 status가 `불명`으로\n수집된다 — 선별에서 제목·게시일로 1차 거르고, candidate는 상세에서 접수 여부를 확인한다.\n`--since` 컷오프를 쓴 조사는 coverage_manifest에 컷오프 날짜를 명시한다 (전수 아님을 표기).\n\n**보조금24는 선택 소스**: 종료 코드 4(미활성)면 coverage_manifest에\n`미활성(선택 소스, API 키 미등록)`으로 기록하고 보고서 한계에 활성화 방법\n(data.go.kr 15113968 활용신청 → `DATA_GO_KR_API_KEY` 또는 `~\u002F.config\u002Fsole-search\u002Fapi_key`)을\n한 줄 안내한다. 활성 시 상시 제도는 보고서에 **\"상시 혜택(보조금24)\" 별도 섹션**으로\n다룬다 — 마감 기준 정렬인 \"오늘 신청할 것\"과 섞지 않는다. 키를 프로필·보고서 폴더에\n저장하지 않는다.\n\nstderr의 `TOTAL\u002FCOLLECTED\u002FDUPLICATES`·`PAGES\u002FCRAWLED`를 기록한다 — coverage_manifest 재료다.\n종료 코드 2는 부분 수집(partial)이다. **소스별 계약·수동확인 절차는 `references\u002Fsources.md`**,\n지역신보·지자체 포털은 `references\u002Fregion-registry.md` 참조.\n\n**중복 제거**: ① `(발행기관, 공고번호)` ② 정규화 canonical URL — 특히 sbiz24_combine의\n`PBLN_*` ID는 bizinfo의 pblancId와 같은 공고다 ③ 제목+기관+접수기간 전부 일치.\n애매하면 삭제하지 말고 묶어서 \"동일 사업 추정 N건\"으로 표기.\n\n## 1.5단계 — 전수 선별 (screening)\n\n100% 수집해도 일부만 읽으면 전수조사가 아니다:\n\n- 수집된 **모든** 레코드를 배치(예: 100건씩)로 나눠 빠짐없이 읽는다. 제목 키워드로 자동 제외 금지\n- 각 레코드에 `screening: candidate | excluded | needs_detail` + 제외 사유를 붙여 `screening.jsonl`로 저장\n- 프로필의 needs·업종·지역과 명백히 무관해도 \"excluded + 사유\"로 기록하고 넘어간다 (조용히 버리지 않는다)\n- 중단되면 어디까지 검토했는지 기록하고 coverage를 partial로 보고\n- **모델 분기(비용 최적화)**: 선별은 거친 1차 통과라 서브에이전트를 **저비용 모델**(Claude Code면\n  `model: haiku`)로 돌려도 된다 — 실수는 2단계 판정에서 걸러진다. 단 방향이 중요하다:\n  **애매하면 excluded가 아니라 `candidate`\u002F`needs_detail`로** (과소 선별은 2단계가 못 되살린다).\n  2단계 자격 판정은 원문·첨부 해석이 필요하므로 세션 기본 모델을 유지한다\n\n## 2단계 — 자격 판정\n\ncandidate와 needs_detail 레코드는 상세 원문을 확인한다:\n\n```bash\n# 소상공인24 상세+첨부 (첨부 자동 다운로드 + 목록 jsonl에 content_hash 병합)\npython3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fsbiz_crawl.py\" detail \u003CpbancSn> \\\n    --download-dir details -o details\u002F\u003CpbancSn>.json --merge-into sbiz24.jsonl\n# 기업마당 상세 (본문 해시 v2·첨부 링크를 목록에 병합 — 레코드에 hash_version: 2)\n#   --download-dir details 를 붙이면 첨부까지 다운로드·추출하고, 전부 성공 시\n#   해시 v3(본문+정렬된 첨부 sha256, hash_version: 3)를 스탬프한다 — v2↔v3 전환은\n#   diff가 1회 CHANGED로 흡수. 첨부 일부가 실패·생략되면 본문만의 v2 해시를 유지하고\n#   attachments_complete: false + exit 2로 첨부 미검증을 표현한다\npython3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fsources_crawl.py\" detail \"\u003CURL>\" \\\n    -o details --merge-into bizinfo.jsonl\n# 판판대로·서울신보 상세 (canonical_url로 소스 자동 판별, 소스별 jsonl에 병합)\n#   --download-dir details 를 붙이면 첨부까지 다운로드·추출한다 (bizinfo와 동일 계약:\n#   전부 성공 시 hash v3, 일부 실패·생략 시 본문 v2 유지 + attachments_complete: false\n#   + exit 2). 서울신보는 연속 다운로드 시 서버가 http 리다이렉트로 막는 경우가 있다 —\n#   blocked_redirect로 남으면 재실행하거나 수동 확인\npython3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fregion_crawl.py\" detail \\\n    \"\u003Ccanonical_url>\" -o details --merge-into \u003C해당소스>.jsonl [--download-dir details]\n# 첨부 텍스트 추출 (HWP는 hwp5txt→PrvText 미리보기 폴백 — 부분 추출\u002F실패 후보는 '확인 필요')\npython3 \"${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fsole-search\u002Fscripts\u002Fattach_extract.py\" \\\n    details\u002F\u003C파일> -o details\u002F\u003C파일>.txt\n```\n\n**sbiz24_combine 레코드의 상세 분기** (계약: references\u002Fsources.md §1):\n- ID가 `PBLN_*` → 기업마당 공고 — `sources_crawl.py detail \u003Cbizinfo URL>`로 검증\n- 비PBLN·비대출(`raw.pbancGubun`이 A(공단)\u002FD(지방정부)) → `sbiz_crawl.py detail \u003Csn>\n  --source sbiz24_combine --merge-into sbiz24.jsonl` — pbanc 상세 API를 공유한다\n  (2026-07-23 실호출 검증). **--merge-into 필수**: 목록 레코드의 pbancGubun 게이트 +\n  상세 응답 sn·제목 대조를 통과해야 병합한다(불일치 시 exit 2, 조용한 오독 금지)\n- `raw.pbancGubun`이 C(대출상품)·미지 코드·부재(구버전 목록) → 별도 네임스페이스\u002F계약\n  미확인이라 exit 2로 거부(fail-closed) — canonical_url로 수동 확인.\n  bizType=`대출상품` 문자열도 보조 검사로 거부된다\n\n판정 상태 5단계:\n\n| 상태 | 의미 |\n|---|---|\n| `확인됨` | 공고 원문(첨부 포함)에서 모든 필수 신청자격 충족 확인 |\n| `조건부` | 구체 요건 충족 시 가능 (예: 교육 이수 후) — 요건 명시 |\n| `확인 필요` | 프로필 또는 원문 부족 — 부족한 항목 명시 |\n| `신청 불가` | 필수요건 불충족 — 근거 문구 인용 |\n| `사업전환 후보` | 실제 사업전환 전제 — 별도 섹션, 기본 비표시 |\n\n검증 축: 업종 제한(제외 업종), 업력(공고 기준일로 산정), 상시근로자 수, 매출액 기준,\n소재지(본점\u002F사업장 구분), 기수혜 제외, 영업상태.\n\n규칙:\n- **판정 상태는 위 5개 중 정확히 하나** — '정보성', '조건부\u002F확인 필요' 같은 비표준·복합 상태 금지.\n  직접 신청 대상이 아닌 통합·메타 공고는 선별 단계에서 `excluded`(사유: 메타 공고, 세부공고로 신청) 처리\n- **접수 마감이 확정된 후보는 상세검증을 생략할 수 있다** — 단 보고서에 건수·대표 목록·\n  \"차기 재조사 우선확인 대상\"을 명시한다 (조용한 생략 금지)\n- **첨부를 읽지 못한 후보(`attachments_complete: false` 포함)는 `확인됨` 금지** → `확인 필요` + \"첨부 미확인(사유)\".\n  HWP의 PrvText 미리보기 추출(`extract_reason: hwp_preview_only`)은 **부분 추출**이라 여기에 해당한다\n- **status가 `불명`인 레코드는 접수 여부부터 상세에서 확인** — 크롤러는 낙관 추정하지 않는다\n- 크롤러 종료 코드 3(MANUAL)은 차단 신호다 — 재시도하지 말고 해당 소스를 manual로 기록\n- 각 판정에 근거 출처(문서·문구)를 기록\n- `확인됨` = 공고상 신청자격 확인일 뿐, 선정·대출심사 통과 예측이 아님 — 보고서에 명시\n- 연락처는 `contacts: [{kind: phone|email|url, value}]`, 없으면 \"연락처 미기재\"\n- 유형은 `primary_type`(grant|loan|advisory) + tags. loan에는 한도·금리(기준일)·기간·\n  거치·상환방식·보증기관을 채우고, 회차 접수상태는 sources.md의 수동확인 절차를 따른다\n\n## 3단계 — 보고서\n\n`survey-YYYYMMDD\u002Freport.md`. 사장님이 읽는 문서 — 관공서 용어에 괄호 해설. 구조:\n\n1. **오늘 신청할 것** — 전 유형 통합 `확인됨` 목록. 정렬: 마감 D-day 오름차순 →\n   예산소진 시까지(\"서두르세요\") → 상시 → 회차예정(예정일). 각 항목: 제목, 한 줄 요약,\n   금액\u002F혜택, 마감, 신청 방법·링크, 연락처. `확인됨` 목록 **뒤에** 남은 조건이 1개뿐인\n   `조건부`를 별도 하위 목록(🔶 \"조건 1개만 채우면 됨\")으로 붙일 수 있다 — 확인됨과\n   섞지 말고, 각 항목 첫 줄에 남은 조건을 명시하며, 정렬 규칙은 동일 적용\n2. **coverage_manifest** — 소스별 `collection_status`와 `screening_status`\n   (`success|partial|failed|manual`), collected\u002Fscreened\u002Fcandidate\u002Fdetail_verified 카운트.\n   **카운트는 소스별로 기재 — \"(합산)\" 뭉개기 금지**. 중복 제거 시 어느 소스에 귀속했는지\n   설명해 수집→선별 합계가 재검산 가능해야 한다. partial·manual·미갱신은 사유 명시.\n   **partial인 소스를 \"전수 수집 완료\"로 표현 금지**. 미커버 영역(미등록 지자체 포털 등) 한계 고지\n3. **유형별 상세** — 💰 받는 돈 \u002F 🏦 빌리는 돈 \u002F 🎓 배우고 돕기 순, 각 유형 안에서 판정 상태순.\n   🏦에는 \"갚아야 하는 돈입니다\" 문구 + 한도·금리(기준일)·기간·취급기관 필수\n4. **사업전환 후보** — 해당 시에만. 그 외 부가 정보(공통 준비물, 마감 후보 목록 등)는\n   번호 없는 \"비고\"로 붙인다\n\n**보고서 자가 점검** — 작성 직후 아래를 전부 확인하고, 어긋난 항목은 고친 뒤 완료 선언:\n\n- 판정 상태에 5개 enum 외 값·복합 표기 없음 (항목당 정확히 하나)\n- \"오늘 신청할 것\"에서 확인됨\u002F🔶조건부가 구분돼 있고 정렬 규칙(D-day 오름차순 → 예산소진 → 상시 → 회차예정) 준수\n- coverage_manifest 카운트가 소스별로 채워져 있고 수집→선별 합계가 재검산됨\n- 첨부 미추출 항목 전부가 상세 표에 `확인 필요`로 존재 (coverage 언급과 상세 표 판정 일치)\n- `확인 필요` 판정에 \"실무상 문제 가능성 낮음\" 류의 추정 보완 문구 없음 — 부족한 항목과 확인 방법만 적는다\n- 사장님용 본문에 내부 식별자(idx, candidate, needs_detail 등) 노출 최소화 — 감사 정보는 산출 파일에 있다\n\n완료 후 프로필의 `last_survey_at`·`last_survey_dir`를 갱신하고, **갱신된 현재\n`sole-profile.md`를 조사 폴더에 `profile-snapshot.md`로 복사(cp)한다** (필수 —\n다음 diff의 `--old-profile` 재료, 1단계에서 만든 스냅샷을 덮어써 최종본으로 남긴다).\n\n## 중단선\n\n403·CAPTCHA·로그인 요구를 만나면 우회(TLS 지문 변경, 내부 API 반복 재시도)하지 않는다.\n해당 소스를 manual로 전환하고 sources.md의 수동확인 절차를 보고서에 첨부한다.\n",{"name":5,"description":7},"main","f6fd9e8ec43af2465893382021091b9db2bd496a","skills\u002Fsole-search",11,"https:\u002F\u002Fgithub.com\u002Fdjfksjd\u002Fsole-search","https:\u002F\u002Fgithub.com\u002Fdjfksjd","Building ALIVE","2026-07-30 16:10:40",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add djfksjd\u002Fsole-search --skill sole-search",{"tool":38,"command":39},"bunx","bunx skills add djfksjd\u002Fsole-search --skill sole-search",{"tool":41,"command":42},"pnpm","pnpm dlx skills add djfksjd\u002Fsole-search --skill sole-search","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdjfksjd\u002Fsole-search\u002Fblob\u002Fmain\u002Fskills\u002Fsole-search\u002FSKILL.md",true,[46,52,56,62,66,70,74,78,82,86],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"references\u002Fregion-registry.md","REFERENCE","参考文档",3129,"https:\u002F\u002Fgithub.com\u002Fdjfksjd\u002Fsole-search\u002Fblob\u002Fmain\u002Fskills\u002Fsole-search\u002Freferences\u002Fregion-registry.md",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"references\u002Fsources.md",18203,"https:\u002F\u002Fgithub.com\u002Fdjfksjd\u002Fsole-search\u002Fblob\u002Fmain\u002Fskills\u002Fsole-search\u002Freferences\u002Fsources.md",{"path":57,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":60,"sourceHtmlUrl":61},"scripts\u002Fattach_download.py","SCRIPT","脚本",27614,"https:\u002F\u002Fgithub.com\u002Fdjfksjd\u002Fsole-search\u002Fblob\u002Fmain\u002Fskills\u002Fsole-search\u002Fscripts\u002Fattach_download.py",{"path":63,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":64,"sourceHtmlUrl":65},"scripts\u002Fattach_extract.py",14570,"https:\u002F\u002Fgithub.com\u002Fdjfksjd\u002Fsole-search\u002Fblob\u002Fmain\u002Fskills\u002Fsole-search\u002Fscripts\u002Fattach_extract.py",{"path":67,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":68,"sourceHtmlUrl":69},"scripts\u002Fdiff_surveys.py",13096,"https:\u002F\u002Fgithub.com\u002Fdjfksjd\u002Fsole-search\u002Fblob\u002Fmain\u002Fskills\u002Fsole-search\u002Fscripts\u002Fdiff_surveys.py",{"path":71,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":72,"sourceHtmlUrl":73},"scripts\u002Fgov24_crawl.py",22731,"https:\u002F\u002Fgithub.com\u002Fdjfksjd\u002Fsole-search\u002Fblob\u002Fmain\u002Fskills\u002Fsole-search\u002Fscripts\u002Fgov24_crawl.py",{"path":75,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":76,"sourceHtmlUrl":77},"scripts\u002Fregion_crawl.py",35637,"https:\u002F\u002Fgithub.com\u002Fdjfksjd\u002Fsole-search\u002Fblob\u002Fmain\u002Fskills\u002Fsole-search\u002Fscripts\u002Fregion_crawl.py",{"path":79,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":80,"sourceHtmlUrl":81},"scripts\u002Fsbiz_crawl.py",32268,"https:\u002F\u002Fgithub.com\u002Fdjfksjd\u002Fsole-search\u002Fblob\u002Fmain\u002Fskills\u002Fsole-search\u002Fscripts\u002Fsbiz_crawl.py",{"path":83,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":84,"sourceHtmlUrl":85},"scripts\u002Fscope_plan.py",16968,"https:\u002F\u002Fgithub.com\u002Fdjfksjd\u002Fsole-search\u002Fblob\u002Fmain\u002Fskills\u002Fsole-search\u002Fscripts\u002Fscope_plan.py",{"path":87,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":88,"sourceHtmlUrl":89},"scripts\u002Fsources_crawl.py",23495,"https:\u002F\u002Fgithub.com\u002Fdjfksjd\u002Fsole-search\u002Fblob\u002Fmain\u002Fskills\u002Fsole-search\u002Fscripts\u002Fsources_crawl.py",[91],{"skillNo":92,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":93,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":19},"01M79DBP2BKZ5XJQPDFBHQ4BSF","https:\u002F\u002Fgithub.com\u002Fdjfksjd\u002Fsole-search\u002Fblob\u002Fmain\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fdjfksjd\u002Fsole-search\u002Fblob\u002Fmain\u002FSKILL.md",[],[]]