ai-developer-skill-os 9.3.1 → 10.2.0

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

@@ -1,372 +0,0 @@
----
-# ── Identity ───────────────────────────────────────────────
-name: qk-project-bootstrap
-version: 9.2.0
-status: stable
-description: "Khởi tạo dự án mới HOẶC setup DEV_PROFILE.md cho dự án đang chạy — auto-detect stack từ manifest files, không hỏi lại những gì đã có thể đọc được. Dùng skill này khi user nhắc đến: khởi tạo dự án, project setup, scaffold, bootstrap, new app, setup dev profile, detect stack, cấu hình skin — kể cả khi chỉ nói 'bắt đầu dự án mới'."
-platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
-
-# ── Classification ─────────────────────────────────────────
-type: capability
-
-intent:
-  - project-initialization
-  - dev-profile-setup
-  - stack-detection
-  - scaffolding
-
-complexity:
-  level: high
-  criteria:
-    files_affected: "10+"
-    has_behavior_change: false
-    has_external_dependency: false
-    has_breaking_change: false
-
-triggers:
-  - "khởi tạo dự án"
-  - "project setup"
-  - "scaffold"
-  - "bootstrap"
-  - "new app"
-  - "setup dev profile"
-  - "detect stack"
-  - "cấu hình skin"
-
-# ── References ─────────────────────────────────────────────
-workflow: feature-delivery
-
-rules:
-  - global
-  - safety
-
-tools:
-  - filesystem
-  - terminal
-
-related_skills:
-  - qk-context-loader   # Load sau khi DEV_PROFILE.md đã được tạo
-
-knowledge_scope:
-  owns:
-    - project-structure
-    - dev-profile-setup
-    - stack-detection
-  references:
-    - architecture
-    - security
-
-# ── Verification ───────────────────────────────────────────
-verification:
-  required: true
-  strategy: bootstrap
-
-examples: []
-learnings: []
-
-# ── Runtime ────────────────────────────────────────────────
-execution_mode: deterministic
-cost: low
-latency: fast
-risk: low
-side_effects: create_files
-produces: [dev-profile, scaffold]
-consumes: [manifest-files, user-description]
-
-token_budget:
-  max_files_read: 10
-  max_lines_per_read: 80
-  max_shell_commands: 2
-  stop_early: true
-
-exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
----
-
-# qk-project-bootstrap — Project Setup & Stack Detection
-
-> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
-
----
-
-## Preconditions
-
-Trước khi khởi tạo dự án hoặc setup DEV_PROFILE.md, AI BẮT BUỘC kiểm tra:
-
-- [ ] Xác định thư mục root của dự án.
-- [ ] Kiểm tra xem thư mục có file manifest nào tồn tại không (`package.json`, `requirements.txt`, `go.mod`, `Cargo.toml`, v.v.) để chọn Mode A (dự án mới) hay Mode B (dự án hiện có).
-- [ ] Kiểm tra xem `.agents/DEV_PROFILE.md` đã tồn tại chưa. Nếu đã có và user không yêu cầu ghi đè:
-  → **EXIT: PARTIAL**
-  → Đề xuất cập nhật hoặc giữ nguyên thay vì overwrite toàn bộ.
-
----
-
-## Hai chế độ hoạt động
-
-**Mode A — New Project:** Tạo project mới từ đầu theo Blueprint template
-**Mode B — Existing Project:** Scan project đang có, detect stack, tạo/cập nhật `DEV_PROFILE.md`
-
-AI tự xác định mode dựa vào context:
-- Có `package.json` / `requirements.txt` / `go.mod` tồn tại → **Mode B**
-- Không có gì → **Mode A**
-- User nói rõ → follow user
-
----
-
-## Scope
-
-✅ Skill này làm:
-- Auto-detect tech stack từ manifest files
-- Tạo / cập nhật `.agents/DEV_PROFILE.md` với stack được detect
-- Tạo cấu trúc project theo Blueprint template đúng loại
-- Setup `.gitignore`, `.env.example`, `README.md` ban đầu
-- Gợi ý skills phù hợp với stack được detect
-
-❌ Skill này KHÔNG làm:
-- Viết business logic hay feature code
-- Setup CI/CD pipeline (→ `qk-devops-platform`)
-- Deploy hay publish (→ `qk-production-release`)
-- Viết test (→ `qk-test-engineering`)
-
----
-
-## Execution Steps — Mode B: Detect Stack cho dự án đang có
-
-> Đây là mode quan trọng nhất — dùng khi muốn setup skin cho project hiện tại.
-
-### Step 1 — Scan Manifest Files
-```
-Actions (chạy song song, đọc lần lượt từng file nếu tồn tại):
-
-JavaScript / TypeScript:
-  - package.json          → dependencies, devDependencies, scripts
-  - tsconfig.json         → strict mode, paths, target
-  - .nvmrc / .node-version → Node version
-
-Python:
-  - requirements.txt / requirements/*.txt
-  - pyproject.toml (poetry/pdm sections)
-  - setup.py / setup.cfg
-  - Pipfile
-
-Go:
-  - go.mod                → module name, Go version, dependencies
-
-Rust:
-  - Cargo.toml
-
-Java / Kotlin:
-  - pom.xml / build.gradle / build.gradle.kts
-
-Data / AI:
-  - dbt_project.yml       → dbt version, profile
-  - airflow.cfg / dag folder structure
-  - mlflow.yml / kedro.yml
-  - .env.example          → DB_URL, OPENAI_API_KEY hints
-
-Infrastructure:
-  - docker-compose.yml    → services (db type, cache, queue)
-  - Dockerfile            → base image → language + version
-  - .github/workflows/    → CI tools
-  - terraform/ / pulumi/  → infra provider
-
-Output: raw_detected = { language, frameworks[], databases[], tools[] }
-```
-
-### Step 2 — Classify Stack
-```
-Inputs:  raw_detected
-Actions:
-  Determine role từ stack combination:
-  
-  fe:          React/Vue/Angular + NO backend framework trong cùng repo
-  be:          Express/FastAPI/NestJS/Django + NO React/Vue trong cùng repo
-  fullstack:   Frontend framework + Backend framework TRONG CÙNG REPO
-               (Next.js = fullstack mặc định; Nuxt = fullstack mặc định)
-  data:        dbt / Airflow / Spark / Dagster / Prefect / Pandas heavy
-  ai-engineer: LangChain / LlamaIndex / OpenAI SDK + vector DB
-  devops:      Terraform / Pulumi / GitHub Actions heavy, ít application code
-  
-  Nếu ambiguous → default: fullstack, ghi chú để user confirm
-
-  Map dependencies → specific stack fields:
-  
-  frontend:  next → "Next.js", nuxt → "Nuxt 3", react (no next) → "React",
-             vue → "Vue 3", angular → "Angular", svelte → "SvelteKit"
-  backend:   express → "Express", fastapi → "FastAPI", nestjs → "NestJS",
-             django → "Django", laravel → "Laravel", gin → "Gin (Go)"
-  database:  pg/postgres → "PostgreSQL", mysql → "MySQL",
-             mongodb → "MongoDB", sqlite → "SQLite",
-             supabase → "Supabase", prisma → also check schema.prisma
-  orm:       prisma → "Prisma", typeorm → "TypeORM", drizzle → "Drizzle",
-             sqlalchemy → "SQLAlchemy", sequelize → "Sequelize"
-  css:       tailwind → "Tailwind CSS", sass/scss → "SCSS",
-             styled-components → "Styled Components", @emotion → "Emotion"
-  state:     zustand → "Zustand", redux → "Redux Toolkit",
-             jotai → "Jotai", pinia → "Pinia", @tanstack/query → "React Query"
-  auth:      next-auth/auth.js → "NextAuth", clerk → "Clerk",
-             passport → "Passport.js", supabase/auth → "Supabase Auth"
-  test:      jest → "Jest", vitest → "Vitest", pytest → "Pytest",
-             playwright → "Playwright", cypress → "Cypress"
-  language:  typescript in deps → "TypeScript", python → "Python",
-             go.mod exists → "Go"
-
-Output: classified_stack = fully mapped stack object
-```
-
-### Step 3 — Tạo / Cập nhật DEV_PROFILE.md
-```
-Inputs:  classified_stack, detected role
-Actions:
-  - Đọc DEV_PROFILE.md hiện tại nếu tồn tại (không overwrite những gì user đã điền)
-  - Điền các field detect được, giữ nguyên field user đã điền tay
-  - Để trống những field không detect được (không đoán mò)
-  - Thêm comment "# auto-detected" sau mỗi giá trị được detect
-  - Nếu có conflict giữa detected và existing → giữ existing, ghi chú
-
-Output: .agents/DEV_PROFILE.md được điền đầy đủ phần detect được
-```
-
-### Step 4 — Report & Suggest Next Steps
-```
-Actions:
-  - Hiển thị detected stack summary cho user confirm
-  - List những field còn trống cần user điền tay
-  - Suggest 3 skills phù hợp nhất để bắt đầu với stack này
-  - Suggest conventions dựa trên stack (ví dụ: Next.js → feature-based folder)
-```
-
----
-
-## Execution Steps — Mode A: New Project
-
-### Blueprint Types
-
-**Type 1: Standard Web App** (fe / be / fullstack)
-```
-Cấu trúc:
-  src/
-  ├── features/          # Feature-based modules
-  ├── components/        # Shared UI components  
-  ├── lib/               # Utilities, helpers
-  ├── hooks/             # Custom React hooks (nếu React)
-  ├── types/             # TypeScript interfaces
-  ├── api/               # API layer / service functions
-  └── config/            # App configuration
-
-Files sinh ra:
-  .gitignore, .env.example, README.md,
-  DESIGN.md (placeholder), .agents/DEV_PROFILE.md (pre-filled)
-```
-
-**Type 2: RAG / AI Agent** (ai-engineer)
-```
-Cấu trúc (4-folder chuẩn):
-  prompts/               # System prompts, few-shot examples
-  data/
-  ├── raw/               # Source data — KHÔNG bao giờ edit
-  ├── processed/         # Cleaned, chunked
-  └── embeddings/        # Vector representations
-  agents/                # Agent definitions, tool configs
-  evals/
-  ├── traces/            # Execution logs
-  ├── datasets/          # Golden Q&A sets
-  └── scorecards/        # Metric definitions
-
-Files sinh ra:
-  .gitignore (data/raw/, .env), .env.example,
-  README.md, .agents/DEV_PROFILE.md (ai-engineer role pre-filled)
-```
-
-**Type 3: Data Pipeline** (data)
-```
-Cấu trúc:
-  dags/ / pipelines/     # DAG definitions
-  models/
-  ├── staging/           # Raw → cleaned
-  ├── intermediate/      # Business transforms
-  └── mart/              # Final analytics tables
-  tests/                 # Data quality tests
-  docs/                  # Data lineage docs
-  seeds/                 # Static reference data
-
-Files sinh ra:
-  .gitignore, .env.example, README.md,
-  dbt_project.yml (nếu dbt), .agents/DEV_PROFILE.md (data role)
-```
-
-**Type 4: DevOps / Platform** (devops)
-```
-Cấu trúc:
-  .github/workflows/     # CI/CD pipelines
-  terraform/ / pulumi/   # IaC modules
-  scripts/               # Automation scripts
-  docs/
-  ├── runbooks/          # Incident response
-  └── architecture/      # System diagrams
-
-Files sinh ra:
-  .gitignore, .env.example, README.md,
-  .agents/DEV_PROFILE.md (devops role)
-```
-
----
-
-## Prompt Template
-
-```
-Mode:    [new / existing / profile-only]
-Role:    [fe / be / fullstack / data / ai-engineer / devops — hoặc "auto-detect"]
-Name:    [Tên project]
-Mô tả:  [1-2 câu app làm gì]
-Stack:   [Nếu biết rồi — hoặc để trống để AI detect]
-```
-
----
-
-### Ví dụ theo từng tình huống:
-
-**Tình huống 1 — Dự án đang có, muốn setup DEV_PROFILE nhanh**
-```
-Mode:    existing
-Role:    auto-detect
-Name:    (đọc từ project)
-```
-→ AI scan `package.json`, detect `Next.js + Prisma + Tailwind + TypeScript`,
-  điền DEV_PROFILE.md với `role: fullstack`, toàn bộ stack fields,
-  gợi ý: "Tiếp theo dùng `qk-feature-delivery` để build feature đầu tiên".
-
-**Tình huống 2 — Dự án mới Fullstack**
-```
-Mode:    new
-Role:    fullstack
-Name:    ecommerce-platform
-Mô tả:  Nền tảng thương mại điện tử B2C — quản lý sản phẩm, đơn hàng, thanh toán
-Stack:  Next.js 14 + Prisma + PostgreSQL + Tailwind + TypeScript
-```
-→ AI tạo: folder structure theo Standard Web App blueprint,
-  `.env.example` với `DATABASE_URL`, `NEXTAUTH_SECRET`, `STRIPE_SECRET_KEY`,
-  `README.md` với setup instructions, `DEV_PROFILE.md` pre-filled.
-
-**Tình huống 3 — Setup RAG pipeline**
-```
-Mode:    new
-Role:    ai-engineer
-Name:    internal-kb-assistant
-Mô tả:  Q&A bot trả lời từ tài liệu nội bộ công ty (PDF, Confluence)
-Stack:  OpenAI GPT-4o + pgvector + LangChain + FastAPI
-```
-→ AI tạo: 4-folder AI structure, `prompts/system.txt` placeholder,
-  `evals/scorecards/rag_metrics.yml` template (faithfulness, relevance, groundedness),
-  `DEV_PROFILE.md` với `role: ai-engineer`, full `data_stack` filled.
-
-**Tình huống 4 — Data pipeline mới**
-```
-Mode:    new
-Role:    data
-Name:    sales-analytics
-Mô tả:  Pipeline load sales data từ Salesforce → BigQuery, build mart cho dashboard
-Stack:  dbt + Airflow + BigQuery + Python
-```
-→ AI tạo: dbt project structure (staging/intermediate/mart),
-  `dbt_project.yml`, Airflow DAG folder, `DEV_PROFILE.md` với `role: data`,
-  full `data_stack` (pipeline: "dbt + Airflow", warehouse: "BigQuery").

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

@@ -1,23 +0,0 @@
-# Auto-generated from SKILL.md frontmatter
-schema_version: 1
-id: "qk-project-bootstrap"
-version: "9.1.0"
-description: "Khởi tạo dự án mới theo chuẩn V8.2 Blueprint Plugin Generator (project.yaml, 4-folder AI RAG hoặc Coding) với cấu trúc kiên cường."
-tools:
-  - "filesystem"
-  - "terminal"
-knowledge:
-  owns:
-    - "project-structure"
-    - "initial-setup"
-  references:
-    - "architecture"
-    - "security"
-    - "anti-patterns"
-eval:
-  scorecard: "evals/scorecard.yaml"
-decision_boundary:
-  owns:
-    - "qk-project-bootstrap"
-  does_not_own: []
-  conflicts_with: []

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

@@ -1,28 +0,0 @@
-name: qk-project-bootstrap-eval
-description: Đánh giá chất lượng khởi tạo dự án V8.2 Blueprint
-version: 9.1.0
-threshold: 85 # Đảm bảo cấu trúc kiến trúc được thiết lập chuẩn xác ngay từ đầu
-
-metrics:
-  - id: blueprint_selection
-    name: Lựa chọn Blueprint phù hợp
-    description: Chọn đúng Blueprint và Manifest project.yaml tương ứng chưa?
-    weight: 35
-    criteria:
-      - Nhận diện đúng loại hình dự án (Coding, RAG/AI, Workflow) và áp dụng Blueprint cấu trúc thư mục phù hợp (15đ)
-      - Tạo ra file project.yaml chứa manifest của workspace (20đ)
-
-  - id: mandatory_files_scaffolding
-    name: Cấu trúc thư mục và File bắt buộc
-    description: Cây thư mục có thiếu các file quản lý chất lượng lõi không?
-    weight: 40
-    criteria:
-      - Sinh đúng kiến trúc (Ví dụ: 4-folder architecture cho AI RAG) (20đ)
-      - Đảm bảo đầy đủ các files chống thoái hóa: DESIGN.md, security.md, anti-patterns.md, scorecard.yaml (20đ)
-
-  - id: tooling_configuration
-    name: Cấu hình Công cụ (Tooling)
-    description: Môi trường có được thiết lập strict type và linter chưa?
-    weight: 25
-    criteria:
-      - Các cấu hình (tsconfig, eslint, prettier) được thiết lập chặt chẽ, không dễ dãi (25đ)

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

@@ -1,202 +0,0 @@
----
-# ── Identity ───────────────────────────────────────────────
-name: qk-project-health
-version: 9.2.0
-status: stable
-description: "Kiểm toán toàn diện sức khỏe dự án: đo lường Code Smells, Technical Debt, độ phức tạp Cyclomatic, God files, vi phạm SOLID — chấm điểm Health Score (0–100) và đề xuất lộ trình cải tiến. Dùng skill này khi user nhắc đến: audit project, code smell, tech debt, health check, project score, nợ kỹ thuật, kiểm tra sức khỏe code, đánh giá chất lượng dự án — kể cả khi chỉ nói 'xem thử project này nợ kỹ thuật nhiều không' — KHÔNG dùng cho phân tích tính khả thi hay gap analysis trước khi code (dùng qk-project-audit)."
-platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
-
-# ── V9: Classification ─────────────────────────────────────
-type: utility
-
-intent:
-  - project-audit
-  - codebase-health
-  - tech-debt-analysis
-
-complexity:
-  level: high
-  criteria:
-    files_affected: "10+"
-    has_behavior_change: false
-    has_external_dependency: false
-    has_breaking_change: false
-
-triggers:
-  - "audit project"
-  - "code smell"
-  - "tech debt"
-  - "health check"
-  - "project score"
-  - "nợ kỹ thuật"
-  - "kiểm tra sức khỏe code"
-  - "đánh giá chất lượng dự án"
-
-
-# ── V8: References ─────────────────────────────────────────
-workflow: code-review
-
-rules:
-  - global
-  - coding
-
-tools:
-  - filesystem
-  - terminal
-
-related_skills:
-  - qk-code-review
-  - qk-refactor
-  - qk-security-audit
-
-knowledge_scope:
-  owns:
-    - tech-debt
-    - codebase-health
-    - code-metrics
-  references:
-    - architecture
-    - security
-    - anti-patterns
-
-# ── V8: Verification ───────────────────────────────────────
-verification:
-  required: true
-  strategy: review
-
-selection:
-  priority: medium
-  confidence_threshold: 0.75
-
-examples: []
-learnings: []
-
-# ── V7 Runtime ─────────────────────────────────────────────
-execution_mode: deterministic
-cost: high
-latency: slow
-risk: low
-side_effects: read_only
-produces: [report]
-consumes: [source-code]
-
-token_budget:
-  max_files_read: 12
-  max_lines_per_read: 150
-  max_shell_commands: 2
-  stop_early: true
-
-exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
----
-
-# qk-project-health — Codebase Health Auditor & Tech Debt Evaluator
-
-> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
-
-Chịu trách nhiệm kiểm toán độc lập chất lượng toàn diện của codebase, đo lường nợ kỹ thuật (Technical Debt) theo các ngưỡng định lượng chuẩn hóa (R-C-09 & R-C-10), chấm điểm **Health Score (0–100)** và cung cấp lộ trình tái cấu trúc khả thi.
-
----
-
-## Preconditions
-
-Trước khi tiến hành kiểm toán sức khỏe:
-
-- [ ] Xác định rõ phạm vi kiểm toán: Toàn bộ codebase (Full repository) hay Module / Thư mục cụ thể.
-- [ ] Đọc file conventions trong `.agents/DEV_PROFILE.md` để đánh giá đúng tiêu chuẩn dự án.
-- [ ] Nếu codebase chưa có source code hoặc chỉ có file khởi tạo rỗng:
-  → **EXIT: BLOCKED**
-  → Báo cáo: "Dự án chưa đủ mã nguồn để đánh giá chỉ số nợ kỹ thuật."
-
----
-
-## Scope
-
-✅ Skill này làm:
-- Quét các vi phạm số liệu kỹ thuật (Metric thresholds theo R-C-10):
-  - Function dài quá 40 dòng.
-  - File dài quá 300 dòng (God files).
-  - Nesting depth vượt quá 3 tầng.
-  - Cyclomatic complexity ước tính > 10.
-- Phát hiện các Code Smells kinh điển: Duplicated logic (vi phạm DRY), Dead code, Magic numbers/strings, Any-casting lạm dụng, Silent error swallowing (`catch {}` rỗng).
-- Đánh giá kiến trúc: Circular dependencies, vi phạm phân tầng (e.g. Controller truy cập trực tiếp DB, UI chứa business calculation).
-- Chấm điểm **Health Score (0–100)** phân bổ theo 4 trục:
-  - Architecture Consistency (25đ)
-  - Maintainability & Clean Code (25đ)
-  - Testability & Reliability (25đ)
-  - Hygiene & Security Practice (25đ)
-- Lập bảng danh mục nợ kỹ thuật xếp hạng ưu tiên (P0: Nguy hiểm, P1: Cần refactor sớm, P2: Nợ nhỏ).
-
-❌ Skill này KHÔNG làm:
-- Trực tiếp sửa đổi code của người dùng (`side_effects: read_only`).
-- Audit chuyên sâu lỗ hổng bảo mật CVE (thuộc `qk-security-audit`).
-- Tối ưu truy vấn SQL cụ thể (thuộc `qk-db-optimizer`).
-
----
-
-## Execution Steps
-
-### Step 1 — Quét tĩnh & Phân tích Kích thước (Size & Structure Scan)
-```
-Inputs:  Workspace files
-Actions:
-  - Thống kê các file có độ dài lớn nhất (> 300 dòng).
-  - Tìm kiếm các file gom quá nhiều trách nhiệm (God components / God services).
-  - Liệt kê các hàm vượt quá 40 dòng.
-Outputs: Danh sách các điểm nóng về kích thước (Hotspots)
-```
-
-### Step 2 — Phát hiện Code Smells & Vi phạm Tiêu chuẩn
-```
-Actions:
-  - Grep các mẫu vi phạm:
-    - Empty catch blocks / Silent error suppression.
-    - `as any` hoặc `@ts-ignore` tràn lan.
-    - Console.log / print debug bị bỏ quên.
-    - Magic strings / Magic numbers trong logic điều kiện.
-  - Kiểm tra tính gắn kết của modules (Cohesion & Coupling).
-Outputs: Bảng thống kê các lỗi Code Smell theo mức độ nghiêm trọng
-```
-
-### Step 3 — Chấm điểm Health Score định lượng (Rubric 0–100)
-```
-Cách tính điểm:
-  100 Điểm Gốc
-  - Trừ 2đ cho mỗi God file (>300 lines) (Max trừ 20đ).
-  - Trừ 1đ cho mỗi hàm quá dài (>40 lines) (Max trừ 15đ).
-  - Trừ 3đ cho mỗi vi phạm Silent error hoặc IDOR/Any (Max trừ 20đ).
-  - Trừ 5đ nếu thiếu hoàn toàn Unit test hoặc cấu trúc phân tầng bị đảo lộn (Max trừ 25đ).
-  - Trừ 2đ cho mỗi block logic trùng lặp rõ ràng (Max trừ 20đ).
-Outputs: Điểm số Health Score (Ví dụ: 74/100)
-```
-
-### Step 4 — Lập Báo cáo Kiểm toán & Lộ trình Cải tiến
-```
-Format báo cáo:
-  1. HEALTH SCORE: XX/100 (Rating: Critical / Warning / Good / Excellent)
-  2. EXECUTIVE SUMMARY: 3 điểm mạnh & 3 vấn đề lớn nhất.
-  3. HOTSPOT AUDIT: Bảng danh sách files & lines cần xử lý.
-  4. ACTIONABLE ROADMAP:
-     - [P0] Fix ngay: Các điểm nghẽn nghiêm trọng có nguy cơ gây crash/leak.
-     - [P1] Sprint tới: Tách God files và hàm phức tạp (gợi ý dùng `qk-refactor`).
-     - [P2] Tech debt backlog: Dọn dẹp magic constants và dead code.
-```
-
----
-
-## Prompt Template
-
-```
-Scope:        [Toàn bộ dự án / Thư mục src/services / Module checkout]
-Trọng tâm:    [Đo lường nợ kỹ thuật / Chuẩn bị refactor lớn / Đánh giá code định kỳ]
-Ngưỡng mong muốn: [Muốn đạt tối thiểu bao nhiêu điểm]
-```
-
-### Ví dụ theo Nhu cầu:
-
-**Audit toàn diện dự án chuẩn bị mở rộng tính năng**
-```
-Scope:        Toàn bộ repo
-Trọng tâm:    Tìm các file có độ phức tạp cao và kiến trúc lộn xộn trước khi scale.
-```
-→ AI quét toàn bộ source code, xuất báo cáo Health Score kèm danh sách Top 5 God Files cần tách trước khi implement tính năng mới.
-

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

@@ -1,23 +0,0 @@
-# Auto-generated from SKILL.md frontmatter
-schema_version: 1
-id: "qk-project-health"
-version: "9.1.0"
-description: "Kiểm toán toàn diện Code Smells, Tech Debt, Architecture — health score 0–100 với actionable roadmap."
-tools:
-  - "filesystem"
-  - "terminal"
-knowledge:
-  owns:
-    - "tech-debt"
-    - "codebase-health"
-  references:
-    - "architecture"
-    - "security"
-    - "anti-patterns"
-eval:
-  scorecard: "evals/scorecard.yaml"
-decision_boundary:
-  owns:
-    - "qk-project-health"
-  does_not_own: []
-  conflicts_with: []

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

@@ -1,27 +0,0 @@
-name: qk-project-health-eval
-description: Đánh giá năng lực Kiểm toán toàn diện sức khỏe Codebase
-version: 9.1.0
-threshold: 85 # Đảm bảo chấm điểm công tâm và vạch ra Roadmap cải thiện rõ ràng
-
-metrics:
-  - id: five_dimensions_scoring
-    name: Chấm điểm 5 Phương diện (5 Dimensions)
-    description: Đánh giá toàn diện 5 yếu tố cốt lõi của codebase chưa?
-    weight: 40
-    criteria:
-      - Quét và tính điểm đầy đủ 5 phương diện: Security, Code Quality, Architecture, Dependencies, Documentation (20đ)
-      - Có bằng chứng (Evidence) cho các vi phạm bị trừ điểm (20đ)
-
-  - id: security_and_antipatterns
-    name: Quét Bảo mật (R-SEC-04) và Anti-patterns (R-C-09)
-    description: Agent có tìm ra các lỗ hổng bảo mật hoặc rác mã nghiêm trọng không?
-    weight: 30
-    criteria:
-      - Tìm thấy hardcoded secrets, eval(), hoặc vi phạm kiến trúc (God files, circular deps) nếu có (30đ)
-
-  - id: actionable_roadmap
-    name: Roadmap Tái cấu trúc thực tiễn
-    description: Báo cáo có vạch ra con đường sửa chữa rõ ràng không?
-    weight: 30
-    criteria:
-      - Output không chỉ chê bai mà còn sắp xếp các vấn đề theo độ ưu tiên (CRITICAL sửa trước) để team fix (30đ)