knowme-careerforge-skill 0.0.2 → 0.0.6

package/src/templates/modern/style.css

@@ -1,55 +1,43 @@
+/**
+ * KnowMe CareerForge — Modern Split Sidebar Template Style
+ * Style Tone: Modern Deep Navy (Two-Column Sidebar 32:68)
+ * Inherits: src/templates/common/base.css
+ */
+
 :root {
-  /* 页面物理约束 */
-  --resume-page-width: 210mm;
-  --resume-page-min-height: 297mm;
-
-  /* 配色体系 */
-  --resume-color-sidebar-bg: #254665;    /* 经典深海蓝 Navy */
-  --resume-color-sidebar-text: #f8fafc;  /* 侧边栏反白字 */
-  --resume-color-sidebar-muted: #94a3b8; /* 侧边栏辅助文字 */
-  --resume-color-sidebar-accent: #38bdf8;/* 侧边栏亮色高亮 */
+  /* === COMPONENT TOKENS (Overrides & Aliases) === */
+  --resume-color-sidebar-bg: var(--primitive-color-navy-800);
+  --resume-color-sidebar-text: var(--primitive-color-slate-50);
+  --resume-color-sidebar-muted: var(--primitive-color-slate-400);
+  --resume-color-sidebar-accent: var(--primitive-color-sky-400);
   
-  --resume-color-main-bg: #ffffff;
-  --resume-color-primary: #0f172a;       /* Slate 900 */
-  --resume-color-secondary: #334155;     /* Slate 700 */
-  --resume-color-muted: #64748b;         /* Slate 500 */
-  --resume-color-accent: #254665;        /* 主舞台强调色 */
-  --resume-color-border: #e2e8f0;        /* Slate 200 */
-
-  /* 字阶系统 */
-  --resume-font-body: -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", sans-serif;
-  --resume-font-size-name: 22pt;
-  --resume-font-size-target: 11pt;
-  --resume-font-size-h2: 12pt;
-  --resume-font-size-body: 9.2pt;
-  --resume-font-size-meta: 8.5pt;
-  --resume-line-height-body: 1.45;
-
-  /* 间距 Tokens (Agent 自愈参数) */
-  --resume-space-section: 12pt;
-  --resume-space-item: 8pt;
-  --resume-space-bullet: 2.5pt;
+  --resume-color-main-bg: var(--primitive-color-white);
+  --resume-color-primary: var(--primitive-color-slate-900);
+  --resume-color-secondary: var(--primitive-color-slate-700);
+  --resume-color-muted: var(--primitive-color-slate-500);
+  --resume-color-accent: var(--primitive-color-navy-800);
+  --resume-color-border: var(--primitive-color-slate-200);
+
+  /* Typography Bindings */
+  --resume-font-body: var(--primitive-font-sans);
+  --resume-font-size-name: var(--primitive-font-size-display);
+  --resume-font-size-target: var(--primitive-font-size-h3);
+  --resume-font-size-h2: var(--primitive-font-size-h2);
+  --resume-font-size-body: var(--primitive-font-size-body);
+  --resume-font-size-meta: var(--primitive-font-size-meta);
+  --resume-line-height-body: var(--primitive-line-height-normal);
+
+  /* Spacing Tokens (Calibratable for Self-Healing) */
+  --resume-space-section: var(--primitive-space-6);
+  --resume-space-item: var(--primitive-space-4);
+  --resume-space-bullet: var(--primitive-space-1);
   --resume-sidebar-width: 32%;
 }
 
-* { box-sizing: border-box; margin: 0; padding: 0; }
-
-body {
-  background-color: #e2e8f0;
-  font-family: var(--resume-font-body);
-  display: flex;
-  justify-content: center;
-  padding: 24px 0;
-  -webkit-font-smoothing: antialiased;
-}
-
 .resume-page {
-  width: var(--resume-page-width);
-  min-height: var(--resume-page-min-height);
   background: var(--resume-color-main-bg);
   display: grid;
   grid-template-columns: var(--resume-sidebar-width) 1fr;
-  box-shadow: 0 10px 25px -5px rgba(0, 0, 0, 0.15), 0 8px 10px -6px rgba(0, 0, 0, 0.1);
   overflow: hidden;
 }
 
@@ -227,51 +215,70 @@ body {
 .tech-badge {
   font-size: 8pt;
   color: var(--resume-color-muted);
-  background: #f1f5f9;
+  background: var(--primitive-color-slate-100);
   padding: 1.5pt 4pt;
   border-radius: 2pt;
 }
 
-.date-range {
-  font-size: var(--resume-font-size-meta);
-  color: var(--resume-color-muted);
-  font-variant-numeric: tabular-nums;
-}
-
 .bullet-list {
-  margin-left: 12pt;
+  margin: 0;
+  padding-left: 14pt;
   font-size: var(--resume-font-size-body);
-  color: var(--resume-color-secondary);
   line-height: var(--resume-line-height-body);
+  color: var(--resume-color-secondary);
 }
 
 .bullet-list li {
   margin-bottom: var(--resume-space-bullet);
 }
 
-.bullet-list strong {
-  color: var(--resume-color-primary);
-  font-weight: 600;
-}
-
 .edu-desc {
   font-size: var(--resume-font-size-body);
   color: var(--resume-color-secondary);
   line-height: var(--resume-line-height-body);
 }
 
-@media print {
-  body { background: transparent; padding: 0; }
-  .resume-page {
-    box-shadow: none;
-    margin: 0;
-    width: var(--resume-page-width);
-    min-height: var(--resume-page-min-height);
-    page-break-after: always;
-    page-break-inside: avoid;
-  }
-  @page {
-    size: A4 portrait;
-    margin: 0;
-  }
+/* === GENERATED HTML COMPONENT CLASSES ===
+ * These classes are emitted by instantiate-resume.py at runtime.
+ * Must stay in sync with the HTML generator output.
+ */
+
+/* Sidebar section grouping container */
+.sidebar-section {
+  display: flex;
+  flex-direction: column;
+}
+
+/* Experience / project card wrappers (alias of timeline-item) */
+.experience-item,
+.project-item {
+  margin-bottom: var(--resume-space-item);
+}
+
+/* Role badge next to company/project name in instantiated cards */
+.role-badge {
+  font-size: 9pt;
+  font-weight: 500;
+  color: #0284c7; /* Sky 600 — matches .role-title */
+  white-space: nowrap;
+}
+
+/* Tech stack tag row container */
+.tech-stack-tags {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 3pt;
+  margin: 3pt 0 5pt;
+}
+
+/* Individual tech stack pill */
+.tech-tag {
+  font-size: 7.5pt;
+  color: var(--resume-color-secondary);
+  background: var(--primitive-color-slate-100);
+  padding: 1pt 5pt;
+  border-radius: 2pt;
+  white-space: nowrap;
+  line-height: 1.35;
+  font-family: var(--primitive-font-mono);
 }

package/src/templates/startup-generalist/README.md

@@ -0,0 +1,25 @@
+# Startup Generalist Cards Template (`startup-generalist`)
+
+> **定位：面向早期初创公司 0~1 核心骨干、独立开发者与增长工程师的模块化卡片流模板。**
+
+- **版式风格**：模块化卡片流 (Modular Cards Flow)
+- **视觉色系**：活力翡翠绿 (`#059669`, `--palette-emerald-fresh`) + 板岩灰阶 (`#1e293b`, `#334155`)
+- **ATS 评级**：Tier 1 (Optimal - 100% 完美解析)
+- **目标页数**：1 页
+- **信息密度**：高 (High)
+- **核心 Tokens**：
+  - `--resume-space-section`: `10pt`
+  - `--resume-space-item`: `7pt`
+  - `--resume-space-bullet`: `2.0pt`
+  - `--resume-font-size-body`: `9.0pt`
+  - `--resume-line-height-body`: `1.42`
+  - `--resume-color-accent`: `var(--palette-emerald-fresh)`
+
+## 文件维护
+
+- `canvas.html`：唯一维护的 HTML 布局，包含统一命名槽位。
+- `style.css`：此模板的样式与设计变量。
+- `sample-profile.json`：仅供画廊使用的虚构样例数据，不作为用户简历默认值。
+- `metadata.json`：模板选择与布局元数据。
+
+在项目根目录运行 `python3 scripts/build/build-gallery.py` 生成画廊。预览与实际简历共用实例化器及完整 CSS 链；生成的 HTML 位于 `output/templates_gallery/`，不回写到模板源目录。

package/src/templates/startup-generalist/canvas.html

@@ -0,0 +1,21 @@
+<!DOCTYPE html>
+<html lang="{{ resume:language }}">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title><!-- resume:document-title --></title>
+<!-- resume:styles -->
+</head>
+<body>
+<div class="resume-page bound-canvas canvas-startup-generalist">
+<main>
+<!-- resume:basics -->
+<!-- resume:summary -->
+<!-- resume:skills -->
+<!-- resume:experience -->
+<!-- resume:projects -->
+<!-- resume:education --><!-- resume:certifications -->
+</main>
+</div>
+</body>
+</html>

package/src/templates/startup-generalist/metadata.json

@@ -0,0 +1,37 @@
+{
+  "id": "startup-generalist",
+  "name": "Startup Generalist Cards",
+  "version": "1.0.0",
+  "style": "modular-cards",
+  "roleCategory": "startup-growth",
+  "layout": {
+    "type": "modular-cards",
+    "targetPages": 1,
+    "maxPages": 1,
+    "density": "high"
+  },
+  "visualStyle": {
+    "tone": "emerald-green",
+    "accentColor": "#059669",
+    "fontFamily": "System Sans-Serif"
+  },
+  "atsScoreTier": "tier-1-optimal",
+  "supportedRoles": [
+    "fullstack",
+    "indie-hacker",
+    "startup-cto",
+    "growth-engineer",
+    "product-engineer",
+    "frontend",
+    "backend"
+  ],
+  "languages": ["zh-CN", "en-US"],
+  "customizableTokens": [
+    "--resume-font-size-body",
+    "--resume-line-height-body",
+    "--resume-space-section",
+    "--resume-space-item",
+    "--resume-space-bullet",
+    "--resume-color-accent"
+  ]
+}

package/src/templates/startup-generalist/sample-profile.json

@@ -0,0 +1,86 @@
+{
+  "language": "zh-CN",
+  "basics": {
+    "name": "示例候选人",
+    "title": "fullstack",
+    "email": "candidate@example.com",
+    "phone": "138-0000-0000",
+    "location": "示例城市",
+    "summary": "本页为虚构排版样例，姓名、机构和经历均不代表真实候选人。"
+  },
+  "skills": [
+    {
+      "category": "工程实践",
+      "items": [
+        "Python",
+        "TypeScript",
+        "SQL"
+      ]
+    },
+    {
+      "category": "协作与交付",
+      "items": [
+        "需求分析",
+        "质量验证",
+        "技术文档"
+      ]
+    }
+  ],
+  "experience": [
+    {
+      "company": "示例科技公司（虚构）",
+      "role": "fullstack",
+      "startDate": "2022.07",
+      "endDate": "2025.06",
+      "bullets": [
+        {
+          "text": "负责示例业务模块的需求分析、实现与交付，整理接口约定和验收标准。"
+        },
+        {
+          "text": "与产品和测试协作完成版本迭代，补充异常场景验证及使用文档。"
+        }
+      ]
+    },
+    {
+      "company": "示例工作室（虚构）",
+      "role": "项目成员",
+      "startDate": "2020.07",
+      "endDate": "2022.06",
+      "bullets": [
+        {
+          "text": "参与内部工具开发，梳理业务流程并维护数据校验规则。"
+        }
+      ]
+    }
+  ],
+  "projects": [
+    {
+      "name": "业务协作平台（虚构项目）",
+      "role": "核心开发",
+      "techStack": [
+        "TypeScript",
+        "Python",
+        "PostgreSQL"
+      ],
+      "startDate": "2024.01",
+      "endDate": "2024.10",
+      "bullets": [
+        {
+          "text": "实现任务分配、进度记录与报表导出，建立可复用的数据访问接口。"
+        },
+        {
+          "text": "补充自动化校验和部署说明，支持团队复现开发环境。"
+        }
+      ]
+    }
+  ],
+  "education": [
+    {
+      "institution": "示例大学（虚构）",
+      "degree": "学士",
+      "field": "计算机科学",
+      "startDate": "2016.09",
+      "endDate": "2020.06"
+    }
+  ]
+}

package/src/templates/startup-generalist/style.css

@@ -0,0 +1,237 @@
+/**
+ * KnowMe CareerForge — Startup Generalist Cards Template Style
+ * Style Tone: Emerald Green (Modular Cards Flow)
+ * Inherits: src/templates/common/base.css
+ */
+
+:root {
+  /* === COMPONENT TOKENS (Overrides & Aliases) === */
+  --resume-page-padding: 12mm 14mm;
+
+  /* Color Bindings */
+  --resume-color-primary: #0f172a;
+  --resume-color-secondary: #334155;
+  --resume-color-muted: #64748b;
+  --resume-color-accent: var(--palette-emerald-fresh);
+  --resume-color-accent-bg: #ecfdf5;
+  --resume-color-card-border: #e2e8f0;
+  --resume-color-card-bg: #f8fafc;
+  --resume-color-tag-bg: #e6f4ea;
+  --resume-color-border: #cbd5e1;
+
+  /* Typography Bindings */
+  --resume-font-body: var(--primitive-font-sans);
+  --resume-font-size-name: 20pt;
+  --resume-font-size-target: 10pt;
+  --resume-font-size-h2: 11pt;
+  --resume-font-size-body: 9.0pt;
+  --resume-font-size-meta: 8.5pt;
+  --resume-line-height-body: 1.42;
+
+  /* Spacing Tokens (Calibratable for Self-Healing) */
+  --resume-space-header-bottom: 8pt;
+  --resume-space-section: 10pt;
+  --resume-space-item: 7pt;
+  --resume-space-bullet: 2.0pt;
+}
+
+.resume-page {
+  padding: var(--resume-page-padding);
+}
+
+/* Header 模块 */
+.resume-header {
+  border-bottom: 2px solid var(--resume-color-accent);
+  padding-bottom: var(--resume-space-header-bottom);
+  margin-bottom: var(--resume-space-section);
+}
+
+.header-top {
+  display: flex;
+  justify-content: space-between;
+  align-items: baseline;
+  flex-wrap: wrap;
+  gap: 6pt;
+}
+
+.candidate-name {
+  font-size: var(--resume-font-size-name);
+  font-weight: 700;
+  color: var(--resume-color-accent);
+  margin: 0;
+  letter-spacing: 0.5px;
+}
+
+.job-target {
+  font-size: var(--resume-font-size-target);
+  color: var(--resume-color-secondary);
+  font-weight: 600;
+  margin: 0;
+}
+
+.contact-grid {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 4pt 12pt;
+  font-size: var(--resume-font-size-meta);
+  color: var(--resume-color-muted);
+  margin-top: 4pt;
+}
+
+.contact-item {
+  display: inline-flex;
+  align-items: center;
+}
+
+.value-prop {
+  font-size: var(--resume-font-size-body);
+  color: var(--resume-color-secondary);
+  line-height: var(--resume-line-height-body);
+  margin: 5pt 0 0 0;
+}
+
+/* 章节通用样式 */
+.resume-section {
+  margin-bottom: var(--resume-space-section);
+}
+
+.section-title {
+  font-size: var(--resume-font-size-h2);
+  font-weight: 700;
+  color: var(--resume-color-primary);
+  display: flex;
+  align-items: center;
+  gap: 6pt;
+  margin: 0 0 calc(var(--resume-space-item) * 0.75) 0;
+  text-transform: uppercase;
+  letter-spacing: 0.5px;
+}
+
+.section-title::before {
+  content: "";
+  display: inline-block;
+  width: 4pt;
+  height: 11pt;
+  background-color: var(--resume-color-accent);
+  border-radius: 1pt;
+}
+
+/* 技能模块 */
+.skills-content {
+  display: flex;
+  flex-direction: column;
+  gap: 3pt;
+  background-color: var(--resume-color-card-bg);
+  border: 1px solid var(--resume-color-card-border);
+  border-radius: 4pt;
+  padding: 6pt 10pt;
+}
+
+.skill-row {
+  font-size: var(--resume-font-size-body);
+  line-height: var(--resume-line-height-body);
+}
+
+.skill-category {
+  font-weight: 700;
+  color: var(--resume-color-primary);
+}
+
+.skill-items {
+  color: var(--resume-color-secondary);
+}
+
+/* 卡片风格条目 */
+.experience-item,
+.project-item,
+.education-item {
+  margin-bottom: var(--resume-space-item);
+  background-color: #ffffff;
+  border: 1px solid var(--resume-color-card-border);
+  border-radius: 4pt;
+  padding: 6pt 10pt;
+}
+
+.item-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: baseline;
+  margin-bottom: 2pt;
+}
+
+.item-title-group {
+  display: flex;
+  align-items: center;
+  gap: 6pt;
+  flex-wrap: wrap;
+}
+
+.org-name,
+.project-name {
+  font-weight: 700;
+  font-size: var(--resume-font-size-body);
+  color: var(--resume-color-primary);
+}
+
+.role-badge {
+  font-size: var(--resume-font-size-meta);
+  font-weight: 600;
+  color: var(--resume-color-accent);
+  background-color: var(--resume-color-accent-bg);
+  padding: 1pt 5pt;
+  border-radius: 3pt;
+}
+
+.date-range {
+  font-size: var(--resume-font-size-meta);
+  color: var(--resume-color-muted);
+  font-weight: 500;
+  white-space: nowrap;
+}
+
+.tech-stack-tags {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 3pt;
+  margin: 2pt 0 3pt 0;
+}
+
+.tech-tag {
+  font-size: 7.5pt;
+  background-color: var(--resume-color-tag-bg);
+  color: var(--resume-color-accent);
+  padding: 1pt 5pt;
+  border-radius: 3pt;
+  font-family: var(--primitive-font-mono);
+  font-weight: 600;
+}
+
+.bullet-list {
+  margin: 0;
+  padding-left: 13pt;
+  color: var(--resume-color-secondary);
+  font-size: var(--resume-font-size-body);
+  line-height: var(--resume-line-height-body);
+}
+
+.bullet-list li {
+  margin-bottom: var(--resume-space-bullet);
+}
+
+.edu-detail {
+  font-size: var(--resume-font-size-meta);
+  color: var(--resume-color-secondary);
+  margin: 2pt 0 0 0;
+}
+
+.sidebar-section {
+  margin-bottom: var(--resume-space-section);
+}
+
+@media print {
+  .resume-page {
+    padding: var(--resume-page-padding);
+    page-break-after: always;
+    page-break-inside: avoid;
+  }
+}

package/src/references/ats.md

@@ -1,17 +0,0 @@
-# Reference Manual: ATS Compatibility (ATS 解析合规手册)
-
----
-
-## 1. ATS 友好性标准
-
-ATS（Applicant Tracking System，求职者追踪系统）在筛选简历时依赖确定性的文本流与标准的标头层次。
-
-### 核心合规法则：
-1. **纯文本可提取性**：所有关键文字（姓名、公司、职位、技能词）必须是标准 HTML 文本节点，严禁使用图片代替文字。
-2. **标准标头词典**：模块标题必须使用行业标准词汇：
-   - `工作经历` / `Work Experience`
-   - `项目经历` / `Projects`
-   - `专业技能` / `Skills`
-   - `教育背景` / `Education`
-3. **线性文档流**：在双栏或复杂布局中，必须保证 DOM 树的逻辑顺序清晰，避免文字抽取时产生词句乱序。
-4. **标准联系方式格式**：电话使用标准连字符或空格（如 `138-0000-0000`），邮箱使用标准格式。

package/src/references/evidence-first.md

@@ -1,22 +0,0 @@
-# Reference Manual: Evidence-First Principle (证据为先与防幻觉准则)
-
-> **"The goal is not to make the candidate look better than they are. The goal is to make their real strengths visible to the right opportunity."**
-
----
-
-## 1. 证据级别判定标准
-
-| 级别 | 判定标准 | 证据源形态 | 允许使用的表述范例 | 严禁使用的表述 |
-| :--- | :--- | :--- | :--- | :--- |
-| **Level 1 (直接强证据)** | 代码实现、配置文件、API 契约、文档、测试套件中有直接支撑 | `src/`, `package.json`, `Dockerfile`, CI/CD 脚本, Commit 记录 | "基于 FastAPI 与 Qdrant 研发 RAG 检索流水线，通过双路召回使 Top-3 召回率达 92%" | 夸大超出代码库的业务范围或虚构营收数字 |
-| **Level 2 (结构中证据)** | 目录架构、依赖库声明、模块拆分等可推导的技术关联 | 模块命名、依赖版本、数据库 Schema | "参与分布式微服务中台建设，负责商品与订单服务接口研发" | 将仅有依赖包集成的经历包装为从零主导底层自研 |
-| **Level 3 (合理弱推论)** | 根据行业通用实践与上下文合理推论得出的辅助动作 | 项目上线流程、团队协同机制 | "协同产品团队推进需求落地，参与敏捷迭代与 Code Review" | 宣称“统筹百人团队进行跨国架构重构” |
-| **Unsupported (无支撑)** | 候选人材料与代码库中完全未出现的技术或经历 | 无对应内容 | **严禁写入简历** | 凭空虚构未经证实的项目或大厂背景 |
-
----
-
-## 2. 防幻觉门禁执行清单
-
-1. **核实关键技术名词**：是否在候选人技能列表或代码中有据可查？
-2. **核实职责边界**：候选人是“主导”、“核心研发”还是“参与协同”？
-3. **核实指标真实性**：百分比提升、QPS 数值、用户规模必须来自真实材料，若无具体数值可聚焦架构与技术攻坚点，严禁捏造虚假数字。

package/src/references/pdf.md

@@ -1,40 +0,0 @@
-# Reference Manual: Deterministic PDF Rendering (Playwright 确定性渲染实践)
-
----
-
-## 1. 为什么使用 Playwright 而非传统转换器？
-
-传统 HTML 到 PDF 工具（如 wkhtmltopdf 或 puppeteer 简易打印）存在两大痛点：
-1. **网络字体未就绪即打印**：导致字体 fallback 变形，字符间距和总高度发生突变；
-2. **跨系统渲染差异**：Linux / macOS / Windows 默认 DPI 与字体抗锯齿不同。
-
----
-
-## 2. Playwright 确定性渲染标准配置
-
-```typescript
-import { chromium } from 'playwright';
-
-const browser = await chromium.launch({ headless: true });
-const context = await browser.newContext({
-  viewport: { width: 794, height: 1123 }, // A4 at 96 DPI
-  deviceScaleFactor: 2
-});
-
-const page = await context.newPage();
-await page.goto(fileUrl, { waitUntil: 'networkidle' });
-
-// 严格等待所有 Web 字体与静态资源加载完成
-await page.evaluateHandle('document.fonts.ready');
-
-// 导出标准 A4 矢量 PDF
-await page.pdf({
-  path: outputPath,
-  format: 'A4',
-  printBackground: true,
-  preferCSSPageSize: true,
-  margin: { top: '0px', right: '0px', bottom: '0px', left: '0px' }
-});
-
-await browser.close();
-```