jobscout 1.2.0

package/README.md

@@ -0,0 +1,123 @@
+# JobMatching
+
+AI tìm và xếp hạng việc làm phù hợp nhất với CV của bạn — song ngữ Việt–Anh, không cần API key.
+
+Thu thập job thật từ ITviec, TopCV, VietnamWorks, LinkedIn… qua web search, chấm điểm 6 chiều
+(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.
+
+## Cài đặt
+
+```bash
+npx jobscout setup
+```
+
+Tự phát hiện nền tảng và setup. Hoặc chỉ định:
+
+```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ả
+```
+
+## Sau khi setup
+
+### Claude Code
+
+```
+/plugin marketplace add .
+/plugin install job-matching
+/find-jobs path/to/CV.pdf
+```
+
+### Codex CLI
+
+```bash
+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
+
+```
+CV + Target
+   ▼  [1] candidate-intake     Parse CV → profile.json
+   ▼  [2] job-collector        Web search → tối đa 20 job hợp lệ
+   ▼  [3] job-matcher          Chấm điểm 6 chiều → shortlist xếp hạng
+   ▼  [4] fit-analyzer         Báo cáo fit/gap + link apply từng job
+   ▼  [5] application-assistant (tùy chọn)  Tailor CV / cover letter / tin nhắn HR
+```
+
+## Trọng số chấm điểm
+
+| Chiều | Mặc định | Ý nghĩa |
+|---|---|---|
+| skills | 35% | Khớp kỹ năng must-have / nice-to-have |
+| seniority | 20% | Cấp bậc & năm kinh nghiệm |
+| domain | 15% | Ngành / lĩnh vực |
+| compensation | 15% | Lương so với kỳ vọng |
+| location | 5% | Địa điểm & remote |
+| culture | 5% | Quy mô / loại hình công ty |
+
+Override bằng cách khai `priorities` khi được hỏi target (tổng tự chuẩn hóa về 1).
+
+## Thành phần
+
+| Thành phần | Loại | Vai trò |
+|---|---|---|
+| `candidate-intake` | Skill | Parse CV + hỏi target → `profile.json` |
+| `job-collector` | Subagent | Search + scrape JD từ job boards → `jobs.json` |
+| `job-matcher` | Subagent | Chấm điểm & xếp hạng → `shortlist.json` |
+| `fit-analyzer` | Skill | Báo cáo fit/gap chi tiết → `fit_report.md` |
+| `application-assistant` | Skill | Tailor CV / cover letter / tin nhắn tiếp cận HR |
+| `scoring-rubric` | Skill | Công thức tính điểm 6 chiều |
+| `job-schema` | Skill | Schema chuẩn cho job + cách map dữ liệu thô |
+| `bilingual-normalization` | Skill | Chuẩn hóa skill/chức danh/lương Việt–Anh |
+
+## Data contracts
+
+JSON schema trong `job-matching-plugin/schemas/`:
+- **`profile.schema.json`** — hồ sơ ứng viên (CV + target + priorities)
+- **`job.schema.json`** — tin tuyển dụng chuẩn hóa (kèm contact nếu JD có)
+- **`match.schema.json`** — kết quả chấm điểm (6 chiều + rationale)
+
+## Cấu trúc repo
+
+```
+├── bin/cli.mjs                   ← CLI (npx job-matching setup)
+├── job-matching-plugin/          ← nguồn chân lý duy nhất
+│   ├── .claude-plugin/             Claude Code manifest
+│   ├── .codex-plugin/              Codex CLI manifest
+│   ├── skills/*/SKILL.md           Logic pipeline + rubric
+│   ├── 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
+```
+
+## Lưu ý
+
+- Quét từ các trang tuyển dụng chính thống. Chỉ giữ job xem được full JD và còn hạn.
+- Tôn trọng robots.txt và ToS; không vượt qua anti-bot/CAPTCHA.
+- Không bịa dữ liệu job/CV. Thiếu thông tin → `unknown` + hạ confidence.
+- **Không tự nộp hồ sơ / gửi tin nhắn thay người dùng.**
+
+## License
+
+MIT

package/bin/cli.mjs

@@ -0,0 +1,190 @@
+#!/usr/bin/env node
+
+import { existsSync, mkdirSync, cpSync, readFileSync, writeFileSync } from "node:fs";
+import { resolve, join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+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 RESET = "\x1b[0m";
+const GREEN = "\x1b[32m";
+const CYAN = "\x1b[36m";
+const YELLOW = "\x1b[33m";
+const BOLD = "\x1b[1m";
+const DIM = "\x1b[2m";
+
+function log(msg) { console.log(msg); }
+function ok(msg) { log(`${GREEN}✓${RESET} ${msg}`); }
+function info(msg) { log(`${CYAN}→${RESET} ${msg}`); }
+function warn(msg) { log(`${YELLOW}!${RESET} ${msg}`); }
+function heading(msg) { log(`\n${BOLD}${msg}${RESET}`); }
+
+const command = process.argv[2];
+
+const HELP = `
+${BOLD}jobscout${RESET} — AI job matching setup CLI
+
+${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
+
+${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
+`;
+
+function copyDir(src, dest) {
+  cpSync(src, dest, { recursive: true });
+}
+
+function ensureDir(dir) {
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+}
+
+function detectPlatforms() {
+  const platforms = [];
+  if (existsSync(join(CWD, ".claude")) || process.env.CLAUDE_CODE) {
+    platforms.push("claude");
+  }
+  if (existsSync(join(CWD, ".codex")) || process.env.CODEX_HOME) {
+    platforms.push("codex");
+  }
+  return platforms;
+}
+
+function setupClaude() {
+  heading("Claude Code");
+
+  const marketplaceDest = join(CWD, ".claude-plugin");
+  const pluginDest = join(CWD, "job-matching-plugin");
+
+  ensureDir(marketplaceDest);
+
+  const marketplace = {
+    name: "jobmatching-marketplace",
+    owner: { name: "JobMatching" },
+    metadata: {
+      description: "Marketplace chứa plugin Job Matching — tìm job phù hợp với target + CV.",
+      version: "1.2.0"
+    },
+    plugins: [
+      {
+        name: "job-matching",
+        source: "./job-matching-plugin",
+        description: "Tìm và xếp hạng job phù hợp nhất với target + CV. Song ngữ Việt–Anh.",
+        version: "1.2.0"
+      }
+    ]
+  };
+
+  writeFileSync(
+    join(marketplaceDest, "marketplace.json"),
+    JSON.stringify(marketplace, null, 2) + "\n"
+  );
+  ok("Tạo .claude-plugin/marketplace.json");
+
+  copyDir(PLUGIN_SRC, pluginDest);
+  ok("Copy job-matching-plugin/ (skills, schemas, agents, commands)");
+
+  log("");
+  info("Mở Claude Code terminal rồi chạy:");
+  log(`   ${CYAN}/plugin marketplace add .${RESET}`);
+  log(`   ${CYAN}/plugin install job-matching${RESET}`);
+  log(`   ${CYAN}/find-jobs path/to/CV.pdf${RESET}`);
+}
+
+function setupCodex() {
+  heading("Codex CLI");
+
+  const pluginDest = join(CWD, "job-matching-plugin");
+  copyDir(PLUGIN_SRC, pluginDest);
+  ok("Copy job-matching-plugin/ (skills, schemas, .codex-plugin)");
+
+  log("");
+  info("Chạy Codex:");
+  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.`);
+}
+
+function setupChatgpt() {
+  heading("ChatGPT");
+
+  const dest = join(CWD, "job-matching-chatgpt");
+  ensureDir(dest);
+
+  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)");
+  }
+
+  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`);
+}
+
+function runSetup(platform) {
+  log(`${BOLD}🔧 JobMatching 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`);
+    process.exit(1);
+  }
+
+  heading("Xong!");
+  log(`Repo: ${DIM}https://github.com/hieutrong512/JobMatching${RESET}`);
+}
+
+if (!command || command === "help" || command === "--help" || command === "-h") {
+  log(HELP);
+} else if (command === "setup") {
+  runSetup(process.argv[3]);
+} else {
+  warn(`Lệnh "${command}" không tồn tại.`);
+  log(HELP);
+  process.exit(1);
+}

package/chatgpt/GPT-INSTRUCTIONS.md

@@ -0,0 +1,103 @@
+# 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

@@ -0,0 +1,72 @@
+# 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

@@ -0,0 +1,58 @@
+{
+  "$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

@@ -0,0 +1,48 @@
+{
+  "$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" }
+  }
+}