knowme-careerforge-skill 0.0.2 → 0.0.4

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,21 +215,14 @@ 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;
   font-size: var(--resume-font-size-body);
-  color: var(--resume-color-secondary);
   line-height: var(--resume-line-height-body);
 }
 
@@ -249,29 +230,8 @@ body {
   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;
-  }
-}

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();
-```

package/src/references/resume-writing.md

@@ -1,25 +0,0 @@
-# Reference Manual: Resume Writing & FAB Formula (简历撰写与论据模型)
-
----
-
-## 1. FAB 论据构造法
-
-优质的简历 Bullet 应当同时满足**技术深度**与**业务成效**，标准句式结构如下：
-
-$$\text{Bullet} = [\text{强动词}] + [\text{Feature: 核心系统/项目}] + [\text{Advantage: 技术亮点/架构选型}] + [\text{Benefit: 量化业务/技术成效}]$$
-
-### 范例对比：
-
-- ❌ **弱表达（平铺直叙，无亮点）**：
-  > "负责公司 AI 客服系统的后端开发，使用 Python 和大模型编写接口，处理客户问题。"
-- ✅ **强表达（FAB 量化，证据充分）**：
-  > "主导研发基于多 Agent 协同的企业级智能客服系统，采用 LangGraph 状态机与动态剪枝机制优化任务流转，将复杂多轮问答意图识别准确率提升至 94.2%，支撑日均 20 万+ 咨询请求并缩减 Token 成本 35%。"
-
----
-
-## 2. 经历重塑的四大要素
-
-1. **动词要强**：采用精准主动动词（主导、设计、架构、研发、解耦、优化、压榨）。
-2. **技术要硬**：点出关键选型与技术方案（如异步流式响应、分库分表、双路召回、GC 调优）。
-3. **指标要真**：数字可涵盖性能（Latency / QPS）、业务（转化率 / GMV）、稳定性（Crash 率 / SLA）、研发效能（构建提速 / 交付周期）。
-4. **篇幅要精**：单条 Bullet 长度控制在 1~2 行（约 50~100 字），信息密度最大化。

package/src/references/template-design.md

@@ -1,57 +0,0 @@
-# Reference Manual: Template Design & Tokens (模板设计与 Token 体系)
-
----
-
-## 1. 物理 A4 印刷尺寸与 CSS Paged Media
-
-```css
-@page {
-  size: A4 portrait;
-  margin: 0; /* 消除默认打印边距，由容器内边距接管 */
-}
-
-@media print {
-  body { background: transparent; padding: 0; }
-  .resume-page {
-    width: 210mm;
-    height: 297mm;
-    page-break-after: always;
-    page-break-inside: avoid;
-  }
-  .avoid-break {
-    break-inside: avoid;
-    page-break-inside: avoid;
-  }
-}
-```
-
----
-
-## 2. 核心 Design Tokens 字典
-
-```css
-:root {
-  /* 色彩系统 (Slate / Blue 阶梯) */
-  --resume-color-primary: #0f172a;       /* 正文主要文字 (Slate 900) */
-  --resume-color-secondary: #334155;     /* 次要文字与日期 (Slate 700) */
-  --resume-color-muted: #64748b;         /* 辅助文字 (Slate 500) */
-  --resume-color-accent: #2563eb;        /* 主题强调色 (Blue 600) */
-  --resume-color-border: #e2e8f0;        /* 分隔线与边框 (Slate 200) */
-  --resume-color-tag-bg: #f1f5f9;        /* 技能标签背景 (Slate 100) */
-
-  /* 字阶系统 */
-  --resume-font-body: -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", sans-serif;
-  --resume-font-size-name: 20pt;
-  --resume-font-size-target: 10.5pt;
-  --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-header-bottom: 11pt;
-  --resume-space-section: 11pt;
-  --resume-space-item: 7.5pt;
-  --resume-space-bullet: 2.5pt;
-}
-```

package/src/workflows/analyze-job.md

@@ -1,16 +0,0 @@
-# Workflow 3: Analyze Job (洞察岗位与需求分析)
-
-> **目标：深入拆解招聘 JD，提取硬性门槛、加分亮点与招聘信号。**
-
----
-
-## 1. JD 结构化提取流程
-
-1. **提取必备技能 (Must-Have Skills)**：
-   - 筛选招聘 JD 中明确要求的核心语言、框架与基础设施（如 Python, RAG, LangGraph, FastAPI）。
-2. **提取加分技能 (Nice-to-Have Skills)**：
-   - 识别具备竞争优势的加分项（如 K8s, 模型评测 Eval, 论文专利）。
-3. **识别业务痛点与职责关键词 (Responsibilities & Pain Points)**：
-   - 提取业务痛点词（如“长上下文优化”、“高并发削峰”、“Token 降本”、“团队效能”）。
-4. **提取企业文化与招聘信号 (Hiring Signals)**：
-   - 分析团队风格（学术研究型、工程落地型、业务敏捷型、架构治理型）。

package/src/workflows/define-goal.md

@@ -1,16 +0,0 @@
-# Workflow 2: Define Goal (明确方向与定位)
-
-> **目标：明确目标岗位、期望职级与核心价值主张，确立职业叙事重心。**
-
----
-
-## 1. 目标设定要素
-
-1. **目标岗位名称 (Target Role Title)**：
-   - 明确标准岗位名称（如“资深 AI Agent 研发工程师”、“全栈架构师”）。
-2. **期望职级 (Target Seniority)**：
-   - 确定表达重心（Junior/Mid/Senior/Lead/Architect/Director）。
-3. **行业细分领域 (Industry Domain)**：
-   - 锁定行业背景（AI/大模型、企业级 SaaS、金融科技、消费互联网等）。
-4. **核心价值主张 (Core Value Proposition - CVP)**：
-   - 提炼一句话核心定位（15~25 字），概括候选人独特的技术与业务壁垒。

package/src/workflows/forge-resume.md

@@ -1,25 +0,0 @@
-# Workflow 5: Forge Resume (简历工程与修改场排版)
-
-> **目标：以 HTML 为唯一修改场，填充结构化内容，调校 Design Tokens 实现像素级排版。**
-
----
-
-## 1. 模板检索与修改场实例化
-
-1. **执行模板检索**：
-   ```bash
-   python3 scripts/template/search-template.py "<Target Role>" --style "<minimal|modern|executive|classic>" --target-pages 1
-   ```
-2. **实例化中间修改场**：
-   ```bash
-   python3 scripts/template/instantiate-resume.py --template <template_id> --keywords "Python,LLM,RAG,FastAPI" --output workspace/resume.html
-   ```
-
-## 2. 修改场编辑规范
-
-1. **内容填充**：
-   - 保持语义化标签结构：`h1.candidate-name`, `p.job-target`, `section.resume-section`, `div.experience-item`, `ul.bullet-list`。
-2. **Design Tokens 视觉调校**：
-   - 全局间距：`--resume-space-section`, `--resume-space-item`, `--resume-space-bullet`。
-   - 正文字号：`--resume-font-size-body`（标准 `9.2pt`，紧凑可微调至 `8.8pt`）。
-   - 色彩体系：`--resume-color-accent`, `--resume-color-primary`。

package/src/workflows/know-me.md

@@ -1,21 +0,0 @@
-# Workflow 1: Know Me (自我认知与证据挖掘)
-
-> **目标：全面梳理候选人真实事实，建立可信证据底座，杜绝 AI 凭空捏造。**
-
----
-
-## 1. 证据挖掘四步法
-
-1. **结构化资产输入**：
-   - 提取教育背景（学校、专业、学历、时间、GPA/荣誉）。
-   - 提取职业经历（公司、职位、起止时间、部门/团队定位）。
-   - 提取代码库与项目档案（GitHub 仓库、系统架构图、核心职责、采用技术栈）。
-2. **客观事实提取**：
-   - 将主观描述过滤为客观事实实体（技术栈、业务规模、代码量、测试覆盖率、性能指标）。
-3. **L1~L3 证据等级评定**：
-   - **Level 1 (强证据 - Direct Code/Config)**：在代码库、配置文件、CI/CD、文档中有直接证据支持。
-   - **Level 2 (中证据 - Structural/Dependency)**：由目录结构、依赖库选型、架构模式合理推导得出。
-   - **Level 3 (弱推论 - Contextual Inference)**：根据业务上下文合理推测（需使用保守句式，如“参与…的研发”）。
-   - **Unsupported (无证据支撑)**：候选人档案完全未提及。**严禁写入简历**。
-4. **输出 Master Profile JSON**：
-   - 沉淀为标准的结构化候选人事实档案（候选人真实经历底座）。

package/src/workflows/position.md

@@ -1,19 +0,0 @@
-# Workflow 4: Position (优势对齐与策略设计)
-
-> **目标：进行差距分析，将真实证据精准对齐 JD 需求，制定本轮简历策略。**
-
----
-
-## 1. 策略制定四步法
-
-1. **差距分析 (Gap Analysis)**：
-   - **强匹配区 (Strong Match)**：候选人拥有 L1 强证据且完全契合 JD 必备项（重点大篇幅展开）。
-   - **潜在匹配区 (Potential Match)**：候选人拥有 L2/L3 证据可迁移关联（合理呼应）。
-   - **缺失区 (Gap)**：真实经历中未涉及的技能（严禁造假，弱化或引导用户补充真实经历）。
-2. **确定模块优先级 (Section Priority)**：
-   - 技术研发类：`Skills` ➔ `Projects` ➔ `Experience` ➔ `Education`
-   - 管理架构类：`Summary` ➔ `Experience` ➔ `Projects` ➔ `Skills` ➔ `Education`
-3. **确定高亮关键词清单 (Highlight Targets)**：
-   - 提取 8~12 个高频硬核技术词，在 HTML 修改场中注入 `<strong>` 或标签。
-4. **运用 FAB 模型重塑 Bullets**：
-   - 确保每个经历条目包含：强动词 + Feature（系统） + Advantage（架构创新） + Benefit（量化成效）。

package/src/workflows/review.md

@@ -1,31 +0,0 @@
-# Workflow 6: Review & QA (双重质检与自愈闭环)
-
-> **目标：自动化验证 ATS 纯文本可解析性与 DOM 高度溢出，闭环自愈调参，导出确定性 PDF。**
-
----
-
-## 1. 双重 QA 自动化测试
-
-1. **测试 1：布局与 DOM 高度溢出检测**：
-   ```bash
-   python3 scripts/validation/validate-resume.py --html workspace/resume.html --expected-pages 1
-   ```
-   - 单页标准高度：$297\text{mm} \times 96\text{DPI} / 25.4 \approx 1122.5\text{px}$。
-2. **测试 2：ATS 纯文本流解析检测**：
-   ```bash
-   npx ts-node scripts/validation/validate-ats.ts --html workspace/resume.html
-   ```
-
-## 2. 自动化自愈修复闭环
-
-- **若发生页面溢出（如高度 1145px > 1122.5px）**：
-  1. 在 `workspace/resume.html` 的 `<style>` 中微调 `--resume-space-section: 9.5pt;`；
-  2. 微调 `--resume-font-size-body: 9.0pt;`；
-  3. 精简多余空行或过长描述；
-  4. 重新运行验证脚本直至 100% 通过。
-
-## 3. 确定性无损 PDF 导出
-
-```bash
-python3 scripts/rendering/render-pdf.py workspace/resume.html workspace/resume.pdf
-```