챕터 05. GitHub 무료 도구로 나만의 지원사업 AI 작업실 만들기 (선택·심화)

2026년 11월 18일 기준 GitHub에는 한국 지원사업 공고를 5개 사이트(K-Startup·기업마당·NIPA·KOCCA·SMTECH)에서 모아 자격까지 검증하는 ir-search, HWP·HWPX·PDF를 AI가 읽고 쓰게 하는 kordoc, 공고 양식(HWPX)의 서식을 지키며 내용만 바꾸는 hwpxskill 같은 무료 공개 도구가 있습니다. 이 챕터는 그 도구 7개와 학습 자료 7개를 묶어 "공고 찾기 → 공고문 읽기 → 10단계 작성 → 결함 진단 → 양식 채우기 → 발표자료·재무표"까지 이어지는 나만의 AI 작업실을 만드는 방법을 설명합니다. 코딩을 몰라도 따라 할 수 있게 터미널 여는 법부터 다루지만, 선택(심화) 챕터이므로 챕터 01~04만으로도 계획서는 충분히 쓸 수 있습니다.

난이도 심화 · 예상 시간 90분
이 챕터를 마치면
  • GitHub 저장소의 별·업데이트·라이선스·README를 보고 쓸 만한 도구인지 판단할 수 있다
  • 터미널을 열고 Node.js·Python 설치 여부를 확인할 수 있다
  • ir-search·kordoc·hwpxskill 등으로 공고 찾기 → 공고문 읽기 → 양식 채우기 흐름을 구성할 수 있다
  • 작업실 폴더와 지시서를 만들어 AI 에이전트에게 단계별로 일을 맡길 수 있다
이 챕터는 선택(심화)입니다. 챕터 01~04와 2부 실습만으로도 사업계획서 초안까지 갈 수 있습니다. 이 챕터는 "같은 일을 더 빠르고 빠짐없이" 하고 싶은 분을 위한 것입니다. 저장소의 별 수·기능·설치 명령은 2026년 11월 18일 기준으로 각 저장소의 README(설명 문서)에서 확인한 내용이며, 이후 바뀔 수 있습니다. 실행 전에는 반드시 저장소의 최신 README를 다시 확인하세요.

1. GitHub이 뭐고, 왜 지원사업 준비에 쓸모가 있나

GitHub(깃허브)은 전 세계 개발자들이 프로그램 코드를 올려 두고 함께 고치는 웹사이트입니다. 여기에 올라온 프로그램 하나하나를 저장소(repository, 줄여서 repo)라고 부릅니다. 저장소 주소는 github.com/만든사람/저장소이름 형식이고, 이 챕터에서는 줄여서 만든사람/저장소이름(예: chrisryugj/kordoc)으로 씁니다.

최근 1~2년 사이 한국 개발자들이 "정부지원사업 공고 찾기", "한글(HWP) 문서를 AI가 읽게 하기", "사업계획서 결함 검사" 같은 도구를 무료로 공개하기 시작했습니다. 챕터 03에서 배운 10단계 중 시간이 가장 많이 드는 일 — 공고를 빠짐없이 찾고, 공고문 HWP를 AI에 넣고, 마지막에 HWP 양식에 옮기는 일 — 이 바로 이 도구들이 잘하는 일입니다.

1-1. 저장소 화면 읽는 법 (처음 들어갔을 때 볼 4가지)

보는 곳무엇인가어떻게 판단하나
★ Star(별)다른 사람이 "유용하다"고 눌러 준 북마크 수많을수록 많이 쓰이고 검증된 편. 수십 개 이하면 개인 프로젝트일 가능성이 높아 더 조심해서 검증
최근 업데이트 (커밋 날짜)마지막으로 코드가 고쳐진 날몇 년째 멈춰 있으면 지금 사이트 구조와 안 맞을 수 있음. 공고 사이트 크롤링 도구는 특히 최신인지 확인
License(라이선스)이 코드를 써도 되는 조건MIT·Apache-2.0은 개인·상업 사용이 비교적 자유로운 편. 라이선스 표기가 없거나 불분명하면 "개인 학습·사용은 하되, 재배포·상업 이용 전 확인" 원칙
README저장소 첫 화면 아래에 나오는 설명서무엇을 하는지, 설치 방법, 하지 않는 일(한계)이 적혀 있음. 설치 전 반드시 끝까지 읽기

그 밖에 Issues(이슈) 탭에는 사용자들이 올린 오류 신고가 있습니다. 설치하다 막히면 같은 오류를 누가 먼저 겪었는지 여기서 찾아보면 해결책이 있는 경우가 많습니다.

1-2. 안전 수칙 7가지 (꼭 지키세요)

  1. 별 수·최근 업데이트·라이선스·이슈를 먼저 확인합니다. 위 표의 기준대로요.
  2. 남의 코드를 실행하기 전에 README와 설치 스크립트를 읽습니다. 특히 curl … | bash처럼 "인터넷에서 받은 스크립트를 바로 실행"하는 명령은 편하지만, 내용을 모른 채 실행하면 내 컴퓨터에서 무엇이 일어나는지 알 수 없습니다. 주소를 브라우저로 열어 내용을 한 번 훑어보거나, 그 대신 단계별 수동 설치 방법을 쓰세요.
  3. API 키·비밀번호·주민번호·계좌번호를 파일이나 AI 대화에 넣지 않습니다. API 키는 "AI 서비스를 프로그램으로 쓰기 위한 비밀 열쇠"인데, 남이 보면 내 돈으로 AI를 쓸 수 있습니다.
  4. 미공개 아이디어·고객 개인정보(인터뷰 대상자 이름·전화번호)는 AI에 넣기 전에 지우거나 "사장님 A"처럼 바꿉니다.
  5. 크롤링(웹사이트에서 자동으로 정보 수집)은 각 사이트의 이용약관을 지킵니다. 짧은 시간에 너무 많이 반복 실행하지 말고, 필요할 때 한 번씩만 돌리세요.
  6. 별이 적은 개인 프로젝트는 "참고용"으로 쓰고 결과를 반드시 사람이 검증합니다.
  7. 도구가 낸 결과도 최종 판단은 원문 공고로 합니다. 도구는 공고를 놓치거나 잘못 읽을 수 있습니다.

2. 시작 전 준비 — 코딩을 몰라도 됩니다

2-1. 코딩 없이 vs 도구를 쓰면 — 무엇이 달라지나

할 일코딩 없이 (웹 AI + 챕터 03 프롬프트)GitHub 도구를 쓰면
공고 찾기K-Startup·기업마당에서 직접 검색, 키워드에 안 걸리는 공고는 놓치기 쉬움ir-search가 여러 사이트의 모집중 공고를 전부 훑고 내 조건으로 A·B·C 그룹 분류
공고문 HWP 읽기한글에서 PDF로 저장 후 AI에 올림, 표가 깨질 수 있음kordoc이 HWP·HWPX·PDF를 표 구조를 살린 Markdown으로 변환
10단계 작성한 대화방에서 프롬프트를 하나씩 복사작업실 폴더 + 지시서로 에이전트가 순서대로 진행하고 단계별 파일 저장
결함 진단챕터 03 ⑥ 근거 검수 프롬프트plan-lint가 누락·분량·수치 모순을 규칙으로 먼저 잡고, 원문 인용과 함께 보고
HWP 양식에 옮기기한글을 열고 목차별로 복사·붙여넣기hwpxskill·hwpx-skill로 양식 서식을 지키며 내용만 교체, kordoc으로 HWPX 생성
발표자료·재무표AI가 준 목차를 보고 직접 PPT·엑셀 작성anthropics/skills의 pptx·xlsx 스킬로 파일까지 생성

결론: 계획서 내용의 질은 챕터 01~04가 결정합니다. 도구는 시간과 누락을 줄여 줄 뿐입니다.

2-2. 용어 정리 (처음 보는 말만)

용어쉬운 뜻
터미널마우스 대신 글자로 컴퓨터에 명령하는 창. Mac은 "터미널", Windows는 "PowerShell"
명령어터미널에 입력하는 한 줄. 이 페이지의 회색 상자(pre) 안 글자를 그대로 복사해 붙여 넣고 Enter
Node.js / npm / npxNode.js는 자바스크립트 프로그램을 돌리는 엔진, npm은 그 프로그램을 설치하는 도구, npx는 설치 없이 한 번 실행하는 도구. kordoc이 사용
Python / pipPython은 또 다른 프로그래밍 언어 엔진, pip는 Python 프로그램 설치 도구. plan-lint·ir-search 일부가 사용
clone(클론)GitHub 저장소를 내 컴퓨터에 통째로 복사해 오는 것 (git clone 주소)
스킬(Skill)AI 에이전트에게 주는 "작업 설명서 + 보조 프로그램" 묶음. 폴더 하나에 들어 있고, 에이전트가 필요할 때 읽어서 따라 함
플러그인(Plugin)스킬·설정 등을 한 번에 설치할 수 있게 포장한 것. "마켓플레이스 추가 → 설치" 두 단계가 보통
MCPModel Context Protocol. AI 앱이 외부 도구(예: 문서 변환기)를 "손발처럼" 불러 쓰게 연결하는 표준 규격. 연결해 두면 AI에게 "이 HWP 읽어 줘"라고 말만 하면 됨
CLICommand Line Interface. 터미널에서 명령어로 쓰는 프로그램
Markdown(마크다운)# 제목, - 목록처럼 기호로 서식을 표시하는 글 형식. AI가 가장 잘 읽고 쓰는 형식

2-3. 터미널 처음 열기

Mac

  1. Command(⌘) + Space를 눌러 Spotlight 검색을 엽니다.
  2. "터미널" 또는 "Terminal"을 입력하고 Enter.
  3. 검은(또는 흰) 창에 깜빡이는 커서가 보이면 준비 완료입니다.

Windows

  1. 시작 버튼을 누르고 "PowerShell"을 입력합니다.
  2. "Windows PowerShell"을 클릭해 엽니다(관리자 권한은 꼭 필요할 때만).

2-4. 설치되어 있는지 확인하는 명령

터미널에 아래를 한 줄씩 입력해 보세요. 숫자(버전)가 나오면 설치된 것입니다.

node -v
python3 --version
git --version

2-5. 어떤 AI 에이전트를 쓸까

에이전트특징비용
Claude CodeAnthropic의 코딩 에이전트. 폴더 안 파일을 읽고 쓰고, 스킬·플러그인·MCP를 지원. 이 챕터 도구 대부분이 지원유료 플랜 필요 (가격은 서비스·시기별로 다름)
CodexOpenAI의 코딩 에이전트. ir-search·kordoc·hwpx-skill 등이 지원요금제는 서비스·시기별로 다름
Gemini CLIGoogle의 터미널용 AI. ir-search가 확장(extension)으로 지원무료 사용 범위는 서비스 정책에 따라 다름
Cursor 등코드 편집기에 AI가 붙은 형태. 일부 도구가 지원서비스별로 다름

돈을 아끼려면: 먼저 챕터 03 프롬프트로 웹 AI(무료 계정)에서 해 보고, 반복 작업이 많아져 시간이 아까울 때 에이전트를 고려하세요. 에이전트 없이도 kordoc CLI(터미널 명령)는 단독으로 쓸 수 있습니다.

3. 나만의 지원사업 AI 작업실 — 전체 그림

도구 하나하나보다 순서가 중요합니다. 아래 6단계는 챕터 03의 10단계와 관문 3곳에 그대로 연결됩니다.

나만의 지원사업 AI 작업실 흐름① 공고 전수조사ir-search → 후보 A·B·C 그룹사람: 후보 3개② 공고문 읽기kordoc: HWP·PDF → Markdown③ 계획서 작성챕터 03 AI 10단계사람: 전략 선택④ 결함 진단plan-lint (참고용)⑤ 한글 양식 채우기hwpxskill · hwpx-skill사람: 제출⑥ 발표·재무 파일anthropics/skills (pptx·xlsx)
그림 1. 나만의 지원사업 AI 작업실 — 도구 6단계와 사람이 결정하는 곳
① 공고 전수조사      ir-search        → 후보 A·B·C 그룹 보고서         [관문 ① 사람이 후보 3개 확정]
        ↓
② 공고문·양식 읽기   kordoc           → 공고문 HWP/PDF → Markdown, 양식 구조 파악
        ↓
③ 10단계 작성        지시서 + 에이전트 → 인터뷰·조사·반대증거·재무·초안  [관문 ② 사람이 전략 선택]
        ↓
④ 결함 진단          plan-lint        → 누락·분량·수치 모순·근거 없는 주장 목록
        ↓
⑤ 양식에 채우기      hwpxskill / hwpx-skill / kordoc generate → 제출용 HWPX
        ↓                                                           [관문 ③ 사람이 사실 증거 채우고 제출]
⑥ 발표·재무 파일     anthropics/skills (pptx, xlsx) → 발표자료, 재무 추정표
단계도구넣는 것나오는 것사람이 확인할 것챕터 연결
①ir-search내 프로필(단계·지역·필요)A·B·C 그룹 보고서, 원문 URLA그룹 공고를 원문으로 열어 자격·마감 재확인챕터 01 공고 검토 5단계
②kordoc공고문·양식 HWP/HWPX/PDFMarkdown(표 포함)표 숫자(배점·금액)가 원문과 같은지챕터 01 공고 분석 프롬프트
③에이전트 + 지시서공고 Markdown, 내 메모, 인터뷰단계별 결과 파일, 초안관문 ①②에서 멈췄는지, 숫자 출처챕터 03 10단계
④plan-lint초안 Markdown결함 보고서(원문 인용)지적이 맞는지, 고칠지 결정챕터 03 ⑥ 근거 검수
⑤hwpxskill 등공고 HWPX 양식 + 최종 원고내용이 채워진 HWPX한글로 열어 쪽수·서식·잔재 문구 확인챕터 03 ⑩ 문서 완성
⑥anthropics/skills최종 원고, 재무 가정PPTX, XLSX발표 숫자 = 계획서 숫자, 수식 검산챕터 04 발표·재무

4. 도구 ① ir-search — 지원사업 공고 전수조사

저장소: djfksjd/ir-search · ★394 · MIT (2026-11-18 기준)

4-1. 무엇을 하나

README 기준으로, 한국 정부·공공기관 지원사업을 "전수조사"하는 스킬입니다. K-Startup·기업마당(bizinfo)·NIPA·KOCCA·SMTECH의 모집중 공고를 모은 뒤, 내 프로필(창업 단계·지역·필요한 것: 자금/공간/R&D)에 맞는 사업을 골라 상세공고 원문으로 자격요건을 검증하고, 세 그룹으로 나눈 보고서를 만들어 줍니다.

그룹뜻내가 할 일
A그룹지금 신분 그대로 자격 충족 — 즉시 지원 가능 (마감순, 임박 강조)원문 확인 후 챕터 01 후보 메모로
B그룹요건을 충족하면 열림 — 법인 설립·투자유치 같은 "트리거"와 이어지는 경로 표시로드맵으로 저장, 연간 캘린더에 반영
C그룹아이템을 다른 분야 언어로 재서술(프레이밍)하면 가능무리한 각색인지 판단, 애매하면 문의처에 전화

왜 키워드 검색이 아니라 전수조사인가? README의 설명대로, 키워드로는 안 걸리지만 내 아이템이 지원할 수 있는 사업(예: 다른 부처의 콘텐츠·사회서비스 관련 사업)이 있기 때문입니다. 결과는 ~/Documents/지원사업조사_대상_날짜/ 폴더에 보고서(md), 원시 데이터(jsonl), 상세공고 원문으로 저장되고, 공고에 없는 정보는 추정하지 않고 '불명'으로 적는다고 README에 쓰여 있습니다.

4-2. 조사 범위 고르기 (프리셋)

프리셋용도언제
quickK-Startup 한 곳만 빠르게처음 써 볼 때, 주간 점검
focused내가 고른 등록 소스 한 곳만특정 기관만 볼 때
recommendedK-Startup·기업마당 + 프로필과 맞는 자동 소스 (권장)본격 후보 찾기
all_registered자동화된 모든 등록 소스놓친 게 없는지 한 번 크게
all_known후보·수동 확인 소스까지 계획연초 통합공고 시즌
custom--include로 지정한 소스만익숙해진 뒤

README에 따르면 범위를 정하는 scope_plan.py는 네트워크·API·LLM을 호출하지 않습니다. 실제 수집은 그다음 단계에서 일어나니, 계획부터 확인하고 돌리면 불필요한 수집을 줄일 수 있습니다.

4-3. 설치

방법 A — 한 줄 설치 (설치된 에이전트를 자동으로 찾아 설치. 편하지만, 실행 전 스크립트 내용을 브라우저로 열어 확인하는 것을 권장합니다)

curl -fsSL https://raw.githubusercontent.com/djfksjd/ir-search/main/install.sh | bash

방법 B — 쓰는 에이전트별 수동 설치

Claude Code

claude plugin marketplace add djfksjd/ir-search
claude plugin install ir-search@djfksjd

Codex

codex plugin marketplace add djfksjd/ir-search
codex plugin add ir-search@djfksjd

Gemini CLI

gemini extensions install https://github.com/djfksjd/ir-search
pip3 install 'curl_cffi>=0.15'

README 기준 Claude Code·Codex는 필요한 부품(curl_cffi)을 세션 시작 시 자동 설치하고, Gemini CLI·agy는 위처럼 따로 설치합니다. 설치 후에는 에이전트를 껐다 켜야 새 플러그인이 보이는 경우가 많습니다.

4-4. 첫 실행 — 재고콕으로 해 보기

예시 — 재고콕프로필: 예비창업자(사업자 등록 전) · 서울(가정) · 필요: 자금(사업화) · 아이템: 동네 카페용 재고 자동 발주 앱(소프트웨어, SaaS) · 대표 연령은 공고 자격 판단에 쓰이므로 실제 나이를 넣되 이름은 넣지 않음.

에이전트(예: Claude Code)를 작업실 폴더에서 열고, 아래처럼 말합니다. 처음에는 quick으로 작게 시작하세요.

AI에 붙여 넣을 프롬프트
AI 답 예시(가상)※ 아래는 보고서 형식을 보여 주기 위한 가상 예시입니다. 공고명·숫자는 실제가 아닙니다.

# 지원사업 전수조사 — 재고콕 (카페 재고 SaaS, 예비창업자, 서울)
조사 범위 quick · K-Startup 모집중 공고 [N]건 검토 → 후보 [n]건 상세 검증

## A그룹 — 지금 즉시 지원 가능 (마감순)
1. [예시 공고명 1] — [주관기관]
  - 지원: [공고 원문의 지원 내용]
  - 자격: 예비창업자 포함 ✓ · 지역 제한 없음 ✓ · 연령 [불명 — 원문에 기재 없음]
  - 마감: [YYYY-MM-DD HH:MM] (D-[n])
  - [원문 URL]

## B그룹 — 요건 충족 시 열림
- [예시 공고명 2]: 트리거 = 사업자 등록(창업 3년 이내 대상). 경로: 모두의 창업 준비 → 사업자 등록 → 초기 단계 사업

## C그룹 — 프레이밍하면 가능
- [예시 공고명 3]: "재고 앱"이 아니라 "소상공인 식자재 폐기 감소 서비스"로 재서술하면 대상. 위험: 실제 폐기 감소 데이터가 없으면 과장으로 읽힘(위험도 중)

## 부재 확인
- [사업명]: 현재 모집중 아님 — 통상 공고 시기 확인 필요

4-5. 결과를 받은 뒤 할 일

  1. A그룹 공고를 하나씩 원문 링크로 열어 챕터 01의 공고 검토 5단계(종류·자격·제외·마감·평가표)로 다시 확인합니다.
  2. 중복 판단 4질문을 적용합니다. 도구는 내 과거 수혜 이력을 모릅니다.
  3. 최종 후보 3개를 챕터 01 "후보 지원사업 3개 메모" 표로 옮깁니다. — 관문 ①은 사람이 닫습니다.
  4. B그룹은 연간 캘린더(챕터 01)에 "트리거 → 다음 사업" 순서로 적어 둡니다.

4-6. 주의

5. 도구 ② kordoc — HWP·HWPX·PDF를 AI가 읽고 쓰게

저장소: chrisryugj/kordoc · ★3,035 · MIT (2026-11-18 기준)

5-1. 무엇을 하나

README의 표현대로 "한국 공문서를 AI가 읽고 쓸 수 있게" 하는 도구입니다. HWP(3.x·5.x), HWPX, HWPML, PDF, XLS·XLSX, DOCX, PPTX, 이미지(스캔본은 OCR=글자 인식)를 Markdown과 구조화 데이터로 바꾸고, 반대로 Markdown에서 HWPX·HWP 문서를 만듭니다. 라이브러리·CLI(터미널 명령)·MCP 서버(AI 앱에 연결) 세 가지 방식으로 쓸 수 있고, MCP로 연결하면 README 기준 22개 도구를 AI가 불러 씁니다.

지원사업에서 쓰는 곳은 두 군데입니다.

5-2. 설치

Node.js 20 이상이 필요합니다(2-4 참고).

# 설치 없이 바로 한 번 써 보기
npx kordoc 공고문.hwpx -o 공고문.md

# 계속 쓸 거라면 설치
npm install kordoc

AI 앱에 연결(MCP) — 연결하면 터미널 명령 없이 AI에게 "이 파일 읽어 줘"라고 말하면 됩니다.

# 설치된 Claude Desktop·Claude Code·Cursor·Codex 등을 찾아 자동 등록
npx -y kordoc setup

Claude Code 플러그인으로 설치하려면 Claude Code 안에서:

/plugin marketplace add chrisryugj/kordoc
/plugin install kordoc@kordoc

Claude 앱(데스크톱)은 README 기준 플러그인 디렉터리에서 kordoc을 찾아 설치할 수 있습니다. 등록 후에는 앱을 다시 시작하세요.

5-3. 자주 쓸 명령 (README 예시 기준)

하고 싶은 일명령
HWPX 공고문 → Markdownnpx kordoc 공고문.hwpx -o 공고문.md
PDF 일부 쪽만 JSON으로npx kordoc 문서.pdf --format json --pages 1-3
스캔본 PDF 글자 인식npx kordoc 스캔본.pdf --ocr -o 스캔본.md
옛 HWP → HWPX 변환npx kordoc to-hwpx 양식.hwp -o 양식.hwpx
Markdown 원고 → HWPX 문서npx kordoc generate 보고서.md --preset 보고서 -o 보고서.hwpx
템플릿에 값 채우기npx kordoc fill --template gian -j 값.json -o 기안문.hwpx
HWPX 문서 검사npx kordoc lint 보고서.hwpx --gate --preset 보고서

--preset 보고서, --template gian(기안문)은 README 예시에 나온 이름입니다. 사업계획서 양식은 공고마다 다르므로, 제출 양식 자체를 채울 때는 6장 hwpxskill처럼 공고가 준 원본 양식을 기준으로 하는 편이 안전합니다.

5-4. 첫 실행 — 재고콕

예시 — 재고콕K-Startup에서 받은 [예시 공고문].hwp와 [사업계획서 양식].hwp를 작업실/공고/에 넣고, 둘 다 Markdown으로 바꿔 작업실/공고/md/에 저장. 그다음 챕터 01 "공고 분석 프롬프트"를 그 Markdown에 적용.
cd 작업실/공고
npx kordoc to-hwpx 공고문.hwp -o 공고문.hwpx
npx kordoc 공고문.hwpx -o md/공고문.md
npx kordoc to-hwpx 양식.hwp -o 양식.hwpx
npx kordoc 양식.hwpx -o md/양식.md

MCP로 연결했다면 에이전트에게 이렇게 말해도 됩니다.

AI에 붙여 넣을 프롬프트
AI 답 예시(가상)※ 형식 예시입니다.
변환 완료: 공고/md/공고문.md, 공고/md/양식.md
| 항목 | 내용 | 근거 |
| 업력 기준 | [공고 원문 문구] | 제[n]조 [n]항 |
| 평가 배점 | 문제 인식 [n]점 / 실현 가능성 [n]점 / … | 붙임 [n] 평가표 |
| 분량 | [양식에 적힌 쪽수 제한] | 양식 작성 요령 |
⚠ 확인 필요: 평가표 3쪽의 병합 칸 숫자는 원문 PDF와 대조 권장

5-5. 주의

6. 도구 ③④ hwpxskill · hwpx-skill — 공고 양식(HWPX)에 내 계획서 채우기

정부지원사업 계획서는 대부분 공고가 준 한글 양식에 써야 합니다. 서식(글꼴·표·칸 병합·여백·쪽수)을 망가뜨리면 보기 나쁜 것은 물론 분량 규정 위반이 될 수도 있습니다. 이 두 스킬은 그 문제를 다룹니다.

6-1. Canine89/hwpxskill (★339, 2026-11-18 기준 · 라이선스 표기는 저장소에서 확인 필요)

무엇을 하나: README 기준, 원본 HWPX 양식을 넣으면 스타일·표 구조·셀 병합·여백까지 분석해 구조를 보존한 채 내용만 바꿔 줍니다. 작업 후 page_guard.py가 원본 대비 쪽수가 달라졌는지, content_guard.py가 원문 잔재·placeholder(예: "○○○를 입력하세요" 같은 안내 문구)가 남았는지 검사합니다. Claude Code·Cursor·Codex CLI에서 동작합니다.

언제 쓰나: 챕터 03 ⑩ "문서 완성" 단계 — 최종 원고가 확정된 뒤, 공고 양식에 옮길 때.

설치: 저장소를 복사(clone)한 뒤, 쓰는 에이전트의 스킬 폴더에 넣습니다. 스킬 폴더 위치는 에이전트마다 다르니 저장소 README의 에이전트별 안내를 따르세요.

git clone https://github.com/Canine89/hwpxskill.git

6-2. jkf87/hwpx-skill (★312, 2026-11-18 기준 · README에 MIT 표기)

무엇을 하나: README 기준, HWP/HWPX 문서 변환·생성·읽기·편집을 위한 AI 에이전트 스킬(Claude·Codex)입니다. Windows에서는 설치된 한컴오피스로 HWP를 HWPX로 바꾼 뒤 작업을 이어 갑니다. 레퍼런스 양식을 복제해 문구를 바꾸는 흐름에서 map_preflight.py로 바꿀 자리를 뽑고(dump) 점검한 뒤(check), fill_hwpx.py replace로 채우고, residue로 원본 문구 잔재를 검사합니다. 원샷 생성 유형으로 official-letter, brief-report, plan-report, markdown을 지원합니다.

언제 쓰나: 양식 채우기 외에, 사업계획서 요약본·내부 보고서를 HWPX로 새로 만들 때(plan-report, brief-report).

# README의 치환 흐름 예시 (저장소 폴더 안에서)
python3 scripts/map_preflight.py dump    base.hwpx
python3 scripts/map_preflight.py check   base.hwpx --map map.json
python3 scripts/fill_hwpx.py    replace  base.hwpx out.hwpx --map map.json
python3 scripts/map_preflight.py residue out.hwpx --against base.hwpx

명령을 직접 치기 어렵다면, 스킬을 설치한 에이전트에게 아래 프롬프트처럼 "말로" 시키면 에이전트가 이 명령들을 대신 실행합니다.

6-3. 첫 실행 — 재고콕 원고를 양식에 채우기

예시 — 재고콕준비: 공고/양식.hwpx(공고가 준 원본 양식), 초안/최종원고.md(챕터 03 ⑨까지 끝난 원고, 목차가 양식과 같음). 결과: 제출/재고콕_사업계획서.hwpx.
AI에 붙여 넣을 프롬프트
AI 답 예시(가상)※ 형식 예시입니다.
저장: 제출/사업계획서.hwpx
- 쪽수: 원본 양식 [n]쪽 → 결과 [n+1]쪽 ⚠ "3. 성장 전략"이 약 1/3쪽 넘침. 줄일 후보 문장 3개: (1) … (2) … (3) …
- 잔재 검사: 안내 문구 1건 남음 — "※ 작성 시 삭제" (2쪽 표 아래) → 삭제 완료
- 직접 확인할 곳: 사업비 표 합계 칸, 일정표 병합 칸, 첫 쪽 블라인드 위반 여부

6-4. 주의

7. 도구 ⑤ anthropics/skills — Word·PPT·엑셀 파일 만들기

저장소: anthropics/skills · Anthropic 공식 Agent Skills 저장소 · ★약 19.7만 (2026-11-18 기준)

7-1. 무엇이 들어 있나

저장소의 skills 폴더에는 여러 스킬이 있고, 지원사업 준비에 직접 쓸 만한 것은 다음과 같습니다.

스킬쓰는 곳재고콕 예
docxWord 문서 생성·편집양식이 Word(docx)인 공고의 계획서, 인터뷰 요약 보고서
pptxPowerPoint 발표자료발표평가·오디션용 슬라이드(챕터 04 발표 대비와 연결)
xlsx엑셀 파일·수식3년 추정 손익표, 손익분기·민감도 표
pdfPDF 다루기PDF 공고문 읽기, 제출용 PDF
doc-coauthoring문서를 함께 쓰는 흐름초안 공동 작성·수정
skill-creator나만의 스킬 만들기"내 지원사업 작업 순서"를 스킬로 만들어 매번 재사용

설치·사용 방법은 Claude 앱인지 Claude Code인지에 따라 다르고 바뀔 수 있으므로, 저장소 README의 최신 안내를 따르세요.

7-2. 첫 실행 — 재고콕 발표자료와 재무표

AI에 붙여 넣을 프롬프트
AI에 붙여 넣을 프롬프트
AI 답 예시(가상)※ 형식 예시입니다.
재무추정.xlsx 생성 — 손익분기 셀 수식: =ROUNDUP(가정!B3/(가정!B1-가정!B2),0) → 200(곳)
확인할 것: 가정 시트의 신규 고객 가정 근거(인터뷰·거래처 제휴)가 원고와 같은지

8. 도구 ⑥ plan-lint — 사업계획서 결함 진단 (참고용)

저장소: Choihello/plan-lint · ★1 · MIT (2026-11-18 기준)

먼저 알아둘 점: 별이 1개인 개인 프로젝트입니다. 아이디어는 유용하지만 널리 검증된 도구는 아니므로 참고용으로 쓰고, 지적 내용은 반드시 사람이 판단하세요.

8-1. 무엇을 하나

README 기준, 정부 창업지원사업 사업계획서의 객관적 결함을 원문 인용과 함께 짚어 주는 CLI입니다.

기본 검사 기준(프로파일)은 예비창업패키지 PSST 표준이고, 공고별 프로파일(yaml 파일)을 추가할 수 있다고 README에 쓰여 있습니다. 2027년에는 예비창업패키지가 정부안에서 0원이므로, 모두의 창업·초기창업패키지 양식에 맞게 프로파일을 손봐야 정확도가 올라갑니다.

8-2. 설치와 실행

git clone https://github.com/Choihello/plan-lint.git
cd plan-lint
pip install -e .

# API 키 없이 규칙 검사만
plan-lint 사업계획서.md --rules-only

# 점검 보고서 파일로 (README 예시 그대로 — 키가 필요한 전체 검사)
plan-lint 사업계획서.md --report out.md

LLM 검사까지 하려면 Anthropic 또는 OpenAI API 키(유료)가 필요합니다. 키 없이 --rules-only로도 누락·분량·수치 모순은 잡을 수 있습니다. 키는 절대 파일에 적어 공유하지 마세요.

8-3. 재고콕에 적용

예시 — 재고콕초안/최종원고.md를 --rules-only로 검사 → "사업비 표 합계 3,000만원 vs 본문 '총 3,200만원' 불일치" 같은 지적이 나오면 어느 쪽이 맞는지 사람이 확인해 고칩니다. (예시 지적은 가상)
AI에 붙여 넣을 프롬프트

9. 도구 ⑦ StartupKit — 아이디어 단계 검증 (영어)

저장소: mohamedameen-io/StartupKit · ★170 · MIT (2026-11-18 기준)

README 기준, Claude Code용 아이디어 검증 파이프라인입니다. 11단계 — diverge(아이디어 넓히기) → niche(틈새 고르기) → competitors(경쟁사) → positioning(포지셔닝) → offer(제안) → validate(검증) → money(수익) → leads(잠재 고객) → skills(AI 스킬 활용 계획) → pitch(피치) → export(내보내기) — 를 스킬로 하나씩 진행하고, API 키가 필요 없습니다.

언제 쓰나: 아직 아이템이 확정되지 않았을 때, 챕터 02 문제 정의 전에 "어떤 고객의 어떤 문제를 풀지"를 넓게 탐색하는 용도. 영어 기반이므로 결과를 한국 지원사업 언어(PSST)로 옮기는 프롬프트를 함께 쓰세요.

AI에 붙여 넣을 프롬프트

10. 작업실 만들기 — 폴더 구조와 지시서 전문

도구를 설치했다면 이제 "작업실"을 만듭니다. 에이전트는 폴더를 열면 그 안의 지시서 파일(Claude Code는 CLAUDE.md, Codex 등은 AGENTS.md를 읽는 경우가 많음)을 먼저 읽고 그 규칙대로 일합니다. 챕터 03의 지시서에 이 챕터의 도구 순서를 더한 버전입니다.

10-1. 폴더 구조

지원사업작업실/
  CLAUDE.md            ← 지시서 (Codex 등은 같은 내용을 AGENTS.md로)
  내자료/
    아이템메모.md        ← 문제·고객·해 본 것
    인터뷰/             ← 인터뷰 메모 (이름은 "사장님 A"로)
    내글.md             ← 말투 기준 글 1~2쪽
    경력실적.md          ← 사실만: 기간·역할·숫자
  공고/
    원본/               ← K-Startup에서 받은 공고문·양식 (HWP/HWPX/PDF)
    md/                 ← kordoc 변환 결과
  조사/
    전수조사/            ← ir-search 보고서 복사본
    출처목록.md          ← 직접 확인한 출처만
  초안/                 ← 10단계 결과 파일 (01_인터뷰.md … 10_최종원고.md)
  점검/                 ← plan-lint 보고서, 모의심사 결과
  제출/                 ← 최종 HWPX, PPTX, XLSX

10-2. 지시서 전문 (복사해서 CLAUDE.md 또는 AGENTS.md로 저장)

AI에 붙여 넣을 프롬프트

10-3. 첫 메시지 예시

AI에 붙여 넣을 프롬프트

11. 문제 해결 — 설치하다 막혔을 때

증상흔한 원인해결 요령
command not found: node / npxNode.js 미설치 또는 설치 후 터미널을 다시 안 엶nodejs.org에서 LTS 설치 → 터미널을 완전히 닫았다 다시 열기 → node -v
kordoc 실행 시 버전 관련 오류Node.js가 20 미만node -v 확인 후 최신 LTS로 업데이트
pip 권한 오류(Permission denied)시스템 Python에 설치하려 함pip install --user … 또는 가상환경(python3 -m venv .venv 후 활성화)에서 설치. sudo pip는 피하기
python3가 Windows에서 안 됨Windows는 python/py 명령을 씀py --version 시도, 안 되면 python.org 설치 시 PATH 체크
설치한 플러그인·스킬이 안 보임에이전트가 시작될 때만 읽음에이전트(앱)를 완전히 종료 후 다시 시작, 설치 위치가 README 안내와 같은지 확인
한글 파일명·내용이 깨짐인코딩·글꼴 문제, 옛 HWP 형식파일명을 영어로 바꿔 보기, HWP는 먼저 HWPX로 변환(kordoc to-hwpx) 후 작업
변환된 표가 이상함복잡한 병합 칸, 스캔본PDF로도 변환해 비교, 스캔본은 --ocr, 숫자는 원문 대조
크롤링 결과가 0건사이트 구조 변경, 일시 장애, 범위가 좁음잠시 후 재시도, 프리셋을 recommended로, 저장소 Issues에서 같은 증상 검색
채운 HWPX가 한글에서 경고서식 XML 손상 가능성원본 양식으로 다시 시작, 쪽수·잔재 검사 재실행, 그래도 안 되면 한글에서 직접 붙여넣기

막혔을 때 가장 빠른 방법: 오류 메시지를 통째로 복사해 AI에게 "이 오류가 났어. 나는 [Mac/Windows]이고 [어떤 명령]을 실행했어. 초보자도 따라 할 수 있게 한 단계씩 알려 줘"라고 묻기.

12. 도구 없이 같은 일을 하는 대체법

도구대체법 (코딩 없음)
ir-searchK-Startup "사업공고"와 기업마당에서 내 단계·지역으로 필터 → 목록을 복사해 AI에 붙이고 "이 목록에서 예비창업자·서울·사업화 자금에 맞는 것만 표로, 원문 확인 필요 표시"
kordoc한글(또는 한글 뷰어)에서 공고문을 PDF로 저장 → 웹 AI에 PDF 업로드. 표가 많으면 표를 캡처해 이미지로도 함께 올리기
hwpxskillAI에게 "양식 목차 순서대로 나눠서, 한 항목씩 복사하기 좋게 출력"을 시키고 한글에서 직접 붙여넣기(서식은 "텍스트만 붙여넣기")
plan-lint챕터 03 ⑥ 근거 검수 + ⑩ 최종 점검 프롬프트, 챕터 04 블라인드 검사 프롬프트
anthropics/skillsAI에게 슬라이드별 제목·문장·도표 아이디어를 받아 PPT에 직접, 엑셀은 챕터 04의 수식을 그대로 입력

13. 더 배우고 싶다면 — 무료 학습 자료 (GitHub)

저장소별 (2026-11-18)라이선스무엇을 배우나
anthropics/prompt-eng-interactive-tutorial약 3.9만저장소에서 확인Anthropic의 대화형 프롬프트 엔지니어링 튜토리얼 — 역할·예시·형식 지정 등 기본기
dair-ai/Prompt-Engineering-Guide약 8만MIT프롬프트 기법 총정리 가이드
microsoft/generative-ai-for-beginners약 12.4만MIT생성형 AI 입문 21강
f/prompts.chat약 17.8만저장소에서 확인옛 이름 Awesome ChatGPT Prompts — 역할별 프롬프트 모음(아이디어 참고용)
anthropics/claude-cookbooks—MITClaude 활용 예제 모음(개발자용)
openai/openai-cookbook—MITOpenAI API 활용 예제(개발자용)
google-gemini/cookbook—Apache-2.0Gemini API 활용 예제(개발자용)

추천 순서: 비개발자라면 prompt-eng-interactive-tutorial(기본기) → Prompt-Engineering-Guide(기법) → generative-ai-for-beginners(전체 이해). cookbook 3종은 API로 직접 프로그램을 만들고 싶을 때.

확인 기준과 남기는 것

확인 기준: 내 상황에서 도구를 쓸지 말지 정했고, 쓴다면 어떤 단계에 어떤 도구를 쓸지 작업실 지시서에 적었는가?

남기는 것: 작업실 폴더 + 지시서(CLAUDE.md/AGENTS.md) + ir-search 첫 보고서(또는 대체법으로 만든 공고 후보 표).

숙제
  1. 준비 확인(10분): 터미널을 열고 node -v, python3 --version(Windows는 py --version), git --version 결과를 적어 보기. 없는 것은 설치.
  2. 도구 1개 설치(30분): 쓰는 에이전트에 ir-search를 설치(4-3). 에이전트가 없다면 kordoc을 npx로 한 번 실행해 공고문 하나를 Markdown으로 바꿔 보기.
  3. 전수조사 실행(20분): 재고콕 대신 내 아이템과 내 프로필로 ir-search를 quick으로 실행(4-4 프롬프트).
  4. 후보 메모로 옮기기(20분): 결과 A그룹 중 3개를 원문 링크로 열어 확인하고, 챕터 01의 "후보 지원사업 3개 메모" 표에 옮기기. 도구가 '불명'으로 둔 칸은 원문에서 직접 채우기.
  5. 작업실 만들기(15분): 10-1 폴더 구조를 만들고 10-2 지시서를 저장. 첫 메시지(10-3)를 보내 1단계까지만 진행.
체크리스트
  • □ 설치 전에 README와 설치 스크립트를 읽었다
  • □ API 키·개인정보를 파일에 넣지 않았다
  • □ A그룹 공고 3개를 원문으로 다시 확인했다
  • □ 변환된 공고 Markdown의 배점·금액 숫자를 원문과 대조했다
  • □ 채운 HWPX를 한글로 열어 쪽수·잔재 문구를 눈으로 확인했다

핵심 요약

  1. ir-search는 K-Startup·기업마당·NIPA·KOCCA·SMTECH 공고를 모아 A·B·C 그룹 보고서를 만드는 스킬입니다(2026-11-18 기준 ★394).
  2. kordoc은 HWP·HWPX·PDF를 Markdown으로 바꿔 AI가 읽게 하고, Markdown에서 HWPX를 만듭니다(★3,035, MIT).
  3. hwpxskill·hwpx-skill은 공고 양식(HWPX)의 서식을 지키며 내용만 바꾸는 데 씁니다.
  4. 남의 코드를 실행하기 전에는 README와 설치 스크립트를 확인하고, API 키·개인정보를 넣지 않습니다.
  5. 도구가 없어도 웹 AI와 챕터 03 프롬프트만으로 계획서는 쓸 수 있으며, 이 챕터는 시간을 줄이는 선택 과정입니다.

확인 퀴즈 (6문항)

답을 먼저 골라 보고 "정답 확인"을 누르세요.

Q1. 처음 보는 저장소의 설치 명령이 "curl … | bash"입니다. 가장 안전한 행동은?

  1. 바로 실행한다
  2. 스크립트 내용을 먼저 열어 무엇을 설치하는지 확인한 뒤 실행한다
  3. 관리자 권한으로 실행한다
  4. 별이 많으면 확인할 필요 없다
정답 확인

정답 B. curl | bash는 내려받은 스크립트를 그대로 실행합니다. 내용을 먼저 확인하는 것이 기본 안전 수칙입니다.

Q2. 공고문이 HWP 파일이라 AI에 올리면 글자가 깨집니다. 가장 알맞은 도구는?

  1. StartupKit
  2. plan-lint
  3. ir-search
  4. kordoc으로 Markdown 변환 후 올리기
정답 확인

정답 D. kordoc은 HWP·HWPX·PDF를 Markdown과 구조화 데이터로 바꿔 AI가 표까지 읽을 수 있게 합니다.

Q3. 공고 양식(HWPX)의 표·서식을 그대로 두고 내 내용만 채우고 싶습니다. 어떤 도구 계열이 맞나요?

  1. prompts.chat
  2. StartupKit
  3. hwpxskill / hwpx-skill
  4. ir-search
정답 확인

정답 C. hwpxskill은 원본 양식의 스타일·표 구조·셀 병합을 보존하고 내용만 바꾸며, page_guard로 페이지 수 변화를 검사합니다.

Q4. ir-search 보고서의 "B그룹"은 무엇을 뜻하나요?

  1. 법인 설립·투자 유치 같은 요건을 갖추면 열리는 사업
  2. 지금 즉시 지원 가능
  3. 아이템을 다른 분야 언어로 재서술하면 가능한 사업
  4. 마감된 사업
정답 확인

정답 A. A는 즉시 가능, B는 트리거(요건) 충족 시 로드맵, C는 프레이밍을 바꾸면 가능한 사업입니다.

Q5. 별이 1개인 개인 프로젝트 도구(plan-lint)를 쓸 때 맞는 태도는?

  1. 공식 도구처럼 결과를 그대로 믿는다
  2. 절대 쓰면 안 된다
  3. 별 수와 품질은 항상 같다
  4. 참고용으로 쓰고 지적 내용은 원문과 직접 대조해 검증한다
정답 확인

정답 D. 별이 적은 프로젝트는 검증 사례가 적습니다. 진단 결과를 힌트로만 쓰고 최종 판단은 직접 합니다.

Q6. 작업실 지시서(CLAUDE.md·AGENTS.md)에 꼭 넣어야 할 규칙은?

  1. 모든 결정을 AI가 알아서 하라
  2. 관문에서 멈추고 사람에게 묻기, 내 자료에 없는 경력·실적은 만들지 않기
  3. 최대한 길게 써라
  4. 출처는 나중에 붙여라
정답 확인

정답 B. 자동화할수록 관문 3곳에서 멈추고, 사실을 지어내지 않는 규칙이 있어야 결과를 믿고 쓸 수 있습니다.

자주 묻는 질문

GitHub을 몰라도 지원사업 AI 도구를 쓸 수 있나요?

네, 쓸 수 있습니다. 터미널을 열고 이 챕터의 명령어를 복사해 붙여 넣는 정도면 됩니다. 예를 들어 kordoc은 Node.js 20 이상만 있으면 npx kordoc 공고문.hwpx -o 공고문.md 한 줄로 공고문을 AI가 읽기 좋은 Markdown으로 바꿉니다. 그래도 어렵다면 챕터 01~04의 웹 AI 프롬프트만으로도 계획서 초안까지 충분히 갈 수 있습니다.

이 GitHub 도구들은 무료인가요?

도구 자체는 무료 공개입니다. 2026년 11월 18일 기준 ir-search·kordoc·plan-lint·StartupKit은 MIT 라이선스이고, hwpx-skill은 README에 MIT로 적혀 있으며, hwpxskill은 라이선스 표기가 없어 개인 사용 범위에서 쓰는 것이 안전합니다. 다만 도구를 돌리는 AI 에이전트(Claude Code 등)는 유료 플랜이 필요할 수 있고, plan-lint의 LLM 검사는 유료 API 키가 필요합니다. 키 없이 --rules-only 검사는 가능합니다.

한글(HWP) 사업계획서 양식을 AI로 채울 수 있나요?

네, 가능합니다. hwpxskill은 원본 HWPX 양식의 표 구조·셀 병합·여백을 보존한 채 내용만 바꾸고, 원본 대비 쪽수 변화와 안내 문구 잔재를 자동 검사합니다. 옛 HWP 양식은 kordoc to-hwpx로 먼저 HWPX로 바꿉니다. 그래도 제출 전에는 반드시 한글로 열어 쪽수·서식·사업비 표 합계를 눈으로 확인해야 합니다.

정부지원사업 공고를 자동으로 찾는 방법이 있나요?

있습니다. ir-search 스킬은 K-Startup·기업마당·NIPA·KOCCA·SMTECH 5곳의 모집중 공고를 모아 내 단계·지역·필요에 맞는 사업을 고르고, 원문으로 자격을 검증해 A(즉시 지원)·B(요건 충족 시)·C(재서술 시) 3개 그룹 보고서를 만듭니다. 주 1회 quick 프리셋으로 점검하고, 결과는 반드시 공고 원문으로 다시 확인하세요.

GitHub에서 받은 도구를 내 컴퓨터에서 실행해도 안전한가요?

확인 절차를 지키면 위험을 크게 줄일 수 있습니다. 실행 전 별 수·최근 업데이트·라이선스·이슈를 보고, README와 설치 스크립트를 먼저 읽으세요. 특히 curl … | bash 한 줄 설치는 내용을 확인한 뒤 쓰고, API 키·주민번호·고객 개인정보는 파일이나 AI에 넣지 마세요. 별이 적은 개인 프로젝트는 참고용으로만 쓰는 것이 안전합니다.

← 챕터 04 AI 활용 확장 예시 계획서 →