请参阅上方提供的SKILL.md中文翻译（部分）, 以下为完整中文SKILL.md内容...（由于字符限制，完整内容未全部显示，请参考原文）
통합됨: 기존 invoice-gen, korean-invoice 스킬을 통합
한국형 견적서/세금계산서 + 프리랜서 인보이스를 하나로.
주요 기능
- 📋 한국형 견적서: 사업자등록번호, 공급가액, 부가세 자동 계산
- 🧾 세금계산서: 영수/청구 구분, 승인번호 생성
- 💼 프리랜서 인보이스: Markdown/PDF, 다국어 지원 (KRW/USD/EUR)
- 🏢 거래처 관리: 사업자 정보, 연락처 DB
- 📦 품목 관리: 자주 쓰는 품목 저장 및 재사용
- 📄 PDF 출력: HTML → PDF 자동 변환
- 🔢 자동 계산: 공급가액, 부가세, 총액 자동 계산
빠른 시작
한국형 견적서 생성
node scripts/generate.js quote \
--client "무펭이즘" \
--items "포토부스 대여,2,500000" \
--notes "부가세 별도"
세금계산서 생성
node scripts/generate.js tax \
--client "무펭이즘" \
--items "포토부스 대여,1,500000" \
--type 영수
프리랜서 인보이스 (영문)
node scripts/generate.js invoice \
--client "Acme Corp" \
--items "Web development,40h,50" \
--currency USD \
--lang en
문서 타입
| 타입 | 설명 | 용도 |
|---|
quote | 한국형 견적서 | 고객에게 견적 제시 |
tax | 세금계산서 | 부가세 신고용 정식 세금계산서 |
invoice | 프리랜서 인보이스 | 국제 거래, 프리랜서 작업 |
견적서 필드
| 필드 | 설명 | 필수 | 기본값 |
|---|
--client | 거래처명 또는 ID | ✅ | - |
--items | 품목 리스트 (품명,수량,단가) | ✅ | - |
--issue-date | 작성일자 | ❌ | 오늘 |
--valid-until | 유효기간 | ❌ | +30일 |
--notes | 비고 | ❌ | - |
--include-vat | 부가세 포함 여부 | ❌ | true |
--currency | 통화 (KRW/USD/EUR) | ❌ | KRW |
--lang | 언어 (ko/en) | ❌ | ko |
세금계산서 필드
| 필드 | 설명 | 필수 | 기본값 |
|---|
--client | 공급받는자 (거래처 ID) | ✅ | - |
--items | 품목 리스트 | ✅ | - |
--issue-date | 작성일자 | ✅ | - |
--type | 영수/청구 | ❌ | 영수 |
--notes | 비고 | ❌ | - |
자동 계산
한국형 (부가세 10%)
공급가액: 500,000 원
부가세(10%): 50,000 원
합계: 550,000 원
- 공급가액 입력 시 부가세 10% 자동 추가
- 총액 입력 시 역산 (총액 ÷ 1.1)
- 품목별 소계 자동 합산
프리랜서 (VAT + Withholding)
Subtotal: $2,000
VAT (10%): $200
Withholding: -$66 (3.3% for Korean freelance)
Total: $2,134
- 국가별 세율 커스터마이징 가능
- 원천징수세 자동 계산 (한국 프리랜서 3.3%)
거래처 관리
# 거래처 추가
node scripts/manage-clients.js add "무펭이즘" \
--business-number "123-45-67890" \
--ceo "김형님" \
--address "서울시 강남구..." \
--phone "010-1234-5678" \
--email "contact@mufism.com"# 거래처 목록
node scripts/manage-clients.js list
# 거래처 상세 조회
node scripts/manage-clients.js view "무펭이즘"
# 거래처 수정
node scripts/manage-clients.js edit "무펭이즘" --phone "010-9999-9999"
# 거래처 삭제
node scripts/manage-clients.js remove "무펭이즘"
거래처 데이터: data/clients.json
품목 관리
# 품목 추가
node scripts/manage-items.js add "포토부스 대여" \
--price 500000 \
--unit "일"# 품목 목록
node scripts/manage-items.js list
# 품목 수정
node scripts/manage-items.js edit "포토부스 대여" --price 600000
# 품목 삭제
node scripts/manage-items.js remove "포토부스 대여"
품목 데이터: data/items.json
저장된 품목 사용:
node scripts/generate.js quote \
--client "무펭이즘" \
--item-ids "포토부스 대여,출장비"
템플릿
한국형 견적서 (templates/quote.html)
- 공급자 정보 (사업자등록번호, 상호, 대표자, 주소, 연락처)
- 공급받는자 정보
- 작성일자, 유효기간
- 품목 테이블 (품명, 규격, 수량, 단가, 공급가액)
- 합계 (공급가액, 부가세, 총액)
- 비고
세금계산서 (templates/tax-invoice.html)
- 승인번호 (임의 생성)
- 공급자/공급받는자 정보 (사업자등록번호, 상호, 성명, 주소)
- 작성일자
- 품목 테이블
- 합계 (공급가액, 세액)
- 영수/청구 구분
프리랜서 인보이스 (Markdown)
- Professional layout
- Sender/receiver info
- Itemized table with subtotals
- Tax calculation
- Payment terms and bank details
- Auto-incremented invoice number (INV-YYYY-NNN)
커스텀 템플릿 생성:
cp templates/quote.html templates/my-custom.html
# 수정 후
node scripts/generate.js quote --template my-custom ...
출력 형식
- HTML: 브라우저에서 바로 확인
- PDF: HTML → PDF 변환 (OpenClaw 브라우저 필요)
- Markdown: 프리랜서 인보이스 (편집 가능)
저장 경로: output/YYYY-MM-DD-{type}-{client}.{html|pdf|md}
내 정보 설정
data/my-info.json:
{
"businessNumber": "123-45-67890",
"companyName": "무펭이즘",
"ceo": "김무펭",
"address": "서울시 강남구...",
"phone": "010-1234-5678",
"email": "contact@mufism.com",
"bankAccount": "우리은행 1002-123-456789"
}
프리랜서 정보 (영문):
{
"name": "John Doe",
"email": "john@freelancer.com",
"address": "123 Main St, New York, NY 10001",
"phone": "+1-555-1234",
"bankAccount": "Bank of America, Account #12345678"
}
사용 예시
1. 한국 고객에게 견적서
# 거래처 미리 저장
node scripts/manage-clients.js add "무펭이즘" \
--business-number "123-45-67890" \
--ceo "김형님"# 품목 미리 저장
node scripts/manage-items.js add "포토부스 대여" --price 500000 --unit "일"
node scripts/manage-items.js add "출장비" --price 100000 --unit "회"
# 견적서 생성
node scripts/generate.js quote \
--client "무펭이즘" \
--item-ids "포토부스 대여,출장비" \
--notes "부가세 별도"
2. 세금계산서 발행
node scripts/generate.js tax \
--client "무펭이즘" \
--items "포토부스 대여,1,500000" \
--type 영수 \
--issue-date 2026-02-18
3. 해외 고객 인보이스
node scripts/generate.js invoice \
--client "Acme Corp" \
--items "Web development,40h,50" \
--currency USD \
--lang en \
--notes "Payment due within 30 days"
통합 기능
- message 스킬: 이메일/Discord로 견적서 전송
- daily-report: 작업 시간 → 인보이스 자동 변환
- calendar: 유효기간/납기일 알림 설정
- trello/notion: 견적서 발행 → 태스크 자동 생성
설치
cd skills/unified-invoice
npm install
주의사항
- 사업자등록번호:
123-45-67890 형식 (하이픈 포함)
- 금액: 원 단위 숫자만 입력 (콤마 없이)
- PDF 생성: OpenClaw 브라우저 실행 필요 (포트 18800)
- 템플릿 수정: HTML 파일 직접 편집 가능
- 다국어:
--lang en 옵션으로 영문 출력
트러블슈팅
PDF 생성 실패:
- OpenClaw 브라우저 실행 확인 (
openclaw gateway status)
- 포트 18800 접근 가능 확인
거래처/품목 로드 안 됨:
data/clients.json, data/items.json 파일 존재 확인- JSON 문법 오류 확인
부가세 계산 오류:
--include-vat false 옵션으로 부가세 제외 가능- 수동 계산 필요 시
--items "품명,수량,공급가액" 입력
디렉토리 구조
unified-invoice/
├── SKILL.md # 이 파일
├── package.json
├── scripts/
│ ├── generate.js # 견적서/세금계산서/인보이스 생성
│ ├── manage-clients.js # 거래처 관리
│ └── manage-items.js # 품목 관리
├── templates/
│ ├── quote.html # 한국형 견적서
│ ├── tax-invoice.html # 세금계산서
│ └── freelance-invoice.md # 프리랜서 인보이스 (Markdown)
├── data/
│ ├── clients.json # 거래처 DB
│ ├── items.json # 품목 DB
│ └── my-info.json # 내 사업자 정보
└── output/ # 생성된 문서 저장
통합 히스토리
| 원본 스킬 | 기여 내용 | 통합 날짜 |
|---|
| korean-invoice | 한국형 견적서/세금계산서, 사업자등록번호, HTML 템플릿 | 2026-02-18 |
| invoice-gen | 프리랜서 인보이스, Markdown 템플릿, 다국어 지원 | 2026-02-18 |
🐧 Built by 무펭이 — 무펭이즘(Mupengism) 생태계 스킬
by