jobscout 1.4.1 → 1.5.2

package/README.md

@@ -6,7 +6,7 @@ Thu thập job thật từ ITviec, TopCV, VietnamWorks, LinkedIn… qua web sear
 (skills · seniority · domain · compensation · location · culture), xuất báo cáo fit/gap chi tiết
 với link apply cho từng job.
 
-**Chạy được trên Claude Code, Codex CLI và ChatGPT** — cùng một logic, một lệnh cài đặt.
+**Chạy được trên Claude Code và Codex CLI** — cùng một logic, một lệnh cài đặt.
 
 ## Cài đặt
 
@@ -14,12 +14,12 @@ với link apply cho từng job.
 npx jobscout setup
 ```
 
-Tự phát hiện nền tảng và setup. Hoặc chỉ định:
+Hiện menu chọn nền tảng (Claude Code / Codex / All) ngay trên terminal — dùng ↑/↓ di chuyển,
+`space` chọn, `enter` xác nhận. Cài xong sẽ hiển thị hướng dẫn bước tiếp theo. Hoặc chỉ định thẳng:
 
 ```bash
 npx jobscout setup claude    # Claude Code
 npx jobscout setup codex     # Codex CLI
-npx jobscout setup chatgpt   # ChatGPT (Custom GPT)
 npx jobscout setup all       # Tất cả
 ```
 
@@ -40,16 +40,6 @@ codex --search
 # Gọi skill find-jobs với đường dẫn CV
 ```
 
-### ChatGPT
-
-CLI tạo thư mục `job-matching-chatgpt/` chứa sẵn mọi thứ:
-
-1. Vào [chatgpt.com/gpts/editor](https://chatgpt.com/gpts/editor) → **Create**
-2. **Instructions**: dán nội dung `job-matching-chatgpt/GPT-INSTRUCTIONS.md`
-3. **Knowledge**: kéo-thả tất cả file trong `job-matching-chatgpt/knowledge/`
-4. Bật **Web Search** → Save → Publish
-5. Mở GPT, dán CV là chạy
-
 ## Pipeline
 
 ```
@@ -105,9 +95,6 @@ JSON schema trong `job-matching-plugin/schemas/`:
 │   ├── schemas/*.json              Data contracts
 │   ├── agents/*.md                 Subagent definitions
 │   └── commands/find-jobs.md       Slash command /find-jobs
-├── chatgpt/                      ← adapter ChatGPT
-│   ├── GPT-INSTRUCTIONS.md         Orchestrator cho Custom GPT
-│   └── knowledge/                   Skills + schemas flatten sẵn
 └── package.json
 ```
 

package/bin/cli.mjs

@@ -3,12 +3,13 @@
 import { existsSync, mkdirSync, cpSync, readFileSync, writeFileSync } from "node:fs";
 import { resolve, join, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
+import { emitKeypressEvents } from "node:readline";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const PKG_ROOT = resolve(__dirname, "..");
 const PLUGIN_SRC = join(PKG_ROOT, "job-matching-plugin");
-const CHATGPT_SRC = join(PKG_ROOT, "chatgpt");
 const CWD = process.cwd();
+const REPO_URL = "https://github.com/hieutrong512/JobMatching";
 
 const RESET = "\x1b[0m";
 const GREEN = "\x1b[32m";
@@ -32,16 +33,15 @@ ${BOLD}Usage:${RESET}
   npx jobscout ${CYAN}<command>${RESET}
 
 ${BOLD}Commands:${RESET}
-  ${CYAN}setup${RESET}           Auto-detect platform & install (recommended)
-  ${CYAN}setup claude${RESET}    Setup for Claude Code
-  ${CYAN}setup codex${RESET}     Setup for Codex CLI
-  ${CYAN}setup chatgpt${RESET}   Setup for ChatGPT (copy files to configure Custom GPT)
-  ${CYAN}setup all${RESET}       Setup for all platforms
+  ${CYAN}setup${RESET}           Chọn nền tảng (menu) rồi cài đặt
+  ${CYAN}setup claude${RESET}    Cài cho Claude Code
+  ${CYAN}setup codex${RESET}     Cài cho Codex CLI
+  ${CYAN}setup all${RESET}       Cài cho tất cả nền tảng
 
 ${BOLD}Examples:${RESET}
-  ${DIM}npx jobscout setup          ${RESET}# auto-detect
-  ${DIM}npx jobscout setup claude    ${RESET}# Claude Code only
-  ${DIM}npx jobscout setup chatgpt   ${RESET}# ChatGPT only
+  ${DIM}npx jobscout setup          ${RESET}# hiện menu chọn Claude Code / Codex
+  ${DIM}npx jobscout setup claude    ${RESET}# chỉ Claude Code
+  ${DIM}npx jobscout setup all       ${RESET}# tất cả
 `;
 
 function copyDir(src, dest) {
@@ -73,6 +73,103 @@ function detectPlatforms() {
   return platforms;
 }
 
+// ─────────────────────────────────────────────────────────────────────────────
+// Interactive multi-select (zero-dep). Trả về mảng platform ("claude"/"codex").
+// ─────────────────────────────────────────────────────────────────────────────
+function selectPlatforms(defaults = []) {
+  const items = [
+    { value: "claude", label: "Claude Code", checked: defaults.includes("claude") },
+    { value: "codex", label: "Codex", checked: defaults.includes("codex") }
+  ];
+
+  return new Promise((res) => {
+    // Không phải TTY (CI, pipe) → không hỏi, dùng defaults hoặc cả hai.
+    if (!process.stdin.isTTY) {
+      const picked = items.filter((i) => i.checked).map((i) => i.value);
+      res(picked.length ? picked : ["claude", "codex"]);
+      return;
+    }
+
+    let cursor = 0;
+    let rendered = 0;
+
+    const allChecked = () => items.every((i) => i.checked);
+    const anyChecked = () => items.some((i) => i.checked);
+
+    function render() {
+      // Xóa các dòng đã vẽ lần trước.
+      if (rendered > 0) process.stdout.write(`\x1b[${rendered}A`);
+      const lines = [];
+      lines.push(`${CYAN}◆${RESET}  ${BOLD}Cài JobScout cho nền tảng nào?${RESET}`);
+      lines.push(`${DIM}│${RESET}  ${DIM}↑/↓ di chuyển · space chọn · a chọn tất cả · enter xác nhận${RESET}`);
+      items.forEach((item, i) => {
+        const box = item.checked ? `${GREEN}[+]${RESET}` : "[ ]";
+        const pointer = i === cursor ? `${CYAN}❯${RESET}` : " ";
+        const label = i === cursor ? `${BOLD}${item.label}${RESET}` : item.label;
+        lines.push(`${DIM}│${RESET}  ${pointer} ${box} ${label}`);
+      });
+      const allBox = allChecked() ? `${GREEN}[+]${RESET}` : "[ ]";
+      const allPointer = cursor === items.length ? `${CYAN}❯${RESET}` : " ";
+      const allLabel = cursor === items.length ? `${BOLD}All${RESET}` : "All";
+      lines.push(`${DIM}│${RESET}  ${allPointer} ${allBox} ${allLabel}`);
+      lines.push(`${DIM}└${RESET}`);
+      // Xóa cuối mỗi dòng để không sót ký tự cũ.
+      process.stdout.write(lines.map((l) => `\x1b[2K${l}`).join("\n") + "\n");
+      rendered = lines.length;
+    }
+
+    function cleanup() {
+      process.stdin.setRawMode(false);
+      process.stdin.pause();
+      process.stdin.removeListener("keypress", onKey);
+      process.stdout.write("\x1b[?25h"); // hiện lại con trỏ
+    }
+
+    function toggleCurrent() {
+      if (cursor === items.length) {
+        // Dòng "All": bật/tắt tất cả.
+        const next = !allChecked();
+        items.forEach((i) => (i.checked = next));
+      } else {
+        items[cursor].checked = !items[cursor].checked;
+      }
+    }
+
+    function onKey(str, key) {
+      if (!key) return;
+      if (key.name === "up") {
+        cursor = (cursor - 1 + (items.length + 1)) % (items.length + 1);
+      } else if (key.name === "down") {
+        cursor = (cursor + 1) % (items.length + 1);
+      } else if (key.name === "space") {
+        toggleCurrent();
+      } else if (str === "a" || str === "A") {
+        const next = !allChecked();
+        items.forEach((i) => (i.checked = next));
+      } else if (key.name === "return") {
+        if (!anyChecked()) return; // cần chọn ít nhất một
+        cleanup();
+        log("");
+        res(items.filter((i) => i.checked).map((i) => i.value));
+        return;
+      } else if (key.name === "escape" || (key.ctrl && key.name === "c")) {
+        cleanup();
+        log("");
+        warn("Đã hủy.");
+        process.exit(0);
+      }
+      render();
+    }
+
+    emitKeypressEvents(process.stdin);
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdout.write("\x1b[?25l"); // ẩn con trỏ
+    render();
+    process.stdin.on("keypress", onKey);
+  });
+}
+
 // Skills cần cho Claude — bỏ find-jobs/job-collector/job-matcher (command + agents đã lo).
 const CLAUDE_SKILLS = [
   "candidate-intake",
@@ -124,10 +221,11 @@ function setupClaude() {
   });
   ok(`Copy .claude/skills/ (${CLAUDE_SKILLS.length} skills)`);
 
-  log("");
-  info("Xong! Trong Claude Code (thư mục này) chạy luôn:");
-  log(`   ${CYAN}/find-jobs path/to/CV.pdf${RESET}`);
-  log(`   ${DIM}Không cần /plugin install — Claude Code tự nhận .claude/${RESET}`);
+  return {
+    label: "Claude Code",
+    detail: `${CLAUDE_SKILLS.length} skills + 2 agents → .claude/`,
+    steps: [`Trong Claude Code chạy: ${CYAN}/find-jobs path/to/CV.pdf${RESET}`]
+  };
 }
 
 // Codex chỉ auto-discover skills trong skills/ — nên flatten mọi thứ (kể cả
@@ -162,78 +260,91 @@ function setupCodex() {
   });
   ok(`Copy .agents/skills/ (${CODEX_SKILLS.length} skills)`);
 
-  log("");
-  info("Xong! Chạy Codex trong thư mục này:");
-  log(`   ${CYAN}codex --search${RESET}  ${DIM}# bật web search${RESET}`);
-  log(`   Gọi skill ${CYAN}find-jobs${RESET} với đường dẫn CV.`);
+  return {
+    label: "Codex CLI",
+    detail: `${CODEX_SKILLS.length} skills → .agents/`,
+    steps: [
+      `Chạy: ${CYAN}codex --search${RESET}  ${DIM}# bật web search${RESET}`,
+      `Gọi skill ${CYAN}find-jobs${RESET} với đường dẫn CV`
+    ]
+  };
 }
 
-function setupChatgpt() {
-  heading("ChatGPT");
-
-  const dest = join(CWD, "job-matching-chatgpt");
-  ensureDir(dest);
+// ─────────────────────────────────────────────────────────────────────────────
+// Hộp "ready to use" — hướng dẫn bước tiếp theo sau khi cài xong.
+// ─────────────────────────────────────────────────────────────────────────────
+const ANSI_RE = /\x1b\[[0-9;]*m/g;
+function visibleLen(s) { return s.replace(ANSI_RE, "").length; }
 
-  const instrSrc = join(CHATGPT_SRC, "GPT-INSTRUCTIONS.md");
-  const instrDest = join(dest, "GPT-INSTRUCTIONS.md");
-  cpSync(instrSrc, instrDest);
-  ok("Copy GPT-INSTRUCTIONS.md");
-
-  const knowledgeSrc = join(CHATGPT_SRC, "knowledge");
-  if (existsSync(knowledgeSrc)) {
-    const knowledgeDest = join(dest, "knowledge");
-    copyDir(knowledgeSrc, knowledgeDest);
-    ok("Copy knowledge/ (skills + schemas)");
-  }
+function printReadyBox(results) {
+  const lines = [];
+  results.forEach((r) => {
+    lines.push(`${GREEN}✓${RESET}  ${BOLD}${r.label}${RESET}  ${DIM}${r.detail}${RESET}`);
+  });
+  lines.push("");
+  lines.push(`${DIM}Installed to:${RESET} ${CWD}`);
+  lines.push("");
+  lines.push(`${BOLD}Bước tiếp theo:${RESET}`);
+  lines.push(`  1. Mở project ở folder này bằng AI agent của bạn`);
+  let n = 2;
+  results.forEach((r) => {
+    r.steps.forEach((s) => {
+      lines.push(`  ${n}. ${s}`);
+      n += 1;
+    });
+  });
+  lines.push("");
+  lines.push(`${DIM}Repo: ${REPO_URL}${RESET}`);
 
+  const inner = Math.max(...lines.map(visibleLen), visibleLen("JobScout đã sẵn sàng!")) + 2;
+  const top = `┌─ ${BOLD}${GREEN}JobScout đã sẵn sàng!${RESET} ${"─".repeat(Math.max(0, inner - visibleLen("JobScout đã sẵn sàng!") - 3))}┐`;
   log("");
-  info("Tạo Custom GPT:");
-  log(`   1. Vào ${CYAN}chatgpt.com/gpts/editor${RESET} → Create`);
-  log(`   2. Instructions: dán nội dung ${CYAN}${instrDest}${RESET}`);
-  log(`   3. Knowledge: kéo-thả tất cả file trong ${CYAN}${join(dest, "knowledge")}${RESET}`);
-  log(`   4. Bật ${CYAN}Web Search${RESET} → Save → Publish`);
+  log(top);
+  log(`│${" ".repeat(inner)}│`);
+  lines.forEach((l) => {
+    const pad = inner - 1 - visibleLen(l);
+    log(`│ ${l}${" ".repeat(Math.max(0, pad))}│`);
+  });
+  log(`│${" ".repeat(inner)}│`);
+  log(`└${"─".repeat(inner)}┘`);
 }
 
-function runSetup(platform) {
+function runPlatforms(platforms) {
+  const results = [];
+  platforms.forEach((p) => {
+    if (p === "claude") results.push(setupClaude());
+    if (p === "codex") results.push(setupCodex());
+  });
+  printReadyBox(results);
+}
+
+async function runSetup(platform) {
   log(`${BOLD}🔧 JobScout Setup${RESET}`);
 
-  if (!platform) {
-    const detected = detectPlatforms();
-    if (detected.length > 0) {
-      info(`Phát hiện: ${detected.join(", ")}`);
-      detected.forEach((p) => {
-        if (p === "claude") setupClaude();
-        if (p === "codex") setupCodex();
-      });
-    } else {
-      info("Không phát hiện Claude Code / Codex. Setup cho tất cả nền tảng.");
-      setupClaude();
-      setupCodex();
-      setupChatgpt();
-    }
-  } else if (platform === "claude") {
-    setupClaude();
-  } else if (platform === "codex") {
-    setupCodex();
-  } else if (platform === "chatgpt") {
-    setupChatgpt();
-  } else if (platform === "all") {
-    setupClaude();
-    setupCodex();
-    setupChatgpt();
-  } else {
-    warn(`Platform "${platform}" không hợp lệ. Dùng: claude, codex, chatgpt, all`);
+  if (platform === "all") {
+    runPlatforms(["claude", "codex"]);
+    return;
+  }
+  if (platform === "claude" || platform === "codex") {
+    runPlatforms([platform]);
+    return;
+  }
+  if (platform) {
+    warn(`Platform "${platform}" không hợp lệ. Dùng: claude, codex, all`);
     process.exit(1);
   }
 
-  heading("Xong!");
-  log(`Repo: ${DIM}https://github.com/hieutrong512/JobMatching${RESET}`);
+  // Không chỉ định platform → hỏi qua menu (mặc định gợi ý theo nền tảng phát hiện được).
+  const detected = detectPlatforms();
+  if (detected.length) info(`Phát hiện sẵn: ${detected.join(", ")}`);
+  const picked = await selectPlatforms(detected);
+  runPlatforms(picked);
 }
 
 if (!command || command === "help" || command === "--help" || command === "-h") {
   log(HELP);
 } else if (command === "setup") {
-  runSetup(process.argv[3]);
+  await runSetup(process.argv[3]);
 } else {
   warn(`Lệnh "${command}" không tồn tại.`);
   log(HELP);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jobscout",
-  "version": "1.4.1",
-  "description": "AI job matching — tìm và xếp hạng việc làm phù hợp CV, song ngữ Việt–Anh. Chạy trên Claude Code, Codex CLI và ChatGPT.",
+  "version": "1.5.2",
+  "description": "AI job matching — tìm và xếp hạng việc làm phù hợp CV, song ngữ Việt–Anh. Chạy trên Claude Code và Codex CLI.",
   "bin": {
     "jobscout": "bin/cli.mjs"
   },
@@ -14,7 +14,6 @@
     "recruitment",
     "claude",
     "codex",
-    "chatgpt",
     "ai-agents",
     "vietnam"
   ],
@@ -25,7 +24,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/hieutrong512/JobMatching.git"
+    "url": "git+https://github.com/hieutrong512/JobScout.git"
   },
   "files": [
     "bin/",
@@ -37,8 +36,7 @@
     "job-matching-plugin/commands/",
     "job-matching-plugin/docs/",
     "job-matching-plugin/AGENTS.md",
-    "job-matching-plugin/README.md",
-    "chatgpt/"
+    "job-matching-plugin/README.md"
   ],
   "engines": {
     "node": ">=18"

package/chatgpt/GPT-INSTRUCTIONS.md

@@ -1,103 +0,0 @@
-# JobMatching — hướng dẫn cho ChatGPT (Custom GPT / Project)
-
-Bạn là **JobMatching**, trợ lý tìm và xếp hạng việc làm phù hợp nhất với **target** và **CV**
-của ứng viên, song ngữ Việt–Anh. Bạn thu thập job qua **web browsing** (Search) — không cần API key.
-
-> Dán toàn bộ file này vào ô **Instructions** của một Custom GPT (bật **Web Search**), hoặc dùng làm
-> chỉ dẫn cho một ChatGPT Project. Nếu có upload các file knowledge (`*.md` skill + `*.schema.json`),
-> hãy ưu tiên đọc chúng để lấy chi tiết; nếu không có, làm theo bản rút gọn dưới đây là đủ.
-
-## Môi trường ChatGPT
-
-- **Web**: dùng công cụ browsing/Search sẵn có để tìm và mở JD. Không bịa job hay URL.
-- **File**: ChatGPT không có ổ đĩa lâu dài. Giữ dữ liệu trung gian (profile/jobs/shortlist) **dạng JSON
-  ngay trong hội thoại** (khối ```json). Nếu bật Code Interpreter, có thể ghi file tạm để tải về, nhưng
-  không bắt buộc.
-- Không tự nộp hồ sơ / gửi email / gửi tin nhắn thay người dùng.
-
-## Pipeline (chạy tuần tự trong 1 hội thoại)
-
-```
-CV + Target → [1] Intake → profile(JSON)
-            → [2] Collect → jobs(JSON, tối đa 20)
-            → [3] Match → shortlist(JSON đã xếp hạng)
-            → [4] Fit report (Markdown)
-            → [5] (tùy chọn) Application assistant
-```
-
-### [1] Intake — tạo `profile`
-- Nhận CV (dán text, hoặc upload PDF/DOCX → trích text). Trích: thông tin cá nhân tối thiểu, skills,
-  kinh nghiệm (title/công ty/thời gian/highlights), học vấn, ngôn ngữ. Suy `total_years` + `seniority`.
-- Hỏi target **gộp 1 lần** (bỏ qua phần người dùng đã nêu): (1) vai trò + cấp bậc; (2) địa điểm + remote;
-  (3) lương min & target (VND/USD, tháng/năm); (4) ngành + quy mô công ty; (5) dealbreakers;
-  (6) **ưu tiên** → chuyển thành trọng số `priorities` (tổng ~1) cho bước chấm điểm.
-- Chuẩn hóa skills/chức danh về **canonical EN** (xem "Chuẩn hóa" bên dưới). Tóm tắt cho user xác nhận.
-
-### [2] Collect — tạo `jobs`
-- Sinh query song ngữ từ role/seniority/location/skills. Tìm trên job boards chính thống
-  (ITviec, TopCV, VietnamWorks, LinkedIn, CareerViet…).
-- **Chỉ giữ job đọc được full JD và còn hạn.** Bỏ: snippet rời rạc, hết hạn, 404–410. Mục tiêu ≤ 20 job.
-- Khử trùng theo URL chuẩn hóa (bỏ query tracking). Mỗi job đặt `extraction_confidence` (0–1) trung thực:
-  0.8–1.0 nếu đọc được full JD; ≤0.4 nếu chỉ có snippet.
-- **`url` luôn là link gốc để bấm apply.** Nếu JD có contact (email/phone/Zalo/form) → ghi lại.
-
-### [3] Match — tạo `shortlist`
-Chấm từng job theo rubric, xếp giảm dần, để `excluded` cuối.
-
-**Trọng số mặc định** (chuẩn hóa để tổng = 1; nếu user có `priorities` thì dùng nó, cũng chuẩn hóa):
-skills 0.35 · seniority 0.20 · domain 0.15 · compensation 0.15 · location 0.05 · culture 0.05
-
-**Hard filter trước:** vi phạm dealbreaker (có đủ bằng chứng) → `recommendation="excluded"`, `overall=0`.
-Thiếu dữ liệu để khẳng định vi phạm → KHÔNG loại, chỉ hạ `confidence`.
-
-**Điểm mỗi chiều 0–100:**
-- **skills** = `100*(0.75*must_cover + 0.25*nice_cover)`; +≤10 nếu có skill advanced/expert cho must-have chính (cap 100). Ghi `matched_skills`, `missing_must_have`.
-- **seniority**: khoảng cách bậc (intern<junior<mid<senior<lead<manager<director) 0→100, 1→75, 2→45, ≥3→15. Overqualified cũng bị trừ. `total_years < min_years` → nhân 0.6.
-- **domain**: trùng ngành 100; ngành liền kề 60; không liên quan 30.
-- **location**: remote khớp / đúng địa điểm 100; hybrid cùng thành phố 85; onsite khác TP mà user để "any" 60; ngoài vùng (chưa tới dealbreaker) 25.
-- **compensation**: quy về VND/tháng để so ($1 = 26.100 VND, year→month chia 12). `job_mid ≥ target` → 100; trong [min,target] nội suy 70–100; ≥90% min → 50; thấp hơn → 20. **Lương unknown → 60 neutral (KHÔNG chấm 0)**, hạ confidence.
-- **culture**: khớp `company_size` +baseline; tín hiệu tốt trong JD cộng thêm; ít dữ liệu → 60.
-
-**Tổng hợp:** `overall = Σ(dimension_score[d] * normalized_weight[d])`. Map:
-≥80 strong · 65–79 good · 50–64 maybe · <50 weak · (dealbreaker) excluded.
-**Không bao giờ chấm 0 vì "thiếu thông tin"** — dùng neutral 55–60 và hạ `confidence`.
-Luôn ghi `weights_used`, `rationale` (1–2 lý do mạnh + 1 gap lớn nhất), `confidence`.
-
-### [4] Fit report (Markdown) — GỬI CHO USER
-- **Bảng xếp hạng đầu**: rank | title | company | score | recommendation | lương | location | **link nộp CV** (markdown link, mọi job đều có link bấm được).
-- **Phân tích chi tiết TẤT CẢ job** (nếu >20 thì chi tiết 20 job cao nhất, còn lại vẫn đủ trong bảng). **KHÔNG rút gọn còn top 3.** Mỗi job:
-  1. Header: `#N. Title @ Company` — score, recommendation, **link apply**, lương, location/remote, hạn nộp, contact (nếu có).
-  2. **Vì sao hợp** (2–3 gạch đầu dòng).
-  3. **Khoảng cách** (missing_must_have + gaps, kèm severity; nói rõ "học nhanh được" vs "cần thời gian").
-  4. **Rủi ro / cần xác minh** (confidence thấp → đọc kỹ JD gốc; over/underqualified; lương unknown).
-  5. **Hành động đề xuất**.
-- Cuối: nhận xét thị trường, gap lặp lại (skill nên học), có nên nới target không.
-
-### [5] Application assistant (tùy chọn)
-Khi user chọn job để apply: tailor CV bullets khớp `must_have_skills` (dùng canonical name cho ATS,
-định lượng thành tích, **không bịa**); viết cover letter (~250–350 từ) hoặc tin nhắn tiếp cận HR mẫu.
-Nêu rõ đây là bản nháp để user tự chỉnh. **Không tự gửi thay user.**
-
-## Chuẩn hóa Việt–Anh (dùng xuyên suốt)
-
-- **Skills → canonical EN**: `ReactJS`/`React.js` → `React`; `NodeJS` → `Node.js`; `K8s` → `Kubernetes`; `.NET`/`dotnet` → `.NET`. Giữ biến thể trong `aliases`.
-- **Chức danh VN → EN**: "Lập trình viên"/"Kỹ sư phần mềm" → Software Engineer; "Trưởng nhóm" → Lead; "Kiểm thử"/"QC" → QA; "Khoa học dữ liệu" → Data Science.
-- **Cấp bậc VN**: Fresher→junior, "Chuyên viên"→mid, "Senior"→senior, "Team Lead"→lead, "Trưởng phòng"→manager, "Giám đốc"→director.
-- **Địa điểm**: "TP.HCM"/"Sài Gòn"/"HCMC" → Ho Chi Minh City; "HN"/"Hà Nội" → Hanoi; "ĐN"/"Đà Nẵng" → Da Nang.
-- **Lương — giữ nguyên gốc**: "15 triệu"/"15tr"/"15M" → 15.000.000 VND; "$1500"/"1500 USD" → USD; "Up to $2000" → max 2000 USD; "Thỏa thuận"/"Negotiable" → không set số, `negotiable=true`, currency=unknown. **Chỉ quy đổi khi so sánh**, không ghi đè giá trị gốc.
-
-## Cấu trúc JSON (rút gọn)
-
-**profile**: `{candidate{name,headline,location,languages[]}, skills[{name,aliases[],years,level,evidence}], experience[{title,company,start,end,domain,highlights[]}], education[], total_years, seniority, domains[], target{desired_roles[],desired_level,locations[],remote_preference,salary{min,target,currency,period},industries[],company_size[],dealbreakers[],priorities{skills,seniority,domain,location,compensation,culture}}}`
-
-**job**: `{id,title,company,location,remote,url,source,posted_date,application_deadline,employment_type,language,description,contact{email,phone,zalo,form_url,how_to_apply},requirements{must_have_skills[],nice_to_have_skills[],min_years,seniority,education},salary{min,max,currency,period,negotiable},industry,company_size,collected_at,extraction_confidence}`
-
-**match**: `{job_id,overall_score,recommendation,dimension_scores{skills,seniority,domain,location,compensation,culture},weights_used{},matched_skills[],missing_must_have[],gaps[{area,detail,severity}],dealbreaker_violations[],rationale,confidence}`
-
-## Nguyên tắc (bắt buộc)
-
-- **Không bịa** trường job/CV. Thiếu → `unknown` + hạ `confidence` (không chấm 0 mù quáng).
-- Tôn trọng robots.txt/ToS; **không vượt anti-bot/CAPTCHA**.
-- Giữ **đơn vị lương gốc**; chỉ quy đổi khi so sánh.
-- Trung thực: match yếu thì nói thẳng, không thổi phồng khả năng trúng tuyển.
-- **Không tự nộp hồ sơ / gửi email / tin nhắn** thay người dùng.

package/chatgpt/README.md

@@ -1,72 +0,0 @@
-# JobMatching cho ChatGPT
-
-Cùng một logic pipeline + rubric chấm điểm như Claude Code / Codex, chạy bằng **web browsing**
-sẵn có của ChatGPT — không cần cài plugin hay API key.
-
-## Cách cài (Custom GPT — khuyên dùng)
-
-1. [Tải repo về](https://github.com/hieutrong512/JobMatching/archive/refs/heads/main.zip) và giải nén.
-2. Vào [chatgpt.com/gpts/editor](https://chatgpt.com/gpts/editor) → **Create** → tab **Configure**:
-   - **Name**: `JobMatching`
-   - **Description**: "Tìm & xếp hạng việc làm phù hợp CV, song ngữ Việt–Anh"
-   - **Instructions**: mở [`GPT-INSTRUCTIONS.md`](GPT-INSTRUCTIONS.md), copy toàn bộ nội dung dán vào
-   - **Knowledge**: kéo-thả **tất cả** file trong thư mục [`knowledge/`](knowledge/) vào
-   - **Capabilities**: bật **Web Search** (bắt buộc). Bật **Code Interpreter** nếu muốn tải báo cáo (tùy chọn)
-3. **Save** → **Publish** ("Anyone with a link" để chia sẻ, hoặc "Only me" để dùng riêng)
-4. Mở GPT, dán CV vào là chạy.
-
-## Cách khác
-
-### ChatGPT Project
-
-1. Tạo **Project** mới → dán [`GPT-INSTRUCTIONS.md`](GPT-INSTRUCTIONS.md) vào Instructions.
-2. Kéo các file trong [`knowledge/`](knowledge/) vào **Files** của Project.
-3. Bắt đầu chat, dán CV.
-
-### Chat thường (nhanh, 1 lần)
-
-Dán prompt này rồi dán CV ngay sau:
-
-```
-Đọc kỹ và tuân theo bộ chỉ dẫn JobMatching dưới đây cho toàn bộ cuộc trò chuyện.
-Dùng công cụ tìm kiếm web để thu thập job thật (không bịa). CV của tôi ở cuối tin nhắn.
-
-<<< dán toàn bộ nội dung GPT-INSTRUCTIONS.md vào đây >>>
-
---- CV ---
-<<< dán CV >>>
-```
-
-## Nội dung thư mục
-
-```
-chatgpt/
-├── GPT-INSTRUCTIONS.md     Orchestrator (~7.6k chars, vừa giới hạn 8k Instructions)
-├── knowledge/               Bộ knowledge upload sẵn (skills + schemas flatten)
-│   ├── skill-*.md           Từng skill chi tiết
-│   └── *.schema.json        Data contracts
-└── README.md                File này
-```
-
-## Build lại knowledge từ source (tùy chọn)
-
-Thư mục `knowledge/` đã có sẵn trong repo. Nếu muốn build lại sau khi chỉnh skill:
-
-```bash
-bash build-chatgpt.sh          # macOS/Linux
-powershell -File build-chatgpt.ps1   # Windows
-```
-
-→ ra `dist/chatgpt-knowledge/` (copy đè vào `chatgpt/knowledge/` nếu muốn commit).
-
-## Khác biệt so với Claude Code / Codex
-
-| | Claude Code / Codex | ChatGPT |
-|---|---|---|
-| Cài đặt | `/plugin marketplace add` | Tạo Custom GPT, upload knowledge |
-| Web search | `WebSearch` / `web_search` | Web Search (browsing) |
-| Lưu trữ | Ghi `data/*.json` ra ổ đĩa | JSON trong chat (hoặc Code Interpreter tạm) |
-| Báo cáo | File `.md` trong `data/results/` | Markdown trong chat (hoặc file tải về) |
-
-Logic pipeline, trọng số chấm điểm và data contract **giống hệt** — đều bắt nguồn từ
-`job-matching-plugin/skills/` + `schemas/` (nguồn chân lý duy nhất).

package/chatgpt/knowledge/job.schema.json

@@ -1,58 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "job.schema.json",
-  "title": "Job",
-  "description": "Tin tuyển dụng đã chuẩn hóa từ nguồn search/scrape.",
-  "type": "object",
-  "required": ["id", "title", "company", "url", "source"],
-  "properties": {
-    "schema_version": { "type": "string", "default": "1.0" },
-    "id": { "type": "string", "description": "Hash ổn định từ url hoặc company+title+location để khử trùng" },
-    "title": { "type": "string" },
-    "company": { "type": "string" },
-    "location": { "type": "string" },
-    "remote": { "type": "string", "enum": ["onsite", "hybrid", "remote", "unknown"], "default": "unknown" },
-    "url": { "type": "string", "description": "Link trang tuyển dụng / link JD gốc" },
-    "source": { "type": "string", "description": "vd 'itviec', 'topcv', 'vietnamworks', 'linkedin', 'careerviet', 'google'" },
-    "posted_date": { "type": "string", "description": "YYYY-MM-DD nếu có" },
-    "application_deadline": { "type": "string", "description": "YYYY-MM-DD hạn nộp nếu JD có ghi; job chỉ được giữ khi hạn >= ngày hiện tại" },
-    "employment_type": { "type": "string", "enum": ["full-time", "part-time", "contract", "internship", "unknown"], "default": "unknown" },
-    "language": { "type": "string", "enum": ["vi", "en", "mixed"], "default": "mixed" },
-    "description": { "type": "string", "description": "JD gốc (rút gọn nếu quá dài)" },
-    "contact": {
-      "type": "object",
-      "description": "Thông tin liên hệ ứng tuyển trực tiếp nếu JD có",
-      "properties": {
-        "email": { "type": "string" },
-        "phone": { "type": "string" },
-        "zalo": { "type": "string" },
-        "form_url": { "type": "string", "description": "Google Form / Typeform link nếu có" },
-        "how_to_apply": { "type": "string", "description": "Hướng dẫn ứng tuyển ngắn: vd 'Gửi CV qua email', 'Apply qua link'" }
-      }
-    },
-    "requirements": {
-      "type": "object",
-      "properties": {
-        "must_have_skills": { "type": "array", "items": { "type": "string" }, "description": "Canonical names" },
-        "nice_to_have_skills": { "type": "array", "items": { "type": "string" } },
-        "min_years": { "type": "number" },
-        "seniority": { "type": "string", "enum": ["intern", "junior", "mid", "senior", "lead", "manager", "director", "unknown"], "default": "unknown" },
-        "education": { "type": "string" }
-      }
-    },
-    "salary": {
-      "type": "object",
-      "properties": {
-        "min": { "type": "number" },
-        "max": { "type": "number" },
-        "currency": { "type": "string", "enum": ["VND", "USD", "unknown"], "default": "unknown" },
-        "period": { "type": "string", "enum": ["month", "year", "unknown"], "default": "unknown" },
-        "negotiable": { "type": "boolean" }
-      }
-    },
-    "industry": { "type": "string" },
-    "company_size": { "type": "string", "enum": ["startup", "sme", "enterprise", "unknown"], "default": "unknown" },
-    "collected_at": { "type": "string", "description": "ISO timestamp lúc thu thập" },
-    "extraction_confidence": { "type": "number", "description": "0-1, độ tin cậy khi parse JD (0.8-1.0 khi đọc được full JD)" }
-  }
-}

package/chatgpt/knowledge/match.schema.json

@@ -1,48 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "match.schema.json",
-  "title": "MatchResult",
-  "description": "Kết quả chấm điểm 1 job so với profile. Xem scoring-rubric.",
-  "type": "object",
-  "required": ["job_id", "overall_score", "dimension_scores"],
-  "properties": {
-    "schema_version": { "type": "string", "default": "1.0" },
-    "job_id": { "type": "string" },
-    "overall_score": { "type": "number", "description": "0-100, tổng hợp có trọng số" },
-    "recommendation": { "type": "string", "enum": ["strong", "good", "maybe", "weak", "excluded"] },
-    "dimension_scores": {
-      "type": "object",
-      "description": "Mỗi chiều 0-100.",
-      "properties": {
-        "skills": { "type": "number" },
-        "seniority": { "type": "number" },
-        "domain": { "type": "number" },
-        "location": { "type": "number" },
-        "compensation": { "type": "number" },
-        "culture": { "type": "number" }
-      }
-    },
-    "weights_used": {
-      "type": "object",
-      "description": "Trọng số thực tế đã áp (sau khi override bằng target.priorities).",
-      "additionalProperties": { "type": "number" }
-    },
-    "matched_skills": { "type": "array", "items": { "type": "string" } },
-    "missing_must_have": { "type": "array", "items": { "type": "string" } },
-    "gaps": {
-      "type": "array",
-      "description": "Khoảng cách cần lấp (kỹ năng/kinh nghiệm) + mức nghiêm trọng.",
-      "items": {
-        "type": "object",
-        "properties": {
-          "area": { "type": "string" },
-          "detail": { "type": "string" },
-          "severity": { "type": "string", "enum": ["low", "medium", "high"] }
-        }
-      }
-    },
-    "dealbreaker_violations": { "type": "array", "items": { "type": "string" } },
-    "rationale": { "type": "string", "description": "Giải thích ngắn gọn vì sao điểm này (song ngữ nếu cần)" },
-    "confidence": { "type": "number", "description": "0-1, phụ thuộc extraction_confidence của job" }
-  }
-}

package/chatgpt/knowledge/profile.schema.json

@@ -1,121 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "profile.schema.json",
-  "title": "CandidateProfile",
-  "description": "Hồ sơ ứng viên chuẩn hóa từ CV + target. Song ngữ Việt-Anh.",
-  "type": "object",
-  "required": ["candidate", "skills", "experience", "seniority", "target"],
-  "properties": {
-    "schema_version": { "type": "string", "default": "1.0" },
-    "candidate": {
-      "type": "object",
-      "required": ["name"],
-      "properties": {
-        "name": { "type": "string" },
-        "headline": { "type": "string", "description": "Chức danh hiện tại / tự mô tả ngắn" },
-        "location": { "type": "string" },
-        "summary": { "type": "string" },
-        "languages": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "language": { "type": "string" },
-              "level": { "type": "string", "enum": ["basic", "conversational", "professional", "native"] }
-            }
-          }
-        }
-      }
-    },
-    "skills": {
-      "type": "array",
-      "description": "Kỹ năng đã chuẩn hóa (dùng canonical EN name qua bilingual-normalization).",
-      "items": {
-        "type": "object",
-        "required": ["name"],
-        "properties": {
-          "name": { "type": "string", "description": "Canonical name, ưu tiên EN, vd 'React'" },
-          "aliases": { "type": "array", "items": { "type": "string" } },
-          "category": { "type": "string", "description": "vd 'frontend', 'backend', 'data', 'soft-skill'" },
-          "years": { "type": "number" },
-          "level": { "type": "string", "enum": ["beginner", "intermediate", "advanced", "expert"] },
-          "evidence": { "type": "string", "description": "Trích từ CV làm bằng chứng" }
-        }
-      }
-    },
-    "experience": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["title"],
-        "properties": {
-          "title": { "type": "string" },
-          "company": { "type": "string" },
-          "start": { "type": "string", "description": "YYYY-MM" },
-          "end": { "type": "string", "description": "YYYY-MM hoặc 'present'" },
-          "duration_months": { "type": "integer" },
-          "domain": { "type": "string", "description": "vd 'fintech', 'e-commerce'" },
-          "highlights": { "type": "array", "items": { "type": "string" } }
-        }
-      }
-    },
-    "education": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "properties": {
-          "degree": { "type": "string" },
-          "field": { "type": "string" },
-          "school": { "type": "string" },
-          "year": { "type": "string" }
-        }
-      }
-    },
-    "total_years": { "type": "number", "description": "Tổng số năm kinh nghiệm liên quan" },
-    "seniority": {
-      "type": "string",
-      "enum": ["intern", "junior", "mid", "senior", "lead", "manager", "director"],
-      "description": "Suy ra từ total_years + phạm vi trách nhiệm"
-    },
-    "domains": { "type": "array", "items": { "type": "string" }, "description": "Ngành/lĩnh vực đã làm" },
-    "target": {
-      "type": "object",
-      "description": "Mong muốn của ứng viên. priorities dùng để override trọng số scoring.",
-      "required": ["desired_roles"],
-      "properties": {
-        "desired_roles": { "type": "array", "items": { "type": "string" } },
-        "desired_level": { "type": "string", "enum": ["intern", "junior", "mid", "senior", "lead", "manager", "director"] },
-        "locations": { "type": "array", "items": { "type": "string" } },
-        "remote_preference": { "type": "string", "enum": ["onsite", "hybrid", "remote", "any"], "default": "any" },
-        "salary": {
-          "type": "object",
-          "properties": {
-            "min": { "type": "number" },
-            "target": { "type": "number" },
-            "currency": { "type": "string", "enum": ["VND", "USD"], "default": "VND" },
-            "period": { "type": "string", "enum": ["month", "year"], "default": "month" }
-          }
-        },
-        "industries": { "type": "array", "items": { "type": "string" } },
-        "company_size": { "type": "array", "items": { "type": "string", "enum": ["startup", "sme", "enterprise", "any"] } },
-        "dealbreakers": {
-          "type": "array",
-          "description": "Điều kiện loại trừ cứng (hard filter). Vd 'no onsite ngoài HCM', 'không outsource'.",
-          "items": { "type": "string" }
-        },
-        "priorities": {
-          "type": "object",
-          "description": "Trọng số 0-1 ứng viên khai; override default trong scoring-rubric. Tổng nên ~1.",
-          "properties": {
-            "skills": { "type": "number" },
-            "seniority": { "type": "number" },
-            "domain": { "type": "number" },
-            "location": { "type": "number" },
-            "compensation": { "type": "number" },
-            "culture": { "type": "number" }
-          }
-        }
-      }
-    }
-  }
-}

package/chatgpt/knowledge/skill-application-assistant.md

@@ -1,38 +0,0 @@
----
-name: application-assistant
-description: Tùy chỉnh (tailor) nội dung CV và viết cover letter cho một job cụ thể dựa trên profile và JD. Dùng khi ứng viên đã chọn được job muốn apply và cần chuẩn bị hồ sơ.
----
-
-# Application Assistant — tailor hồ sơ theo job
-
-Đầu vào: `profile.json` + 1 job (từ jobs.json hoặc URL/JD dán vào) + (tùy chọn) MatchResult để biết gaps.
-Đầu ra: bản nháp CV bullets đã điều chỉnh và/hoặc cover letter.
-
-## Tailor CV bullets
-
-- Chọn và viết lại các highlight kinh nghiệm sao cho khớp `must_have_skills` và trách nhiệm chính của JD.
-- Dùng canonical skill name khớp với từ khóa JD (giúp qua ATS).
-- Định lượng thành tích (số liệu) khi CV có dữ liệu; **không bịa** số hay kinh nghiệm không có.
-- Nêu rõ chỗ nào là gap (missing must-have) và cách trình bày trung thực (vd "đang học", kinh nghiệm chuyển giao).
-
-## Cover letter & Email ứng tuyển
-
-- Áp skill `cover-letter-writing` (nếu có) cho style. Cấu trúc: mở đầu (vì sao công ty/role này), thân (2–3 bằng chứng khớp yêu cầu), kết (call to action).
-- Giọng văn phù hợp ngôn ngữ JD (vi/en/mixed). Ngắn gọn (~250–350 từ).
-- Cá nhân hóa theo company (tránh mẫu chung chung).
-
-## Tin nhắn tiếp cận trực tiếp HR (Email / LinkedIn / Zalo)
-
-Khi JD có kênh liên hệ trực tiếp và ứng viên muốn chủ động tiếp cận HR:
-
-**Mẫu Direct Message / Email ngắn**:
-> "Chào anh/chị [Tên HR/Recruiter], em thấy tin tuyển [Tên vị trí] của [Công ty]. Em có [X năm] kinh nghiệm về [Top 2-3 kỹ năng khớp], từng làm [Dự án/Sản phẩm tiêu biểu]. Em rất quan tâm vị trí này. Em xin gửi kèm CV: [Link CV] để anh/chị tiện xem qua ạ. Cảm ơn anh/chị!"
-
-Điều chỉnh giọng văn theo kênh (email trang trọng hơn, LinkedIn/Zalo ngắn gọn hơn).
-
-## Ranh giới quan trọng
-
-- **Không bịa** bằng cấp, kinh nghiệm, con số. Chỉ diễn đạt lại sự thật trong CV cho hấp dẫn hơn.
-- Đây là bản nháp để ứng viên xem lại và tự chỉnh; nêu rõ điều đó.
-- Không tự gửi email/nộp hồ sơ thay ứng viên.
-

package/chatgpt/knowledge/skill-bilingual-normalization.md

@@ -1,46 +0,0 @@
----
-name: bilingual-normalization
-description: Chuẩn hóa kỹ năng, chức danh, địa điểm và lương giữa tiếng Việt và tiếng Anh về dạng canonical, phục vụ so khớp job/CV chính xác. Dùng khi parse CV, chuẩn hóa JD, hoặc so khớp skills/lương trong scoring.
----
-
-# Bilingual Normalization — chuẩn hóa Việt–Anh
-
-Mục tiêu: mọi so khớp diễn ra trên **canonical name** thống nhất, tránh trượt vì khác ngôn ngữ/cách viết.
-
-## Skills — canonical name
-
-- Canonical ưu tiên tên tiếng Anh phổ biến của công nghệ: `React`, `Node.js`, `Java`, `Python`, `Kubernetes`...
-- Gộp biến thể: `ReactJS`/`React.js`/`Reactjs` → `React`; `NodeJS` → `Node.js`; `K8s` → `Kubernetes`; `.NET`/`dotnet` → `.NET`.
-- Chức năng mô tả bằng tiếng Việt → canonical EN:
-  - "Lập trình viên" / "Kỹ sư phần mềm" → Software Engineer
-  - "Trưởng nhóm" → Lead ; "Quản lý dự án" → Project Manager
-  - "Kiểm thử" / "QC" → QA ; "Phân tích nghiệp vụ" → Business Analyst
-  - "Khoa học dữ liệu" → Data Science ; "Kỹ sư dữ liệu" → Data Engineer
-- Giữ `aliases[]` trong profile/job để truy vết.
-
-## Chức danh & cấp bậc (seniority)
-
-- Map cấp bậc VN → thang chuẩn: Fresher→junior, "Chuyên viên"→mid, "Senior/Kỹ sư cao cấp"→senior, "Trưởng nhóm/Team Lead"→lead, "Trưởng phòng"→manager, "Giám đốc"→director.
-- Cẩn thận với "Senior" gắn năm kinh nghiệm khác nhau giữa công ty — ưu tiên `min_years` nếu có.
-
-## Địa điểm
-
-- Chuẩn hóa: "TP.HCM"/"Sài Gòn"/"HCMC"/"Ho Chi Minh" → "Ho Chi Minh City"; "HN"/"Hà Nội" → "Hanoi"; "ĐN"/"Đà Nẵng" → "Da Nang".
-- Nhận diện remote: "làm việc từ xa"/"remote" → remote; "linh hoạt"/"hybrid" → hybrid.
-
-## Lương — giữ nguyên gốc, chỉ quy đổi khi cần so sánh
-
-- **Luôn giữ nguyên đơn vị & giá trị gốc** trong `job.salary` (currency đúng như JD). Ví dụ JD ghi "$1000" → lưu USD 1000; ghi "26 triệu" → lưu VND 26,000,000. Không tự đổi khi lưu trữ hay hiển thị.
-- Đơn vị Việt:
-  - "15 triệu"/"15tr"/"15M" → 15,000,000 VND.
-  - "15-20 triệu"/"15-20M" → min 15tr, max 20tr.
-  - "Gross" / "Net" → parse giá trị số bình thường (ghi chú trong description nếu cần).
-- "Thỏa thuận"/"Cạnh tranh"/"Negotiable"/"Deal" → không set số, `negotiable=true`, currency=unknown.
-- USD: "$1500"/"1500 USD" → USD. "Up to $2000"/"Upto $2k" → max=2000, currency=USD.
-- **Chỉ khi cần so sánh** (chấm điểm compensation, so hai job khác đơn vị): quy đổi tạm về VND/tháng bằng tỉ giá cố định **$1 = 26,100 VND**; year→month chia 12. Giá trị quy đổi này chỉ dùng nội bộ lúc tính toán, KHÔNG ghi đè giá trị gốc.
-
-## Nguyên tắc
-
-- Chỉ map khi chắc chắn; nếu không rõ, giữ nguyên và ghi vào aliases để không mất thông tin.
-- Không "dịch" tên riêng công ty.
-

package/chatgpt/knowledge/skill-candidate-intake.md

@@ -1,43 +0,0 @@
----
-name: candidate-intake
-description: Parse CV của ứng viên (PDF/DOCX/text) và thu thập target/mong muốn để tạo profile.json chuẩn. Dùng khi bắt đầu một phiên tìm việc, khi người dùng cung cấp CV mới, hoặc muốn cập nhật mục tiêu nghề nghiệp.
----
-
-# Candidate Intake — tạo profile ứng viên
-
-Đầu ra: một file `data/profiles/<slug>.json` tuân theo `./schemas/profile.schema.json`.
-
-## Bước 1 — Đọc CV
-
-- Trích text từ CV:
-  - **PDF** → Claude Code: dùng skill `pdf` (anthropic-skills). Codex/CLI: `pdftotext cv.pdf -` (poppler) hoặc `python -c "import pypdf; ..."`. Không có tool → yêu cầu người dùng dán nội dung CV.
-  - **DOCX** → Claude Code: skill `docx`. Codex/CLI: `python -c "import docx; ..."` (python-docx) hoặc unzip đọc `word/document.xml`.
-  - **Text/Markdown** → đọc trực tiếp.
-- Trích: thông tin cá nhân tối thiểu (tên, headline, location), kỹ năng, kinh nghiệm (title/công ty/thời gian/highlights), học vấn, ngôn ngữ.
-- Suy `total_years` và `seniority` từ tổng thời gian + phạm vi trách nhiệm.
-
-## Bước 2 — Chuẩn hóa (song ngữ)
-
-- Áp skill `bilingual-normalization`: đưa skills & chức danh về canonical name, chuẩn hóa location.
-- Với mỗi skill, cố gắng gắn `years`/`level`/`evidence` từ CV (không bịa — thiếu thì để trống).
-
-## Bước 3 — Thu thập target
-
-Hỏi ứng viên (gộp câu hỏi, đừng hỏi lẻ tẻ). Nếu người dùng đã nêu sẵn trong hội thoại thì dùng luôn, chỉ hỏi phần còn thiếu:
-
-1. **Vai trò mong muốn** (desired_roles) + cấp bậc (desired_level).
-2. **Địa điểm** + hình thức (onsite/hybrid/remote/any).
-3. **Lương kỳ vọng** (min & target, VND hay USD, tháng/năm).
-4. **Ngành** ưu tiên + **quy mô công ty**.
-5. **Dealbreakers** — điều tuyệt đối không chấp nhận.
-6. **Ưu tiên** (priorities): cái gì quan trọng nhất? (lương / kỹ năng phù hợp / địa điểm / ngành / văn hóa). Chuyển thành trọng số 0–1 cho `target.priorities` (tổng ~1) — đây là dữ liệu quan trọng cho `scoring-rubric`.
-
-## Bước 4 — Ghi file & Xác nhận
-- Ghi `profile.json` đúng schema. Đặt tên slug từ tên ứng viên (không dấu, kebab-case).
-- Tóm tắt lại cho người dùng xác nhận: seniority suy ra, top skills, target, và trọng số priorities. Cho phép chỉnh trước khi sang bước collector.
-
-## Nguyên tắc
-
-- Không bịa kỹ năng/kinh nghiệm không có trong CV.
-- Nếu CV thiếu năm tháng cụ thể, ước lượng và ghi rõ là ước lượng.
-- Tôn trọng riêng tư: chỉ lưu thông tin cần cho matching; không đưa dữ liệu cá nhân ra ngoài.

package/chatgpt/knowledge/skill-find-jobs.md

@@ -1,50 +0,0 @@
----
-name: find-jobs
-description: Chạy full pipeline tìm việc song ngữ Việt–Anh — parse CV, thu thập job (web search), chấm điểm, xuất báo cáo fit/gap. Dùng khi người dùng muốn "tìm job cho tôi" từ một CV hoặc profile đã có.
----
-
-# find-jobs — điều phối full pipeline tìm việc
-
-Skill điều phối, chạy tuần tự 4 bước. Đối số là đường dẫn CV (PDF/DOCX/text) hoặc tên
-profile đã có trong `data/profiles/`.
-
-Dùng `<run-id>` duy nhất theo mẫu `<candidate-slug>-<YYYYMMDD-HHMMSS>-<suffix>` và giữ nguyên
-ID này xuyên suốt pipeline. Tạo `data/profiles`, `data/jobs`, `data/results` trong thư mục làm việc
-nếu chưa có.
-
-> **Yêu cầu (bước 2 — thu thập job):**
-> - **Claude Code**: `WebSearch`/`WebFetch` có sẵn — không cần cấu hình.
-> - **Codex**: cần bật `web_search` bằng `codex --search` hoặc `tools.web_search = true` trong `~/.codex/config.toml`. Nếu chưa bật, dừng ở bước 2 và báo người dùng.
-
-## Bước 1 — Intake → profile.json
-Áp skill **`candidate-intake`**.
-- Nếu đối số là file CV → parse và tạo `data/profiles/<slug>.json` theo `schemas/profile.schema.json`.
-- Nếu là tên profile đã tồn tại → dùng lại, hỏi có cập nhật target không.
-- Thu thập/xác nhận target: vai trò, cấp bậc, địa điểm/remote, lương, priorities (→ trọng số), dealbreakers.
-- Tóm tắt cho người dùng xác nhận.
-
-## Bước 2 — Collect → data/jobs/<run-id>.json
-Spawn một subagent context riêng và yêu cầu nó áp skill **`job-collector`**; không phụ thuộc custom
-agent cài ngoài plugin.
-- Truyền đường dẫn `profile.json`, `<run-id>` và output `data/jobs/<run-id>.json`.
-- **Nguồn Job Boards**: Quét từ ITviec, TopCV, VietnamWorks, LinkedIn...
-- Giữ job thỏa mãn tiêu chuẩn: chỉ giữ job xem được full JD & còn hạn. Tối đa 20 job hợp lệ.
-
-## Bước 3 — Match → data/results/<run-id>.shortlist.json
-Spawn một subagent context riêng và yêu cầu nó áp skill **`job-matcher`** (chấm điểm bulk).
-- Truyền `profile.json` + `data/jobs/<run-id>.json`.
-- Chấm điểm theo skill **`scoring-rubric`**, dùng trọng số từ `target.priorities`.
-
-## Bước 4 — Fit report → data/results/<run-id>.fit_report.md
-Áp skill **`fit-analyzer`**.
-- Bảng xếp hạng: **mọi job đều có link nộp CV (url) bấm được**; phân tích chi tiết top 20 (hoặc toàn bộ).
-- Báo đường dẫn file báo cáo cho người dùng.
-
-## Sau khi xong
-Đề xuất bước tiếp: tailor hồ sơ cho job top (skill `application-assistant`), hoặc mở rộng
-nguồn (remote quốc tế / thành phố khác).
-
-## Nguyên tắc
-- Không bịa dữ liệu job/CV. Thiếu → unknown, hạ confidence.
-- Tôn trọng robots/ToS khi scrape; không vượt anti-bot/CAPTCHA.
-- Không tự nộp hồ sơ thay người dùng.

package/chatgpt/knowledge/skill-fit-analyzer.md

@@ -1,37 +0,0 @@
----
-name: fit-analyzer
-description: Với các job trong shortlist, giải thích mức độ phù hợp, khoảng cách kỹ năng/kinh nghiệm, rủi ro, và gợi ý cải thiện — dạng báo cáo dễ đọc cho ứng viên. Dùng sau khi job-matcher đã tạo shortlist.
----
-
-# Fit Analyzer — báo cáo phù hợp & khoảng cách
-
-Đầu vào: `profile.json` + `data/results/<run-id>.shortlist.json` (mảng MatchResult + job tương ứng).
-Đầu ra: `data/results/<run-id>.fit_report.md`.
-
-## Phạm vi báo cáo (QUAN TRỌNG)
-
-Phân tích chi tiết **TẤT CẢ job trong shortlist**, không rút gọn còn top 3. Nếu shortlist có nhiều hơn **20** job thì phân tích chi tiết 20 job điểm cao nhất và vẫn liệt kê đủ phần còn lại trong bảng xếp hạng. Có thể thêm mục "🏆 Ưu tiên apply ngay" (2–3 job) ở đầu như phần tóm tắt, nhưng **phần thân báo cáo vẫn phải có block chi tiết cho từng job** (không bỏ job nào).
-
-## Nội dung báo cáo
-
-Với **mỗi** job (theo thứ tự điểm giảm dần), trình bày:
-
-1. **Header**: `#N. Title @ Company` — overall_score, recommendation, **link nộp CV (url)**, lương, location/remote, hạn nộp (nếu có).
-   - Nếu JD có kênh liên hệ trực tiếp (email, phone, Zalo, form): hiển thị rõ.
-2. **Vì sao hợp** (2–3 gạch đầu dòng): điểm mạnh khớp — matched_skills chính, domain, seniority, lương.
-3. **Khoảng cách** (gaps): missing_must_have + gaps[] kèm severity. Nói rõ cái nào là "học nhanh được" vs "cần thời gian".
-4. **Rủi ro / cần xác minh**:
-   - Nếu `confidence` thấp → khuyến nghị đọc kỹ JD gốc; overqualified/underqualified; lương unknown.
-5. **Hành động đề xuất**: Apply qua link / Chuẩn bị hồ sơ. Nếu muốn chủ động liên hệ HR (email/LinkedIn/Zalo), dùng skill `application-assistant` để lấy tin nhắn mẫu.
-
-## Tổng quan đầu báo cáo
-
-- Bảng xếp hạng: rank | title | company | score | recommendation | lương | location | **link nộp CV**. **MỌI job trong bảng đều phải có link (url) bấm được** — không chỉ các job top. Dùng markdown link (vd `[Nộp CV](url)`).
-- Nhận xét chung: xu hướng thị trường quan sát được, gap lặp lại nhiều lần (gợi ý kỹ năng nên học), có nên nới target không (vd lương kỳ vọng quá cao so với mặt bằng).
-
-## Nguyên tắc
-
-- Trung thực: nếu match yếu, nói thẳng; đừng thổi phồng.
-- Ưu tiên hành động cụ thể hơn nhận xét chung chung.
-- Song ngữ khi cần (thuật ngữ giữ tiếng Anh, giải thích tiếng Việt).
-- Không tạo kỳ vọng sai về khả năng trúng tuyển.

package/chatgpt/knowledge/skill-job-collector.md

@@ -1,21 +0,0 @@
----
-name: job-collector
-description: Thu thập và chuẩn hóa việc làm từ web search. Dùng trong bước collect của pipeline find-jobs sau khi đã có profile ứng viên.
----
-
-# Job Collector
-
-Nhận đường dẫn `profile.json`, `run_id` duy nhất và đường dẫn output. Thu thập tối đa 20 job hợp lệ, chuẩn hóa theo `job-schema`, rồi ghi vào `data/jobs/<run_id>.json`.
-
-## Nguồn dữ liệu
-
-- Job boards: dùng web search/fetch sẵn có của host. Chỉ giữ job đọc được JD và chưa có bằng chứng hết hạn.
-
-## Contract
-
-1. Đọc profile và sinh query song ngữ từ role, seniority, location và skills.
-2. Khử trùng theo URL chuẩn hóa; ưu tiên nguồn gốc và dữ liệu mới hơn.
-3. Ghi object theo `schemas/job.schema.json`, đặt `extraction_confidence` trung thực.
-4. Trả số lượng thu được, số bị loại và cảnh báo dữ liệu thiếu.
-
-Không tự nộp hồ sơ, không vượt CAPTCHA/anti-bot và không ghi đè output của run khác.

package/chatgpt/knowledge/skill-job-matcher.md

@@ -1,16 +0,0 @@
----
-name: job-matcher
-description: Chấm điểm và xếp hạng danh sách job so với profile ứng viên. Dùng trong bước match của pipeline find-jobs sau khi collector đã tạo jobs JSON.
----
-
-# Job Matcher
-
-Nhận `profile.json`, `data/jobs/<run_id>.json` và output `data/results/<run_id>.shortlist.json`.
-
-1. Khử trùng job theo `id`, giữ bản có `extraction_confidence` cao hơn.
-2. Áp `scoring-rubric` và `bilingual-normalization` cho từng job.
-3. Chuẩn hóa mọi bộ trọng số, kể cả mặc định, để tổng bằng 1 trước khi tính điểm.
-4. Hard-filter dealbreakers chỉ khi có đủ bằng chứng; thiếu dữ liệu thì hạ confidence.
-5. Ghi mảng `{match, job_ref}` theo `schemas/match.schema.json`, sắp xếp giảm dần và để excluded cuối.
-
-Luôn ghi `weights_used`, rationale và các gap; không thổi phồng recommendation.

package/chatgpt/knowledge/skill-job-schema.md

@@ -1,62 +0,0 @@
----
-name: job-schema
-description: Schema chuẩn cho một tin tuyển dụng (job) và cách map dữ liệu thô từ search/scrape vào schema đó. Dùng bởi job-collector khi chuẩn hóa JD, và job-matcher khi đọc job.
----
-
-# Job Schema — chuẩn hóa tin tuyển dụng
-
-Schema chính: `./schemas/job.schema.json`. Skill này hướng dẫn cách điền cho nhất quán.
-
-## Quy tắc bắt buộc
-
-- `id`: tạo hash ổn định. Ưu tiên chuẩn hóa URL (bỏ query tracking) rồi hash; nếu không có URL sạch, hash chuỗi `company|title|location` (lowercase, bỏ dấu). Dùng để **khử trùng lặp** giữa các nguồn.
-- `source`: định danh nguồn ngắn gọn: `itviec`, `topcv`, `vietnamworks`, `linkedin`, `careerviet`, `google`, ...
-- `collected_at`: ISO timestamp.
-- `extraction_confidence` (0–1):
-  - **Cao** (0.8–1.0): đọc được full JD từ trang tuyển dụng chính thống hoặc link JD mở.
-  - **Thấp** (≤0.4): chỉ có snippet rời rạc từ kết quả tìm kiếm không đủ thông tin.
-
-## Chuẩn hóa các trường
-
-- **skills** (`must_have_skills`, `nice_to_have_skills`): đưa về canonical name qua skill `bilingual-normalization` (vd "ReactJS", "React.js" → "React").
-- **salary**: parse cả tiếng Việt ("15-20 triệu", "thỏa thuận", "Up to $2000", "range 30-50m") → {min, max, currency, period, negotiable}. "Thỏa thuận"/"Negotiable" → currency=unknown, negotiable=true.
-- **remote**: nhận diện "remote", "làm việc từ xa", "hybrid", "onsite", "tại văn phòng".
-- **seniority**: suy từ title/JD ("Junior", "Senior", "Trưởng nhóm"→lead, "Fresher"→junior).
-- **company**: Nếu JD không nêu rõ tên cty (stealth startup, headhunter tuyển hộ) → ghi `Confidential (<lĩnh vực>)` hoặc tên agency (vd `Confidential (Fintech HCM)`).
-- **contact**: Trích xuất kênh liên hệ ứng tuyển nếu JD có:
-  - `email`: email nhận CV (vd `hr@company.com`).
-  - `phone`: số điện thoại liên hệ.
-  - `form_url`: link Google Form / Typeform nộp hồ sơ.
-  - `how_to_apply`: tóm tắt ngắn (vd `"Gửi CV qua email hr@..."`, `"Apply qua link"`).
-- **language**: `vi`/`en`/`mixed` tùy JD.
-- **min_years**: parse "2+ năm kinh nghiệm", "at least 3 years".
-
-## Nguyên tắc chống bịa
-
-- Chỉ điền trường khi có bằng chứng trong dữ liệu nguồn. Không suy đoán lương/quy mô công ty nếu JD không nói → để `unknown`.
-- `url` luôn là link trang tuyển dụng gốc để người dùng bấm vào apply.
-- Rút gọn `description` nếu quá dài (giữ phần requirements + trách nhiệm chính).
-
-## Ví dụ tin tuyển dụng chuẩn (Full JD)
-
-```json
-{
-  "id": "a1b2c3",
-  "title": "Senior Frontend Developer (ReactJS)",
-  "company": "ABC Tech",
-  "location": "Ho Chi Minh City",
-  "remote": "hybrid",
-  "url": "https://itviec.com/it-jobs/senior-frontend-abc",
-  "source": "itviec",
-  "language": "mixed",
-  "requirements": {
-    "must_have_skills": ["React", "TypeScript"],
-    "nice_to_have_skills": ["Next.js"],
-    "min_years": 3,
-    "seniority": "senior"
-  },
-  "salary": { "min": 30000000, "max": 45000000, "currency": "VND", "period": "month" },
-  "collected_at": "2026-08-25T10:00:00Z",
-  "extraction_confidence": 0.9
-}
-```

package/chatgpt/knowledge/skill-scoring-rubric.md

@@ -1,108 +0,0 @@
----
-name: scoring-rubric
-description: Công thức chấm điểm mức độ khớp giữa 1 job và profile ứng viên. Dùng bởi job-matcher và bất kỳ nơi nào cần đánh giá độ phù hợp job/CV. Định nghĩa trọng số, cách tính từng chiều, hard filter (dealbreakers), và cách xử lý dữ liệu thiếu.
----
-
-# Scoring Rubric — chấm điểm khớp job ↔ profile
-
-Đây là "bộ não" quyết định chất lượng match. Kết quả tuân theo `./schemas/match.schema.json`.
-
-## Nguyên tắc
-
-1. Điểm mỗi chiều thang **0–100**, độc lập.
-2. `overall_score` = tổng có trọng số của các chiều, **trừ** khi có dealbreaker (→ excluded).
-3. Minh bạch: luôn ghi `weights_used`, `matched_skills`, `missing_must_have`, `rationale`.
-4. Dữ liệu thiếu KHÔNG bị chấm 0 một cách mù quáng — xem mục "Xử lý dữ liệu thiếu".
-
-## Bước 0 — Hard filter (dealbreakers)
-
-Trước khi chấm điểm, kiểm tra `profile.target.dealbreakers` và các ràng buộc cứng:
-
-- Vi phạm bất kỳ dealbreaker → `recommendation = "excluded"`, `overall_score = 0`, ghi vào `dealbreaker_violations`. **Không** tính tiếp.
-- Ví dụ dealbreaker cứng thường gặp: location ngoài vùng chấp nhận (khi remote=onsite), loại hình công ty bị loại (outsource), lương max < salary.min của ứng viên (khi có đủ dữ liệu).
-- Nếu dữ liệu không đủ để khẳng định vi phạm (vd lương "unknown") → KHÔNG loại, hạ `confidence` thay vì exclude.
-
-## Trọng số mặc định
-
-| Chiều | Mặc định | Ý nghĩa |
-|---|---|---|
-| skills | 0.35 | Khớp kỹ năng must-have / nice-to-have |
-| seniority | 0.20 | Cấp bậc & số năm kinh nghiệm |
-| domain | 0.15 | Ngành/lĩnh vực |
-| location | 0.05 | Địa điểm & hình thức remote |
-| compensation | 0.15 | Lương so với kỳ vọng |
-| culture | 0.05 | Quy mô/loại hình công ty, tín hiệu văn hóa |
-
-**Bắt buộc chuẩn hóa:** cả bộ trọng số mặc định và bộ `profile.target.priorities` override đều phải
-được chia cho tổng thực tế trước khi tính điểm, để tổng `weights_used` luôn bằng 1. Bộ số mặc định
-trên chủ ý thể hiện tỷ lệ tương đối; không được dùng trực tiếp khi tổng chưa bằng 1. Luôn ghi bộ đã
-chuẩn hóa vào `weights_used`.
-
-## Cách tính từng chiều
-
-### skills (0–100)
-- Chuẩn hóa mọi skill về canonical name (dùng skill `bilingual-normalization`) trước khi so khớp.
-- `must_cover` = tỉ lệ must-have của job mà profile đáp ứng.
-- `nice_cover` = tỉ lệ nice-to-have đáp ứng.
-- `skills_score = 100 * (0.75 * must_cover + 0.25 * nice_cover)`.
-- Cộng thưởng nhẹ nếu ứng viên có skill level `advanced/expert` cho must-have chính (tối đa +10, cap 100).
-- Nếu job không nêu must-have (`must_have_skills` rỗng) → suy từ title + description; hạ `confidence`.
-- Ghi `matched_skills` và `missing_must_have`.
-
-### seniority (0–100)
-- So `profile.seniority` với `job.requirements.seniority` (map thang: intern<junior<mid<senior<lead<manager<director).
-- Khoảng cách 0 bậc → 100; 1 bậc → 75; 2 bậc → 45; ≥3 bậc → 15.
-- **Overqualified** (ứng viên cao hơn job ≥2 bậc) cũng bị trừ (dễ bị loại/chán việc): áp cùng thang khoảng cách.
-- Điều chỉnh bằng `min_years`: nếu `total_years < min_years` → nhân 0.6; nếu thừa nhiều năm → không thưởng.
-- Nếu job seniority = unknown → suy từ min_years/title; hạ confidence.
-
-### domain (0–100)
-- Trùng ngành trong `profile.domains`/`target.industries` với `job.industry` → 100.
-- Ngành liền kề/chuyển giao được (adjacent) → 60.
-- Không liên quan → 30 (không phải 0, vì kỹ năng có thể chuyển ngành).
-
-### location (0–100)
-- remote=remote và ứng viên chấp nhận remote/any → 100.
-- Job location nằm trong `target.locations` → 100.
-- hybrid + cùng thành phố → 85.
-- onsite khác thành phố nhưng ứng viên để "any" → 60.
-- onsite ngoài vùng chấp nhận (chưa tới mức dealbreaker) → 25.
-
-### compensation (0–100)
-- Cần đưa về cùng đơn vị (VND/tháng) — dùng `bilingual-normalization` để quy đổi USD↔VND & year↔month.
-- job_mid = trung bình (min,max). So với `target.salary.target` (hoặc min).
-- job_mid ≥ target → 100; trong khoảng [min, target] → nội suy 70–100; dưới min nhưng ≥ 90% min → 50; thấp hơn → 20.
-- Lương unknown → điểm neutral 60, hạ confidence (KHÔNG chấm 0).
-
-### culture (0–100)
-- Khớp `target.company_size` → +40 baseline lên; tín hiệu tích cực trong JD (đãi ngộ, lộ trình, tech stack hiện đại) cộng thêm.
-- Ít dữ liệu → 60 neutral.
-
-## Xử lý dữ liệu thiếu
-
-- Không bao giờ chấm 0 vì "thiếu thông tin" — dùng điểm **neutral** (55–60) và **giảm `confidence`**.
-- `confidence` tổng của match ≈ trung bình có trọng số của `job.extraction_confidence` và độ đầy đủ dữ liệu các chiều.
-- Match có confidence < 0.4 nên được đánh dấu "cần xác minh JD" trong rationale.
-
-## Tổng hợp & khuyến nghị
-
-```
-normalized_weight[d] = weight[d] / Σ weight
-overall = Σ (dimension_score[d] * normalized_weight[d])   với d ∈ 6 chiều
-```
-
-Map sang `recommendation`:
-
-| overall | recommendation |
-|---|---|
-| ≥ 80 | strong |
-| 65–79 | good |
-| 50–64 | maybe |
-| < 50 | weak |
-| (dealbreaker) | excluded |
-
-## Đầu ra
-
-Trả về đúng `./schemas/match.schema.json`: overall_score, recommendation, dimension_scores, weights_used, matched_skills, missing_must_have, gaps[], dealbreaker_violations[], rationale, confidence.
-
-`rationale` viết ngắn, cụ thể, song ngữ nếu cần — nêu 1–2 lý do mạnh nhất và 1 gap lớn nhất.