career-ops 韩语模式本地化解析：modes/ko 的激活机制、翻译范围与术语体系

career-ops 韩语模式本地化解析：modes/ko 的激活机制、翻译范围与术语体系

【免费下载链接】career-opsOpen-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)项目地址: https://gitcode.com/GitHub_Trending/ca/career-ops

导读

career-ops 以 Markdown 提示词文件（mode）作为 AI 编码 CLI（Claude Code、Codex 等）的"工作大脑"，每个 mode 定义一个工作流。而本仓库针对非英语市场提供了成套的语言模式目录，其中modes/ko/专为韩语求职者与韩国招聘市场服务：它把评估、投递、管线等核心工作流翻译为自然韩语，并把 정규직（正式员工）、포괄임금제（包薪制）、4대 보험（四大保险）、퇴직금（退职金）等韩国特有的报酬/雇佣概念编码进评估与谈判规则。本文以 modes/ko/README.md 为骨架，结合 AGENTS.md、config/profile.example.yml 与modes/ko/目录下的实际模式文件，讲清三件事：何时该启用韩语模式、如何激活（会话级与永久级）、以及一个技术本地化项目在"翻译什么、保留什么、如何维护一致性"上的完整决策清单。

一、modes/ko/定位：给谁用、何时用

modes/ko/是 career-ops 多语言模式族（modes/ar/ da/ de/ es/ fr/ ja/ ko/ ...）中的韩语成员。其 README 明确了适用判定标准，满足以下任一情况就应当使用韩语模式：

• 主要申请韩语招聘公告（채용 공고）；
• 需要把 CV/이력서、커버레터（cover letter）、投递表单回答写成韩语；
• 需要的是贴合韩国科技招聘语境的自然韩语，而不是机翻腔（기계 번역투）；
• 需要评估韩国市场的雇佣条件：정규직（正式员工）、계약직（合同工）、수습기간（试用期）、포괄임금제（包薪制/综合工资制）、퇴직금（退职金）、4대 보험（四大社会保险）、성과급（绩效奖金）、스톡옵션/RSU、재택/하이브리드 근무（远程/混合办公）等。

反向边界同样明确：如果目标岗位绝大多数是英语公告、走的是全球化/外企流程，则应使用默认的modes/（英文）。默认英文模式也能处理韩国企业的英文公告，但不会精细反映韩国招聘市场特有的报酬/契约条件——这正是"市场模式（market mode）"与"通用模式"的差别。

从仓库结构看，modes/顶层 README（modes/README.md）也印证了这一点：语言模式目录的职责被描述为"核心模式的母语翻译 + 市场特有词汇（market-specific vocabulary）"，其中ko与ja、de、fr等同列于子目录清单中。

二、激活方式：从"每会话一句提示"到"配置永久生效"

modes/ko/README.md给出了两种激活路径，且都是基于config/profile.yml中的language.modes_dir约定。

方式一：会话级激活

在会话开始时直接对 AI 助手说：

"modes/ko/아래의 한국어 모드를 사용해."（使用modes/ko/下的韩语模式）

此时 AI 会读取modes/ko/中的文件，而不是默认的modes/。

方式二：永久配置（推荐）

在config/profile.yml中写入：

language: primary: ko modes_dir: modes/ko

并在首个会话里提示 AI 检查该配置（例如："profile.yml에language.modes_dir를 설정해뒀어"），此后 AI 会自动加载韩语模式。

关键区分：modes_dir 与 output 是两条独立轴

这一点在 config/profile.example.yml 的language块注释和 AGENTS.md 的 "Output Language vs Market Modes" 一节中有非常清晰的说明，是理解本机制的关键：

language: # 面向人的输出语言（报告、tracker 笔记、PDF、cover letter、外联、表单答案）。 # 使用 ISO 语言代码，如 en 或 zh-CN。 output: en # modes_dir: modes/ko # 可选：引入韩国市场词汇与本地化评估规则

• language.output控制所有面向人的文字产出的语言（报告、tracker 备注、PDF、cover letter、外联、面试准备、表单答案），缺省为en；
• language.modes_dir只负责提供市场词汇与本地评估规则（例如modes/de注入 13. Monatsgehalt 等 DACH 概念，modes/ko则注入 한국식 보상/계약 개념）；
• 组合规则：output对正文文字有最终决定权，modes_dir只提供市场语境。因此 "英语写作 + 韩国市场词汇"、"韩语写作 + 日本市场词汇" 这类任意组合都是合法的。

这一规则的工程实现在 profile-language.mjs 中可查证：parseOutputLanguage负责从 profile YAML 解析language.output（解析失败或缺省回落到en），outputLanguageInstruction则生成一条注入每个模型提示词的规范指令——"所有面向人的输出一律使用{language.output}，无论指令与 JD 用什么语言；language.output的配置永远压过 JD 语言"。

另外，modes_dir的值并非无条件信任：gemini-eval.mjs 中可以看到运行时校验——若language.modes_dir逃逸出项目根目录会回退到默认modes/并给出警告，若目录不存在同样回退默认值。从该实现可以推断，这是一个"配置即约定、非法值安全降级"的设计。

什么时候不该切到市场模式

AGENTS.md 同时给出了"不切换"的判定：如果用户申请的是英语角色——即使对方是这些市场的公司——应使用默认英文模式，除非会话中用户明确要求其他市场模式、或config/profile.yml中显式设置了language.modes_dir（显式用户偏好永远压过基于 JD 语言的自动探测）。该文件还列出激活市场模式的三条途径：用户口头要求、配置文件显式设置、AI 检测到该语言的 JD 后建议切换。

三、已翻译模式清单：四个文件的"源-目标-职责"

首个版本覆盖影响面最大的四个模式，而非全量翻译。完整对照如下（源自modes/ko/README.md表格）：

翻译源不全是英文版，说明该模式的维护实际上以"市场模式集"为单位复制演进（例如西班牙语oferta.md的 A–F 结构版本先于英文落地）。modes/README.md对每套语言模式的构成给出了一致描述："each includes_shared.md, an evaluation mode, an apply mode, andpipeline.md"，即市场模式的标准四件套。

其余工具导向模式（scan、batch、pdf、tracker、auto-pipeline、deep、contacto、ofertas、project、training）不翻译、继续沿用 EN/ES 原版——因为这些文件以工具、路径、命令为核心，天然与语言无关。这是本地化范围的一个理性裁剪：先翻译"与候选人对话密度最高"的模式，把纯工具流程留在通用语言层。

四、刻意保留英语的清单：术语本地化的"不做"清单

一份高质量的本地化，同样重要的是明确哪些内容不译。modes/ko/README.md列出了刻意保留英语的项目：

• 文档/产物专名：cv.md、pipeline、tracker、report、score、archetype、proof point；
• 工具名：Playwright、WebSearch、WebFetch、Read、Write、Edit、Bash；
• tracker 状态值：Evaluated、Applied、Interview、Offer、Rejected；
• 代码片段、路径、命令行本身。

写作基调在modes/ko/_shared.md的全局规则中有落地："한국 테크 채용 문맥에 맞는 자연스러운 한국어를 사용합니다。짧은 문장, 동사 중심, 수동태 회피。stack, pipeline, deployment, embedding 같은 현장 용어는 억지로 번역하지 않습니다。"（使用贴合韩国科技招聘语境的自然韩语：短句、动词中心、避免被动式；stack/pipeline/deployment/embedding等现场术语不强译。）

这与language.output轴的运行机制相互呼应：市场模式不改写正文语言，正文语言由output决定。modes/ko/的产物是"以韩语为市场语言"的指令与词汇表，而最终的求职材料语种仍由profile.yml的output字段统辖。

五、基准术语表：维护一致性的核心资产

为了让多位贡献者在不同模式文件中保持同一文风，modes/ko/README.md提供了一份以本代码库为准（"이 codebase 기준"）的英→韩对照表。以下为全文关键条目：

注意该表的语气是"规范性基准（기준）"而非"音译建议"：例如Remote work被定译为 재택근무/원격근무，Probation用行业标准词 수습기간，Inclusive wage system直指韩国特有的 포괄임금제。术语表同时是贡献规范的一部分——新增或修改模式时，术语必须与此表对齐。

六、术语表背后的"市场知识层"：评估与谈判规则如何被本地化

术语表并非孤立词汇清单，它与 modes/ko/_shared.md 中"한국 채용 시장 -- 특이사항"（韩国招聘市场特有事宜）一节构成完整的本地化知识层。该节把每个术语映射到评估影响，可视为 Block D（보상과 시장 수요）的领域规则：

该文件还内置了配套的谈判脚本（협상 스크립트）与Location Policy：例如回应"희망 연봉"（期望年薪）时把 base/bonus/equity/복지 拆开谈；对本地折扣（region-based discount）用"delivery 与 impact 决定评估"回应；对目标偏低的开价给出结构化的还价句式。从这些内容可以推断，韩语市场模式的深度不止于翻译：它把"韩国谈薪要先问 세전 还是 실수령、总包由哪些分量构成、哪些条款是 red flag"这类领域知识直接固化成了规则。

七、四个已翻译模式的实战结构

为了判断"翻译后的模式是否依然可用"，值得对照实际文件确认其工作流骨架与英文/西语版本保持一致。

7.1_shared.md— 公共上下文与全局护栏

modes/ko/_shared.md 是全套模式的公共上下文，包含：

• Source of Truth 阅读顺序：每次评估前必读cv.md、article-digest.md（若有）、config/profile.yml；proof point 的 metric 不得硬编码，评估时动态读取；article-digest.md中的数值优先于cv.md；
• 四条 guardrail：不得把"使用某工具"当成"创造了某工具"（authorship）、关键词只能改写不得虚构、只有批准源文件可作为候选人主张的证据、绝不以用户名义代提交申请（只起草，提交前必须人工确认）；
• North Star / Archetype 表：AI Platform/LLMOps、Agentic/Automation、Technical AI PM、AI Solutions Architect、AI Forward Deployed、AI Transformation 六大 archetype 及其对公司交付价值的定位；
• Comp Intelligence 指南：用 WebSearch 查 원티드、리멤버、잡플래닛、블라인드、Levels.fyi、Glassdoor 等；按 title 定位（salary band 通常由 title 而非 skill 决定）；把 base + 성과급 + stock/RSU + signing + welfare 拆开看 total compensation；remote 的 geo-arbitrage 可能性及 EOR/contractor 形态下的报酬调整风险。

7.2gonggo.md— 채용 공고 全量评估（Block A–F + G）

modes/ko/gonggo.md 在候选人粘贴 JD（文本或 URL）后，固定产出 6 个评估块：

• Step 0：把公告归类到六大 archetype（混合型取最近的两个），并决定 Block B 的 proof point 优先级、Block E 的 summary 改写方式与 Block F 的 STAR 故事准备方向；
• Block A 角色摘要：archetype、domain、function、seniority、remote 形态、团队规模、单句 TL;DR 的表格；
• Block B CV 匹配：逐条把 JD 资格要求映射到cv.md的精确句子，并单列 Gaps 区逐项判断 hard blocker 与否、可否用相邻经验证明、有无 portfolio 项目覆盖、给出 mitigation plan；
• Block C 级别与策略：JD 级别 vs 候选人在该 archetype 的自然级别；"无虚假地 senior 定位"计划；"downlevel 情形"计划（报酬合适可接受、谈 6 个月 review、要求明确晋升标准）；
• Block D 报酬与市场需求：强制用 WebSearch，来源（원티드/리멤버/잡플래닛/블라인드/Levels.fyi/Glassdoor）整理成表，数据缺失就说缺失，绝不编造；并附韩国市场强制核对清单（세전 基准？성과급/signing 是否单列？vesting 是否写明？정규직/계약직？수습기간与降薪？포괄임금제/固定 OT？퇴직금/4대 보험/연차/식대？재택/하이브리드的实际频率与地域限制？）；
• Block E 个性化计划：Summary/经历等条目的 current state → proposed change → rationale 表 + Top 5 CV 与 Top 5 LinkedIn 修改建议；
• Block F 面试准备：按 JD 资格要求准备 6–10 个STAR+R（STAR + Reflection）故事，Reflection 列承载"学到了什么/重来会怎么做"，是区分 junior/senior 的信号；配合interview-prep/story-bank.md的 Story Bank 复用机制，以及 red-flag 问题应答策略。

评估后的收尾动作同样工程化：以reports/{###}-{company-slug}-{YYYY-MM-DD}.md格式落盘（报告必须含**URL:**头字段）；序号必须通过node reserve-report-num.mjs原子预约（写毕再--release释放，规避并发编号冲突）；tracker 行不直接改data/applications.md，而是写入batch/tracker-additions/{num}-{company-slug}.tsv再交由node merge-tracker.mjs合并（TSV 列为{num}\t{date}\t{company}\t{role}\tEvaluated\t{score}/5\t{pdf}\t[report链接]\t{note}，pdf生成记为✅否则❌）。

7.3jiwon.md— 投递表单 live assistant

modes/ko/jiwon.md 定位为候选人正在 Chrome 填表那一刻的交互模式：DETECT → IDENTIFY → SEARCH（在reports/内 grep 既有 report）→ LOAD（读完整 report 与既有 Block G）→ COMPARE（页面角色与已评估角色是否一致，变了要提醒并询问是重评还是仅按新 title 调答案）→ ANALYZE → GENERATE → PRESENT（可复制粘贴格式）。要点包括：

• 无 Playwright 时的降级路径：让候选人共享截图（Read 工具可读图）或粘贴问题文本；
• 每个答案都引用既有评估产物：Block B 的 proof point、Block F 的 STAR story、既有 Block G 草稿；
• 韩语投递表单高频字段的处理规则：희망 연봉/처우 用profile.yml的 range 并写明 세전 基准、입사 가능일 依据在职/퇴사 통보 기간给出现实日期、근무 가능 지역/출근 가능 여부 如实填写、언어 능력 用 CEFR 或业务/实战水平表达、포트폴리오 链接只来自 profile/cv/article-digest 的已验证来源；
• 输出为"可直接复制粘贴"的分节格式，标题行注明 Base Report #、Score、Archetype；
• 提交后的收尾：状态变更走 TSV +merge-tracker.mjs，最终答案回写 Block G，并建议/career-ops contacto做 LinkedIn outreach。

7.4pipeline.md— URL Inbox（Second Brain）批处理

modes/ko/pipeline.md 处理data/pipeline.md中累积的 JD 链接。工作流要点：

• 从 "대기"（待处理）区的- [ ]项开始逐条处理，完成后以- [x] #NNN | URL | Company | Role | Score/5 | PDF yes/no移到 "처리 완료" 区；
• 每条约跑完整 auto-pipeline：Evaluation A–F → Report.md → PDF（score ≥ 3.0 时）→ Tracker；
• 无论待处理 URL 有多少，Playwright 支持的抓取一律串行——多个 browser-backed agent 会共享同一 browser instance，不能并行；
• 抓取降级链：Playwright（browser_navigate+browser_snapshot）→ WebFetch → WebSearch；可选scan.extractor: cli用node browser-extract.mjs <url> --mode jd返回精简 JSON 以减少 token，出错或缺省时静默回退到 Playwright；
• 特殊情形：LinkedIn 需要登录时标[!]请候选人贴文本；URL 指向 PDF 时用 Read 直读；local:前缀读本地文件；원티드/리멤버/잡코리아/사람인/LinkedIn KR 等韩国常用平台若有 cookie banner 或 login wall 先用 Playwright 探明；
• 节标题兼容多语言风格：EN "Pending"/"Processed"、ES "Pendientes"/"Procesadas"、DE "Offen"/"Verarbeitet"、FR "En attente"/"Traitees"、KO "대기"/"처리 완료"，写入时沿用现有文件的风格；
• 处理前先跑node cv-sync-check.mjs校验源一致性。

八、贡献与扩展规范：如何把新模式并入韩语集

modes/ko/README.md对贡献者给出 5 步规范：

1. 先开 Issue 说明提案（参考仓库根目录的CONTRIBUTING.md）；
2. 按上文术语表保持文风一致；
3. 翻译追求自然韩语而非逐字直译；
4. 结构要素原样保留：Block A–F、表格、代码块、工具指令一律不动结构、只译文字；
5. 用真实韩语 JD（원티드、리멤버、잡코리아、사람인、LinkedIn KR 等）实测后再提 PR。

结合 AGENTS.md 中的语言模式总表可以看出，本仓库的市场化维护遵循一个统一契约：每套语言模式目录都必须包含_shared.md+ 一个评估模式 + 一个 apply 模式 +pipeline.md；翻译方向与新增市场的验收标准一致（对照该表可见 de/fr/ar/ja/tr/hi 等各自的本地词汇示例）。这与modes/ko/实际交付的四文件结构完全吻合。仓库同时把模式文件归为 system-layer（修改属于上游演进），个人定制则应放用户层文件（modes/_profile.md、modes/_custom.md，gitignored 且不会被更新脚本覆盖）——韩语模式文件的个人化同理应体现在config/profile.yml与个人 CV 材料上，而非直接改动modes/ko/文件。

九、小结：一条可复用的"市场语言模式"范式

modes/ko/README.md展示的不只是韩语翻译，而是 career-ops 面向非英语市场的一套完整工程范式，可提炼为四层：

1. 范围层：只翻译与候选人对话密度最高的模式（_shared+ 评估 + 投递 + pipeline），工具导向模式留在通用语言层，避免无谓的多语言维护成本；
2. 激活层：language.modes_dir提供市场词汇与本地规则、language.output锁定正文语言，两条轴正交组合，配置非法时运行时安全回退到默认英文模式；
3. 知识层：术语表 + "시장 특이사항" 表格把 정규직/계약직/수습기간/포괄임금제/퇴직금/4대 보험/성과급/스톡옵션 等概念翻译成"可执行的评估信号与谈判话术"，而不是停留在词典层面；
4. 质量层：明确的"保留英语清单"、结构不动原则、真实门户实测要求，共同保证本地化产物既地道又不丢失原工作流的可操作语义。

对于任何需要在 AI agent 工作流中落地多语言求职模式的开发者而言，这套"翻译哪些、激活靠什么配置、保留什么原文、用什么术语表守底"的设计，比翻译本身更具参考价值——它给出了一份可以直接复刻到其他市场（或复用为评估任意市场模式完备性）的检查清单。

延伸阅读（仓库内）

• AGENTS.md："Output Language vs Market Modes" 规则、语言模式总表与触发/不触发条件；
• config/profile.example.yml：language.output/language.modes_dir的完整注释示例，及其与 CV、补偿、扫描器等模块的关系；
• profile-language.mjs：输出语言指令的生成与解析实现；
• gemini-eval.mjs：modes_dir越界/缺失时的回退逻辑；
• modes/_shared.md 与 modes/oferta.md：韩语模式的英文/西语翻译基准；
• modes/README.md：全部语言模式目录的定位与维护约定。

【免费下载链接】career-opsOpen-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)项目地址: https://gitcode.com/GitHub_Trending/ca/career-ops