ai-developer-skill-os 9.3.0 → 10.1.0

package/.agents/skills/qk-project-memory/SKILL.md

@@ -1,303 +0,0 @@
----
-# ── Identity ───────────────────────────────────────────────
-name: qk-project-memory
-version: 9.2.0
-status: stable
-description: "Quản trị Tri thức và Bộ nhớ dự án V1 (Local Private Mode) — Quản lý tại .ai-local/ như source code: tự động khởi tạo, bảo mật gitignore, có thể review, cập nhật và luôn có con người phê duyệt. Dùng skill này khi user nhắc đến: lưu context, project memory, ghi nhớ, /learn, lưu vào bộ nhớ, nhớ lại, tìm lại fact, lưu tri thức dự án — kể cả khi chỉ nói 'nhớ lại lỗi này để sau không mắc lại'."
-platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
-
-# ── V9: Classification ─────────────────────────────────────
-type: utility
-
-intent:
-  - context-management
-  - knowledge-retrieval
-  - project-learning
-
-complexity:
-  level: medium
-  criteria:
-    files_affected: "1-2"
-    has_behavior_change: false
-    has_external_dependency: false
-    has_breaking_change: false
-
-triggers:
-  - "lưu context"
-  - "project memory"
-  - "ghi nhớ"
-  - "/learn"
-  - "lưu vào bộ nhớ"
-  - "nhớ lại"
-  - "tìm lại fact"
-  - "lưu tri thức dự án"
-
-# ── V9: References ─────────────────────────────────────────
-workflow: documentation
-
-rules:
-  - global
-  - coding
-
-tools:
-  - filesystem
-
-related_skills:
-  - qk-context-loader
-  - qk-docs
-
-knowledge_scope:
-  owns:
-    - project-facts
-    - verified-context
-    - patterns
-    - hard-bugs
-  references:
-    - architecture
-    - convention
-    - pattern
-    - hard-bug
-
-# ── V9: Verification ───────────────────────────────────────
-verification:
-  required: true
-  strategy: human-approval
-
-selection:
-  priority: high
-  confidence_threshold: 1.0
-
-examples: []
-learnings: []
-
-# ── Runtime ─────────────────────────────────────────────
-execution_mode: deterministic
-cost: low
-latency: fast
-risk: low
-side_effects: edit_files
-produces: [knowledge-update]
-consumes: [source-code, task-outcome]
-
-token_budget:
-  max_files_read: 3
-  max_lines_per_read: 150
-  max_shell_commands: 0
-  stop_early: true
-
-exit_codes: [SUCCESS, BLOCKED, DISMISSED, FAILED]
----
-
-# qk-project-memory — Project Knowledge Management V1
-
-> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
-
-> **Kim chỉ nam tối thượng:** *"Knowledge phải được quản lý giống như source code: đơn giản, có thể xem xét (review), có thể cập nhật, có thể loại bỏ và luôn có con người chịu trách nhiệm phê duyệt."*
-
----
-
-## Preconditions
-
-Trước khi đọc hoặc ghi vào bộ nhớ dự án:
-
-- [ ] Kiểm tra xem thư mục `.ai-local/` đã tồn tại chưa:
-  - Nếu **chưa có**: Tự động tạo `.ai-local/AGENTS.md` và `.ai-local/knowledge/index.yaml` (Self-Init Protocol), đồng thời đảm bảo `.ai-local/` đã nằm trong `.gitignore`.
-- [ ] Xác định thao tác: **Tra cứu (Retrieve)** hay **Học/Ghi nhớ (/learn)**.
-- [ ] Với thao tác Ghi nhớ: Tri thức BẮT BUỘC phải thuộc 1 trong 4 danh mục cốt lõi:
-  1. `Architecture` (Cấu trúc nền tảng)
-  2. `Convention` (Quy ước viết code bất di bất dịch)
-  3. `Pattern` (Mẫu giải pháp lặp lại nhiều bước)
-  4. `Hard Bug` (Lỗi tốn nhiều thời gian xử lý)
-- [ ] Nếu là lỗi typo, format CSS vặt vãnh, hoặc CRUD tầm thường:
-  → **EXIT: DISMISSED** (Bỏ qua để giữ sạch bộ nhớ).
-
----
-
-## Scope
-
-✅ Skill này làm:
-- Khởi tạo và duy trì bộ nhớ cục bộ an toàn tại `.ai-local/` (tách biệt khỏi git commit chung).
-- Tra cứu nhanh các quyết định kiến trúc, patterns và cách fix bug cũ trước khi giải quyết task mới.
-- Đề xuất bản thảo tri thức mới (Draft Proposal) dưới chuẩn YAML súc tích.
-- Xin phê duyệt rõ ràng từ lập trình viên (Human Approval Gate) trước khi lưu vĩnh viễn.
-- Lưu vết lịch sử theo cơ chế Zero-Overwrite (Chuyển trạng thái cũ sang `Archived` thay vì xóa mất dữ liệu).
-
-❌ Skill này KHÔNG làm:
-- Tự động ghi ngầm tri thức mà không có sự đồng ý của con người.
-- Lưu trữ nhật ký hội thoại ("Hôm nay user bảo làm X...").
-- Dùng đường dẫn tuyệt đối máy cá nhân (`C:/...`, `D:/...`).
-- Thay thế mã nguồn thật (Memory chỉ là Navigator hỗ trợ định vị).
-
----
-
-## 1. Chế Độ Lưu Trữ Local Private & Tự Động Khởi Tạo (Self-Init Protocol)
-
-Tri thức dự án V1 được chuẩn hóa duy nhất dưới chế độ **Local Private Mode** nhằm đảm bảo an toàn bảo mật riêng tư, tránh nhầm lẫn và không xâm phạm Git chính của team:
-
-### Cấu Trúc Bộ Nhớ (.ai-local/)
-```text
-.ai-local/
-├── AGENTS.md            ──> Bản đồ dự án (< 100 dòng)
-├── knowledge/
-│     └── index.yaml     ──> Kho tri thức 4 lĩnh vực
-└── candidates/          ──> Kho lưu Candidate Memory tạm thời
-```
-- **Tự động Khởi tạo (Self-Init) & Gitignore Bắt Buộc:**
-  - Bất cứ khi nào kích hoạt kỹ năng hoặc khi cần tra cứu/lưu trữ tri thức mà thư mục `.ai-local/` chưa tồn tại trong gốc dự án, AI **BẮT BUỘC** tự động tạo ngay cấu trúc thư mục này cùng các file `AGENTS.md` và `knowledge/index.yaml`.
-  - AI **BẮT BUỘC** kiểm tra file `.gitignore` của dự án, nếu chưa có dòng `.ai-local/` thì phải tự động chèn vào ngay lập tức.
-  - Tuyệt đối không dừng lại để hỏi ý kiến hay chờ phê duyệt về việc khởi tạo bộ nhớ local này. AI phải luôn chủ động để không bị bối rối về nơi tìm kiếm hay lưu trữ tri thức.
-- **Đã loại bỏ Shared Mode:** Không sử dụng hay tìm kiếm tại `.agents/knowledge/index.yaml` để thống nhất một nguồn tra cứu duy nhất từ `.ai-local/`.
-
----
-
-## 2. Tiêu Chuẩn File 1: `AGENTS.md` (Bản Đồ Dự Án)
-
-- **Giới hạn cứng:** Tuyệt đối không vượt quá **100 dòng** (được parse trong < 5 giây).
-- **Quy tắc Quick Actions:** KHÔNG ghi đường dẫn file cụ thể nếu chưa ổn định để tránh gãy link khi refactor. Nhỏ gọn trỏ tới từ khóa tra cứu trong `index.yaml`.
-
-### Mẫu Chuẩn `AGENTS.md`:
-```markdown
-> [!IMPORTANT]
-> **MEMORY NAVIGATOR:** Memory chỉ dùng để giảm thời gian tìm kiếm, không thay thế việc đọc mã nguồn hiện tại.
-
-# Architecture (~15 dòng)
-- Framework: React + TypeScript + TanStack Router
-- State/Data: Axios Instance wrapper tại `src/services/httpClient.ts`
-- UI Style: TailwindCSS / Custom Component Library
-
-# Folder Map (~20 dòng)
-- `src/routes/`: Cấu hình routing (file-based routing)
-- `src/api/`: Các dịch vụ kết nối endpoint backend
-- `src/components/`: Component sử dụng lại trong toàn dự án
-
-# Quick Actions (~30 dòng)
-- Thêm / Sửa Menu -> Tra cứu Pattern "add-menu" trong `knowledge/index.yaml`
-- Xây dựng bảng dữ liệu -> Tra cứu Pattern "data-table" trong `knowledge/index.yaml`
-- Quy tắc gọi API -> Tra cứu Convention "api-wrapper" trong `knowledge/index.yaml`
-
-# Agent Rules (~20 dòng)
-1. Luôn đọc `AGENTS.md` đầu tiên.
-2. Tra cứu `knowledge/index.yaml` trước khi dùng lệnh tìm kiếm mù toàn dự án.
-3. Hậu task: Chỉ đề xuất lưu nếu là Architecture, Convention, Pattern, hoặc Hard Bug.
-```
-
----
-
-## 3. Tiêu Chuẩn File 2: `knowledge/index.yaml` (Kho Tri Thức)
-
-### Quy Tắc Lõi:
-1. **Chỉ lưu 4 Loại Tri Thức duy nhất:**
-   - `Architecture`: Nền tảng cấu trúc lớn.
-   - `Convention`: Chuẩn mực viết code bắt buộc.
-   - `Pattern`: Quy trình hành động tái sử dụng nhiều bước.
-   - `Hard Bug`: Lỗi cực kỳ khó nhằn hoặc tốn nhiều thời gian fix (KHÔNG lưu lỗi typo, CSS lặt vặt, lỗi cú pháp tầm thường).
-2. **Chỉ lưu Hành Động:** Đổi thẻ `summary` thành `steps` cho Pattern/Convention. AI nhìn là thực thi ngay.
-3. **Hard Bug Tối Giản 3 Trường:** Chỉ giữ `cause`, `fix`, và `refs`.
-4. **Lịch Sử An Toàn (Zero-Overwrite):** Khi một tri thức thay đổi hoặc lỗi thời, KHÔNG xóa đè. Chuyển trạng thái (`status`) của cụm cũ từ `Active` sang `Archived`, sau đó chèn cụm mới với trạng thái `Active`.
-5. **Đường dẫn chuẩn thương mại:** Mọi `refs` bắt buộc dùng đường dẫn tương đối từ Root (`src/...`) và chỉ định tên Biểu tượng (Symbol/Component/Hook name), cấm dùng đường dẫn ổ đĩa tuyệt đối (`C:/...`, `D:/...`).
-
-### Mẫu Chuẩn `index.yaml`:
-```yaml
-# ==============================================================================
-# KHO TRI THỨC DỰ ÁN V1 (AI SKIN V9 ARCHITECTURE)
-# Lifecycle đơn giản: Active (Đang dùng) -> Archived (Lỗi thời/Lịch sử)
-# ==============================================================================
-
-knowledge:
-  # --- PATTERN: CÔNG DỤNG LẶP LẠI ---------
-  - id: add-menu
-    type: Pattern
-    status: Active
-    tags: [menu, navigation, sidebar, router]
-    steps:
-      - 1. Cập nhật Sidebar hoặc Router config
-      - 2. Khai báo quyền (access permissions) cho menu item mới
-      - 3. Áp dụng chuẩn API hook tương ứng
-    refs:
-      - src/routes/_app.tsx#SidebarNavigation
-      - src/config/permissions.ts#UserRoles
-
-  # --- HARD BUG: CA BỆNH KHÓ NHẰN ---------
-  - id: rerender-infinite-loop
-    type: Hard Bug
-    status: Active
-    tags: [react, use-effect, leak]
-    cause: "Fetch data trực tiếp bên trong useEffect mà dependency bị thay đổi tham chiếu liên tục"
-    fix: "Sử dụng custom hook có sẵn hoặc bọc hàm bằng useCallback trước khi truyền vào useEffect"
-    refs:
-      - src/hooks/useAutoFetch.ts
-
-  # --- CONVENTION: QUY BẰNG CẤM HOẶC BẮT BUỘC ---------
-  - id: axios-only
-    type: Convention
-    status: Active
-    steps:
-      - Cấm tuyệt đối dùng fetch() hay axios mốc rỗng
-      - Luôn import httpClient tích hợp sẵn token từ src/services/
-    refs:
-      - src/services/httpClient.ts
-```
-
----
-
-## Execution Steps — The `/learn` Lifecycle
-
-Bất kỳ lúc nào người dùng gõ `/learn`, `./qk-project-memory`, hoặc sau khi hoàn tất một task phức tạp có tham số yêu cầu ghi nhớ, Agent PHẢI tuân thủ theo 4 bước khép kín:
-
-### Bước 1: Trả lời Câu Hỏi Lọc (Filtering Question)
-AI tự hỏi và đối chiếu: *"Task/Sự kiện vừa rồi có thuộc 1 trong 4 loại (Architecture, Convention, Pattern, Hard Bug) và có giá trị giảm thời gian cho task tương lai không?"*
-- Nếu **KHÔNG** (lỗi typo, trang trí CSS, CRUD đơn giản, sửa text): Trả về `DISMISSED: "Không phát hiện tri thức kiến trúc/bug khó giá trị dài hạn. Đã bỏ qua để giữ sạch bộ nhớ."` -> **Dừng lại ngay.**
-- Nếu **CÓ**: Sang Bước 2.
-
-### Bước 2: Chuẩn Bị Bản Đề Xuất (Draft Proposal)
-AI tóm tắt nội dung tri thức dưới chuẩn đinh dạc của `index.yaml` (với 4 loại và trường `steps` / `cause-fix`).
-- Đối chiếu trong `index.yaml` xem có từ khóa/id trùng lặp hay không để chuẩn bị ghi chú `[Mới]` hoặc `[Cập nhật -> Archived cũ]`.
-
-### Bước 3: Phê Duyệt Của Con Người (Human Approval - Bắt Buộc)
-Trình bày rõ trước người dùng trên chat:
-```markdown
-💡 [AI Skin Project Memory]: Phát hiện tri thức mới đáng ghi nhớ cho dự án.
-Đề xuất ghi vào `.ai-local/knowledge/index.yaml`:
-
-... (Nội dung YAML tóm tắt) ...
-
-👉 **Bạn có muốn xác nhận cập nhật tri thức này không? (Đồng ý / Chỉnh sửa / Bỏ qua)**
-```
-
-### Bước 4: Thực Thi Cập Nhật (Commit)
-- Sau khi được Người dùng xác nhận: Dùng tool (ví dụ `replace_file_content` hoặc `write_to_file`) để chèn thông tin mới vào `index.yaml` (hoặc `AGENTS.md` nếu chỉnh sơ đồ kiến trúc).
-- Báo cáo hoàn tất chu trình Ghi nhớ!
-
----
-
-## 5. Bảng Exit Codes
-
-| Code | Ý Nghĩa | Hành Động Kế Tiếp |
-|------|---------|--------------------|
-| SUCCESS | Đã lưu hoặc đọc tri thức hợp lệ từ `index.yaml` / `AGENTS.md` | Hoàn thành |
-| BLOCKED | Đề xuất tri thức bị Người dùng từ chối (Hoặc thiếu quyền truy xuất file) | Không thay đổi bộ nhớ |
-| DISMISSED | Thao tác không thỏa mãn 4 tiêu chí lọc V1 (Chỉ là typo, css vặt) | Bỏ qua ghi nhớ nhằm sạch hệ thống |
-| FAILED | File bộ nhớ sai định dạng cú pháp YAML hoặc vi phạm giới hạn 100 dòng | Yêu cầu sửa/reset cấu trúc file |
-
----
-
-## Prompt Template
-
-```
-Lệnh:         [/learn hoặc tra cứu tri thức]
-Tri thức:     [Tóm tắt pattern, convention, kiến trúc, hoặc hard bug vừa xử lý]
-File liên quan:[Đường dẫn tương đối: vd: src/services/apiClient.ts]
-Mục đích:     [Giúp AI trong tương lai không lặp lại lỗi hoặc mở đúng file]
-```
-
-### Ví dụ thao tác:
-
-**Lưu một Hard Bug vừa xử lý xong**
-```
-Lệnh:         /learn
-Tri thức:     Hard Bug: Lỗi hydration mismatch trong Next.js do dùng new Date() trực tiếp trong component render.
-Khắc phục:    Dùng useEffect để set client date hoặc dùng thư viện suppressHydrationWarning.
-File:         src/components/HeaderClock.tsx
-```
-→ AI chuẩn bị bản draft YAML đề xuất theo chuẩn `index.yaml` và hỏi người dùng phê duyệt trước khi commit vào `.ai-local/knowledge/index.yaml`.
-

package/.agents/skills/qk-project-memory/capability.yaml

@@ -1,23 +0,0 @@
-# Auto-generated from SKILL.md frontmatter
-schema_version: 1
-id: "qk-project-memory"
-version: "9.1.0"
-description: "Lưu trữ và truy xuất ngữ cảnh dự án dài hạn — chỉ lưu fact đã xác minh, không lưu giả thuyết."
-tools:
-  - "filesystem"
-  - "terminal"
-knowledge:
-  owns:
-    - "project-facts"
-    - "verified-context"
-  references:
-    - "architecture"
-    - "security"
-    - "anti-patterns"
-eval:
-  scorecard: "evals/scorecard.yaml"
-decision_boundary:
-  owns:
-    - "qk-project-memory"
-  does_not_own: []
-  conflicts_with: []

package/.agents/skills/qk-project-memory/evals/scorecard.yaml

@@ -1,27 +0,0 @@
-name: qk-project-memory-eval
-description: Đánh giá quá trình lưu trữ và truy xuất ngữ cảnh dài hạn (Project Memory)
-version: 9.1.0
-threshold: 85 # Yêu cầu độ chính xác cao khi ghi đè hoặc lưu trữ để tránh ảo giác
-
-metrics:
-  - id: fact_verification
-    name: Chỉ lưu trữ Sự thật (Fact), không lưu Giả thuyết
-    description: Agent có kiểm chứng thông tin qua source code trước khi lưu vào Memory không?
-    weight: 40
-    criteria:
-      - Tuyệt đối không lưu các giả định (assumptions) hoặc fact có Confidence LOW (20đ)
-      - Có bằng chứng (file:line) đính kèm khi ghi dữ liệu (20đ)
-
-  - id: zero_trust_memory
-    name: An toàn dữ liệu trong Memory (Zero Trust)
-    description: Agent có vô tình lưu thông tin nhạy cảm vào Memory không?
-    weight: 35
-    criteria:
-      - KHÔNG lưu trữ PII, API Keys, raw JWTs hay credentials dưới dạng clear text (35đ)
-
-  - id: ui_diversification
-    name: Áp dụng UI Diversification
-    description: Có lưu và kiểm tra lịch sử thiết kế để tránh UI lặp lại nhàm chán không?
-    weight: 25
-    criteria:
-      - Đọc và ghi đúng vào file `ui-diversification.json` để ngăn chặn trùng lặp theme/macrostructure (25đ)

package/.agents/skills/qk-refactor/SKILL.md

@@ -1,243 +0,0 @@
----
-name: qk-refactor
-version: 9.2.0
-status: stable
-description: "Tái cấu trúc code để dễ bảo trì, dễ test hơn — không thay đổi external behavior. Dùng skill này khi user nhắc đến: refactor, tái cấu trúc, tách file, extract function/component/module, clean code, reduce complexity, file quá dài, God class, quá nhiều responsibilities — kể cả khi chỉ nói \"file này lộn xộn quá\"."
-platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
-
-type: capability
-
-intent:
-  - refactoring
-  - code-cleanup
-  - complexity-reduction
-
-complexity:
-  level: medium
-  criteria:
-    files_affected: "2-5"
-    has_behavior_change: false
-    has_external_dependency: false
-    has_breaking_change: false
-
-triggers:
-  - "refactor"
-  - "tái cấu trúc"
-  - "tách file"
-  - "extract function/component/module"
-  - "clean code"
-  - "reduce complexity"
-  - "file quá dài"
-  - "God class"
-  - "quá nhiều responsibilities"
-
-
-selection:
-  priority: medium
-  confidence_threshold: 0.80
-
-workflow: refactor
-
-rules:
-  - global
-  - coding
-  - safety
-
-tools:
-  - filesystem
-  - terminal
-
-related_skills:
-  - qk-code-review
-  - qk-project-health
-
-knowledge_scope:
-  owns:
-    - refactoring-patterns
-    - code-smells
-  references:
-    - architecture
-    - coding-standards
-
-verification:
-  required: true
-  strategy: refactor
-
-examples: []
-learnings: []
-
-execution_mode: deterministic
-cost: medium
-latency: medium
-risk: medium
-side_effects: edit_files
-produces: [code, report]
-consumes: [source-code]
-
-token_budget:
-  max_files_read: 3
-  max_lines_per_read: 150
-  max_shell_commands: 2
-  stop_early: true
-
-exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
----
-
-# qk-refactor - Safe Refactor
-
-> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
-
-Chịu trách nhiệm tái cấu trúc mã nguồn để tăng khả năng bảo trì, giảm độ phức tạp và tăng tính kiểm thử mà **TUYỆT ĐỐI KHÔNG làm thay đổi hành vi bên ngoài (External Behavior)**.
-
----
-
-## Preconditions
-
-Trước khi tái cấu trúc bất kỳ file nào, AI BẮT BUỘC kiểm tra:
-
-- [ ] Xác định rõ mục tiêu refactor (tách file, giảm cognitive complexity, khử duplication, áp dụng Design Pattern).
-- [ ] Xác định public contracts (functions, classes, API routes, props) cần giữ nguyên vẹn.
-- [ ] Kiểm tra hệ thống test hiện có: có tests để verify behavior không?
-- [ ] Nếu yêu cầu refactor kèm theo thay đổi nghiệp vụ hoặc đổi behavior:
-  → **EXIT: BLOCKED**
-  → Báo cáo user: Tách riêng việc refactor (qk-refactor) và việc đổi tính năng (qk-feature-delivery).
-
----
-
-## Scope
-
-✅ Skill này làm:
-- Trích xuất hàm, component, custom hooks hoặc helper modules (Extract method/module).
-- Giảm độ phức tạp cyclomatic (lồng if/else sâu, switch case khổng lồ).
-- Khử trùng lặp mã nguồn (DRY) mà không tạo ra over-abstraction gượng ép.
-- Tối ưu đặt tên biến, hàm theo đúng quy ước sạch (Clean Code).
-- Bảo đảm 100% backward compatibility với các consumer của module.
-
-❌ Skill này KHÔNG làm:
-- Sửa đổi business logic hoặc thay đổi đầu ra mong đợi của hệ thống.
-- Viết tính năng mới ngoài lề trong quá trình refactor.
-- Tự ý thay đổi schema cơ sở dữ liệu (→ `qk-data-lifecycle`).
-
----
-
-## Execution Steps
-
-### Step 1 — Current State & Contract Lock
-```
-Inputs:  Mã nguồn mục tiêu, Public interface
-Actions:
-  - Phân tích luồng thực thi và các điểm vào/ra (inputs/outputs, exceptions).
-  - Khóa (lock) contract công khai: không thay đổi signature của exported functions/components.
-  - Kiểm tra test coverage hiện có (nếu có).
-Output: Refactor Safety Boundary
-```
-
-### Step 2 — Incremental Transformation
-```
-Inputs:  Target code, Safety boundary
-Actions:
-  - Tách nhỏ từng phần (baby steps): trích xuất hàm con, module độc lập.
-  - Thay thế cấu trúc lồng ghép bằng Guard Clauses (early return).
-  - Di chuyển các helper/utility sang vị trí phù hợp theo kiến trúc dự án.
-Output: Refactored code
-```
-
-### Step 3 — Verification & Equivalence Check
-```
-Inputs:  Refactored code, Original tests
-Actions:
-  - Chạy linter và typecheck: 0 type errors, 0 lint warnings.
-  - Chạy tests để xác nhận tính tương đương hành vi (behavior equivalence).
-  - So sánh diff để đảm bảo không xóa nhầm logic hay import.
-Exit: SUCCESS nếu code sạch hơn, pass linter/types và giữ nguyên behavior.
-```
-
----
-
-## Prompt Template
-
-AI đọc `DEV_PROFILE.md` để biết conventions. Mô tả vấn đề — AI đọc code thật trước khi refactor.
-
-```
-Target:      [File / module / function cần refactor — đường dẫn cụ thể]
-Vấn đề:     [Code đang gây ra vấn đề gì — quá dài / khó test / lặp lại / ...]
-Mục tiêu:   [Muốn đạt được gì sau refactor]
-Giữ nguyên: [Public interface / behavior / test cases không được đổi]
-```
-
----
-
-### Theo Role — AI refactor theo chiều sâu khác nhau:
-
-**role: fe**
-```
-Target:      src/pages/CheckoutPage.tsx (380 dòng)
-Vấn đề:     Một file trộn lẫn: form state, API calls, validation, UI rendering,
-             cart calculation — không test được, không reuse được
-Mục tiêu:   Tách thành: CheckoutPage (UI) + useCheckout (logic hook) +
-             checkoutSchema (validation) + cartUtils (calculation)
-Giữ nguyên: Props interface của CheckoutPage không đổi, behavior submit không đổi
-```
-→ AI refactor: custom hook extraction pattern, co-location vs separation of concerns,
-  memoization opportunities (useMemo/useCallback), type narrowing sau khi tách.
-
-**role: be**
-```
-Target:      src/services/OrderService.ts (420 dòng)
-Vấn đề:     God class — xử lý: tạo order, tính giá, gửi email, update inventory,
-             generate invoice — vi phạm SRP, unit test không isolate được
-Mục tiêu:   Tách ra theo domain: PricingService, InventoryService, NotificationService,
-             OrderService chỉ orchestrate
-Giữ nguyên: Public method signatures của OrderService, không đổi DB transactions
-```
-→ AI refactor: dependency injection pattern, service boundary design,
-  transaction scope sau khi tách (vẫn cần atomic), interface extraction cho testability.
-
-**role: fullstack**
-```
-Target:      src/features/products/ (toàn bộ folder)
-Vấn đề:     Feature folder có: API route, DB query, FE component, type definitions
-             — tất cả trong cùng 1 file products.ts (550 dòng)
-Mục tiêu:   Feature-based architecture: products/api.ts, products/db.ts,
-             products/components/, products/types.ts, products/hooks.ts
-Giữ nguyên: Import paths của các file khác đang dùng products types
-```
-→ AI refactor: barrel exports để preserve import paths, layer separation
-  (presentation/business/data), shared types location, circular dependency check.
-
-**role: data**
-```
-Target:      transforms/order_metrics.sql (250 dòng)
-Vấn đề:     SQL monolith — một query tính tất cả metrics, không reusable,
-             debug khó, CTE lồng nhau 6 cấp
-Mục tiêu:   Tách thành dbt models: stg_orders, int_order_items, fct_order_metrics
-             Mỗi model làm đúng một việc
-Giữ nguyên: Output schema của fct_order_metrics không đổi (downstream depends on it)
-```
-→ AI refactor: dbt model layering (staging/intermediate/mart), ref() dependencies,
-  incremental model strategy, documentation + schema.yml generation.
-
-**role: ai-engineer**
-```
-Target:      agents/rag_agent.py (300 dòng)
-Vấn đề:     Monolithic RAG function — embed + retrieve + rerank + generate
-             tất cả trong 1 hàm, không thể A/B test từng component
-Mục tiêu:   Tách thành pipeline: Retriever, Reranker, Generator — mỗi class
-             có interface rõ ràng, swap được implementation
-Giữ nguyên: Input/output interface của rag_agent() không đổi
-```
-→ AI refactor: Strategy pattern cho từng pipeline stage, dependency injection
-  cho model/embedding, eval hooks tại từng stage, config-driven pipeline.
-
-**role: devops**
-```
-Target:      .github/workflows/deploy.yml (200 dòng)
-Vấn đề:     Một workflow file làm tất cả: test + build + push image + deploy staging
-             + deploy prod + notify — không reusable, khó debug khi fail
-Mục tiêu:   Tách thành reusable workflows: test.yml, build-push.yml,
-             deploy.yml (reusable), notify.yml — orchestrated từ main.yml
-Giữ nguyên: Trigger conditions và environment variables không đổi
-```
-→ AI refactor: GitHub reusable workflows pattern (workflow_call),
-  matrix strategy cho multi-env deploy, secret scoping per environment,
-  concurrency groups để tránh parallel deploys.

package/.agents/skills/qk-refactor/capability.yaml

@@ -1,26 +0,0 @@
-schema_version: 1
-id: "qk-refactor"
-version: "9.1.0"
-description: "Tái cấu trúc và dọn dẹp mã nguồn để dễ bảo trì hơn mà không làm thay đổi logic hoạt động bên ngoài."
-dependencies:
-  - "refactor"
-tools:
-  - "filesystem"
-  - "terminal"
-knowledge:
-  owns:
-    - "refactoring-patterns"
-    - "code-smells"
-  references:
-    - "architecture"
-    - "coding-standards"
-eval:
-  scorecard: "evals/scorecard.yaml"
-decision_boundary:
-  owns:
-    - "refactoring-patterns"
-  does_not_own:
-    - "new-functionality"
-    - "api-changes"
-  conflicts_with: []
-  delegates_to: []

package/.agents/skills/qk-refactor/evals/scorecard.yaml

@@ -1,27 +0,0 @@
-name: qk-refactor-eval
-description: Đánh giá an toàn và hiệu quả của tiến trình Refactor
-version: 9.1.0
-threshold: 90 # Yêu cầu an toàn rất cao, refactor không được làm hỏng tính năng
-
-metrics:
-  - id: behavior_preservation
-    name: Bảo toàn Logic (Behavior Preservation)
-    description: Tái cấu trúc có làm thay đổi logic hoạt động hoặc API public không?
-    weight: 40
-    criteria:
-      - Tuyệt đối không thêm tính năng mới trong quá trình refactor (20đ)
-      - Không thay đổi chữ ký (signature) của các public API (20đ)
-
-  - id: test_coverage_precondition
-    name: Tiền điều kiện Kiểm thử (Tests)
-    description: Agent có từ chối refactor nếu không có Tests bảo vệ không?
-    weight: 35
-    criteria:
-      - Chặn (BLOCKED) và yêu cầu viết test nếu code chưa có coverage (35đ)
-
-  - id: complexity_reduction
-    name: Giảm Độ phức tạp (Complexity Reduction)
-    description: Kết quả refactor có thực sự làm code sạch và dễ bảo trì hơn không?
-    weight: 25
-    criteria:
-      - Tách hàm, loại bỏ code chết, giảm cyclomatic complexity rõ rệt (25đ)