mirrors/k-skill
2
0
Fork 0
mirror of https://github.com/NomaDamas/k-skill.git synced 2026-06-24 02:04:11 +00:00
Code Issues Projects Releases Packages Wiki Activity
k-skill/docs/features/korean-jangbu-for.md
Jeffrey (Dongkyu) Kim 11b1150110 Protect jangbu wrapper installs from incomplete payloads 
The promoted upstream subskills need to be discoverable without making home installs destructive or incomplete. The wrapper installer now copies its support payload into both home skill roots, allows installed-wrapper reruns, and refuses to overwrite unrelated top-level jangbu-* skills unless explicitly overridden.

Constraint: PR #181 review requires top-level subskill discovery under both Claude and agents roots.

Constraint: Home installs must remain re-runnable without a source checkout.

Rejected: Continue using generic sync_dir for promoted skills | it silently deletes unrelated user-authored skills.

Confidence: high

Scope-risk: narrow

Directive: Do not bypass the promoted-skill ownership check without preserving unrelated home skill directories.

Tested: node --test scripts/skill-docs.test.js --test-name-pattern='korean-jangbu-for'

Tested: bash -n korean-jangbu-for/scripts/install.sh

Tested: bash korean-jangbu-for/scripts/install.sh plus installed ~/.claude and ~/.agents wrapper reruns

Tested: bash ~/.claude/skills/korean-jangbu-for/upstream/scripts/install.sh and verify.sh with Python 3.11 shim

Tested: npm run ci

Tested: Architect verification APPROVED

Not-tested: Live CODEF collection requiring user BYOK credentials and external authentication
2026-04-29 00:50:37 +09:00

5.3 KiB
Raw Permalink Blame History

한국 사업자 장부 자동화 가이드

이 기능으로 할 수 있는 일

  • 카드명세서 PDF, 은행 CSV, 엑셀, 영수증/세금계산서 이미지·PDF를 표준 거래내역으로 정리
  • 거래처·MCC·정규식·학습 규칙을 이용한 계정과목 매핑
  • 세무용 BS·PL, 세무사 전달 CSV, 종합소득세 준비 체크리스트 생성
  • 경영용 현금흐름, cash burn, 카드별 분석, 대시보드 리포트 생성
  • 사용자가 직접 발급한 CODEF 키(BYOK)로 홈택스·은행·카드 자동 수집 흐름 연결

가장 중요한 규칙

본 스킬은 kimlawtech/korean-jangbu-for 업스트림의 thin wrapper 이다. 원저작자·관리자는 @kimlawtech (SpeciAI) 이며, k-skill 측은 원본 링크, attribution, 설치 진입점, 회계·세무 면책 고지를 책임진다.

이 스킬을 사용한 답변은 반드시 아래를 함께 언급한다.

  • 원본: https://github.com/kimlawtech/korean-jangbu-for
  • 원저작자: @kimlawtech (SpeciAI)
  • 라이선스: Apache-2.0
  • 생성물은 참고용 초안이며 공식 회계감사·세무신고를 대체하지 않는다.
  • 신고/제출 전 세무사 검토, 외감 대상 법인은 공인회계사 감사가 필요하다.

먼저 필요한 것

  • 인터넷 연결 (업스트림 clone 용)
  • git, bash, Python 3.11+
  • macOS 또는 Linux
  • OCR/PDF 처리 의존성 (업스트림 install/verify 흐름이 안내)
  • 자동 수집을 사용할 경우 사용자가 직접 발급한 CODEF Client ID/Secret (BYOK)

설치 흐름

~/.claude/skills/korean-jangbu-for/upstream/ 와 ~/.agents/skills/korean-jangbu-for/upstream/ 양쪽에 pinned SHA 로 업스트림을 설치한다. 동시에 업스트림 skills/jangbu-* 를 ~/.claude/skills/<skill-name> 및 ~/.agents/skills/<skill-name> top-level 경로로 등록해 slash skill discovery 가 중첩 upstream/ 탐색에 의존하지 않게 한다. /korean-jangbu-for 는 wrapper top-level skill 로 유지한다.

홈 디렉터리 wrapper 에는 재실행 가능한 scripts/install.sh, scripts/upstream.pin, LICENSE.upstream, DISCLAIMER.md, NOTICE 까지 함께 복사된다. Promoted jangbu-* top-level 스킬은 wrapper 가 이전에 설치한 managed copy 만 자동 갱신하며, 같은 이름의 unrelated/user-authored 스킬이 있으면 덮어쓰지 않고 중단한다. 의도적으로 교체해야 하는 경우에만 KOREAN_JANGBU_FOR_OVERWRITE_SKILLS=1 로 재실행한다.

bash korean-jangbu-for/scripts/install.sh

설치 확인:

cat korean-jangbu-for/scripts/upstream.pin
git -C ~/.claude/skills/korean-jangbu-for/upstream rev-parse HEAD
git -C ~/.agents/skills/korean-jangbu-for/upstream rev-parse HEAD

세 SHA 가 모두 같고 ~/.agents/skills/jangbu-import/SKILL.md 같은 top-level 하위 스킬이 존재하면 wrapper 설치가 성공한 것이다. 실제 OCR/MCP 런타임까지 검증해야 할 때는 업스트림 설치 후 verify 를 실행한다.

bash ~/.claude/skills/korean-jangbu-for/upstream/scripts/install.sh
bash ~/.claude/skills/korean-jangbu-for/upstream/scripts/verify.sh

업스트림 installer 는 Claude Code 스킬 symlink 를 등록하므로 wrapper 개발 중이면 실행 후 홈 디렉토리 wrapper 를 다시 sync 한다. 레포 내부에 repo-local .claude/ 또는 .agents/ 디렉토리는 만들지 않는다.

사용 전 intake

사용자에게 한 번에 1~3문항씩 확인한다.

  • 사업자 유형: 개인사업자 / 법인 / 프리랜서 / 복수 사업장
  • 목표 산출물: 표준 거래내역 / 계정과목 분류 / 세무사 전달 CSV / BS·PL / 현금흐름·경영 리포트 / 종소세 체크리스트
  • 입력 자료: 은행 CSV, 카드 PDF, 엑셀, 영수증 이미지, 세금계산서 PDF, CODEF 자동 수집
  • 대상 기간: 월 / 분기 / 연도
  • 민감정보 처리: 마스킹 필요 수준, 외부 LLM 경유 허용 여부
  • 공식 제출 예정 여부: 세무사 검토 또는 공인회계사 감사 필요성 판단

upstream 하위 스킬 라우팅

  • /korean-jangbu-for — 전체 메뉴 라우팅
  • /jangbu-connect — CODEF API 자격증명 설정(BYOK)
  • /jangbu-import — 원본 데이터 표준화
  • /jangbu-tag — 계정과목 매핑
  • /jangbu-tax — 세무용 BS·PL / 세무사 전달 CSV
  • /jangbu-dash — 경영 리포트 / 카드별 분석 / 현금흐름
  • /jangbu-jongso — 종합소득세 준비 체크리스트

보안 / 자격증명

CODEF 자동 수집은 BYOK 원칙을 따른다. 사용자가 직접 발급한 Client ID/Secret 만 사용하고, 값은 채팅에 노출하지 않는다. 저장은 업스트림 정책에 따라 macOS Keychain 또는 ~/.jangbu/credentials.env(0o600) 같은 로컬 저장소에 한정한다. 금융기관 조회, 간편인증, 로그인 등 side-effect 는 사용자의 명시 승인 없이 실행하지 않는다.

라이선스 / 출처

  • 업스트림: https://github.com/kimlawtech/korean-jangbu-for (Apache-2.0)
  • 원저작자·관리자: @kimlawtech (SpeciAI)
  • upstream pin 파일: korean-jangbu-for/scripts/upstream.pin
  • 회계·세무 면책 전문: korean-jangbu-for/DISCLAIMER.md
  • Apache-2.0 전문: korean-jangbu-for/LICENSE.upstream
  • attribution notice: korean-jangbu-for/NOTICE