jobscout 1.2.0

package/job-matching-plugin/AGENTS.md

@@ -0,0 +1,55 @@
+# JobMatching — Codex plugin
+
+Thư mục này **là một plugin dùng được ở CẢ Codex lẫn Claude Code** (dual-manifest):
+`.codex-plugin/plugin.json` là manifest Codex, `.claude-plugin/plugin.json` là manifest Claude —
+dùng CHUNG `skills/`, `schemas/`. Mục tiêu: tìm và xếp hạng job phù hợp nhất với
+**target** + **CV** của ứng viên, song ngữ Việt–Anh. Lấy dữ liệu job qua **Search Engine + web scraping**
+(tool `web_search` của Codex — không cần API key).
+
+> Đường dẫn tham chiếu trong skill (`schemas/…`, `scripts/…`) là **tương đối so với plugin root**
+> (thư mục chứa file này). Trên Claude Code có thể dùng biến `${CLAUDE_PLUGIN_ROOT}`; trên Codex dùng
+> đường dẫn tương đối như hiện tại.
+
+## Thành phần plugin
+
+- **Skills** (`skills/*/SKILL.md`): `find-jobs` (điều phối full pipeline), `candidate-intake`,
+  `scoring-rubric`, `job-schema`, `bilingual-normalization`, `fit-analyzer`, `application-assistant`.
+- **Agents** (`agents/*.md` cho Claude; skills `job-collector`/`job-matcher` cho Codex):
+  chạy context riêng cho các bước tốn token (search/scrape, chấm điểm bulk).
+- **Schemas** (`schemas/*.json`): data contracts profile / job / match.
+
+## Bật web search
+
+Bước collect cần tool `web_search`. Bật một trong hai:
+- `codex --search`
+- hoặc trong `~/.codex/config.toml`: `tools.web_search = true`
+
+## Pipeline
+
+```
+CV + Target
+   │  [1] candidate-intake (skill)   → data/profiles/<slug>.json
+   ▼
+   │  [2] job-collector (agent)      → data/jobs/<run-id>.json   (Job boards, tối đa 20)
+   ▼
+   │  [3] job-matcher (agent)        → data/results/<run-id>.shortlist.json
+   ▼
+   │  [4] fit-analyzer (skill)       → data/results/<run-id>.fit_report.md
+   ▼
+   [5] application-assistant (skill, tùy chọn) → CV bullets / cover letter / tin nhắn tiếp cận HR
+```
+
+`<run-id>` = ngày hiện tại (YYYY-MM-DD). Dữ liệu chạy ghi vào `data/` trong thư mục làm việc.
+
+## Trọng số chấm điểm (mặc định)
+
+skills 35% · seniority 20% · domain 15% · compensation 15% · location 5% · culture 5%
+→ override qua `target.priorities` trong profile (chuẩn hóa tổng = 1).
+
+## Nguyên tắc vận hành (bắt buộc)
+
+- **Tiêu chuẩn thu thập**: Quét từ job boards chính thống (ITviec, TopCV, VietnamWorks, LinkedIn). Chỉ giữ job xem được full JD và còn hạn; snippet-only / hết hạn / 404-410 → bỏ.
+- **Không bịa** trường dữ liệu job/CV. Thiếu → `unknown`, hạ `confidence` (không chấm 0 mù quáng).
+- Giữ nguyên **đơn vị lương gốc** theo JD; chỉ quy đổi khi so sánh (tỉ giá $1 = 26.100 VND).
+- Tôn trọng robots.txt/ToS; **không vượt anti-bot/CAPTCHA**.
+- **Không tự nộp hồ sơ / gửi email / gửi tin nhắn** thay người dùng.

package/job-matching-plugin/README.md

@@ -0,0 +1,84 @@
+# Job Matching Plugin
+
+Plugin Claude Code giúp **tìm và xếp hạng job phù hợp nhất với target + CV** của ứng viên. Xử lý song ngữ Việt–Anh, lấy dữ liệu job qua Search Engine + Web scraping (không cần API key).
+
+## Cài đặt
+
+Thêm marketplace rồi cài plugin (trong phiên `claude` tương tác):
+
+```bash
+/plugin marketplace add <đường-dẫn-hoặc-git-repo-này>
+```
+
+```bash
+/plugin install job-matching
+```
+
+> Marketplace nằm ở `.claude-plugin/marketplace.json` tại gốc repo; plugin nằm trong `job-matching-plugin/`.
+
+## Cách dùng
+
+Nhanh nhất — chạy full pipeline bằng slash command:
+
+```bash
+/find-jobs D:\path\to\CV.pdf
+```
+
+Hoặc gọi từng bước bằng ngôn ngữ tự nhiên (skill tự kích hoạt): "parse CV này", "tìm job cho tôi", "chấm điểm các job", "làm báo cáo fit".
+
+## Pipeline
+
+```
+CV + Target
+   │  candidate-intake (skill)
+   ▼  → data/profiles/<slug>.json
+job-collector (subagent)        ← Job boards (tối đa 20)
+   ▼  → data/jobs/<run-id>.json
+job-matcher (subagent)          ← chấm điểm theo scoring-rubric
+   ▼  → data/results/<run-id>.shortlist.json
+fit-analyzer (skill)            ← báo cáo fit/gap, mọi job có link nộp CV
+   ▼  → data/results/<run-id>.fit_report.md
+application-assistant (skill, tùy chọn) ← tailor CV/cover letter & tin nhắn tiếp cận HR
+```
+
+## Thành phần
+
+| Thành phần | Loại | Vai trò |
+|---|---|---|
+| `find-jobs` | Command | Điều phối toàn bộ pipeline |
+| `candidate-intake` | Skill | Parse CV + target → profile.json |
+| `job-collector` | Agent | Search + scrape từ Job boards → jobs.json |
+| `job-matcher` | Agent | Chấm điểm & rank → shortlist.json |
+| `fit-analyzer` | Skill | Báo cáo fit/gap (link nộp CV cho mọi job) |
+| `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 (nền tảng) |
+| `job-schema` | Skill | Schema chuẩn cho job (kèm contact) |
+| `bilingual-normalization` | Skill | Chuẩn hóa skill/chức danh/lương Việt–Anh |
+
+## Trọng số chấm điểm (mặc định)
+
+skills 35% · seniority 20% · domain 15% · compensation 15% · location 5% · culture 5%
+→ Ứng viên override được qua `target.priorities` trong profile.
+
+## Yêu cầu môi trường
+
+`WebSearch` / `WebFetch` cho Job boards là tool sẵn có của Claude Code — không cần cấu hình.
+
+## Dữ liệu
+
+- **Định nghĩa** (agents/skills/schemas) nằm trong plugin.
+- **Dữ liệu chạy** (`data/profiles`, `data/jobs`, `data/results`) ghi trong thư mục làm việc của người dùng, không nằm trong plugin.
+
+## Kiểm tra
+
+```bash
+cd job-matching-plugin
+python -m unittest discover -s tests -v
+python -m compileall -q -f tests
+```
+
+## Ghi chú vận hành
+
+- **Tiêu chuẩn thu thập**: Quét từ các trang tuyển dụng chính thống (ITviec, TopCV, VietnamWorks, LinkedIn), chỉ giữ job xem được full JD và còn hạn.
+- Giữ nguyên đơn vị lương gốc theo JD; chỉ quy đổi khi so sánh (tỉ giá $1 = 26.100 VND).
+- Tôn trọng robots.txt/ToS; không vượt anti-bot/CAPTCHA; không tự nộp hồ sơ / gửi tin nhắn thay người dùng.

package/job-matching-plugin/agents/job-collector.md

@@ -0,0 +1,40 @@
+---
+name: job-collector
+description: Thu thập tin tuyển dụng từ Search Engine + Web scraping dựa trên profile ứng viên, chuẩn hóa về job.schema.json. Dùng sau khi có profile.json và cần tìm job. Chạy trong context riêng vì tốn nhiều lượt search/fetch.
+tools: WebSearch, WebFetch, Read, Write, Glob
+model: sonnet
+---
+
+# Job Collector — thu thập & chuẩn hóa job
+
+Nhiệm vụ: từ `profile.json`, tìm và chuẩn hóa danh sách job → `data/jobs/<run-id>.json` (mảng object theo `${CLAUDE_PLUGIN_ROOT}/schemas/job.schema.json`).
+
+## Quy trình
+
+### 1. Thu thập từ Job Boards & Search Engine
+Từ `target.desired_roles`, `desired_level`, `locations`, top skills, tạo nhiều biến thể query **song ngữ**:
+- **Job boards VN**: `site:itviec.com`, `site:topcv.vn`, `site:vietnamworks.com`, `site:careerviet.vn`, và `site:linkedin.com/jobs`.
+- Dùng `WebSearch` cho từng query, gom URL + snippet.
+- Khử trùng theo URL chuẩn hóa. Ưu tiên tin còn hạn / mới đăng.
+
+### 3. Fetch & extract
+- `WebFetch` URL job để lấy **full JD** (không chỉ snippet). Tôn trọng robots.txt/ToS. Trang chặn/cần JS render → thử browser.
+- Phải xem được nội dung đầy đủ (`extraction_confidence ≥ 0.5`) và **còn hạn ứng tuyển** (bỏ qua nếu 404/410, "job đã hết hạn / expired", deadline đã qua).
+- **Bóc tách thông tin liên hệ** (nếu JD có): lưu vào trường `contact` (email, phone, how_to_apply).
+- **Không** vượt anti-bot/CAPTCHA.
+
+### 4. Chuẩn hóa
+- Áp skill `job-schema` để map vào schema; áp `bilingual-normalization` cho skills/location/lương.
+- Tạo `id` hash ổn định để khử trùng across nguồn.
+- Set `extraction_confidence` trung thực (full JD cao: 0.8-1.0).
+
+### 5. Ghi kết quả
+- Ghi mảng job hợp lệ vào `data/jobs/<run-id>.json`.
+- Trả về tóm tắt: số job thu được, số bị bỏ (chặn/lỗi), cảnh báo dữ liệu thiếu.
+
+## Nguyên tắc
+- **Chỉ giữ job xem được full JD & còn hạn**.
+- Ưu tiên độ chính xác hơn số lượng; không nhồi job không liên quan.
+- Không bịa trường dữ liệu (xem job-schema). Thiếu → unknown.
+- `url` phải là link trang tuyển dụng — luôn có mặt cho mọi job.
+- **Mục tiêu số lượng: tối đa 20 job** hợp lệ. Nếu sau khi lọc còn dư, mở rộng query để đủ ~20; nếu ít hơn, nêu rõ lý do.

package/job-matching-plugin/agents/job-matcher.md

@@ -0,0 +1,37 @@
+---
+name: job-matcher
+description: Chấm điểm và xếp hạng các job đã thu thập so với profile ứng viên theo scoring-rubric, tạo shortlist. Dùng sau job-collector. Chạy context riêng vì chấm điểm bulk tốn token.
+tools: Read, Write, Glob
+model: sonnet
+---
+
+# Job Matcher — chấm điểm & xếp hạng
+
+Nhiệm vụ: đọc `profile.json` + `data/jobs/<run-id>.json`, chấm điểm từng job, tạo `data/results/<run-id>.shortlist.json`.
+
+## Quy trình
+
+### 1. Nạp dữ liệu & trọng số
+- Đọc profile và mảng job.
+- Xác định trọng số: dùng `target.priorities` nếu có (chuẩn hóa tổng = 1), ngược lại dùng mặc định của `scoring-rubric`.
+
+### 2. Chấm điểm từng job
+Áp **skill `scoring-rubric`** cho mỗi job:
+- Bước 0: hard filter dealbreakers → excluded nếu vi phạm.
+- Chấm 6 chiều (skills, seniority, domain, location, compensation, culture).
+- Chuẩn hóa skill/lương bằng `bilingual-normalization` trước khi so khớp.
+- Tính overall_score, recommendation, confidence.
+- Tạo object theo `${CLAUDE_PLUGIN_ROOT}/schemas/match.schema.json`, kèm tham chiếu job (id, title, company, url, salary, location) để fit-analyzer dùng ngay.
+
+### 3. Khử trùng & xếp hạng
+- Gộp job trùng `id` (giữ bản extraction_confidence cao hơn).
+- Sắp theo overall_score giảm dần; excluded xuống cuối (hoặc tách riêng).
+
+### 4. Ghi kết quả
+- Ghi `data/results/<run-id>.shortlist.json`: mảng {match, job_ref} đã sắp xếp.
+- Trả tóm tắt: phân bố recommendation (strong/good/maybe/weak/excluded), top 5, gap phổ biến, số match confidence thấp cần xác minh.
+
+## Nguyên tắc
+- Nhất quán: luôn theo scoring-rubric, ghi `weights_used` cho minh bạch.
+- Không exclude vì thiếu dữ liệu — hạ confidence thay vì loại.
+- Trung thực về điểm; không thổi phồng để có nhiều "strong".

package/job-matching-plugin/commands/find-jobs.md

@@ -0,0 +1,41 @@
+---
+description: Chạy full pipeline tìm việc — parse CV, thu thập job, chấm điểm, xuất báo cáo fit/gap.
+argument-hint: [đường dẫn CV hoặc tên profile]
+---
+
+# /find-jobs — Điều phối pipeline tìm việc
+
+Chạy tuần tự 4 bước. `$ARGUMENTS` là đường dẫn CV (PDF/DOCX/text) hoặc tên profile đã có.
+
+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 thư mục `data/profiles`, `data/jobs`, `data/results` trong thư mục làm việc nếu chưa có.
+
+## Bước 1 — Intake (skill `candidate-intake`)
+- Nếu `$ARGUMENTS` là file CV → parse và tạo `data/profiles/<slug>.json`.
+- Nếu là tên profile đã tồn tại → dùng lại, hỏi xem 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, ưu tiên (priorities → trọng số), dealbreakers.
+- Tóm tắt cho người dùng xác nhận.
+
+## Bước 2 — Collector (subagent `job-collector`)
+- Truyền đường dẫn `profile.json`, `data/jobs/<run-id>.json` (output).
+- **Nguồn Job Boards**: Quét từ ITviec, TopCV, VietnamWorks, LinkedIn... (WebSearch + WebFetch).
+- Giữ job theo chuẩn: chỉ giữ job xem được full JD & còn hạn. Mục tiêu tối đa 20 job hợp lệ.
+
+## Bước 3 — Matcher (subagent `job-matcher`)
+- 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`.
+- Ghi `data/results/<run-id>.shortlist.json`.
+
+## Bước 4 — Fit report (skill `fit-analyzer`)
+- Đọc shortlist → tạo `data/results/<run-id>.fit_report.md`.
+- **Phân tích chi tiết TẤT CẢ job trong shortlist** (nếu >20 thì chi tiết 20 job điểm cao nhất, phần còn lại vẫn liệt kê đủ trong bảng). **KHÔNG rút gọn báo cáo chỉ còn top 3.**
+- Có thể đánh dấu thêm nhóm "Ưu tiên apply ngay" ở đầu, nhưng đó là phần bổ sung — không thay thế phần phân tích chi tiết từng job bên dưới.
+- **Mọi job trong bảng xếp hạng đều có link nộp CV / bài post bấm được.**
+- Gửi 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/job-matching-plugin/docs/claude-runtime-notes.md

@@ -0,0 +1,69 @@
+# JobMatching — plugin dual-manifest (Claude Code + Codex)
+
+Thư mục `job-matching-plugin/` **là một plugin dùng được ở CẢ Claude Code lẫn Codex**: tìm và xếp
+hạng job phù hợp nhất với **target** và **CV** của ứng viên, song ngữ Việt–Anh. Lấy dữ liệu job qua
+**Search Engine + web scraping** (tool `WebSearch`/`WebFetch` trên Claude, `web_search` trên Codex —
+không cần API key).
+
+## Bố cục repo
+
+- `.claude-plugin/marketplace.json` (gốc repo) — marketplace Claude, trỏ tới plugin `./job-matching-plugin`.
+- `job-matching-plugin/` — **nguồn chân lý duy nhất** của plugin (dùng chung cho cả hai hệ):
+  - `.claude-plugin/plugin.json` — manifest Claude.
+  - `.codex-plugin/plugin.json` — manifest Codex (khai báo `skills`).
+  - `docs/claude-runtime-notes.md` / `AGENTS.md` — hướng dẫn cho Claude / Codex.
+  - `commands/find-jobs.md` — slash command `/find-jobs` (Claude). Trên Codex dùng `skills/find-jobs/SKILL.md`.
+  - `skills/*/SKILL.md` — dùng chung: `find-jobs`, `candidate-intake`, `scoring-rubric`, `job-schema`,
+    `bilingual-normalization`, `fit-analyzer`, `application-assistant`.
+  - `agents/*.md` (Claude); Codex dùng skills `job-collector`, `job-matcher` trong generic subagent.
+  - `schemas/*.json` — data contracts profile / job / match.
+  - `tests/*.py` — unit test cho tính toàn vẹn plugin.
+- `data/` — dữ liệu chạy trong thư mục làm việc (được gitignore phần nhạy cảm).
+
+> Không tạo bản sao skill/agent thứ hai ở gốc repo. Skill dùng chung viết trung lập tên tool
+> (`WebSearch`/`WebFetch` cho Claude, `web_search` cho Codex) để một nguồn phục vụ cả hai hệ.
+
+## Bật web search
+
+`WebSearch` / `WebFetch` là tool sẵn có của Claude Code — không cần cấu hình thêm.
+
+## Pipeline
+
+```
+CV + Target
+   │  [1] candidate-intake (skill)   → data/profiles/<slug>.json
+   ▼
+   │  [2] job-collector (subagent)   → data/jobs/<run-id>.json   (Job boards, tối đa 20)
+   ▼
+   │  [3] job-matcher (subagent)     → data/results/<run-id>.shortlist.json
+   ▼
+   │  [4] fit-analyzer (skill)       → data/results/<run-id>.fit_report.md
+   ▼
+   [5] application-assistant (skill, tùy chọn) → CV bullets / cover letter / tin nhắn tiếp cận HR
+```
+
+`<run-id>` = ngày hiện tại (YYYY-MM-DD). Dữ liệu chạy ghi vào `data/` trong thư mục làm việc.
+
+## Trọng số chấm điểm (mặc định)
+
+skills 35% · seniority 20% · domain 15% · compensation 15% · location 5% · culture 5%
+→ override qua `target.priorities` trong profile (chuẩn hóa tổng = 1).
+
+## Kiểm tra trước khi phát hành
+
+```bash
+cd job-matching-plugin
+python -m unittest discover -s tests -v
+python -m compileall -q -f tests
+```
+
+Không commit `data/profiles`, `data/jobs`, `data/results`, CV gốc (`*.pdf`/`*.docx`), log hay `__pycache__`.
+
+## Nguyên tắc vận hành (bắt buộc)
+
+- **Tiêu chuẩn thu thập**: Quét từ job boards chính thống (ITviec, TopCV, VietnamWorks, LinkedIn).
+  Chỉ giữ job xem được full JD và còn hạn; snippet-only / hết hạn / 404-410 → bỏ.
+- **Không bịa** trường dữ liệu job/CV. Thiếu → `unknown`, hạ `confidence` (không chấm 0 mù quáng).
+- Giữ nguyên **đơn vị lương gốc** theo JD; chỉ quy đổi khi so sánh (tỉ giá $1 = 26.100 VND).
+- Tôn trọng robots.txt/ToS; **không vượt anti-bot/CAPTCHA**.
+- **Không tự nộp hồ sơ / gửi email / gửi tin nhắn** thay người dùng.

package/job-matching-plugin/schemas/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/job-matching-plugin/schemas/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" }
+  }
+}

package/job-matching-plugin/schemas/profile.schema.json

@@ -0,0 +1,121 @@
+{
+  "$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/job-matching-plugin/skills/application-assistant/SKILL.md

@@ -0,0 +1,38 @@
+---
+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/job-matching-plugin/skills/bilingual-normalization/SKILL.md

@@ -0,0 +1,46 @@
+---
+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.
+