career-ops 模板体系完全指南：ATS 安全简历模板的占位符契约、空章节剥离与命名变体机制

career-ops 模板体系完全指南ATS 安全简历模板的占位符契约、空章节剥离与命名变体机制【免费下载链接】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-opscareer-ops 的templates/目录是整条「扫描 → 评估 → 定制 CV → 生成 PDF → 跟踪」自动化链路中的系统层模板中枢从 ATS 友好的 HTML/LaTeX 简历骨架到 portal 扫描配置与申请状态机的规范定义全部沉淀于此。读完本文你将掌握这些模板的占位符契约、可选章节的「标记 哨兵」剥离机制、五种命名 CV 变体与 resume/LaTeX/CJK 模板的正确使用方式并能安全地添加属于自己的自定义模板而不破坏 PDF 管线。templates/ 目录在 career-ops 中的角色与分层原则templates/README.md开门见山地定义了该目录的性质它是System-layer 模板文件集合由 career-ops 的各脚本与 modesAI 工作模式消费。当你在仓库根目录运行npm run update时这些文件会被自动更新——因此用户自定义内容应当写入 user-layer 文件而不是直接改动这里的模板。这一分层在根目录 DATA_CONTRACT.md 中有完整约定是理解“为什么模板里全是占位符、却不建议直接手改”的关键。从工程视角看模板目录至少承担四类职责职责承载文件HTML CV/Resume 生成Playwright 渲染 PDFcv-template.html、五种命名变体、resume-template.htmlLaTeX CV 生成Overleaf 兼容cv-template.tex、cv-template.cjk.texPortal 扫描配置样例portals.example.yml应用状态机与合规数据源states.yml及多个 jurisdiction 数据 YAML全部模板文件被 cv-templates.mjs 统一发现、解析与校验这个“单一事实来源”保证了新增模板文件后能被自动注册而不是散落在构建脚本里的硬编码清单。模板总览谁在使用哪个文件原文档用一张总表刻画了文件与使用方的映射关系核心条目如下路径均已换算为仓库根相对路径文件使用者用途cv-template.htmlgenerate-pdf.mjsATS 优化的 CV PDF 的 HTML/CSS 模板cv-template.{compact,executive,jake,leadership,modern}.htmlgenerate-pdf.mjs、build-cv-html.mjs经由cv-templates.mjs可逐份 CV 选择、或设为cv.template默认值的命名变体与基础模板共享同一套占位符与 ATS 规则resume-template.htmlgenerate-pdf.mjs通过--templateresume 品牌化变体title为 “Resume”、去掉 Certifications 章节、面向 1–2 页美式排版cv-template.texgenerate-latex.mjsATS 优化 LaTeX/Overleaf CV 模板cv-template.cjk.texbuild-cv-latex.mjs --templatecjk、generate-latex.mjsCJK中日韩变体加载fontspecxeCJK需 XeTeX 系引擎portals.example.yml新手上路portal 扫描配置样例复制为portals.yml即生效states.ymlverify-pipeline.mjs、normalize-statuses.mjs、merge-tracker.mjs9 个规范申请状态及其别名restrictive-covenants.yml 等 6 个合规 YAML各 modes如modes/offer-prep.md、modes/interview-redflag.md、modes/oferta.md法域化法定规则表供 prompt 层本地查证除表格之外模板目录还内嵌了两组被构建管线消费的 partialstemplates/sections/下的 7 个 HTML 片段awards、certifications、competencies、education、experience、projects、skills与 templates/ats 下的 ATS 变体包cv-template.ats.html及配套sections/。这一“pack”结构在源码注释中被称为 template packsissue #3202它让一个变体在拥有自己完整 DOM 的同时不再与所有平铺模板共享同一份sections/。cv-template.htmlATS 安全 PDF 的 HTML 骨架cv-template.html 是 HTML 生成链路的基准模板由generate-pdf.mjs经 Playwright 渲染为 PDF。它的正文由两类内容组成占位符 token{{NAME}}、{{SUMMARY_TEXT}}、{{EXPERIENCE}}等与章节标记注释!-- WORK EXPERIENCE --、!-- SKILLS --…。占位符在生成期由 PDF 管线用 payload 数据填充章节标记则供空章节剥离逻辑做精确切分。占位符体系契约的落点从模板源码body 区可以枚举出实际被填充的全部 token头部{{PHOTO}}、{{NAME}}、{{PHONE}}、{{EMAIL}}、{{LINKEDIN_URL}}/{{LINKEDIN_DISPLAY}}、{{PORTFOLIO_URL}}/{{PORTFOLIO_DISPLAY}}、{{LOCATION}}本地化标题{{LANG}}、{{SECTION_SUMMARY}}、{{SECTION_COMPETENCIES}}、{{SECTION_EXPERIENCE}}、{{SECTION_PROJECTS}}、{{SECTION_EDUCATION}}、{{SECTION_CERTIFICATIONS}}、{{SECTION_AWARDS}}、{{SECTION_INTERESTS}}、{{SECTION_SKILLS}}章节正文{{SUMMARY_TEXT}}、{{COMPETENCIES}}、{{EXPERIENCE}}、{{PROJECTS}}、{{EDUCATION}}、{{CERTIFICATIONS}}、{{AWARDS}}、{{INTERESTS}}、{{SKILLS}}布局参数{{PAGE_WIDTH}}max-width来自 payload 的page_formatSECTION_*前缀 token 是刻意区分的它们承载可本地化的章节标题文本从而让同一份模板服务output-language的翻译诉求真正的{{EXPERIENCE}}等则只装内容。值得注意的是校验并不要求全部 token。见 cv-templates.mjs 中KINDS定义cv种类的必填占位符仅三个——NAME、EXPERIENCE、EDUCATION。也就是说“Work Experience 可以被剥离”不等于{{EXPERIENCE}}可以缺席于自定义模板可空的是 payload 的experience数组占位符本身仍是硬契约。机器可读性优先的排版纪律原文档说这套模板“不只是 CSS”cv-template.html 头部注释揭示了三条 ATS 纪律每条都有明确的失效机理禁用捆绑的可变宽 woff2 字体Space Grotesk / DM Sans 这类字体文件的字形步进会让 PDF 文本抽取器在单词内部注入多余空格典型如 “SUM M ARY”、“Germ any”直接毁掉 ATS 关键词解析。因此模板实际采用静态系统 sans 栈--font-family: Liberation Sans, Helvetica Neue, Arial…并用langja/langar规则分别追加 CJK 与阿拉伯字体栈。全局关闭连字ligatures无头 Chromium 在排版期会把fi/fl/ffi替换为 UFB01/FB02 等 Unicode 字形PDF 抽取器再原样解码回去——于是 “verification” 变成 “verification”字面关键字搜索彻底失配。模板通过font-variant-ligatures: none与font-feature-settings: liga 0, clig 0, dlig 0双管齐下*通配 body重复。永远单列布局所有颜色都只是“文本自上而下流动”之上的装饰PDF 抽取顺序因此不受影响多栏是经典 ATS 解析失败源任何变体都不允许使用。模板还以:rootCSS 变量--accent-color、--secondary-color、--font-size、--page-margin暴露主题点issue #1837PDF 管线可在其后追加一份:root覆盖块实现按 profile 注入主题config/profile.yml的style:段。page { margin: var(--page-margin); }的默认值0.6in与generate-pdf.mjs注入的打印页规则保持精确一致。空章节剥离标记匹配而非 DOM 解析当 payload 对某可选章节没有条目时该章节会连头带头整块消失——包含章节标题。机制见共享模块 cv-sections-core.mjs它匹配!-- WORK EXPERIENCE --、!-- PROJECTS --、!-- AWARDS --等标记LaTeX 侧是%%%% ... %%%%形式剥离区间从标记开始直到下一个章节标记结束。正因为靠标记切分重命名或删掉某个标记就等于为该章节关停了剥离。哨兵最后一个章节的安全边界原文档用整整一节强调这个最容易被忽视的细节Skills 是出厂模板的最后一节它后面不再有“下一个章节的标记”供剥离停止因此任何渲染 Skills 的模板都必须在 Skills 之后紧贴一个字面!-- END --注释LaTeX 模板中为%%%% END %%%%它定义了剥离的终点。这块的容错设计非常值得借鉴——缺失哨兵时系统刻意安全失败剥离干脆不运行模板被原样保留Skills 渲染成“一个光秃秃的标题”属于纯外观缺陷而如果既无哨兵又无这个 fail-safe剥离会一路吞到文件末尾删掉收尾的/div/body/htmlLaTeX 的\end{document}产出被截断的坏文档。所以cv-templates.mjs只校验{{NAME}}/{{EXPERIENCE}}/{{EDUCATION}}故意不把哨兵设为必填——缺了它只是退化为外观问题。实现细节在 cv-sections-core.mjs 的正则中HTML 侧用(?!--\s[A-Z][A-Z ]*--)作为通用边界Skills 剥离模式则使用该边界!-- END --自身也是标记天然落入其中LaTeX 侧对应(?^%{4,}\s)。五种命名 CV 变体文件名即注册表cv-template.compact.html、cv-template.executive.html、cv-template.jake.html、cv-template.leadership.html、cv-template.modern.html是基础设计的五种替代风格。发现机制纯粹依赖文件名cv-templates.mjs的正则^cv-template(?:\.([a-z0-9-]))?\.(html|tex)$把cv-template.html解析为名字standard把带后缀的文件解析为对应名字见 cv-templates.mjsresolveTemplate()再经由同一套 discovery 来解析目标文件保证“能列出来的名字就一定能解析”。五种变体的设计定位与适用场景沿自 templates/README.md名称设计要点适合人群modern超大字号姓名、accent 色条标题、浅色 summary 面板、彩色岗位头衔产品与技术类岗位compact紧凑行距、小字号、左侧栏标签列让标题只占一次纵向空间把两页经历压进一页executive衬线字体、居中页眉、细分小型大写标题、无色块填充银行、基金、传统企业leadershipexecutive 的混合体领导力摘要前置、能力块先于时间线高级/领导岗位申请jake广为流传的 “Jakes Resume” LaTeX 版式的 HTML 移植双行岗位头、通栏分隔线期待熟悉版式的工程岗如何选用与设置默认对单份 CV直接用解析器命令锁定目标模板即可node cv-templates.mjs list cv # 输出名字与显示名JSON node cv-templates.mjs resolve cv modern # 输出待填充的模板绝对路径命令也支持 cover letter 种类cv-templates.mjs list|resolve cover与--formattex。若想全局默认在config/profile.yml中设置cv: template: modern源码中loadProfileDefault()从 profile 读取cv.templatecover letter 对应cover_letter.template作为隐式默认未配置时回落standard。此外模板文件头部可携带一段!-- career-ops-template … --元数据注释parseMeta()会解析其中的name:字段作为展示名未提供则按文件名 prettify。“不是 CSS 换肤”的契约测试这些变体不是视觉样式的排列组合而是与基础模板共享完整契约的对象。仓库用 tests/cv-named-templates.test.mjs 把契约钉死在 CI 里对五个变体逐一断言能被listTemplates发现、resolveTemplate解析到自己文件、validateTemplate通过必填占位符校验空可选章节用一条experience: [{ company: Canary }]做金丝雀防止剥离越界吞掉中段内容剥离后文档仍能正常闭合不含捆绑的可变 woff2 字体、禁用连字——这条在 cv-template.html 头注释里被明确称为“不可谈判”因为视觉变体恰恰是最容易丢掉这份纪律的地方。该测试文件头注释点明了两类曾经回归的隐性缺陷issues #2515/#2516变体渲染完美却漏掉!-- AWARDS --标记会把候选人的奖项整段丢弃漏掉尾部!-- END --哨兵则会在每个无技能列表的 CV 上留下光秃秃的 “Skills” 标题——两种都在截图上不可见必须靠测试兜底。模板包packs与命名唯一性从 cv-templates.mjs 的发现逻辑可见模板既可平铺在templates/下也可组织为一层深度的模板包即templates/任意目录名/cv-template.name.html加自己的sections/。模板的名字永远来自文件名而非目录名templates/ats/cv-template.ats.html叫 “ats” 是因为文件包的意义在于build-cv-html.mjs会相对模板文件解析 partials于是每个包拥有自己独立的 DOM 而不触碰平铺模板共享的sections/。同一模板名被两个文件认领如平铺文件与包内文件同名时系统在发现阶段直接抛错而不是用优先级悄悄吞掉一个——assertNoCollision()认为“迁移期输家无声消失、输出里却不点名赢家”是不可接受的失败模式。另外发现逻辑显式跟随符号链接目录repo 支持 symlink 的 user layerissue #524跳过链接会让合法外部模板无声失踪。resume-template.html美式 Resume 变体resume-template.html 是面向美国/行业岗位申请的 resume 品牌化变体与 CV 模板的关键差异title是 “Resume”而非 “CV”不设 Certifications 章节——resume 聚焦最近的相关经历瞄准 1–2 页——省略学术式章节保留 Awards Honors竞赛奖牌或院长名单是“竞争力信号”而非学术注水也是简历经历单薄时早期候选人最强的卖点而空数据时整节自动消失留着零成本。其余部分与cv-template.html共用同一套占位符{{NAME}}、{{SUMMARY_TEXT}}等完全兼容既有 PDF 管线。README 还给出维护纪律更新cv-template.html时必须把相应修改同步到resume-template.html保留上述差异——模板维护者应把它当成一对共同演进的姊妹文件。LaTeX 链路cv-template.tex 与 CJK 变体cv-template.texOverleaf 直接可用的排版模板cv-template.tex 基于广为使用的 sb2nov/resume 格式改写使用{{NAME}}、{{EXPERIENCE}}、{{PROJECTS}}等占位符由 LaTeX 管线在生成期填充。设计上只用 CTAN 标准宏包fontawesome、enumitem、hyperref、titlesec、tabularx、multicol等无自定义字体、无外部依赖因此可以直接原样上传到 Overleaf。其头部还显式设置\pdfgentounicode1并注释“Ensure that generate pdf is machine readable/ATS parsable”与 HTML 模板的机器可读目标遥相呼应。本机用法要求pdflatex在 PATH 中# 校验并编译 .tex → .pdf node generate-latex.mjs output/cv-name-company-date.tex # 或指定自定义输出路径 node generate-latex.mjs output/cv-name-company-date.tex output/custom-name.pdf前置条件Windows 用 MiKTeX、Linux/macOS 用 TeX Live首次编译可能自动补装缺失宏包。不想本地安装时把生成的.tex直接传 Overleaf 即可。占位符全集在 modes/latex.md 的 “Template Placeholders” 一节有文档改边距、章节顺序或格式命令就是编辑此文件本身。HTML 模板占位符文档则在 batch/batch-prompt.md 的 “Template placeholders”。cv-template.cjk.tex中日韩字符渲染cv-template.cjk.tex 是 LaTeX 模板的 CJK中文/日文/韩文变体与cv-template.tex共享占位符与结构仅额外加载fontspecxeCJK从而能渲染假名/汉字/谚文。显式选用node build-cv-latex.mjs input.json output.tex --templatecjk它的使用门槛是引擎与字体README 给出了两条硬约束需要 XeTeX 系后端区别于 pdflatex 的 pdfTeX。本机场景即tectonic引擎——generate-latex.mjs仅在解析到的编译器是 tectonic 时才接受该路径pdflatex-only 的环境会被重定向回pdf模式。Overleaf 上则需在 Menu → Compiler 手动切到 XeLaTeX其默认的 pdfLaTeX 同样编不过此文件。需要系统级安装 CJK 字体。fontspec/xeCJK 从操作系统读取字体tectonic 不会下载或捆绑。模板默认\setCJKmainfont{Noto Serif CJK SC}见 cv-template.cjk.tex若本机无该字体请把这一行改成你实际拥有的字体如 “Noto Sans CJK JP”、“Microsoft YaHei”、“Hiragino Mincho ProN”。portals.example.yml一键开启自动扫描portals.example.yml 是预配置的 portal 扫描器样例内置 45 家跟踪公司与搜索查询涵盖标题过滤器、公司招聘页 URL、Greenhouse API 端点与 WebSearch 查询。它同时是扫描策略的活文档文件头注释定义了四级抓取策略——0) 本地 parser 脚本处理 SSR/静态页面零 token1) Playwright 实时抓取每家公司careers_url2) HTTP JSONWebFetch走api:端点3) 带site:过滤的 WebSearch 做宽泛发现可能陈旧。激活与定制按注释指引进行复制为项目根目录的portals.yml把title_filter.positive关键字改成你的目标岗位关键词在tracked_companies增删公司调整search_queries适配心仪招聘板对不关心的公司设enabled: false。文件还强烈建议优先使用品牌化 careers URLcareers.openai.com而非 ATS 托管地址job-boards.greenhouse.io/...因为品牌页存在时使用裸 ATS URL 可能触发因职位 ID 不匹配导致的假 410 错误。此外包含若干可选行为开关默认注释scan_history.recheck_after_days让已收录 URL 在 N 天后可被再次收录适配职位重开/同 URL 重发的场景dedup_include_location: true则把城市纳入“公司标题”的重复判定令 “Staff Engineer — London” 与 “Staff Engineer — Dublin” 成为两条独立记录适合工作授权、搬迁等受地点约束的求职者。states.yml九态状态机与别名表states.yml 定义应用追踪的 9 个规范状态evaluated/applied/responded/interview/offer/hired/rejected/discarded/skip每个状态附带 label、aliases、description 与 dashboard_group。文件头注释明确规则applications.md的 status 字段必须恰好命中其中一个值不区分大小写不能带 Markdown 加粗、日期或多余文本日期归日期列。需要说明的是README 表格中状态的展示名是Evaluated、Applied、Responded、Interview、Offer、Hired、Rejected、Discarded、SKIP后五个在 YAML 中被terminal: true标记为终结态每个 id 都带一组多语别名如evaluated的[evaluada, condicional, hold, …]、skip的[no_aplicar, monitor, geo blocker, …]——这让 pipeline 脚本能把不同语言记录者的习惯写法归一到同一状态。terminal标记还被 tracker-sync-check.mjs 的compareLifecycle()issue #1504消费终结态之间不再定义单向生命周期顺序但都覆盖任何非终结的前置状态。README 给出的维护红线是不要重命名状态——dashboard 与全部脚本依赖这些精确 ID遇到新写法时应该新增别名映射到既有状态而不是发明新状态。合规数据 YAMLprompt 层的法域化查证表除面向脚本的配置外templates/还驻留六份专供 modes 在 prompt 层使用的法域化数据文件。它们的共同纪律是没有脚本读取本地查证、永不联网检索由 Agent 依据证据分级自行判断匹配且没有可引用法律来源、生效日期与as_of核验日期就不允许新增条目。原文档对每条文件的用途、播种内容与贡献门槛均有明确说明文件消费方种子内容与用途restrictive-covenants.ymlmodes/offer-prep.md按法域的竞业限制成文法表v1 仅 non-compete播入 US-CA BP §16600/§16600.5 与 Ontario ESA s.67.2状态谱系prohibited / allowed_with_mandatory_compensation / allowed_with_limits / common_law_reasonableness。只喂 statutory-context 笔记与定向律师问题绝不构成对候选人条款的裁决protected-grounds.ymlmodes/interview-redflag.mdStep 2c招聘中禁问话题表播种 CA-ON 安省人权法典 s.5(1) 的 16 项事由JP 厚劳省“公正な採用選考”14 项禁问清单双语术语。每个事由带legitimate_contextsBFOR、合理便利、offer 后防误报措辞永远停留在“触及 {事由}受 {法律依据} 保护”绝不判“此举违法”agency-licensing.ymlmodes/oferta.mdBlock G signal 10中介/招聘机构牌照监管表如 Ontario 自 2024-07-01 起强制 THA/招聘牌照并附官方登记查询入口只记录官方政府登记 URL从不抓取immigration-status-requirements.ymlmodes/oferta.md、modes/apply.mdStep 5d雇主不得索要的移民身份要求表如 8 U.S.C. §1324b 下 “US citizens only”、安省人权法典的Haseeb永久居留代理推断。每行强制携带lawful_screening_contrast——授权/担保类问题合法且永不标记jurisdiction-ai-screening-disclosure.ymlmodes/oferta.mdBlock G signal 15AI 招聘筛查披露义务表NYC Local Law 144 AEDT 偏见审计 候选人告知按US-NY-NYC拆分job_location_condition/candidate_residency_conditionIllinois AI Video Interview Act 面试前同意EU AI Act 第 26 条面向高风险招聘 AI 的通知义务生效期 2027-12-02。告示类 half 可独立触发缺省 half 仅作佐证——广告对 AI 筛查只字未提不等于流程后端没有披露jurisdiction-prohibited-content.ymlmodes/oferta.mdBlock G signal 10、modes/apply.mdStep 5c法律禁止要求/询问的内容表如 Ontario 招聘中的 “Canadian experience”、加州的薪资历史提问这组文件体现了 career-ops 的合规设计哲学法律判断作为可追溯、可核验、分法域的静态数据内置由 Agent 以证据分级规则做本地匹配输出永远指向“下一步该问律师什么问题”而不是直接下达“是否违法”的结论。自定义模板清单如何安全地添加第六个变体综合原文档与源码契约要添加新 HTML 变体需满足命名即注册文件命名为cv-template.name.html放入templates/或作为一层 pack 放入子目录cv-templates.mjs会在list/resolve时自动发现三个必填占位符{{NAME}}、{{EXPERIENCE}}、{{EDUCATION}}缺一不可否则resolveTemplate校验会直接报错并点名缺了哪个全套可选章节标记Core Competencies / Projects / Education / Certifications / Awards / Skills 的标记需齐全保证空章节能被完整剥离漏掉!-- AWARDS --会无声丢掉奖项尾部哨兵Skills 之后必须紧跟字面!-- END --缺哨兵不会损坏文档fail-safe 保留整段但会让空技能列表渲染成光秃秃的标题ATS 纪律静态系统字体栈不打包可变 woff2、禁用连字、单列布局。最稳妥的捷径是复制一个现有变体再改样式——因为 tests/cv-named-templates.test.mjs 已经把上述契约逐一钉进了测试只“看起来对”的模板代价是候选人的奖项被悄悄吞掉或遗留光秃的 Skills 标题。HTML 与 LaTeX 双链路的空章节剥离则由 tests/cv-optional-sections.test.mjs 覆盖九份出厂模板的全空含 experience 为空场景。延伸阅读DATA_CONTRACT.mdsystem-layer / user-layer 分层与自动更新的完整约定cv-templates.mjs模板发现、解析、校验与 CLI 的单一事实来源cv-sections-core.mjs空章节剥离正则与 fail-safe 哨兵语义batch/batch-prompt.mdTemplate placeholders与 modes/latex.mdHTML / LaTeX 占位符文档templates/ats以内嵌 sections 包形式存在的 ATS 模板变体作为 pack 结构的实际样例模板层是 career-ops “机器可读、人手可读、Agent 可维护”三原则的集中体现占位符契约界定内容边界标记与哨兵让剥离安全可预测文件名发现机制让扩展零配置——理解这一层你就能在不动核心脚本的前提下把简历输出塑造成任何雇主与 ATS 都乐于解析的样子。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考