ai-developer-skill-os 9.3.1 → 10.1.0

package/.agents/skills/qk-validation-gate/evals/scorecard.yaml

@@ -1,26 +0,0 @@
-name: qk-validation-gate-eval
-description: Đánh giá Cổng kiểm tra Chất lượng V8.2
-version: 9.1.0
-threshold: 100 # Phải đạt 100 điểm tuyệt đối vì đây là lưới rà soát cuối cùng trước khi Release
-
-metrics:
-  - id: threshold_enforcement
-    name: Thi hành Threshold nghiêm ngặt
-    description: Agent có bỏ qua lỗi Lint, Type check hoặc Test coverage không?
-    weight: 40
-    criteria:
-      - Chặn đứng (FAILED) ngay lập tức nếu Lint error > 0, Type error > 0, hoặc Coverage < 80% (40đ)
-
-  - id: quantitative_eval_execution
-    name: Đánh giá định lượng AI (Eval Pipeline)
-    description: Có đọc và áp dụng scorecard.yaml để chấm điểm AI agent output không?
-    weight: 35
-    criteria:
-      - Áp dụng rubric để chấm điểm và từ chối kết quả nếu tổng điểm < Threshold (35đ)
-
-  - id: trace_verification
-    name: Xác minh Trace (Zero Hallucination)
-    description: Có đối chiếu kết quả với file log traces thực tế không?
-    weight: 25
-    criteria:
-      - Bắt buộc kiểm tra dấu vết (traces) thực thi để đảm bảo AI không tự bịa ra kết quả test (25đ)

package/.agents/skills/qk-web-quality-gate/SKILL.md

@@ -1,197 +0,0 @@
----
-# ── Identity ───────────────────────────────────────────────
-name: qk-web-quality-gate
-version: 9.2.0
-status: experimental
-description: "Đo lường chất lượng kỹ thuật Web: Accessibility violations (WCAG), Core Web Vitals, Lighthouse score, SEO tags, security headers. Output là số đo và lỗi kỹ thuật cụ thể. Dùng skill này khi user nhắc đến: a11y, accessibility, wcag, lighthouse, core web vitals, seo audit, page speed, performance score, security headers — KHÔNG dùng cho review thiết kế UI hay spacing."
-platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
-
-# ── V9: Classification ─────────────────────────────────────
-type: capability
-
-intent:
-  - web-performance
-  - accessibility
-  - seo
-  - lighthouse
-  - ux-audit
-
-complexity:
-  level: high
-  criteria:
-    files_affected: "1-5"
-    has_behavior_change: false
-    has_external_dependency: true
-    has_breaking_change: false
-
-triggers:
-  - "a11y"
-  - "accessibility"
-  - "wcag"
-  - "lighthouse"
-  - "core web vitals"
-  - "seo audit"
-  - "page speed"
-  - "performance score"
-  - "security headers"
-
-
-# ── V8: References ─────────────────────────────────────────
-workflow: feature-delivery
-
-rules:
-  - global
-  - coding
-
-tools:
-  - filesystem
-  - terminal
-
-related_skills:
-  - qk-ui-audit
-  - qk-ui-builder
-
-knowledge_scope:
-  domain:
-    - web-performance
-    - web-accessibility
-  concepts:
-    - lighthouse
-    - seo
-    - ux-heuristics
-  references:
-    - architecture
-
-decision_boundary:
-  owns:
-    - lighthouse audit
-    - accessibility review
-    - performance audit
-    - seo audit
-  does_not_own:
-    - ui component implementation
-  conflicts_with: []
-
-# ── V8: Verification ───────────────────────────────────────
-verification:
-  required: true
-  strategy: web-quality-review
-
-selection:
-  priority: medium
-  confidence_threshold: 0.80
-
-examples: []
-learnings: []
-
-# ── V7 Runtime ─────────────────────────────────────────────
-execution_mode: deterministic
-cost: medium
-latency: slow
-risk: low
-side_effects: read_only
-produces: [report]
-consumes: [user-description, source-code]
-
-token_budget:
-  max_files_read: 5
-  max_lines_per_read: 150
-  max_shell_commands: 2
-  stop_early: true
-
-exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
----
-
-# qk-web-quality-gate — Web Quality, A11y & Performance Auditor
-
-> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
-
-Chịu trách nhiệm đo lường và đánh giá các chỉ số chất lượng kỹ thuật của ứng dụng Web: **Accessibility (WCAG 2.1 AA) → Core Web Vitals (LCP, FID/INP, CLS) → SEO meta tags → Security Headers**. Xuất báo cáo định lượng và chỉ dẫn khắc phục cụ thể.
-
----
-
-## Preconditions
-
-Trước khi audit chất lượng web, AI BẮT BUỘC kiểm tra:
-
-- [ ] Xác định trang hoặc component web cần kiểm tra.
-- [ ] Xác định frontend framework và rendering method (SSR, SSG, CSR, Next.js, Nuxt) từ `.agents/DEV_PROFILE.md`.
-- [ ] Đảm bảo có thể truy cập mã nguồn template HTML / JSX để đọc semantic tags.
-- [ ] Nếu trang hoàn toàn là client-side SPA mà không có mã nguồn cấu trúc DOM:
-  → **EXIT: BLOCKED**
-  → Báo cáo user cung cấp URL môi trường staging hoặc file mã nguồn template tương ứng.
-
----
-
-## Scope
-
-✅ Skill này làm:
-- Kiểm toán Accessibility (A11y theo chuẩn WCAG 2.1 AA):
-  - Semantic HTML (`<main>`, `<nav>`, `<header>`, `<h1>-<h6>` thứ tự đúng).
-  - ARIA attributes (`aria-label`, `aria-expanded`, `aria-hidden`, `role`).
-  - Keyboard navigation (tab order, focus trap trong modals, skip links).
-  - Alt text cho hình ảnh và caption cho media.
-- Phân tích Core Web Vitals & Performance:
-  - LCP (Largest Contentful Paint): Tối ưu hóa ảnh (next/image, webp, priority loading).
-  - CLS (Cumulative Layout Shift): Khai báo width/height cho hình ảnh, placeholder cho ad slots.
-  - INP/FID: Tối ưu bundle size, dynamic imports / code-splitting.
-- Kiểm tra SEO Technical: Title tag, Meta description, OpenGraph tags, Canonical link, Robots/Sitemap.
-- Kiểm tra HTTP Security Headers khuyến nghị: CSP, X-Frame-Options, HSTS.
-
-❌ Skill này KHÔNG làm:
-- Đánh giá tính thẩm mỹ hoặc spacing thị giác (→ `qk-ui-audit`).
-- Tự viết component UI mới từ đầu (→ `qk-ui-builder`).
-- Thiết lập hạ tầng CDN hoặc server proxy Nginx/Cloudflare (→ `qk-devops-platform`).
-
----
-
-## Execution Steps
-
-### Step 1 — Semantic & A11y DOM Inspection
-```
-Inputs:  Page/Component source code
-Actions:
-  - Kiểm tra tính hợp lệ của cây phân cấp headings (h1 -> h2 -> h3, không nhảy cóc).
-  - Soát tất cả thẻ `<img>` thiếu `alt` hoặc thẻ tương tác (`<button>`, `<a>`) thiếu text/aria-label.
-  - Kiểm tra form inputs có gắn kèm `<label>` tường minh hay không.
-Output: A11y violation list
-```
-
-### Step 2 — Performance & Core Web Vitals Analysis
-```
-Inputs:  Asset imports, Rendering architecture
-Actions:
-  - Kiểm tra cách load font chữ (font-display: swap) và CSS render-blocking.
-  - Phát hiện các ảnh dung lượng lớn chưa được responsive srcset hoặc nén modern formats (AVIF/WebP).
-  - Đánh giá chiến lược lazy-loading cho các components nằm dưới màn hình đầu tiên (below the fold).
-Output: Web Vitals bottleneck map
-```
-
-### Step 3 — SEO & Security Header Audit
-```
-Inputs:  HTML Head configuration, Next.js metadata / Nuxt useHead
-Actions:
-  - Soát độ dài Title (50-60 ký tự) và Description (150-160 ký tự).
-  - Kiểm tra cấu hình thẻ mạng xã hội (og:image, og:title, twitter:card).
-  - Đánh giá Content Security Policy (CSP).
-Output: SEO & Security posture report
-```
-
-### Step 4 — Remediation Guide Formulation
-```
-Inputs:  Findings across all categories
-Actions:
-  - Tổng hợp thành bảng điểm định lượng và phân loại độ ưu tiên (P0: Blockers, P1: High, P2: Polish).
-  - Cung cấp đoạn code JSX/HTML sửa mẫu trực quan.
-Exit: SUCCESS
-```
-
----
-
-## Prompt Template
-
-```
-Trang / URL:       [Đường dẫn file page hoặc route URL cần kiểm tra]
-Trọng tâm audit:   [A11y WCAG / Core Web Vitals / SEO Technical / Tất cả]
-Vấn đề ghi nhận:   [Chậm tải trang, lighthouse điểm đỏ, cảnh báo screen reader, ...]
-```

package/.agents/skills/qk-web-quality-gate/capability.yaml

@@ -1,24 +0,0 @@
-# Auto-generated from SKILL.md frontmatter
-schema_version: 1
-id: "qk-web-quality-gate"
-version: "9.1.0"
-description: "Kiểm toán tổng thể chất lượng Web: Accessibility (A11y), SEO, Web Performance, Security, UX Heuristics."
-tools:
-  - "filesystem"
-  - "terminal"
-knowledge:
-  owns:
-    - "qk-web-quality-gate"
-  references:
-    - "architecture"
-eval:
-  scorecard: "evals/scorecard.yaml"
-decision_boundary:
-  owns:
-    - "lighthouse audit"
-    - "accessibility review"
-    - "performance audit"
-    - "seo audit"
-  does_not_own:
-    - "ui component implementation"
-  conflicts_with: []

package/.agents/skills/qk-web-quality-gate/evals/scorecard.yaml

@@ -1,26 +0,0 @@
-name: qk-web-quality-gate-eval
-description: Đánh giá chất lượng tổng thể của Web (Performance, SEO, A11y, UX)
-version: 9.1.0
-threshold: 85 # Đảm bảo đo lường đầy đủ 4 trục chất lượng của ứng dụng Web
-
-metrics:
-  - id: core_web_vitals_focus
-    name: Phân tích Core Web Vitals
-    description: Có đánh giá đúng các chỉ số ảnh hưởng đến trải nghiệm (LCP, CLS, INP) không?
-    weight: 40
-    criteria:
-      - Báo cáo rõ ràng về kích thước Bundle, chiến lược Lazy loading và tối ưu hình ảnh (40đ)
-
-  - id: seo_and_accessibility
-    name: Kiểm tra SEO & A11y
-    description: Web có thân thiện với bot tìm kiếm và người khuyết tật không?
-    weight: 35
-    criteria:
-      - Quét Semantic HTML, Meta tags, và các rào cản truy cập ARIA (35đ)
-
-  - id: actionable_recommendations
-    name: Khuyến nghị thực tiễn (Actionable)
-    description: Các đề xuất tối ưu có khả thi để lập trình viên thực hiện ngay không?
-    weight: 25
-    criteria:
-      - "Không chỉ ra lỗi chung chung mà chỉ định rõ cách fix (ví dụ: Thêm loading='lazy' vào thẻ img dòng 15) (25đ)"

package/.agents/workflows/research.yml

@@ -1,75 +0,0 @@
-name: research
-version: 8.0.0
-description: "Pipeline nghiên cứu codebase để hiểu context, dependency, và architecture trước khi thực hiện task lớn."
-
-owner:
-  type: engineering
-  maintained_by: qk-team
-
-verification_profile: review
-
-triggers:
-  - "how does this work"
-  - "tìm hiểu codebase"
-  - "explore this repo"
-  - "nghiên cứu"
-  - "explain the architecture"
-  - "trace dependency"
-
-ide_binding:
-  slash_command: "/research"
-  aliases: ["/explore", "/explain"]
-
-steps:
-  - id: define_scope
-    name: "Xác định phạm vi nghiên cứu"
-    purpose: "Biết chính xác cần tìm hiểu gì để phục vụ task"
-    required: true
-    skip_if: null
-    inputs:
-      - research_goal    # What decision does this research enable?
-    outputs:
-      - research_questions   # Specific questions to answer
-      - entry_points         # Files to start reading
-    exit_on_fail: BLOCKED
-
-  - id: explore
-    name: "Khám phá codebase"
-    purpose: "Thu thập thông tin đủ để trả lời research questions"
-    required: true
-    skip_if: null
-    inputs:
-      - entry_points
-      - research_questions
-    outputs:
-      - findings           # Answers to research questions
-      - dependency_map     # How components relate
-      - relevant_files     # Files most relevant to the task
-    context_budget: 100
-    actions:
-      - "Dùng grep_search để tìm patterns, không đọc toàn bộ repo"
-      - "Đọc targeted sections (≤ 100 lines per read)"
-      - "Build mental model của dependency relationship"
-
-  - id: synthesize
-    name: "Tổng hợp kết quả"
-    purpose: "Trả lời research questions + tạo context cho task tiếp theo"
-    required: true
-    skip_if: null
-    inputs:
-      - findings
-      - dependency_map
-    outputs:
-      - context_summary      # Ready-to-use context for next skill
-      - architecture_notes   # Key patterns và conventions
-      - warnings             # Gotchas, deprecated patterns, risks
-    actions:
-      - "Viết summary ngắn gọn (không cần exhaustive)"
-      - "Flag các pattern cũ/deprecated nếu thấy"
-      - "Báo cáo mọi pattern vi phạm R-SEC-04 nếu thấy"
-      - "Ghi log execution trace vào evals/traces/"
-      - "Liệt kê relevant files để task tiếp theo load"
-
-escalation:
-  max_retries: 1
-  on_failure: "Report partial findings với confidence level"

package/.agents/workflows/skill-evolution.yml

@@ -1,97 +0,0 @@
-name: skill-evolution
-version: 8.0.0
-description: "Workflow vòng lặp tiến hóa và tối ưu hóa skill (Skill Evolution)."
-
-owner:
-  type: engineering
-  maintained_by: qk-team
-
-verification_profile: skill-evolution
-
-triggers:
-  - "improve this skill"
-  - "tối ưu skill"
-  - "why does this skill keep failing"
-  - "optimize this workflow"
-  - "phân tích usage skill"
-
-ide_binding:
-  slash_command: "/evolve-skill"
-  aliases: ["/skill-tune"]
-
-steps:
-  - id: observe_usage
-    name: "Observe Usage"
-    purpose: "Theo dõi cách skill được sử dụng"
-    required: true
-    inputs:
-      - skill_logs
-    outputs:
-      - usage_metrics
-    actions:
-      - "Thống kê trigger rate và token usage"
-
-  - id: measure_success
-    name: "Measure Success"
-    purpose: "Đánh giá tỷ lệ thành công"
-    required: true
-    inputs:
-      - usage_metrics
-      - execution_results
-    outputs:
-      - success_rate
-    actions:
-      - "Xác định các lần exit SUCCESS vs FAILED/PARTIAL"
-
-  - id: detect_failure
-    name: "Detect Failure Patterns"
-    purpose: "Phát hiện lý do thất bại"
-    required: true
-    inputs:
-      - execution_results
-    outputs:
-      - failure_patterns
-    actions:
-      - "Phân tích log lỗi, hallucination, out of budget"
-
-  - id: improve_skill
-    name: "Improve Skill"
-    purpose: "Đề xuất tối ưu skill"
-    required: true
-    inputs:
-      - failure_patterns
-      - skill_body
-    outputs:
-      - improved_skill_proposal
-    actions:
-      - "Giảm noise trong instruction"
-      - "Cập nhật examples và learnings"
-      - "Tinh chỉnh token budget"
-
-  - id: validate_improvement
-    name: "Validate Improvement"
-    purpose: "Xác thực bản nâng cấp"
-    required: true
-    inputs:
-      - improved_skill_proposal
-    outputs:
-      - validation_result
-    actions:
-      - "Chạy qua validate-skills.js"
-      - "Đảm bảo skill không vi phạm R-C-09"
-      - "Kiểm tra schema compliance"
-
-  - id: promote
-    name: "Promote Skill"
-    purpose: "Đưa bản cải tiến vào sử dụng"
-    required: true
-    inputs:
-      - validation_result
-    outputs:
-      - stable_skill
-    actions:
-      - "Chuyển status thành stable"
-
-escalation:
-  max_retries: 1
-  on_failure: "Hủy bỏ bản cải tiến nếu validation thất bại"

package/tooling/fix-refactor.js

@@ -1,8 +0,0 @@
-const fs = require('fs');
-
-const skillMd = `---\nname: qk-refactor\nversion: 8.0.0\nstatus: stable\ndescription: "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."\nplatforms: [antigravity, claude-code, cursor, windsurf, kilo-code]\n\ntype: capability\n\nintent:\n  - refactoring\n  - code-cleanup\n  - complexity-reduction\n\ncomplexity:\n  level: medium\n  criteria:\n    files_affected: "2-5"\n    has_behavior_change: false\n    has_external_dependency: false\n    has_breaking_change: false\n\ntriggers:\n  - refactor\n  - tái cấu trúc\n  - clean up this code\n  - simplify\n  - reduce complexity\n  - dẫn cấu trúc code\n\nselection:\n  priority: medium\n  confidence_threshold: 0.80\n\nworkflow: refactor\n\nrules:\n  - global\n  - coding\n  - safety\n\ntools:\n  - filesystem\n  - terminal\n\nrelated_skills:\n  - qk-engineering-standard\n  - qk-project-health\n\nknowledge_scope:\n  owns:\n    - refactoring-patterns\n    - code-smells\n  references:\n    - architecture\n    - coding-standards\n\nverification:\n  required: true\n  strategy: refactor\n\nexamples: []\nlearnings: []\n\nexecution_mode: deterministic\ncost: medium\nlatency: medium\nrisk: medium\nside_effects: edit_files\nproduces: [code, report]\nconsumes: [source-code]\n\ntoken_budget:\n  max_files_read: 3\n  max_lines_per_read: 150\n  max_shell_commands: 2\n  stop_early: true\n\nexit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]\n---\n\n# qk-refactor - Safe Refactor\n\n> Language rule: Code, identifiers, file names → English. Explanations, summaries → Vietnamese.\n\n## Preconditions\n- [ ] Target file(s) or module(s) are specified\n- [ ] Tests exist for the target code (or can be created)\n\nOn missing precondition:\n  EXIT: BLOCKED\n  Message: "Missing: target files or test coverage"\n\n## Scope\n- Improve internal code quality without changing external behavior\n- Reduce complexity, improve naming, extract functions\n- Remove dead code and duplication\n\n## Non-Goals\n- Add new functionality\n- Change public API signatures\n- Modify behavior or business logic\n\n## Workflow\n1. Establish baseline (current behavior + tests)\n2. Plan refactor steps\n3. Execute step by step\n4. Verify behavior unchanged\n5. Run validation gate\n\n## Exit Codes\n| Code | Meaning |\n|------|---------|\n| SUCCESS | Refactor complete, behavior preserved, tests pass |\n| PARTIAL | Refactor done, some tests need attention |\n| BLOCKED | Missing preconditions |\n| FAILED | Behavior changed or tests broken |\n`;
-
-const capYaml = `schema_version: 1\nid: "qk-refactor"\nversion: "8.0.0"\ndescription: "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."\ndependencies:\n  - "refactor"\ntools:\n  - "filesystem"\n  - "terminal"\nknowledge:\n  owns:\n    - "refactoring-patterns"\n    - "code-smells"\n  references:\n    - "architecture"\n    - "coding-standards"\neval:\n  scorecard: "evals/scorecard.yaml"\ndecision_boundary:\n  owns:\n    - "refactoring-patterns"\n  does_not_own:\n    - "new-functionality"\n    - "api-changes"\n  conflicts_with: []\n  delegates_to: []\n`;\n
-fs.writeFileSync('.agents/skills/qk-refactor/SKILL.md', skillMd, 'utf8');
-fs.writeFileSync('.agents/skills/qk-refactor/capability.yaml', capYaml, 'utf8');
-console.log('Written qk-refactor files with correct UTF-8 encoding');