knowme-careerforge-skill 0.0.1

package/dist/scripts/validate-ats.js

@@ -0,0 +1,169 @@
+#!/usr/bin/env ts-node
+"use strict";
+/**
+ * KnowMe CareerForge — ATS Text Flow & Heading Hierarchy Inspector
+ * 验证 HTML 简历中的关键文本可提取性、标头层级规范与 ATS 机器解析友好度。
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateAts = validateAts;
+const playwright_1 = require("playwright");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const STANDARD_SECTION_HEADERS = [
+    '工作经历', '工作经验', 'work experience', 'experience',
+    '项目经历', '核心项目', 'projects', 'key projects',
+    '专业技能', '核心技能', 'skills', 'technical skills',
+    '教育背景', '教育经历', 'education',
+    '核心领导力', '重大经历', '资质与证书', '求职意向'
+];
+async function validateAts(htmlPath) {
+    const absoluteHtml = path.resolve(htmlPath);
+    if (!fs.existsSync(absoluteHtml)) {
+        throw new Error(`HTML file not found: ${absoluteHtml}`);
+    }
+    const browser = await playwright_1.chromium.launch({ headless: true });
+    const page = await browser.newPage();
+    await page.goto(`file://${absoluteHtml}`, { waitUntil: 'networkidle' });
+    const rawData = await page.evaluate(() => {
+        const nameEl = document.querySelector('.candidate-name, h1');
+        const name = nameEl ? (nameEl.textContent || '').trim() : null;
+        const fullText = (document.body.innerText || '').trim();
+        // 提取电话与邮箱
+        const phoneMatch = fullText.match(/(?:(?:\+|00)86)?1[3-9]\d{9}|(?:1[3-9]\d-\d{4}-\d{4})/);
+        const emailMatch = fullText.match(/[a-zA-Z0-9_.+-]+@[a-zA-Z0-9-]+\.[a-zA-Z0-9-.]+/);
+        const headings = Array.from(document.querySelectorAll('h1, h2, h3, .section-title, .sub-title')).map(h => ({
+            level: h.tagName.toLowerCase(),
+            text: (h.textContent || '').trim()
+        }));
+        return {
+            candidateName: name,
+            phone: phoneMatch ? phoneMatch[0] : null,
+            email: emailMatch ? emailMatch[0] : null,
+            headings,
+            fullTextLength: fullText.length
+        };
+    });
+    await browser.close();
+    const warnings = [];
+    const errors = [];
+    if (!rawData.candidateName) {
+        errors.push('Candidate name (.candidate-name or h1) could not be extracted');
+    }
+    if (!rawData.email) {
+        warnings.push('No valid email address pattern detected in text flow');
+    }
+    if (!rawData.phone) {
+        warnings.push('No standard mobile phone pattern detected in text flow');
+    }
+    const validatedHeadings = rawData.headings.map(h => {
+        const textClean = h.text.toLowerCase().replace(/[^\w\u4e00-\u9fa5]/g, '');
+        const isStd = STANDARD_SECTION_HEADERS.some(s => textClean.includes(s.toLowerCase().replace(/\s+/g, '')));
+        return {
+            level: h.level,
+            text: h.text,
+            isStandard: isStd
+        };
+    });
+    const nonStdHeadings = validatedHeadings.filter(h => !h.isStandard && h.level === 'h2');
+    if (nonStdHeadings.length > 0) {
+        warnings.push(`Non-standard section headings detected: ${nonStdHeadings.map(h => `"${h.text}"`).join(', ')}`);
+    }
+    const status = errors.length > 0 ? 'FAIL' : warnings.length > 0 ? 'WARN' : 'PASS';
+    return {
+        status,
+        candidateName: rawData.candidateName,
+        detectedContacts: {
+            phone: rawData.phone,
+            email: rawData.email
+        },
+        headingsFound: validatedHeadings,
+        totalTextLength: rawData.fullTextLength,
+        warnings,
+        errors
+    };
+}
+async function main() {
+    const args = process.argv.slice(2);
+    let htmlPath = 'workspace/resume.html';
+    let jsonOutput = false;
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--html' || args[i] === '-i') {
+            htmlPath = args[i + 1];
+            i++;
+        }
+        else if (args[i] === '--json') {
+            jsonOutput = true;
+        }
+    }
+    try {
+        const result = await validateAts(htmlPath);
+        if (jsonOutput) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log('======================================================');
+        console.log(`  KnowMe CareerForge — ATS Compliance QA: [${result.status}]`);
+        console.log(`  Candidate Name : ${result.candidateName || 'N/A'}`);
+        console.log(`  Phone Extracted: ${result.detectedContacts.phone || 'None'}`);
+        console.log(`  Email Extracted: ${result.detectedContacts.email || 'None'}`);
+        console.log(`  Text Extracted : ${result.totalTextLength} characters`);
+        console.log('------------------------------------------------------');
+        console.log('  Headings Structure:');
+        for (const h of result.headingsFound) {
+            const tag = h.isStandard ? '✓' : '?';
+            console.log(`    [${tag}] <${h.level}> ${h.text}`);
+        }
+        if (result.errors.length > 0) {
+            console.log('\n[!] Errors:');
+            for (const e of result.errors)
+                console.log(`  - ✗ ${e}`);
+        }
+        if (result.warnings.length > 0) {
+            console.log('\n[?] Warnings:');
+            for (const w of result.warnings)
+                console.log(`  - ⚠️ ${w}`);
+        }
+        console.log('======================================================');
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`[✗] ATS Validation Failed: ${msg}`);
+        process.exit(1);
+    }
+}
+if (require.main === module) {
+    main();
+}

package/dist/scripts/validate-layout.d.ts

@@ -0,0 +1,24 @@
+#!/usr/bin/env ts-node
+/**
+ * KnowMe CareerForge — Playwright DOM Layout & Overflow Inspector
+ * 基于无头浏览器真实渲染计算 DOM 盒模型高度，检测单页/双页物理 A4 溢出与孤行。
+ */
+interface LayoutValidationResult {
+    status: 'PASS' | 'OVERFLOW';
+    expectedPages: number;
+    totalPagesFound: number;
+    pageDetails: Array<{
+        pageIndex: number;
+        measuredHeightPx: number;
+        allowedHeightPx: number;
+        overflowPx: number;
+        isOverflow: boolean;
+    }>;
+    overflowSections: Array<{
+        selector: string;
+        heightPx: number;
+        textPreview: string;
+    }>;
+}
+export declare function validateLayout(htmlPath: string, expectedPages?: number): Promise<LayoutValidationResult>;
+export {};

package/dist/scripts/validate-layout.js

@@ -0,0 +1,161 @@
+#!/usr/bin/env ts-node
+"use strict";
+/**
+ * KnowMe CareerForge — Playwright DOM Layout & Overflow Inspector
+ * 基于无头浏览器真实渲染计算 DOM 盒模型高度，检测单页/双页物理 A4 溢出与孤行。
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateLayout = validateLayout;
+const playwright_1 = require("playwright");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+async function validateLayout(htmlPath, expectedPages = 1) {
+    const absoluteHtml = path.resolve(htmlPath);
+    if (!fs.existsSync(absoluteHtml)) {
+        throw new Error(`HTML file not found: ${absoluteHtml}`);
+    }
+    const browser = await playwright_1.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(`file://${absoluteHtml}`, { waitUntil: 'networkidle' });
+    await page.evaluateHandle('document.fonts.ready');
+    // A4 标准高度 (297mm in pixels at 96 DPI ~= 1122.5px)
+    const A4_HEIGHT_PX = 1122.5;
+    const evaluation = await page.evaluate((allowedHeight) => {
+        const pages = Array.from(document.querySelectorAll('.resume-page'));
+        const details = pages.map((el, index) => {
+            const rect = el.getBoundingClientRect();
+            const scrollH = el.scrollHeight;
+            const actualH = Math.max(rect.height, scrollH);
+            const diff = actualH - allowedHeight;
+            return {
+                pageIndex: index + 1,
+                measuredHeightPx: Math.round(actualH * 10) / 10,
+                allowedHeightPx: allowedHeight,
+                overflowPx: diff > 2 ? Math.round(diff * 10) / 10 : 0,
+                isOverflow: diff > 2
+            };
+        });
+        const overflows = [];
+        if (details.some(d => d.isOverflow)) {
+            const sections = Array.from(document.querySelectorAll('.resume-section, .timeline-item, .milestone-item, .experience-item, tr'));
+            for (const s of sections) {
+                const r = s.getBoundingClientRect();
+                if (r.bottom > allowedHeight) {
+                    overflows.push({
+                        selector: s.className || s.tagName.toLowerCase(),
+                        heightPx: Math.round(r.height),
+                        textPreview: (s.textContent || '').trim().slice(0, 60)
+                    });
+                }
+            }
+        }
+        return {
+            totalPagesFound: pages.length,
+            pageDetails: details,
+            overflowSections: overflows
+        };
+    }, A4_HEIGHT_PX);
+    await browser.close();
+    const hasOverflow = evaluation.pageDetails.some(p => p.isOverflow) || evaluation.totalPagesFound > expectedPages;
+    return {
+        status: hasOverflow ? 'OVERFLOW' : 'PASS',
+        expectedPages,
+        totalPagesFound: evaluation.totalPagesFound,
+        pageDetails: evaluation.pageDetails,
+        overflowSections: evaluation.overflowSections
+    };
+}
+async function main() {
+    const args = process.argv.slice(2);
+    let htmlPath = 'workspace/resume.html';
+    let expectedPages = 1;
+    let jsonOutput = false;
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--html' || args[i] === '-i') {
+            htmlPath = args[i + 1];
+            i++;
+        }
+        else if (args[i] === '--expected-pages' || args[i] === '-p') {
+            expectedPages = parseInt(args[i + 1], 10) || 1;
+            i++;
+        }
+        else if (args[i] === '--json') {
+            jsonOutput = true;
+        }
+    }
+    try {
+        const result = await validateLayout(htmlPath, expectedPages);
+        if (jsonOutput) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log('======================================================');
+        console.log(`  KnowMe CareerForge — Layout QA: ${result.status}`);
+        console.log(`  HTML Path      : ${htmlPath}`);
+        console.log(`  Expected Pages : ${result.expectedPages} | Pages Found: ${result.totalPagesFound}`);
+        console.log('------------------------------------------------------');
+        for (const p of result.pageDetails) {
+            const statusSymbol = p.isOverflow ? '✗ OVERFLOW' : '✓ FIT';
+            console.log(`  Page ${p.pageIndex}: ${p.measuredHeightPx}px / ${p.allowedHeightPx}px [${statusSymbol}] (Overflow: ${p.overflowPx}px)`);
+        }
+        if (result.overflowSections.length > 0) {
+            console.log('\n[!] Nodes exceeding A4 physical boundary:');
+            for (const o of result.overflowSections) {
+                console.log(`  - <${o.selector}> (${o.heightPx}px): "${o.textPreview}..."`);
+            }
+            console.log('\n[Self-Healing Guidance]:');
+            console.log('  1. Reduce --resume-space-section by 1~2pt in workspace/resume.html <style>');
+            console.log('  2. Reduce --resume-font-size-body by 0.2pt');
+            console.log('  3. Condense verbose bullet points');
+        }
+        console.log('======================================================');
+        if (result.status === 'OVERFLOW') {
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`[✗] Layout Validation Failed: ${msg}`);
+        process.exit(1);
+    }
+}
+if (require.main === module) {
+    main();
+}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "knowme-careerforge-skill",
+  "version": "0.0.1",
+  "description": "An agent-native skill for self-discovery, career positioning, and tailored resume engineering.",
+  "main": "dist/cli/src/index.js",
+  "bin": {
+    "knowme": "bin/knowme.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "src",
+    "scripts",
+    "agents",
+    "SKILL.md",
+    "skill.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "python3 scripts/run-all-tests.py",
+    "search": "python3 scripts/search-template.py",
+    "analyze:jd": "python3 scripts/analyze-jd.py",
+    "instantiate": "python3 scripts/instantiate-resume.py",
+    "validate:layout": "ts-node scripts/validate-layout.ts",
+    "validate:ats": "ts-node scripts/validate-ats.ts",
+    "render:pdf": "ts-node scripts/render-pdf.ts",
+    "build:knowledge": "python3 scripts/build-knowledge.py",
+    "build:gallery": "python3 scripts/build-gallery.py",
+    "release": "python3 scripts/release.py",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "career-forge",
+    "know-me",
+    "resume-engineering",
+    "agent-skill",
+    "ai-resume",
+    "design-tokens",
+    "playwright-pdf",
+    "ats-friendly"
+  ],
+  "author": "Miles <https://github.com/Max-Samson>",
+  "license": "MIT",
+  "homepage": "https://github.com/Max-Samson/knowme-careerforge-skill",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Max-Samson/knowme-careerforge-skill.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Max-Samson/knowme-careerforge-skill/issues"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "playwright": "^1.49.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  }
+}

package/scripts/analyze-jd.py

@@ -0,0 +1,108 @@
+#!/usr/bin/env python3
+"""
+KnowMe CareerForge — JD Analyzer & Hiring Signal Extractor
+结构化解析招聘 JD 文本，提取岗位分类、职级、必备技能、加分项与核心业务关键词。
+"""
+
+import sys, os, json, argparse, re
+from pathlib import Path
+
+COMMON_TECH_STACKS = [
+    "Python", "TypeScript", "JavaScript", "Java", "Go", "Golang", "C++", "Rust",
+    "React", "Vue", "Next.js", "Node.js", "FastAPI", "Spring Boot", "NestJS",
+    "LLM", "RAG", "LangGraph", "LangChain", "LlamaIndex", "VectorDB", "Qdrant",
+    "Milvus", "Pinecone", "Prompt Engineering", "Prompt", "Fine-tuning", "Evaluation",
+    "PostgreSQL", "MySQL", "Redis", "Kafka", "RocketMQ", "Elasticsearch",
+    "Docker", "Kubernetes", "K8s", "CI/CD", "AWS", "Aliyun", "Linux"
+]
+
+def analyze_jd_text(jd_text: str) -> dict:
+    text_lower = jd_text.lower()
+    
+    # 1. 识别岗位与职级
+    seniority = "mid"
+    if any(k in jd_text for k in ["资深", "专家", "架构师", "总监", "Lead", "Senior", "Principal"]):
+        seniority = "senior/lead"
+    elif any(k in jd_text for k in ["初级", "实习", "应届", "Junior"]):
+        seniority = "junior"
+
+    category = "engineering-ai"
+    if any(k in jd_text for k in ["产品经理", "Product Manager", "总监", "Director", "业务负责人"]):
+        category = "management-product"
+
+    # 2. 匹配技术栈与关键词
+    detected_skills = []
+    for skill in COMMON_TECH_STACKS:
+        pattern = re.compile(rf'(?:^|[^\w]){re.escape(skill)}(?:[^\w]|$)', re.IGNORECASE)
+        if pattern.search(jd_text):
+            detected_skills.append(skill)
+
+    # 3. 区分必备与加分
+    must_haves = detected_skills[:6] if len(detected_skills) >= 6 else detected_skills
+    nice_to_haves = detected_skills[6:] if len(detected_skills) > 6 else []
+
+    # 4. 业务痛点与职责关键词提取
+    responsibilities = []
+    for line in jd_text.splitlines():
+        line_clean = line.strip()
+        if len(line_clean) > 6 and any(verb in line_clean for verb in ["负责", "主导", "推进", "设计", "参与", "优化", "统筹", "熟练", "精通"]):
+            responsibilities.append(line_clean)
+
+    return {
+        "status": "success",
+        "category": category,
+        "estimatedSeniority": seniority,
+        "mustHaveSkills": must_haves,
+        "niceToHaveSkills": nice_to_haves,
+        "detectedSkills": detected_skills,
+        "keyResponsibilities": responsibilities[:6],
+        "hiringSignals": [
+            "强调工程化与系统高并发稳定性" if "稳定" in jd_text or "高并发" in jd_text else "强调快速交付与 0-1 探索",
+            "大模型与 AI Agent 场景深度落地" if "大模型" in jd_text or "rag" in text_lower or "agent" in text_lower else "传统业务系统演进"
+        ]
+    }
+
+def main():
+    parser = argparse.ArgumentParser(description="KnowMe CareerForge — JD Analyzer")
+    parser.add_argument("--jd", "-j", help="Path to JD text file")
+    parser.add_argument("--text", "-t", help="Raw JD text string")
+    parser.add_argument("--json", action="store_true", help="Output only clean JSON")
+
+    args = parser.parse_args()
+
+    content = ""
+    if args.jd and Path(args.jd).exists():
+        content = Path(args.jd).read_text(encoding="utf-8")
+    elif args.text:
+        content = args.text
+
+    if not content.strip():
+        # 默认样例
+        content = """职位：资深 AI Agent 研发工程师
+岗位职责：
+1. 负责企业级多 Agent 智能协同工作流平台的设计与核心研发；
+2. 主导基于 RAG 的专业知识库检索管线优化与模型微调；
+3. 持续优化 Prompt 与上下文窗口，压榨模型推理延迟与 Token 成本。
+任职要求：
+1. 本科及以上学历，精通 Python、FastAPI 及多线程异步编程；
+2. 熟练掌握 LangGraph、LangChain、LlamaIndex 等 Agent 开发框架；
+3. 深入理解向量数据库（Qdrant / Milvus）原理，具备高并发高可用调优经验；
+4. 熟悉 Docker、Kubernetes 云原生技术栈者优先。"""
+
+    result = analyze_jd_text(content)
+
+    if args.json:
+        print(json.dumps(result, ensure_ascii=False, indent=2))
+        return
+
+    print("=" * 70)
+    print("  KnowMe CareerForge — JD Analysis Result")
+    print(f"  Category            : {result['category']}")
+    print(f"  Seniority Level     : {result['estimatedSeniority']}")
+    print(f"  Must-Have Skills    : {', '.join(result['mustHaveSkills'])}")
+    print(f"  Nice-To-Have Skills : {', '.join(result['niceToHaveSkills'])}")
+    print(f"  Hiring Signals      : {', '.join(result['hiringSignals'])}")
+    print("=" * 70)
+
+if __name__ == "__main__":
+    main()