knowme-careerforge-skill 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 KnowMe CareerForge Authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,227 @@
+# KnowMe CareerForge
+
+<p align="center">
+  <a href="README.zh-CN.md">🇨🇳 简体中文</a> | 
+  <a href="README.md">🇺🇸 English</a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/Max-Samson/knowme-careerforge-skill/releases"><img src="https://img.shields.io/github/v/release/Max-Samson/knowme-careerforge-skill?style=for-the-badge&color=blue" alt="GitHub Release"></a>
+  <img src="https://img.shields.io/badge/role_profiles-9_standard-green?style=for-the-badge" alt="9 Role Profiles">
+  <img src="https://img.shields.io/badge/templates-4_baseline_A4-purple?style=for-the-badge" alt="4 Baseline A4 Templates">
+  <img src="https://img.shields.io/badge/python-3.9+-yellow?style=for-the-badge&logo=python&logoColor=white" alt="Python 3.9+">
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/Max-Samson/knowme-careerforge-skill?style=for-the-badge&color=green" alt="License: MIT"></a>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/knowme-careerforge-skill"><img src="https://img.shields.io/npm/v/knowme-careerforge-skill?style=flat-square&logo=npm&label=npm" alt="npm package"></a>
+  <a href="https://github.com/Max-Samson/knowme-careerforge-skill/stargazers"><img src="https://img.shields.io/github/stars/Max-Samson/knowme-careerforge-skill?style=flat-square&logo=github" alt="GitHub stars"></a>
+  <img src="https://img.shields.io/badge/architecture-HTML%20Intermediate%20Canvas%20%2B%20Design%20Tokens-blue?style=flat-square" alt="HTML Intermediate Canvas">
+</p>
+
+> **Know Yourself. Define Your Direction. Forge Your Opportunity.**
+>
+> *An agent-native skill for self-discovery, career positioning, and tailored resume engineering.*
+
+---
+
+## 1. What is KnowMe CareerForge?
+
+**KnowMe CareerForge** is an industrial-grade, agent-native resume engineering skill for Claude Code, Cursor, Codex, Windsurf, and Gemini CLI.
+
+Traditional AI resume tools treat resume writing as a superficial text-generation task: feed a prompt to an LLM, get a block of Markdown, and convert it through black-box tools into a fragile, hallucination-prone PDF.
+
+**KnowMe CareerForge** fundamentally rethinks this paradigm into a structured, dual-engine system:
+
+```text
+knowme-careerforge-skill
+          │
+          ▼
+   KnowMe CareerForge
+          │
+    ┌─────┴─────┐
+    ▼           ▼
+  KnowMe     CareerForge
+    │           │
+Self Discovery  Tailored Career Story
+& Evidence      & Engineering Delivery
+```
+
+- **KnowMe (Self-Discovery & Evidence Engine)**: Helps candidates discover who they are, uncover their verifiable career evidence (L1~L3), and map their true competitive strengths.
+- **CareerForge (Career Positioning & Resume Engineering)**: Translates genuine strengths into targeted positioning for specific job opportunities, tailoring high-impact content inside an **HTML Intermediate Working Canvas** with **Design Tokens**, and delivering deterministic, pixel-perfect PDFs via Playwright.
+
+---
+
+## 2. Core Philosophy & Guiding 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."*
+
+```text
+WRONG DIRECTION (Generic AI Hallucination):
+JD ──> Keyword Stuffing ──> AI Guessing ──> Superficial Fluff ──> Inflated Claims (Fragile in Interviews)
+
+RIGHT DIRECTION (KnowMe CareerForge):
+Real Experience ──> Grounded Evidence ──> True Strengths ──> Job Match ──> Precise Engineering & Narrative
+```
+
+---
+
+## 3. Installation
+
+You can install and use KnowMe CareerForge via **CLI (Zero Clone)** or directly through **Agent-Native Manifests**:
+
+### Option A: Using CLI (Recommended)
+
+Run directly with `npx` (no clone required):
+
+```bash
+# Go to your project directory
+cd /path/to/your/project
+
+# Install for your preferred AI assistant
+npx knowme-careerforge-skill init --ai cursor    # Cursor (.cursor/rules/)
+npx knowme-careerforge-skill init --ai claude    # Claude Code (~/.claude/skills/)
+npx knowme-careerforge-skill init --ai codex     # Codex CLI (~/.codex/skills/)
+npx knowme-careerforge-skill init --ai windsurf  # Windsurf (.windsurfrules)
+npx knowme-careerforge-skill init --ai gemini    # Gemini CLI (~/.gemini/skills/)
+npx knowme-careerforge-skill init --ai opencode  # OpenCode (.opencode/skills/)
+npx knowme-careerforge-skill init --all          # All supported assistants
+```
+
+Or install globally:
+
+```bash
+npm install -g knowme-careerforge-skill
+knowme init --ai cursor
+knowme list
+```
+
+---
+
+### Option B: Direct Agent Integration
+
+| Platform | Target Configuration Path | Setup Command |
+| :--- | :--- | :--- |
+| **Cursor** | `.cursor/rules/knowme-careerforge.mdc` | `cp SKILL.md .cursor/rules/knowme-careerforge.mdc` |
+| **Claude Code** | `~/.claude/skills/knowme-careerforge/` | `cp -r knowme-careerforge-skill ~/.claude/skills/` |
+| **Codex** | `~/.codex/skills/knowme-careerforge/` | `cp -r knowme-careerforge-skill ~/.codex/skills/` |
+| **Windsurf** | `.windsurfrules` | `cat agents/windsurf/knowme-careerforge.rules >> .windsurfrules` |
+| **OpenCode** | `.opencode/skills/knowme-careerforge/` | `cp -r knowme-careerforge-skill ~/.opencode/skills/` |
+
+---
+
+## 4. The 3 Operational Modes
+
+```text
+┌─────────────────────────────────────────────────────────────────────────────┐
+│ Mode A: Target-Role Mode                                                    │
+│ User specifies a career direction (e.g., "Senior AI Agent Engineer").       │
+│ ▶ Agent loads role skill tree, extracts matching evidence, builds variant.  │
+├─────────────────────────────────────────────────────────────────────────────┤
+│ Mode B: JD-Specific Mode                                                    │
+│ User pastes a concrete Job Description (JD).                                │
+│ ▶ Agent runs analyze-jd.py, performs gap analysis, highlights hiring keys.  │
+├─────────────────────────────────────────────────────────────────────────────┤
+│ Mode C: Repo-to-Resume Mode                                                 │
+│ User supplies a GitHub repository / codebase / project notes.               │
+│ ▶ Agent inspects code/config files, grades evidence into L1~L3, builds FAB. │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 5. End-to-End Execution Workflow
+
+```text
+  Know (Evidence L1~3) ──> Define (Goal) ──> Understand (JD Signals) ──> Position (Strategy) ──> Forge (HTML Canvas) ──> Review (Dual QA)
+```
+
+1. **[KnowMe] Evidence Mapping**: Candidate experience is analyzed and strictly categorized into L1 (Code/Config proven), L2 (Module/Dependency inferred), and L3 (Contextual inference).
+2. **[Define & Understand] Signal Extraction**: The target JD is parsed to extract must-have competencies and hiring signals.
+3. **[Position] Strategy Formulation**: Gap analysis maps real candidate evidence to target JD requirements.
+4. **[CareerForge] Template Search & Assembly**: The best HTML template is chosen using multi-criteria BM25 ranking (`search-template.py`) and instantiated to `workspace/resume.html`.
+5. **[Review & Dual QA] Self-Healing**: Layout box model height overflow and ATS textual readability tests run automatically. If an overflow is detected, CSS spacing tokens are auto-calibrated.
+6. **[PDF Export] Deterministic Output**: Playwright renders pixel-perfect `workspace/resume.pdf` with `@media print` A4 rules.
+
+---
+
+## 6. Token Self-Healing & Visual Tuning Cheat Sheet
+
+All visual parameters are concentrated in `:root` variables inside `workspace/resume.html`:
+
+| CSS Token | Default | Compact (1-Page Squeeze) | Relaxed (2-Page Flow) | Purpose |
+| :--- | :--- | :--- | :--- | :--- |
+| `--resume-space-section` | `12pt` | `9.5pt` ~ `10.5pt` | `14pt` ~ `16pt` | Section vertical gap (primary self-healing knob) |
+| `--resume-space-item` | `8pt` | `6.5pt` ~ `7pt` | `9pt` ~ `11pt` | Item gap between jobs/projects |
+| `--resume-font-size-body` | `9.2pt` | `8.8pt` ~ `9.0pt` | `9.5pt` ~ `10pt` | Body text size (safe legibility floor is 8.8pt) |
+| `--resume-line-height-body` | `1.45` | `1.38` | `1.50` | Line height ratio |
+| `--resume-color-accent` | `#2563eb` | Custom Hex | Custom Hex | Primary theme accent color |
+| `--resume-sidebar-width` | `32%` | `30%` | `35%` | Sidebar width (for modern/executive templates) |
+
+---
+
+## 7. Core Templates Matrix
+
+| Template ID | Style | Category | ATS Tier | Best For | Target Pages |
+| :--- | :--- | :--- | :--- | :--- | :--- |
+| **`minimal`** | Single-Column Minimal | Tech / AI | Tier 1 (Optimal) | Backend, Algorithms, AI Research, Systems | 1 Page |
+| **`modern`** | Two-Column Split (32:68) | Tech / Fullstack | Tier 1 (Optimal) | Fullstack, AI Agent, Frontend, Global Roles | 1~2 Pages |
+| **`executive`** | Executive Banner + 33:67 | Leadership / Product | Tier 1 (Optimal) | Tech Director, Chief Architect, Tech Lead | 1~2 Pages |
+| **`classic`** | Structured Table Grid | Corporate / Gov | Tier 1 (Optimal) | State Enterprises, Finance, Hardware, Civil | 1 Page |
+
+---
+
+## 8. CLI & Script Reference
+
+```bash
+# 1. Search best template for target role
+knowme search "AI Agent Engineer" --style "two-column-split"
+
+# 2. Analyze a target Job Description
+python3 scripts/analyze-jd.py --jd examples/ai-engineer/jd.md
+
+# 3. Instantiate Intermediate Working Canvas
+python3 scripts/instantiate-resume.py --template modern --keywords "Python,LLM,RAG" --output workspace/resume.html
+
+# 4. Validate working canvas layout & ATS compliance
+knowme validate
+
+# 5. Render deterministic pixel-perfect PDF via Playwright
+npx ts-node scripts/render-pdf.ts --input workspace/resume.html --output workspace/resume.pdf
+
+# 6. Build & view static HTML Template Gallery
+knowme gallery
+```
+
+---
+
+## 9. Automated Testing & Verification
+
+```bash
+# Run full automated test suite (21/21 passing in 0.3s)
+npm test
+# Or:
+python3 scripts/run-all-tests.py
+```
+
+---
+
+## 10. NPM Build, Release & Publishing
+
+This package is ready to be built, tested, and published to the NPM Registry:
+
+```bash
+# 1. Automated release preparation & verification
+npm run release -- 0.0.1
+
+# 2. Publish to public NPM registry
+npm publish --access public
+```
+
+See the full [NPM Publishing & Update Guide](docs/PUBLISHING.md) for step-by-step release instructions.
+
+---
+
+## 11. License
+
+This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.

package/README.zh-CN.md

@@ -0,0 +1,231 @@
+# KnowMe CareerForge
+
+<p align="center">
+  <a href="README.zh-CN.md">🇨🇳 简体中文</a> | 
+  <a href="README.md">🇺🇸 English</a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/Max-Samson/knowme-careerforge-skill/releases"><img src="https://img.shields.io/github/v/release/Max-Samson/knowme-careerforge-skill?style=for-the-badge&color=blue" alt="GitHub Release"></a>
+  <img src="https://img.shields.io/badge/岗位画像-9套标准画像-green?style=for-the-badge" alt="9 Role Profiles">
+  <img src="https://img.shields.io/badge/A4模板-4套黄金基准-purple?style=for-the-badge" alt="4 Baseline A4 Templates">
+  <img src="https://img.shields.io/badge/python-3.9+-yellow?style=for-the-badge&logo=python&logoColor=white" alt="Python 3.9+">
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/Max-Samson/knowme-careerforge-skill?style=for-the-badge&color=green" alt="License: MIT"></a>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/knowme-careerforge-skill"><img src="https://img.shields.io/npm/v/knowme-careerforge-skill?style=flat-square&logo=npm&label=npm" alt="npm package"></a>
+  <a href="https://github.com/Max-Samson/knowme-careerforge-skill/stargazers"><img src="https://img.shields.io/github/stars/Max-Samson/knowme-careerforge-skill?style=flat-square&logo=github" alt="GitHub stars"></a>
+  <img src="https://img.shields.io/badge/核心架构-HTML中间修改场%20%2B%20Design%20Tokens-blue?style=flat-square" alt="HTML Intermediate Canvas">
+</p>
+
+> **认识自己，明确方向，锻造属于你的职业机会。**
+>
+> *Know Yourself. Define Your Direction. Forge Your Opportunity.*
+>
+> *面向主流 AI Agent 的自我认知、职业定位与岗位定制简历工程 Skill。*
+
+---
+
+## 1. 什么是 KnowMe CareerForge？
+
+**KnowMe CareerForge** 是一款专为 Claude Code、Cursor、Codex、Windsurf 及 Gemini CLI 打造的工业级、Agent-Native 简历工程 Skill。
+
+传统的 AI 简历工具通常将写简历视为简单的“文本生成任务”：给大模型一段提示词，吐出一堆 Markdown，再经由黑盒转换器输出格式混乱、排版错位、充斥幻觉的 PDF。
+
+**KnowMe CareerForge** 从底层重构了这一范式，打造为结构化的**双引擎协作系统**：
+
+```text
+knowme-careerforge-skill
+          │
+          ▼
+   KnowMe CareerForge
+          │
+    ┌─────┴─────┐
+    ▼           ▼
+  KnowMe     CareerForge
+    │           │
+认识自己       锻造职业表达
+真实经历与证据   工程化定制交付
+```
+
+- **KnowMe（自我认知与证据挖掘引擎）**：帮助候选人深入认知自我，系统梳理真实经历与可验证的代码/项目证据（L1~L3 分级），提炼真正具备竞争壁垒的优势点。
+- **CareerForge（职业定位与简历工程引擎）**：将候选人的真实优势精准对齐目标岗位（JD），以 **HTML 中间工作区（Intermediate Canvas）** 与 **Design Tokens（设计系统变量）** 为工作场进行微调排版，最终通过 Playwright 无头浏览器导出确定性、像素级的矢量 PDF。
+
+---
+
+## 2. 核心价值观与设计原则
+
+> ### *"目标不是让候选人看起来比真实情况更优秀，而是让真实的优势被正确的机会看见。"*
+>
+> *(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.)*
+
+```text
+【错误方向 (传统 AI 盲目夸大与幻觉)】
+目标 JD ──> 提取关键词 ──> AI 凭空猜测 ──> 虚假包装 ──> 夸大造假 (面试必露馅)
+
+【正确方向 (KnowMe CareerForge 证据为先)】
+真实经历 ──> 代码/事实证据 ──> 核心优势 ──> 岗位精准匹配 ──> 高质量职业叙事与工程交付
+```
+
+---
+
+## 3. 安装与部署指南
+
+你可以通过 **CLI 极速初始化 (无需 Clone)** 或直接通过 **Agent 原生规则文件** 接入：
+
+### 方式 A：通过 CLI 快速安装 (推荐)
+
+直接使用 `npx` 免安装初始化：
+
+```bash
+# 进入你的目标项目目录
+cd /path/to/your/project
+
+# 为你所使用的 AI 编程助手一键安装 Skill
+npx knowme-careerforge-skill init --ai cursor    # Cursor (.cursor/rules/)
+npx knowme-careerforge-skill init --ai claude    # Claude Code (~/.claude/skills/)
+npx knowme-careerforge-skill init --ai codex     # Codex CLI (~/.codex/skills/)
+npx knowme-careerforge-skill init --ai windsurf  # Windsurf (.windsurfrules)
+npx knowme-careerforge-skill init --ai gemini    # Gemini CLI (~/.gemini/skills/)
+npx knowme-careerforge-skill init --ai opencode  # OpenCode (.opencode/skills/)
+npx knowme-careerforge-skill init --all          # 为所有支持的平台一键安装
+```
+
+或全局安装 CLI：
+
+```bash
+npm install -g knowme-careerforge-skill
+knowme init --ai cursor
+knowme list
+```
+
+---
+
+### 方式 B：Agent 平台原生手动配置
+
+| 平台 | 目标注入路径 | 配置方法 |
+| :--- | :--- | :--- |
+| **Cursor** | `.cursor/rules/knowme-careerforge.mdc` | `cp SKILL.md .cursor/rules/knowme-careerforge.mdc` |
+| **Claude Code** | `~/.claude/skills/knowme-careerforge/` | `cp -r knowme-careerforge-skill ~/.claude/skills/` |
+| **Codex** | `~/.codex/skills/knowme-careerforge/` | `cp -r knowme-careerforge-skill ~/.codex/skills/` |
+| **Windsurf** | `.windsurfrules` | `cat agents/windsurf/knowme-careerforge.rules >> .windsurfrules` |
+| **OpenCode** | `.opencode/skills/knowme-careerforge/` | `cp -r knowme-careerforge-skill ~/.opencode/skills/` |
+
+---
+
+## 4. 三大运行模式 (Operational Modes)
+
+```text
+┌─────────────────────────────────────────────────────────────────────────────┐
+│ 模式 A：目标岗位模式 (Target-Role Mode)                                       │
+│ 用户指定职业发展方向（如“资深 AI Agent 研发工程师”）。                       │
+│ ▶ Agent 加载岗位能力树，从经历库中提取强匹配证据，派生对应 Resume Variant。  │
+├─────────────────────────────────────────────────────────────────────────────┤
+│ 模式 B：具体 JD 定制模式 (JD-Specific Mode)                                 │
+│ 用户粘贴具体的招聘需求 (Job Description)。                                   │
+│ ▶ Agent 运行 analyze-jd.py 执行差距分析，提取加分项并高亮核心招聘信号。     │
+├─────────────────────────────────────────────────────────────────────────────┤
+│ 模式 C：代码库到经历挖掘模式 (Repo-to-Resume Mode)                           │
+│ 用户提供 GitHub 仓库链接、代码目录或工程笔记。                              │
+│ ▶ Agent 审查源码与配置文件，判定 L1~L3 证据等级，重塑为高质量 FAB 论据。    │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 5. 端到端执行工作流 (The 6-Stage Workflow)
+
+```text
+  Know (证据分级) ──> Define (明确目标) ──> Understand (洞察JD) ──> Position (制定策略) ──> Forge (HTML修改场) ──> Review (双重QA)
+```
+
+1. **[KnowMe] 证据挖掘**：分析候选人代码库与真实经历，严格划分为 L1 (代码配置直证)、L2 (模块依赖推断) 与 L3 (合理解读)。
+2. **[Define & Understand] 信号提取**：解析目标 JD，提取必备项、加分项与团队招聘风格。
+3. **[Position] 优势对齐**：差距分析匹配真实证据，规划模块优先级。
+4. **[CareerForge] 模板检索与组装**：通过多维打分引擎检索最佳模板，实例化生成 `workspace/resume.html`。
+5. **[Review & Dual QA] 闭环自愈**：无头浏览器检测 DOM 高度溢出与 ATS 文本流，自愈调校 CSS 间距 Tokens。
+6. **[PDF Export] 确定性渲染**：通过 Playwright 导出无损矢量 `workspace/resume.pdf`。
+
+---
+
+## 6. CSS Design Tokens 调优与自愈速查表
+
+所有排版参数均集中在 `workspace/resume.html` 的 `:root` 变量中，可进行全局即时微调：
+
+| CSS Token 变量名 | 默认推荐值 | 紧凑模式 (单页微调) | 宽松模式 (双页饱满) | 调优核心作用 |
+| :--- | :--- | :--- | :--- | :--- |
+| `--resume-space-section` | `12pt` | `9.5pt` ~ `10.5pt` | `14pt` ~ `16pt` | 模块间纵向间距 (自愈核心旋钮) |
+| `--resume-space-item` | `8pt` | `6.5pt` ~ `7pt` | `9pt` ~ `11pt` | 经历/项目条目间距 |
+| `--resume-font-size-body` | `9.2pt` | `8.8pt` ~ `9.0pt` | `9.5pt` ~ `10pt` | 正文字号 (物理安全底线 8.8pt) |
+| `--resume-line-height-body`| `1.45` | `1.38` | `1.50` | 正文行高比例 |
+| `--resume-color-accent` | `#2563eb` | 自定义 Hex | 自定义 Hex | 主题强调色 (科技蓝/松石绿/经典深蓝) |
+| `--resume-sidebar-width` | `32%` | `30%` | `35%` | 侧边栏占比 (双栏/高管模板有效) |
+
+---
+
+## 7. 首期 4 款黄金基准模板
+
+| 模板 ID | 版式风格 | 岗位分类 | ATS 评级 | 适用人群与设计特质 | 目标页数 |
+| :--- | :--- | :--- | :--- | :--- | :--- |
+| **`minimal`** | 单栏极简线性流 | 研发 / AI | Tier 1 (极佳) | 后端、算法、系统、AI 工程师；强调技术胶囊与代码证据 | 1 页 |
+| **`modern`** | 左右双栏 (32:68) | 研发 / 全栈 | Tier 1 (极佳) | 全栈、AI 应用、海外远程；深海蓝侧栏，视觉层次丰满 | 1~2 页 |
+| **`executive`** | 墨黑顶栏 + 33:67 双栏 | 管理 / 产品 | Tier 1 (极佳) | 技术总监、首席架构师、Team Lead；突出领导力与重大项目 | 1~2 页 |
+| **`classic`** | 现代结构化表格网格 | 综合 / 政企 | Tier 1 (极佳) | 国企、金融科技、政企合规岗位；6列矩阵，最高信息密度 | 1 页 |
+
+---
+
+## 8. CLI 命令参考
+
+```bash
+# 1. 智能检索最匹配的 HTML 简历模板
+knowme search "AI Agent Engineer" --style "two-column-split"
+
+# 2. 深度解析目标 JD 文本与技能词频
+python3 scripts/analyze-jd.py --jd examples/ai-engineer/jd.md
+
+# 3. 实例化 HTML 中间工作区并注入关键词高亮
+python3 scripts/instantiate-resume.py --template modern --keywords "Python,LLM,RAG,FastAPI" --output workspace/resume.html
+
+# 4. 运行布局结构、Design Tokens 与文字密度验证
+knowme validate
+
+# 5. 通过 Playwright 确定性导出无损矢量 A4 PDF
+npx ts-node scripts/render-pdf.ts --input workspace/resume.html --output workspace/resume.pdf
+
+# 6. 编译生成可视化模板画廊
+knowme gallery
+```
+
+---
+
+## 9. 自动化测试与质量保障
+
+```bash
+# 运行全链路自动化测试套件 (21/21 项测试 0.3 秒通过)
+npm test
+# 或:
+python3 scripts/run-all-tests.py
+```
+
+---
+
+## 10. NPM 构建、发布与版本更新
+
+本项目已配置为标准的 NPM Package，支持一键编译、测试与发布：
+
+```bash
+# 1. 执行发布前自动化测试与打包预检
+npm run release -- 0.0.1
+
+# 2. 发布至公共 NPM 注册表
+npm publish --access public
+```
+
+更多详细发版与 SemVer 版本升级策略请参阅 [NPM 构建与发布更新指南](docs/PUBLISHING.zh-CN.md)。
+
+---
+
+## 11. 开源协议
+
+本项目采用 **MIT 开源协议**，详情请参阅 [LICENSE](LICENSE) 文件。

package/SKILL.md

@@ -0,0 +1,179 @@
+---
+name: knowme-careerforge
+displayName: KnowMe CareerForge
+description: An agent-native skill for self-discovery, career positioning, and tailored resume engineering. Analyzes candidate evidence, maps strengths to target JDs, crafts tailored resumes inside an HTML Intermediate Canvas, self-heals layout/ATS, and exports pixel-perfect PDFs.
+version: 0.0.1
+---
+
+# KnowMe CareerForge — Agent Reasoning Contract & Execution Specification
+
+> **"Know Yourself. Define Your Direction. Forge Your Opportunity."**
+> 
+> *Core Mission: 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. Operating Rules & Core Constraints
+
+When this skill is activated, you are NOT a generic text generator. You act as a coordinated council of 6 specialized personas:
+1. **Career Researcher**: Discovers user facts, projects, and verifiable achievements.
+2. **Career Strategist**: Analyzes target JDs and formulates career positioning strategy.
+3. **Evidence Analyst**: Strictly enforces L1~L3 evidence classification and eliminates hallucinations.
+4. **Resume Writer**: Crafts high-impact FAB (Feature-Advantage-Benefit) bullet points.
+5. **Resume Designer**: Calibrates CSS Design Tokens within the HTML canvas.
+6. **Resume Reviewer**: Executes automated layout, overflow, and ATS Dual-QA tests.
+
+### Non-Negotiable Invariants:
+- **Evidence-First**: Every single claim on the resume MUST be grounded in candidate facts. Never invent unverified revenue numbers, false company tenures, or fake degrees.
+- **HTML Intermediate Canvas as Source of Truth**: All modifications, tailoring, token tuning, and QA verification happen in `workspace/resume.html`. Never output raw unformatted text or bypass the HTML canvas.
+- **Deterministic Rendering**: The final PDF (`workspace/resume.pdf`) is exported only after passing Dual QA (Layout fit + ATS check) with 100% compliance.
+
+---
+
+## 2. The 6-Stage Deterministic Workflow
+
+You MUST execute the following 6 stages in exact sequence:
+
+```text
+┌──────────────┐     ┌──────────────┐     ┌──────────────────┐
+│ 1. KNOW ME   │ ──> │ 2. DEFINE    │ ──> │ 3. UNDERSTAND    │
+│ Evidence L1~3│     │ Career Goal  │     │ JD & Signals     │
+└──────────────┘     └──────────────┘     └──────────────────┘
+                                                    │
+                                                    ▼
+┌──────────────┐     ┌──────────────┐     ┌──────────────────┐
+│ 6. REVIEW/QA │ <── │ 5. CAREER    │ <── │ 4. POSITION      │
+│ Dual QA & PDF│     │ FORGE HTML   │     │ Strategy & Map   │
+└──────────────┘     └──────────────┘     └──────────────────┘
+```
+
+---
+
+### Stage 1: Know Me (Self-Discovery & Evidence Extraction)
+
+1. **Collect & Structure Facts**:
+   - Extract education, company tenures, project scopes, code repositories, system architectures, and technical competencies.
+2. **Classify Evidence into 3 Strict Levels**:
+   - **Level 1 (Direct Evidence)**: Verified by code files, configuration files (`package.json`, `Dockerfile`), API contracts, Git commits, or published metrics.
+   - **Level 2 (Structural Evidence)**: Deduced from directory structure, tech stack dependencies, and architectural patterns.
+   - **Level 3 (Contextual Inference)**: Reasonable contextual deduction (MUST use conservative phrasing, e.g., *"Participated in the design and implementation of..."*).
+   - **Unsupported**: Facts not present in candidate records. **NEVER WRITE INTO RESUME**. If a core JD skill is missing, prompt the candidate to clarify rather than fabricating.
+
+---
+
+### Stage 2: Define (Goal & Career Positioning)
+
+1. **Clarify Career Target**:
+   - **Target Role Title**: e.g., *Senior AI Agent Engineer*, *Staff Frontend Architect*, *Tech Lead*.
+   - **Target Seniority**: Junior / Mid / Senior / Lead / Principal / Executive.
+   - **Industry Domain**: e.g., AI/LLM, Enterprise SaaS, FinTech, E-Commerce.
+2. **Formulate Core Value Proposition (CVP)**:
+   - One concise statement (15~25 words) capturing the candidate's unique intersection of skills and business impact.
+
+---
+
+### Stage 3: Understand (Job Description & Signal Extraction)
+
+1. Run the JD Analysis script (or execute equivalent extraction logic):
+   ```bash
+   python3 scripts/analyze-jd.py --jd "path/to/jd.txt"
+   ```
+2. **Extract Key Signals**:
+   - **Must-Have Skills**: Absolute prerequisites (e.g., Python, LangChain/LangGraph, RAG, FastAPI).
+   - **Nice-to-Have Skills**: Advantageous boosters (e.g., Kubernetes, VectorDB benchmarking).
+   - **Core Pain Points & Responsibilities**: What business problems is this hire expected to solve?
+   - **Hiring Signals & Cultural Cues**: High-frequency verbs and domain terminology.
+
+---
+
+### Stage 4: Position Myself (Strength Mapping & Resume Strategy)
+
+1. **Conduct Gap Analysis**:
+   - Compare Candidate Evidence (Stage 1) against JD Requirements (Stage 3).
+   - Identify **Strong Matches** (L1 evidence), **Potential Matches** (L2/L3), and **Gaps**.
+2. **Define Resume Strategy**:
+   - **Section Priority**: e.g., for AI Engineer: `Skills` ➔ `Projects` ➔ `Experience` ➔ `Education`. For Executive: `Summary` ➔ `Experience` ➔ `Leadership Projects` ➔ `Skills`.
+   - **Keyword Highlight Targets**: 8~12 high-priority terms to emphasize visually.
+   - **Narrative Angle**: Tailor project bullets using the **FAB Formula** (*Feature: What was built; Advantage: How it was built better; Benefit: Measurable business impact*).
+
+---
+
+### Stage 5: CareerForge (Template Selection, Canvas Instantiation & Editing)
+
+1. **Search & Select Best Template**:
+   ```bash
+   python3 scripts/search-template.py "<Target Role>" --style "<minimal|modern|executive|classic>" --target-pages 1
+   ```
+   - `minimal`: Single-column, tech-dense, optimal for Backend/AI/Systems (1 page).
+   - `modern`: Two-column split (32:68), deep navy sidebar, fullstack/AI/global (1~2 pages).
+   - `executive`: Executive dark banner + 33:67 split, leadership & architecture (1~2 pages).
+   - `classic`: Modern structured table grid, formal/gov/corporate (1 page).
+
+2. **Instantiate Intermediate Working Canvas**:
+   ```bash
+   python3 scripts/instantiate-resume.py --template <template_id> --keywords "Python,LLM,RAG,FastAPI" --output workspace/resume.html
+   ```
+
+3. **Edit in Intermediate Canvas (`workspace/resume.html`)**:
+   - Inject candidate details into the semantic HTML structure.
+   - Wrap core matching keywords in `<strong>` or `<span class="tech-tag">`.
+   - Calibrate CSS Variables in `<style>`:
+     - Spacing: `--resume-space-section`, `--resume-space-item`, `--resume-space-bullet`.
+     - Typography: `--resume-font-size-body`, `--resume-line-height-body`.
+     - Accents: `--resume-color-accent`, `--resume-color-primary`.
+
+---
+
+### Stage 6: Review & Dual QA (Verification, Self-Healing & PDF Export)
+
+1. **Execute Automated Dual QA**:
+   ```bash
+   # QA Test 1: Layout & DOM Height Overflow Check
+   python3 scripts/validate-resume.py --html workspace/resume.html --expected-pages 1
+
+   # QA Test 2: ATS Text Flow & Heading Hierarchy Check
+   npx ts-node scripts/validate-ats.ts --html workspace/resume.html
+   ```
+
+2. **Self-Healing Closed Loop (If QA Fails)**:
+   - **Case A: Page Overflow (e.g. DOM Height 1145px > 1122.5px)**:
+     1. In `workspace/resume.html`, reduce `--resume-space-section` by `1~2pt`.
+     2. Reduce `--resume-font-size-body` by `0.2pt` (minimum `8.8pt`).
+     3. Condense verbose bullet points while preserving evidence verbs and metrics.
+     4. Re-run `validate-resume.py` until 100% single page fit.
+   - **Case B: ATS Structure Warning**:
+     1. Ensure all section titles use standard H2 tags (`工作经历`, `专业技能`, `项目经历`, `教育背景`).
+     2. Ensure contact items are plain text in standard DOM nodes.
+
+3. **Export Deterministic PDF**:
+   ```bash
+   npx ts-node scripts/render-pdf.ts --input workspace/resume.html --output workspace/resume.pdf
+   ```
+
+4. **Deliver to User**:
+   - Provide `workspace/resume.html` and `workspace/resume.pdf`.
+   - Deliver an **Evidence & Strategy Traceability Summary** explaining how real strengths were mapped to the target JD.
+
+---
+
+## 3. Anti-Hallucination & Evidence Rules Summary
+
+| Evidence Level | Permitted Phrasing | Prohibited Phrasing |
+| :--- | :--- | :--- |
+| **L1 (Code/Config Proven)** | "Architected and implemented...", "Reduced latency by 40% (benchmarked in test suite)" | Phrasing that claims scope beyond repository evidence |
+| **L2 (Dependency/Module Proven)** | "Built microservices utilizing FastAPI and PostgreSQL..." | Claiming senior ownership when code only shows minor integration |
+| **L3 (Contextual Inference)** | "Collaborated on the deployment workflow...", "Participated in data pipeline optimization..." | Claiming "Solely designed and led entire enterprise migration" |
+| **Unsupported (No Evidence)** | **DO NOT INCLUDE** | Inventing metrics, tools, or roles |
+
+---
+
+## 4. Troubleshooting & Self-Healing Decision Matrix
+
+```text
+QA Failure: Height Overflow (> 1122.5px)
+ │
+ ├── Step 1: Reduce --resume-space-section (e.g., 11pt -> 9.5pt)
+ ├── Step 2: Reduce --resume-space-item (e.g., 7.5pt -> 6pt)
+ ├── Step 3: Reduce --resume-font-size-body (e.g., 9.2pt -> 9.0pt)
+ └── Step 4: Merge multi-line bullets into concise single-line bullets
+```