knowme-careerforge-skill 0.0.2 → 0.0.6

package/src/templates/Agent.md

@@ -0,0 +1,11 @@
+# Template bundle contract
+
+Each template contains canvas.html, sample-profile.json, style.css, metadata.json and README.md. canvas.html is the sole maintained HTML structure with explicit named slots and no candidate samples. Generate gallery previews with scripts/build/build-gallery.py using the same instantiator and CSS as actual resumes. sample-profile.json is explicitly fictional gallery input, never a runtime default. Generated previews belong in output, not src/templates.
+
+The instantiator validates slot completeness and context before binding facts once. Shared profile normalization accepts missing/null fields, rejects unknown or mistyped data, and preserves every supplied education, experience and project entry. Escape candidate text before embedding it. Do not use sample-based regex substitution or default candidate achievements.
+
+Inline styles in order: common/base.css, template style.css, common/canvas-bindings.css. Use CSS tokens for tunable spacing and typography; narrow columns must wrap long text and maintain readable contrast. No hidden body text, external assets or image-based body copy.
+
+Each explicit .resume-page represents one A4 page. Two-page layouts need two page containers; the current validator deliberately rejects one oversized root flowing implicitly into multiple pages because per-page content acceptance would otherwise be ambiguous. --expected-pages is a maximum of one or two pages.
+
+Tests must use temporary directories. Verify actual print layout and final PDF text, plus inspect rendered screenshots after geometry changes. Metadata ATS tiers describe design intent, not universal ATS certification. Read common/resume-contract.md and ../../references/07-artifact-contract.md for the complete contract.

package/src/templates/academic-research/README.md

@@ -0,0 +1,25 @@
+# Academic Research Flow Template (`academic-research`)
+
+> **定位：面向高校硕博、算法科学家、科研人员与学术求职者的高密度单栏学术风模板。**
+
+- **版式风格**：单栏紧凑学术流 (Single-Column Academic Flow)
+- **视觉色系**：牛津海军蓝 (`#1e3a8a`, `--palette-deep-navy`) + 板岩灰阶 (`#0f172a`, `#334155`)
+- **ATS 评级**：Tier 1 (Optimal - 100% 完美解析)
+- **目标页数**：1~2 页 (默认 1 页自包含紧凑布局)
+- **信息密度**：极高 (Ultra)
+- **核心 Tokens**：
+  - `--resume-space-section`: `10pt`
+  - `--resume-space-item`: `6.5pt`
+  - `--resume-space-bullet`: `2.0pt`
+  - `--resume-font-size-body`: `9.0pt`
+  - `--resume-line-height-body`: `1.40`
+  - `--resume-color-accent`: `var(--palette-deep-navy)`
+
+## 文件维护
+
+- `canvas.html`：唯一维护的 HTML 布局，包含统一命名槽位。
+- `style.css`：此模板的样式与设计变量。
+- `sample-profile.json`：仅供画廊使用的虚构样例数据，不作为用户简历默认值。
+- `metadata.json`：模板选择与布局元数据。
+
+在项目根目录运行 `python3 scripts/build/build-gallery.py` 生成画廊。预览与实际简历共用实例化器及完整 CSS 链；生成的 HTML 位于 `output/templates_gallery/`，不回写到模板源目录。

package/src/templates/academic-research/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-academic-research">
+<main>
+<!-- resume:basics -->
+<!-- resume:summary -->
+<!-- resume:education --><!-- resume:certifications -->
+<!-- resume:skills -->
+<!-- resume:experience -->
+<!-- resume:projects -->
+</main>
+</div>
+</body>
+</html>

package/src/templates/academic-research/metadata.json

@@ -0,0 +1,38 @@
+{
+  "id": "academic-research",
+  "name": "Academic Research Flow",
+  "version": "1.0.0",
+  "style": "single-column-academic",
+  "roleCategory": "research-algorithm",
+  "layout": {
+    "type": "single-column",
+    "targetPages": 1,
+    "maxPages": 2,
+    "density": "ultra"
+  },
+  "visualStyle": {
+    "tone": "oxford-navy",
+    "accentColor": "#1e3a8a",
+    "fontFamily": "System Sans-Serif"
+  },
+  "atsScoreTier": "tier-1-optimal",
+  "supportedRoles": [
+    "ai-agent-engineer",
+    "algorithm-engineer",
+    "research-scientist",
+    "data-scientist",
+    "nlp-engineer",
+    "cv-engineer",
+    "phd-candidate",
+    "postdoc"
+  ],
+  "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/academic-research/sample-profile.json

@@ -0,0 +1,86 @@
+{
+  "language": "zh-CN",
+  "basics": {
+    "name": "示例候选人",
+    "title": "ai-agent-engineer",
+    "email": "candidate@example.com",
+    "phone": "138-0000-0000",
+    "location": "示例城市",
+    "summary": "本页为虚构排版样例，姓名、机构和经历均不代表真实候选人。"
+  },
+  "skills": [
+    {
+      "category": "工程实践",
+      "items": [
+        "Python",
+        "TypeScript",
+        "SQL"
+      ]
+    },
+    {
+      "category": "协作与交付",
+      "items": [
+        "需求分析",
+        "质量验证",
+        "技术文档"
+      ]
+    }
+  ],
+  "experience": [
+    {
+      "company": "示例科技公司（虚构）",
+      "role": "ai-agent-engineer",
+      "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/academic-research/style.css

@@ -0,0 +1,213 @@
+/**
+ * KnowMe CareerForge — Academic Research Template Style
+ * Style Tone: Oxford Navy (Single-Column Academic Flow)
+ * Inherits: src/templates/common/base.css
+ */
+
+:root {
+  /* === COMPONENT TOKENS (Overrides & Aliases) === */
+  --resume-page-padding: 12mm 15mm;
+
+  /* Color Bindings */
+  --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(--palette-deep-navy);
+  --resume-color-accent-bg: #eff6ff;
+  --resume-color-border: var(--primitive-color-slate-200);
+  --resume-color-tag-bg: var(--primitive-color-slate-100);
+
+  /* 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: 11.5pt;
+  --resume-font-size-body: 9.0pt;
+  --resume-font-size-meta: 8.5pt;
+  --resume-line-height-body: 1.40;
+
+  /* Spacing Tokens (Calibratable for Self-Healing) */
+  --resume-space-header-bottom: 8pt;
+  --resume-space-section: 10pt;
+  --resume-space-item: 6.5pt;
+  --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);
+  text-align: center;
+}
+
+.candidate-name {
+  font-size: var(--resume-font-size-name);
+  font-weight: 700;
+  color: var(--resume-color-accent);
+  margin: 0 0 2pt 0;
+  letter-spacing: 0.5px;
+}
+
+.job-target {
+  font-size: var(--resume-font-size-target);
+  color: var(--resume-color-secondary);
+  font-weight: 600;
+  margin: 0 0 4pt 0;
+}
+
+.contact-grid {
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: center;
+  gap: 6pt 14pt;
+  font-size: var(--resume-font-size-meta);
+  color: var(--resume-color-secondary);
+}
+
+.contact-item {
+  display: inline-flex;
+  align-items: center;
+  gap: 3pt;
+}
+
+.value-prop {
+  font-size: var(--resume-font-size-body);
+  color: var(--resume-color-secondary);
+  line-height: var(--resume-line-height-body);
+  margin: 6pt auto 0 auto;
+  max-width: 90%;
+  font-style: italic;
+}
+
+/* 章节通用样式 */
+.resume-section {
+  margin-bottom: var(--resume-space-section);
+}
+
+.section-title {
+  font-size: var(--resume-font-size-h2);
+  font-weight: 700;
+  color: var(--resume-color-accent);
+  border-bottom: 1px solid var(--resume-color-accent);
+  padding-bottom: 2pt;
+  margin: 0 0 calc(var(--resume-space-item) * 0.8) 0;
+  text-transform: uppercase;
+  letter-spacing: 0.5px;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+}
+
+/* 技能模块 */
+.skills-content {
+  display: flex;
+  flex-direction: column;
+  gap: 3pt;
+}
+
+.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, Projects, Education) */
+.experience-item,
+.project-item,
+.education-item {
+  margin-bottom: var(--resume-space-item);
+}
+
+.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);
+}
+
+.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: 4pt;
+  margin: 2pt 0 3pt 0;
+}
+
+.tech-tag {
+  font-size: 7.5pt;
+  background-color: var(--resume-color-tag-bg);
+  color: var(--resume-color-secondary);
+  padding: 1pt 5pt;
+  border-radius: 2pt;
+  font-family: var(--primitive-font-mono);
+}
+
+.bullet-list {
+  margin: 0;
+  padding-left: 14pt;
+  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/templates/classic/README.md

@@ -10,3 +10,12 @@
   - `--resume-cell-padding`: `4.5pt 7pt` (默认)
   - `--resume-font-size-body`: `9pt` (默认)
   - `--resume-color-accent`: `#1d4ed8` (默认)
+
+## 文件维护
+
+- `canvas.html`：唯一维护的 HTML 布局，包含统一命名槽位。
+- `style.css`：此模板的样式与设计变量。
+- `sample-profile.json`：仅供画廊使用的虚构样例数据，不作为用户简历默认值。
+- `metadata.json`：模板选择与布局元数据。
+
+在项目根目录运行 `python3 scripts/build/build-gallery.py` 生成画廊。预览与实际简历共用实例化器及完整 CSS 链；生成的 HTML 位于 `output/templates_gallery/`，不回写到模板源目录。

package/src/templates/classic/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-classic">
+<!-- resume:basics -->
+<table class="resume-grid-table"><tbody>
+<tr><td><!-- resume:summary --></td></tr>
+<tr><td><!-- resume:skills --></td></tr>
+<tr><td><!-- resume:experience --></td></tr>
+<tr><td><!-- resume:projects --></td></tr>
+<tr><td><!-- resume:education --><!-- resume:certifications --></td></tr>
+</tbody></table>
+</div>
+</body>
+</html>

package/src/templates/classic/metadata.json

@@ -28,6 +28,9 @@
   "customizableTokens": [
     "--resume-font-size-body",
     "--resume-cell-padding",
+    "--resume-space-section",
+    "--resume-space-item",
+    "--resume-space-bullet",
     "--resume-color-accent",
     "--resume-color-label-bg"
   ]

package/src/templates/classic/sample-profile.json

@@ -0,0 +1,86 @@
+{
+  "language": "zh-CN",
+  "basics": {
+    "name": "示例候选人",
+    "title": "frontend",
+    "email": "candidate@example.com",
+    "phone": "138-0000-0000",
+    "location": "示例城市",
+    "summary": "本页为虚构排版样例，姓名、机构和经历均不代表真实候选人。"
+  },
+  "skills": [
+    {
+      "category": "工程实践",
+      "items": [
+        "Python",
+        "TypeScript",
+        "SQL"
+      ]
+    },
+    {
+      "category": "协作与交付",
+      "items": [
+        "需求分析",
+        "质量验证",
+        "技术文档"
+      ]
+    }
+  ],
+  "experience": [
+    {
+      "company": "示例科技公司（虚构）",
+      "role": "frontend",
+      "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/classic/style.css

@@ -1,48 +1,38 @@
+/**
+ * KnowMe CareerForge — Classic Structured Table Template Style
+ * Style Tone: Structured Corporate (Table Grid Matrix)
+ * Inherits: src/templates/common/base.css
+ */
+
 :root {
-  /* A4 绝对几何尺寸 */
-  --resume-page-width: 210mm;
-  --resume-page-min-height: 297mm;
+  /* === COMPONENT TOKENS (Overrides & Aliases) === */
   --resume-page-padding: 12mm 14mm;
 
-  /* 配色系统 */
-  --resume-color-primary: #0f172a;       /* Slate 900 */
-  --resume-color-secondary: #334155;     /* Slate 700 */
-  --resume-color-muted: #64748b;         /* Slate 500 */
-  --resume-color-accent: #1d4ed8;        /* Blue 700 */
-  --resume-color-border: #cbd5e1;        /* Slate 300 稳重边框 */
-  --resume-color-header-bg: #f8fafc;     /* Slate 50 */
-  --resume-color-label-bg: #f1f5f9;      /* Slate 100 */
-
-  /* 字阶系统 */
-  --resume-font-body: -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", sans-serif;
-  --resume-font-size-title: 18pt;
+  /* Color Bindings */
+  --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-blue-700);
+  --resume-color-border: var(--primitive-color-slate-300);
+  --resume-color-header-bg: var(--primitive-color-slate-50);
+  --resume-color-label-bg: var(--primitive-color-slate-100);
+
+  /* Typography Bindings */
+  --resume-font-body: var(--primitive-font-sans);
+  --resume-font-size-title: var(--primitive-font-size-title);
   --resume-font-size-body: 9pt;
-  --resume-font-size-meta: 8.5pt;
+  --resume-font-size-meta: var(--primitive-font-size-meta);
   --resume-line-height-body: 1.4;
 
-  /* 单元格内边距 */
+  /* Cell & Spacing Tokens (Calibratable for Self-Healing) */
   --resume-cell-padding: 4.5pt 7pt;
-}
-
-* { 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;
-  color: var(--resume-color-primary);
-  -webkit-font-smoothing: antialiased;
+  --resume-space-section: 6pt;
+  --resume-space-item: 4.5pt;
+  --resume-space-bullet: 2pt;
 }
 
 .resume-page {
-  width: var(--resume-page-width);
-  min-height: var(--resume-page-min-height);
-  background: #ffffff;
   padding: var(--resume-page-padding);
-  box-shadow: 0 10px 25px -5px rgba(0, 0, 0, 0.1), 0 8px 10px -6px rgba(0, 0, 0, 0.1);
-  box-sizing: border-box;
 }
 
 .resume-header {
@@ -91,8 +81,16 @@ body {
   color: var(--resume-color-primary);
 }
 
+.candidate-name {
+  font-weight: 700;
+  color: var(--resume-color-primary);
+}
+
+.job-target {
+  color: var(--resume-color-accent);
+}
 .cell-highlight-bg {
-  background-color: #eff6ff; /* Blue 50 */
+  background-color: var(--primitive-color-blue-50);
   color: var(--resume-color-accent);
 }
 
@@ -136,29 +134,12 @@ body {
   margin-left: 12pt;
   margin-top: 2pt;
 }
-
 .exp-bullets li {
-  margin-bottom: 2pt;
+  margin-bottom: var(--resume-space-bullet);
+  line-height: var(--resume-line-height-body);
 }
-
 .project-desc {
   font-size: 8.5pt;
   color: var(--resume-color-secondary);
   line-height: 1.38;
 }
-
-@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;
-  }
-}