k-skill 是一套面向 AI 代理的韩国服务自动化技能集合，由 ara.so 作为 Daily 2026 Skills 系列发布。它让 Claude Code、Codex、Cursor 等编码代理能够自动完成 SRT 预订、KBO 查询、彩票核对、KakaoTalk 发送、首尔地铁到站查询、HWP 转换和邮编搜索等任务。
用途 该技能集把韩国本地常用服务封装为可被代理调用的模块，使代理在对话中即可执行查询、预订、转换等操作，减少手动切换网站或应用的步骤。
主要能力
- SRT 预订：支持列车查询、预订、预订确认与取消。
- KTX 预订：目前不可用，处于开发中，未来计划支持 Korail 查询、预订、确认与取消。
- KakaoTalk Mac CLI：在 macOS 上通过 kakaocli 查看会话、搜索会话、发送消息，无需认证；发送前需用户明确确认。
- 首尔地铁到站信息：需公共数据门户 API 密钥，可按站名或站码查询实时到站信息，并支持按线路过滤。
- KBO 赛果：无需认证，可查询当日或指定日期的比赛结果，支持按球队过滤，并提供球队列表。
- 彩票中奖核对：无需认证，可获取最新或指定期次的中奖号码，并用自己的号码进行比对。
- HWP 文档处理：无需认证，可将 .hwp 转换为 JSON/Markdown/HTML，提取图片，支持批量处理；在安装韩文与计算机应用的 Windows 上可直接控制原生应用。
- 邮编搜索：使用官方邮政邮编 API，无需认证，可按地址关键词搜索，也可按邮编反查。
使用方式 安装：推荐使用 npx k-skill install 安装全部技能，或 npm install -g k-skill 后执行 k-skill install；也可选择安装，如 npx k-skill install srt 或 npx k-skill install kbo lotto。安装后运行 k-skill-setup 完成 sops+age 设置、secrets 文件创建与运行时检查，再在本地安全注册 secrets 值。 调用：技能既可作为 Node.js 库引入（如 require('k-skill/srt')），也可通过 CLI 使用（如 k-skill srt search、k-skill kbo today、k-skill lotto latest、k-skill subway arrivals、k-skill hwp convert、k-skill zipcode search、k-skill kakao list 等）。 凭据管理：使用标准环境变量名，如 SRT_USERNAME、SRT_PASSWORD、KORAIL_USERNAME、KORAIL_PASSWORD、SEOUL_METRO_API_KEY。推荐用 sops+age 加密保存 secrets，并通过 sops --decrypt secrets.enc.yaml | k-skill env inject 注入环境变量。
适用场景 适合需要在代理对话中自动完成韩国本地事务的用户，例如让代理预订 SRT 车票、查询 KBO 比分、核对彩票、查询地铁到站、转换 HWP 文档或搜索邮编。
限制
- KTX 预订当前不可用。
- KakaoTalk CLI 仅限 macOS，且实际发送必须经用户明确确认。
- 首尔地铁查询需要自行申请公共数据门户 API 密钥。
- HWP 转换可能需要额外依赖（如 hwp.js、python-hwp），Windows 原生控制需安装韩文与计算机应用。
- 建议 Node.js v18 以上。
- 安全要求：禁止在聊天中直接输入密码或 API 密钥，禁止将 .env 提交到 git，禁止在代码中硬编码。
路线图 当前已包含 SRT、KakaoTalk Mac CLI、首尔地铁、KBO、彩票、HWP、邮编；KTX 开发中。后续候选包括 Coupang 订单查询、Danawa 比价、Naver Store 订单确认、胡萝卜市场房源查询、政府24 民愿查询、HomeTax 税务查询。