k-skill 项目 korean-jangbu-for 技能全解析基于上游仓库的韩国事业者账簿自动化 Thin Wrapper 落地指南【免费下载链接】k-skill한국인을 위한 스킬 모음집 - 에이전트를 한국인으로项目地址: https://gitcode.com/GitHub_Trending/ks/k-skill本文以 k-skill 仓库中的 korean-jangbu-for 技能指南 为核心系统讲解如何在 Claude Code / Agent 兼容运行时中通过一个thin wrapper技能接入kimlawtech/korean-jangbu-forApache-2.0上游完成韩国事业者개인사업자/法人/自由职业者的账簿自动化、账户科目映射、税务师交付 CSV 与经营报告生成。读完本文你将掌握该技能的定位原则、dual-install 安装与校验方法、七个斜杠子技能的职责路由、BYOK 凭证安全模型以及会计税务合规边界可直接在本地环境中复现整套工作流。技能定位先理解“Thin Wrapper”设计哲学k-skill 仓库中的korean-jangbu-for技能源码位于 korean-jangbu-for 目录是一个明确的thin wrapper薄封装。其核心设计原则是实现下沉上游所有账簿自动化的具体实现卡明细 PDF 解析、银行 CSV 标准化、Excel 账簿整理、收据/税票图像 OCR、账户科目映射、税务 BS·PL、现金流报告等均由上游kimlawtech/korean-jangbu-for仓库负责k-skill 侧不重复实现任何业务逻辑k-skill 只承担五件事原始仓库发现入口、安装接入点install entrypoint、出处attribution与会计税务免责声明、Agent 无关agent-neutral的使用流程说明响应强约束任何使用本技能生成的回答末尾必须附带固定出处块——原始链接https://github.com/kimlawtech/korean-jangbu-for、原作者kimlawtech (SpeciAI)、许可证 Apache-2.0以及“生成物仅为参考草稿、不替代官方审计与税务申报”的免责声明。这一点从 install.sh 的注释中也能得到印证脚本明确写着“k-skill 侧仅维护薄 wrapper账簿自动化实现全部委托给上游”。仓库内不会把上游 payload 提交进 repo对应文档中“不要在仓库内部创建 repo-local.claude/或.agents/目录”的规则所有上游代码都以 pinned commit 方式安装到用户主目录。技能元数据见 skill.json 与 SKILL.md 的 frontmatter将其归类为finance类别、ko-KR语言环境、v1阶段并声明profiles: action:submission——即涉及正式提交类动作使用上要求格外审慎。能力边界这个技能能做什么、不能做什么能做的核心能力根据关联文档该技能串联上游能力后可完成原始数据标准化将卡片明细 PDF、银行 CSV、Excel 账簿、收据/税务发票图像与 PDF 整理为标准交易明细표준 거래내역账户科目映射通过交易对手거래처、MCC、正则表达式与学习规则将标准交易明细映射为会计科目계정과목税务材料生成生成税务用 BS·PL简易资产负债表/损益表、税务师交付 CSV、综合所得税종합소득세准备检查清单经营分析报告生成经营用现金流、cash burn、卡别分析、仪表盘报告自动数据收集通过用户自行签发的 CODEF Client ID/SecretBYOKBring Your Own Key串联 HomeTax홈택스、银行、信用卡的自动收集流程。不能做的合规红线instruction.md 的 “When not to use” 与 DISCLAIMER.md 明确了以下场景不应使用本技能官方审计、税务申报代理、记账代理기장대행、节税咨询本身——应引导用户咨询税务师/注册会计师用户未明确批准凭证输入、简便认证간편인증、金融机构登录等 side-effect仅凭自动产出物就确定正式对外提交的财务报表/公示材料非韩国事业者账簿、以海外会计标准IFRS/US GAAP 等为核心的工作。环境前置要求按关联文档与 instruction.md 的 Prerequisites 汇总项目要求网络可访问 GitHub用于上游 clone 与 pinned SHA 检出版本控制git2.20Shellbashset -euo pipefail安装脚本依赖运行时Python 3.11OCR/PDF 处理链路依赖操作系统macOS 或 LinuxOCR/PDF 依赖上游install.sh会引导安装如 poppler、Vision/PaddleOCR 等见 install.sh 的说明自动收集可选用户自行签发的 CODEF Client ID/SecretBYOK需要特别说明离线环境下无法运行。install.sh 第 161-171 行的逻辑表明如果上游 clone 失败脚本会直接退出并提示“오프라인 환경에서는 이 스킬의 장부 자동화 흐름을 실행할 수 없다”离线环境下无法执行本技能的账簿自动化流程。安装流程Dual-Install 与 pinned SHA安装目标与设计安装脚本会将上游以 pinned commit 检出到两个主目录技能路径下~/.claude/skills/korean-jangbu-for/upstream/ ~/.agents/skills/korean-jangbu-for/upstream/同时上游的skills/jangbu-*会被注册为顶层技能top-level skill到~/.claude/skills/skill-name与~/.agents/skills/skill-name这样斜杠技能发现slash skill discovery就不必依赖嵌套的upstream/目录搜索。而/korean-jangbu-for保留为 wrapper 的顶层技能。主目录 wrapper 中会一并复制可重执行re-runnable的文件scripts/install.sh、scripts/upstream.pin、LICENSE.upstream、DISCLAIMER.md、NOTICE由 install.sh 的install_wrapper_payload函数负责复制并设置可执行权限。一键安装命令npx -y nomadamas/k-skill0 exec korean-jangbu-for scripts/install.sh --如果本地已 clone 过仓库、或已持有主目录技能 bundle也可以直接运行脚本关联文档提供的备用路径bash ~/.claude/skills/korean-jangbu-for/scripts/install.sh # 或 bash ~/.agents/skills/korean-jangbu-for/scripts/install.sh安装脚本的核心逻辑源码解读结合 install.sh一次安装会依次完成以下步骤读取 pin从scripts/upstream.pin读取 40 位十六进制 git SHA当前仓库中该文件内容为d8c2875ace84e212672e2d6206df254c5048b927。若 SHA 格式不合法^[0-9a-f]{40}$则报错退出克隆与检出首次安装时以git clone --filterblob:none克隆上游到~/.cache/k-skill/korean-jangbu-for/upstream缓存目录随后fetch该 pinned SHA 并checkout --force --detach再用rev-parse HEAD校验检出 HEAD 与 pin 完全一致不一致即报错退出预检preflight遍历两个主目录对 6 个 promoted 子技能jangbu-connect、jangbu-import、jangbu-tag、jangbu-tax、jangbu-dash、jangbu-jongso逐一检查上游SKILL.md是否存在、目标路径是否可写安装 wrapper payload向~/.claude/skills/korean-jangbu-for/与~/.agents/skills/korean-jangbu-for/复制 SKILL.md、install.sh、upstream.pin、LICENSE.upstream、DISCLAIMER.md、NOTICE同步上游把缓存中的上游 checkout 同步到两处upstream/目录并再次校验 SHA注册子技能将上游skills/jangbu-*同步为顶层技能并在每个被提升的 SKILL.md 末尾append_response_policy追加固定的出处/免责政策块该块包含k-skill wrapper attribution and disclaimer标记。覆盖保护机制重要安装脚本对顶层技能做了覆盖保护若目标路径已存在同名技能脚本会检查其 SKILL.md 是否包含 managed 标记k-skill wrapper attribution and disclaimer只有之前由 wrapper 安装的 managed copy 会被自动更新若同名技能是用户自建或无关技能脚本不会覆盖而是直接中止仅当确实需要替换时设置环境变量KOREAN_JANGBU_FOR_OVERWRITE_SKILLS1重新执行。此外 install.sh 还支持两个可配置环境变量KOREAN_JANGBU_FOR_UPSTREAM_REPO覆盖上游仓库地址默认https://github.com/kimlawtech/korean-jangbu-for.git与KOREAN_JANGBU_FOR_UPSTREAM_SHA覆盖 pin 文件中的 SHA。安装验证关联文档给出三处校验命令npx -y nomadamas/k-skill0 read 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存在即代表 wrapper 安装成功。需要进一步验证真实 OCR/MCP 运行时依赖时再执行上游的安装与验证脚本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对应 install.sh 结尾的提示“Re-run this wrapper installer after upstream runtime install to restore wrapper-managed top-level skills”。使用前的强制 Intake一次确认 1~3 个问题关联文档与 instruction.md 都强调用户请求账簿自动化时不要立刻生成文件必须先做 intake 澄清。为避免一次性问太多规则是每次只问 1~3 个问题用户不清楚时可用“可以跳过”保持开放。需要确认的维度事业者类型个人事业者개인사업자/ 法人 / 自由职业者프리랜서/ 多营业场所복수 사업장目标产出物标准交易明细 / 会计科目分类 / 税务师交付 CSV / BS·PL / 现金流·经营报告 / 综合所得税检查清单输入资料银行 CSV、卡片 PDF、Excel、收据图像、税务发票 PDF、CODEF 自动收集期间与货币目标月份/季度/年度是否涉及 KRW 以外货币敏感信息处理原始文件保管位置、需要的掩码等级、是否允许经过外部 LLM自动收集与否CODEF BYOK 是否就绪认证/登录/简便认证必须由用户亲自批准是否计划正式申报据此判断是否需要税务师审查或注册会计师审计。上游子技能路由七个斜杠技能分工安装完成后可用的斜杠路由关联文档“upstream 하위 스킬 라우팅”一节斜杠技能职责/korean-jangbu-for全菜单路由wrapper 顶层技能/jangbu-connectCODEF API 凭证设置BYOKHomeTax·银行·卡自动收集/jangbu-import原始数据Excel·CSV·图像·PDF→ 标准交易明细/jangbu-tag标准交易明细 → 账户科目映射/jangbu-tax税务用 BS·PL / 税务师交付 CSV/jangbu-dash经营报告 / 卡别分析 / 现金流/jangbu-jongso综合所得税准备检查清单及 HomeTax 下载路径指引这 6 个jangbu-*子技能与 install.sh 中UPSTREAM_SUBSKILLS数组的定义完全对应即jangbu-connect、jangbu-dash、jangbu-import、jangbu-jongso、jangbu-tag、jangbu-tax——安装、校验、预检、响应策略追加均围绕这组技能展开。标准工作流从 Intake 到交付综合 instruction.md 的 Workflow 与关联文档推荐执行顺序为Intake按上文维度确认目标与输入资料Dual-install执行npx -y nomadamas/k-skill0 exec korean-jangbu-for scripts/install.sh --安装上游路由选择按用途调用对应子技能见上表敏感信息处理遵循上游 Level 2 掩码原则——将事业者号码사업자번호、居民号码주민번호、卡号카드번호、账户号계좌번호、account_id等 token 化/掩码后才允许传入 LLM fallback自动收集遵循 CODEF BYOK 原则凭证仅存本地macOS Keychain 或~/.jangbu/credentials.env未获用户明确批准不执行外部认证与金融查询完成报告结尾必须附带固定的 Response policy 出处块原始链接、原作者、Apache-2.0、免责声明。安全与凭证模型BYOK 与 Level 2 掩码CODEF BYOK 原则自动数据收集采用BYOKBring Your Own Key仅使用用户亲自签发的 CODEF Client ID/Secret不在对话中暴露明文值凭证存储仅限 macOS Keychain 或~/.jangbu/credentials.env权限 0o600即仅属主可读写等本地存储金融查询、简便认证、登录等 side-effect 动作未经用户明确批准绝不执行。这一约束同时在 SKILL.md 的 Hard rules 中被强调为三条铁律之一“未经用户即时明确批准绝不执行支付、消息/邮件发送、最终提交、取消或公开发布”。Level 2 掩码的边界来自 DISCLAIMERdisclaimer 的 Security Limitations 一节明确指出 Level 2 掩码的局限Level 2 掩码仅覆盖韩国标准识别号模式事业者号、居民号、卡号、账户号非结构化文档中的人个信息可能不会被 token 化上传前应再次确认OCR 误识别可能导致金额/日期提取错误自动登记的交易必须人工复核。会计·税务合规边界务必阅读这是本技能使用中最重要的部分。根据 DISCLAIMER.md技能产出的财务报表·经营报告仅是参考草稿不替代官方审计与税务申报具体限制包括K-GAAP 简化版仅实现一般企业会计基准K-GAAP的简化版本不实现完整会计准则无分录引擎不是复式记账복식부기基础上的正式资产负债表而是基于收付实现制的简易汇总折旧未自动化不按资产耐用年限计算备品/车辆等资产的折旧增值税抵扣未处理无进项税/销项税自动抵扣无附注不含外审用财务报表附注。因此强制要求专家复核法人税申报前税务师审查必须外审对象法人如资产 120 亿韩元以上等注册会计师审计必须投资引进、MA、股权整理节点的财务资料需会计师事务所尽调。法律层面instruction.md 强调该技能以“不构成税法上税务代理记账代理、申报代理”为前提运作产出物限定为供用户与税务师共同审查的参考材料、仅限用户本人账簿、申报前强制专家确认、默认本地处理。失败模式与排查建议关联文档与 instruction.md 的 Failure modes 给出了几类典型问题失败场景处理建议网络阻断上游 clone/pin 检出失败 → 恢复网络后重跑scripts/install.shPython/OCR 依赖失败依据上游scripts/verify.sh输出检查 Python 3.11、poppler、Vision/PaddleOCR 环境CODEF 认证失败检查用户 BYOK 凭证与简便认证状态但绝不把凭证值暴露在对话中OCR 误识别 / 分类置信度低让用户复核原始文件与标准交易明细不自动确认需要正式申报不得将自动产出物直接当作最终版本必须转入税务师/注册会计师审查环节完成判定标准Done When一次成功的技能使用应满足源自 instruction.md目标产出物、输入资料、事业者类型、期间、敏感信息处理等级均已确认scripts/install.sh完成 dual-install且两处upstream/路径指向与scripts/upstream.pin相同的 SHA上游skills/jangbu-*已注册到两处顶层技能路径斜杠技能发现可用实际使用了对应的上游子技能流程/jangbu-import、/jangbu-tag、/jangbu-tax、/jangbu-dash、/jangbu-jongso、/jangbu-connect用户声明用于正式提交/申报时明确提示税务师审查或注册会计师审计的必要性最终回答包含原始链接、原作者kimlawtech (SpeciAI)、Apache-2.0、会计税务免责声明。许可与出处信息汇总关联文档的“라이선스 / 출처”一节给出了完整出处档案对应仓库文件上游仓库kimlawtech/korean-jangbu-forApache-2.0原作者·维护者kimlawtech (SpeciAI)pin 文件korean-jangbu-for/scripts/upstream.pin当前 pinned SHAd8c2875ace84e212672e2d6206df254c5048b927会计税务免责全文korean-jangbu-for/DISCLAIMER.mdApache-2.0 许可全文korean-jangbu-for/LICENSE.upstream归因声明korean-jangbu-for/NOTICE含中英韩三语免责段落。补充说明k-skill 仓库根目录的LICENSE是该仓库 wrapper 的基础许可而本技能目录下的上游资料遵循 Apache-2.0 的声明与再分发条件。延伸阅读技能文档原始指南docs/features/korean-jangbu-for.md技能主入口 SKILL.md 与详细流程说明 instruction.md安装脚本实现korean-jangbu-for/scripts/install.sh技能元数据korean-jangbu-for/skill.json【免费下载链接】k-skill한국인을 위한 스킬 모음집 - 에이전트를 한국인으로项目地址: https://gitcode.com/GitHub_Trending/ks/k-skill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考