ai-developer-skill-os 9.3.1 → 10.2.0

package/.agents/skills/qk-devops-platform/SKILL.md

@@ -1,198 +0,0 @@
----
-# ── Identity ───────────────────────────────────────────────
-name: qk-devops-platform
-version: 9.2.0
-status: experimental
-description: "Kỹ sư nền tảng: Chiến lược CI/CD, kiến trúc triển khai, quản lý môi trường và chiến lược rollback. Dùng skill này khi user nhắc đến: ci/cd, deployment, pipeline, docker, dockerfile, devops, github actions, cấu hình ci/cd, containerize — kể cả khi chỉ nói 'viết dockerfile và pipeline deploy staging'."
-platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
-
-# ── V9: Classification ─────────────────────────────────────
-type: capability
-
-intent:
-  - devops-strategy
-  - cicd-pipeline
-  - deployment-architecture
-  - environment-management
-
-complexity:
-  level: high
-  criteria:
-    files_affected: "1-5"
-    has_behavior_change: true
-    has_external_dependency: true
-    has_breaking_change: false
-
-triggers:
-  - "ci/cd"
-  - "deployment"
-  - "pipeline"
-  - "docker"
-  - "dockerfile"
-  - "devops"
-  - "github actions"
-  - "cấu hình ci/cd"
-  - "containerize"
-
-
-# ── V8: References ─────────────────────────────────────────
-workflow: feature-delivery
-
-rules:
-  - global
-  - coding
-  - security
-
-tools:
-  - filesystem
-  - terminal
-
-related_skills:
-  - qk-production-release
-  - qk-security-audit
-
-knowledge_scope:
-  domain:
-    - devops
-    - platform-engineering
-    - cloud-infrastructure
-  concepts:
-    - continuous-integration
-    - continuous-deployment
-    - containerization
-    - rollback-strategy
-  references:
-    - architecture
-    - security
-    - anti-patterns
-
-decision_boundary:
-  owns:
-    - CI/CD strategy
-    - deployment architecture
-    - environment management
-    - rollback strategy
-  does_not_own:
-    - application code
-    - cloud billing
-    - releasing features
-  conflicts_with:
-    - qk-production-release
-
-# ── V8: Verification ───────────────────────────────────────
-verification:
-  required: true
-  strategy: feature
-
-selection:
-  priority: medium
-  confidence_threshold: 0.80
-
-examples: []
-learnings: []
-
-# ── V7 Runtime ─────────────────────────────────────────────
-execution_mode: deterministic
-cost: medium
-latency: medium
-risk: high
-side_effects: edit_files
-produces: [report, plan, code]
-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-devops-platform — Platform & CI/CD Engineer
-
-> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
-
-Chịu trách nhiệm thiết kế và cấu hình toàn diện hạ tầng CI/CD, Containerization (Docker), quản lý biến môi trường an toàn và kiến trúc triển khai với **chiến lược Rollback bắt buộc cho mọi thay đổi**.
-
----
-
-## Preconditions
-
-Trước khi thiết lập hoặc thay đổi cấu hình hạ tầng, AI BẮT BUỘC kiểm tra:
-
-- [ ] Xác định nền tảng CI/CD (GitHub Actions, GitLab CI, Bitbucket Pipelines) và môi trường runtime (Docker, Kubernetes, AWS, Vercel).
-- [ ] Xác định chiến lược secret management (GitHub Secrets, HashiCorp Vault, AWS SSM) — tuyệt đối không hardcode credentials.
-- [ ] Xác định chiến lược Rollback (Revert commit, container tag rollback, Blue/Green traffic switch).
-- [ ] Nếu không có phương án rollback hoặc phát hiện secret bị lộ trong file cấu hình:
-  → **EXIT: BLOCKED**
-  → Từ chối tạo cấu hình và yêu cầu user thiết lập secret an toàn qua secret manager.
-
----
-
-## Scope
-
-✅ Skill này làm:
-- Viết multi-stage `Dockerfile` tối ưu kích thước image, bảo mật non-root user và layer caching.
-- Tạo workflow pipelines CI/CD: Linting, Unit Testing, Security scanning (Trivy/Snyk), Build & Deploy.
-- Thiết lập quản lý cấu hình đa môi trường (Development, Staging, Production).
-- Cấu hình Healthcheck probes (`livenessProbe`, `readinessProbe`) và Graceful shutdown.
-- Xây dựng Runbook khôi phục nhanh (Rollback Runbook) tự động hoặc 1-click.
-
-❌ Skill này KHÔNG làm:
-- Thẩm định cổng release production cuối cùng (→ `qk-production-release`).
-- Viết application code / API logic bên trong ứng dụng.
-- Quản trị tài chính hoặc thanh toán chi phí Cloud.
-
----
-
-## Execution Steps
-
-### Step 1 — Infrastructure & Dependency Analysis
-```
-Inputs:  Yêu cầu từ user, Manifests (package.json, requirements.txt, etc.)
-Actions:
-  - Xác định phiên bản runtime chuẩn (Node.js, Python, Go, Java).
-  - Phân tích các bước build: compile assets, install production-only dependencies.
-Output: Deployment Architecture Blueprint
-```
-
-### Step 2 — Containerization (Multi-stage Dockerfile)
-```
-Inputs:  Blueprint
-Actions:
-  - Thiết kế Stage 1 (Builder): Cài đặt devDependencies, build artifacts.
-  - Thiết kế Stage 2 (Runner): Copy minimal artifacts, chạy dưới non-root user (USER node / appuser).
-  - Thêm `.dockerignore` để loại trừ node_modules, `.git`, `.env`.
-Output: Dockerfile & .dockerignore
-```
-
-### Step 3 — CI/CD Pipeline Automation
-```
-Inputs:  CI platform (.github/workflows)
-Actions:
-  - Thiết lập trigger hợp lý (push on main, PR to dev).
-  - Tích hợp caching cho package managers (npm/pnpm/pip cache).
-  - Gắn các bước kiểm tra chất lượng tự động: Lint -> Test -> Security Scan -> Build Image.
-Output: Pipeline YAML configuration
-```
-
-### Step 4 — Verification & Rollback Strategy Verification
-```
-Inputs:  Pipeline & Dockerfile
-Actions:
-  - Kiểm tra cú pháp YAML linter.
-  - Xác nhận lệnh hoặc cơ chế revert khi pipeline deploy thất bại.
-Exit: SUCCESS
-```
-
----
-
-## Prompt Template
-
-```
-Hạ tầng mục tiêu: [Docker / GitHub Actions / Kubernetes / AWS / Vercel]
-Môi trường:       [Staging / Production / Preview environments]
-Yêu cầu:          [Tối ưu Dockerfile / Tạo pipeline CI test+build / Cấu hình auto-deploy]
-Ràng buộc:        [Không dùng root user, image size < 200MB, secrets qua Vault]
-```

package/.agents/skills/qk-devops-platform/capability.yaml

@@ -1,29 +0,0 @@
-# Auto-generated from SKILL.md frontmatter
-schema_version: 1
-id: "qk-devops-platform"
-version: "9.1.0"
-description: "Kỹ sư nền tảng: Chiến lược CI/CD, kiến trúc triển khai, quản lý môi trường và chiến lược rollback."
-tools:
-  - "filesystem"
-  - "terminal"
-knowledge:
-  owns:
-    - "qk-devops-platform"
-  references:
-    - "architecture"
-    - "security"
-    - "anti-patterns"
-eval:
-  scorecard: "evals/scorecard.yaml"
-decision_boundary:
-  owns:
-    - "CI/CD strategy"
-    - "deployment architecture"
-    - "environment management"
-    - "rollback strategy"
-  does_not_own:
-    - "application code"
-    - "cloud billing"
-    - "releasing features"
-  conflicts_with:
-    - "qk-production-release"

package/.agents/skills/qk-devops-platform/evals/scorecard.yaml

@@ -1,28 +0,0 @@
-name: qk-devops-platform-eval
-description: Đánh giá chất lượng cấu trúc DevOps và CI/CD
-version: 9.1.0
-threshold: 85 # Đảm bảo an toàn hạ tầng và khả năng chịu lỗi (Rollback)
-
-metrics:
-  - id: secure_secrets_management
-    name: Quản lý Secrets an toàn (R-SEC-04)
-    description: Cấu hình CI/CD có vô tình làm lộ credentials không?
-    weight: 40
-    criteria:
-      - Tuyệt đối không hardcode API keys, mật khẩu hoặc tokens vào file cấu hình (20đ)
-      - Sử dụng cơ chế inject biến môi trường an toàn (Github Secrets, Vault) (20đ)
-
-  - id: robust_pipeline_design
-    name: Thiết kế Pipeline và Môi trường
-    description: Luồng CI/CD có phân tách rõ ràng và tự động hóa tốt không?
-    weight: 35
-    criteria:
-      - Phân tách rõ ràng cấu hình cho các môi trường (Dev, Staging, Prod) (15đ)
-      - Có quy trình containerization (Docker, K8s) hoặc chiến lược deployment hợp lý (20đ)
-
-  - id: rollback_strategy
-    name: Chiến lược Rollback
-    description: Có kịch bản dự phòng khi deploy thất bại không?
-    weight: 25
-    criteria:
-      - Có cơ chế hoặc hướng dẫn rõ ràng để rollback hệ thống về trạng thái ổn định trước đó (25đ)

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

@@ -1,193 +0,0 @@
----
-# ── Identity ───────────────────────────────────────────────
-name: qk-docs
-version: 9.2.0
-status: stable
-description: "Khởi tạo và duy trì tài liệu kỹ thuật chuẩn xác — README, API docs, architecture guides, JSDoc/Docstrings — cam kết đồng bộ 100% với code thực tế, không bịa đặt. Dùng skill này khi user nhắc đến: viết docs, tài liệu, readme, document, jsdoc, swagger, viết hướng dẫn, tài liệu api — kể cả khi chỉ nói 'viết hướng dẫn cài đặt và chạy project này'."
-platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
-
-# ── V9: Classification ─────────────────────────────────────
-type: utility
-
-intent:
-  - documentation
-  - technical-writing
-
-complexity:
-  level: low
-  criteria:
-    files_affected: "1-3"
-    has_behavior_change: false
-    has_external_dependency: false
-    has_breaking_change: false
-
-triggers:
-  - "viết docs"
-  - "tài liệu"
-  - "readme"
-  - "document"
-  - "jsdoc"
-  - "swagger"
-  - "viết hướng dẫn"
-  - "tài liệu api"
-
-
-# ── V8: References ─────────────────────────────────────────
-workflow: documentation
-
-rules:
-  - global
-  - coding
-
-tools:
-  - filesystem
-  - terminal
-
-related_skills:
-  - qk-project-memory
-  - qk-api-lifecycle
-
-knowledge_scope:
-  owns:
-    - code-documentation
-    - architecture-docs
-    - api-documentation
-  references:
-    - source-code
-
-# ── V8: Verification ───────────────────────────────────────
-verification:
-  required: true
-  strategy: documentation
-
-selection:
-  priority: medium
-  confidence_threshold: 0.75
-
-examples: []
-learnings: []
-
-# ── V7 Runtime ─────────────────────────────────────────────
-execution_mode: deterministic
-cost: low
-latency: fast
-risk: low
-side_effects: edit_files
-produces: [docs, report]
-consumes: [source-code]
-
-token_budget:
-  max_files_read: 6
-  max_lines_per_read: 150
-  max_shell_commands: 1
-  stop_early: true
-
-exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
----
-
-# qk-docs — Technical Writer & Documentation Guardian
-
-> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
-
-Chịu trách nhiệm khởi tạo, nâng cấp và đồng bộ tài liệu kỹ thuật trong dự án. **Nguyên tắc cốt lõi: Tài liệu PHẢI phản ánh chính xác 100% code thực tế — cấm bịa đặt, cấm suy đoán tham số hay lệnh chạy.**
-
----
-
-## Preconditions
-
-Trước khi viết hoặc sửa tài liệu, AI BẮT BUỘC:
-
-- [ ] Xác định rõ đối tượng độc giả và mục đích tài liệu:
-  - Developer Onboarding → `README.md`
-  - Client / Frontend Consumer → `API docs` / OpenAPI / Swagger
-  - Kỹ sư nội bộ → Architecture Decision Records (ADR) hoặc Code Docstrings
-- [ ] Đọc trực tiếp file mã nguồn liên quan (đọc `package.json` để lấy scripts thật, đọc `.env.example` để lấy biến môi trường thật, đọc interface/DTO để lấy payload thật).
-- [ ] Nếu mã nguồn chưa được triển khai hoặc thông tin nghiệp vụ chưa rõ:
-  → **EXIT: BLOCKED**
-  → Yêu cầu: "Vui lòng implement code hoặc cung cấp đặc tả trước khi lập tài liệu."
-
----
-
-## Scope
-
-✅ Skill này làm:
-- Viết/cập nhật `README.md` chuẩn công nghiệp: Giới thiệu ngắn gọn, Architecture overview, Yêu cầu môi trường (Node, Go, Python, Docker), Hướng dẫn cài đặt, Cấu hình biến môi trường, Các lệnh chạy thường dùng (dev, test, build, lint).
-- Viết tài liệu API: Bảng endpoints, Headers, Request Body, Response Shapes (200, 400, 401, 403, 500) và Curl examples có thể copy-paste chạy thật.
-- Bổ sung JSDoc / TSDoc / Docstrings cho các hàm xử lý nghiệp vụ phức tạp, public SDK methods hoặc utility functions.
-- Soạn thảo Architecture Decision Records (ADR) khi có quyết định kỹ thuật lớn.
-
-❌ Skill này KHÔNG làm:
-- Thay đổi logic thực thi của mã nguồn (`side_effects: edit_files` chỉ áp dụng cho files `.md` hoặc docstrings comments).
-- Viết tài liệu dài dòng dạng lý thuyết suông không áp dụng được.
-- Bịa đặt các endpoints, env vars hoặc test credentials không tồn tại.
-
----
-
-## Execution Steps
-
-### Step 1 — Khảo sát Mã nguồn Thật (Source of Truth Audit)
-```
-Inputs:  Source files, manifest, config files
-Actions:
-  - Nếu viết README: Đọc `package.json` (dependencies, scripts), đọc `.env.example`, đọc Dockerfile.
-  - Nếu viết API docs: Đọc route handlers, schema validators (Zod/Joi/Pydantic/DTOs).
-  - Trích xuất: Port mặc định, Auth headers, format ngày tháng, error responses.
-Outputs: Bảng thông số kỹ thuật đã kiểm chứng
-```
-
-### Step 2 — Lập cấu trúc tài liệu theo tiêu chuẩn
-```
-Tiêu chuẩn trình bày:
-  - Heading phân cấp rõ ràng (`#`, `##`, `###`).
-  - Dùng bảng (Markdown tables) cho env vars, API params, status codes.
-  - Code block luôn có tag ngôn ngữ (`bash`, `ts`, `json`, `yaml`).
-  - Cung cấp lệnh CLI cụ thể và kết quả mong đợi.
-```
-
-### Step 3 — Soạn thảo nội dung (Drafting)
-```
-Quy tắc hành văn:
-  - Ngắn gọn, trực diện, hướng hành động (action-oriented).
-  - Định dạng cảnh báo theo GitHub Alerts (`> [!IMPORTANT]`, `> [!WARNING]`).
-  - Hướng dẫn troubleshooting cho các lỗi cài đặt thường gặp.
-```
-
-### Step 4 — Verification & Fact-check
-```
-Actions:
-  - Đối chiếu từng biến môi trường trong tài liệu với code thực tế.
-  - Chạy thử lệnh build/test (dry-run) nếu cần xác nhận.
-  - Kiểm tra các link nội bộ trong repo (không để link chết).
-```
-
----
-
-## Prompt Template
-
-```
-Loại tài liệu:  [README / API Reference / Architecture Doc / JSDoc]
-Scope:          [Toàn bộ repo / Module payments / Component Button]
-Độc giả:        [New developer / Frontend dev / External partner]
-Yêu cầu đặc biệt:[Kèm curl mẫu / giải thích env vars / sơ đồ luồng]
-```
-
-### Ví dụ theo nhu cầu:
-
-**Viết README cho Fullstack Web App**
-```
-Loại tài liệu:  README.md
-Scope:          Toàn bộ repo (Next.js + Prisma + PostgreSQL)
-Độc giả:        Developer mới vào dự án
-```
-→ AI đọc `package.json`, `.env.example`, `schema.prisma`.
-→ AI tạo `README.md` gồm: Quickstart 3 bước (install, migrate, dev), bảng biến môi trường bắt buộc, tài liệu các lệnh test/lint, kiến trúc thư mục.
-
-**Viết API Docs cho Endpoint Đặt hàng**
-```
-Loại tài liệu:  API Reference
-Scope:          POST /api/v1/orders
-Độc giả:        Mobile App Developer
-```
-→ AI đọc controller + validation schema.
-→ AI tạo Markdown: Headers (`Authorization: Bearer <token>`), Request JSON schema kèm chú thích kiểu dữ liệu, Bảng response codes (201 Created, 400 Bad Request kèm chi tiết lỗi validation, 401 Unauthorized), Curl command mẫu hoàn chỉnh.
-

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

@@ -1,23 +0,0 @@
-# Auto-generated from SKILL.md frontmatter
-schema_version: 1
-id: "qk-docs"
-version: "9.1.0"
-description: "Viết và duy trì tài liệu chính xác tuyệt đối — phải match code thực tế, cấm bịa đặt."
-tools:
-  - "filesystem"
-  - "terminal"
-knowledge:
-  owns:
-    - "code-documentation"
-    - "architecture-docs"
-  references:
-    - "source-code"
-    - "security"
-    - "anti-patterns"
-eval:
-  scorecard: "evals/scorecard.yaml"
-decision_boundary:
-  owns:
-    - "qk-docs"
-  does_not_own: []
-  conflicts_with: []

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

@@ -1,27 +0,0 @@
-name: qk-docs-eval
-description: Đánh giá chất lượng tài liệu và kỹ năng viết Docs
-version: 9.1.0
-threshold: 85 # Đảm bảo tài liệu phản ánh chính xác 100% logic code thực tế
-
-metrics:
-  - id: accurate_documentation
-    name: Phản ánh chính xác Code (Không bịa đặt)
-    description: Tài liệu viết ra có khớp hoàn toàn với parameters/returns trong code không?
-    weight: 40
-    criteria:
-      - Đọc code trước khi viết, không tự bịa (hallucinate) các params/lỗi không tồn tại trong code (20đ)
-      - Sử dụng đúng format chuẩn (JSDoc/TSDoc) cho hàm/class (20đ)
-
-  - id: documentation_depth
-    name: Giải thích Nguyên nhân (WHY, not WHAT)
-    description: Comments có giải thích tại sao đoạn code tồn tại thay vì diễn giải lại code không?
-    weight: 35
-    criteria:
-      - Comment tập trung giải thích lý do (WHY) thay vì viết những dòng vô nghĩa (WHAT) như `// gets the user` (35đ)
-
-  - id: verify_accuracy
-    name: Kiểm chứng độ chính xác
-    description: Agent có đọc lại tài liệu sau khi viết để đối chiếu với code không?
-    weight: 25
-    criteria:
-      - Re-read để spot check lại từng param/type nhằm đảm bảo độ chính xác tuyệt đối (25đ)

package/.agents/skills/qk-engineering-standard/SKILL.md

@@ -1,89 +0,0 @@
----
-# ── Identity ───────────────────────────────────────────────
-name: qk-engineering-standard
-version: 9.2.1
-status: relocated
-description: "Ép buộc SOLID, DRY, Clean Code với ngưỡng số liệu cụ thể — không có rule mơ hồ."
-platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
-
-# ── V9: Classification ─────────────────────────────────────
-type: utility
-
-intent:
-  - code-quality
-  - standards-enforcement
-
-complexity:
-  level: medium
-  criteria:
-    files_affected: "1-5"
-    has_behavior_change: false
-    has_external_dependency: false
-    has_breaking_change: false
-
-triggers:
-  - "review code"
-  - "clean code"
-  - "check standard"
-  - "refactor clean"
-  - "kiểm tra chuẩn"
-
-# ── V8: References ─────────────────────────────────────────
-workflow: code-review
-
-rules:
-  - global
-  - coding
-
-tools:
-  - filesystem
-  - terminal
-
-related_skills:
-  - qk-project-health
-  - qk-system-evolution
-
-knowledge_scope:
-  owns:
-    - coding-standards
-    - best-practices
-  references:
-    - architecture
-    - security
-    - anti-patterns
-
-# ── V8: Verification ───────────────────────────────────────
-verification:
-  required: true
-  strategy: review
-
-selection:
-  priority: high
-  confidence_threshold: 0.80
-
-examples: []
-learnings: []
-
-# ── V7 Runtime ─────────────────────────────────────────────
-execution_mode: deterministic
-cost: medium
-latency: medium
-risk: low
-side_effects: read_only
-produces: [report]
-consumes: [source-code]
-
-token_budget:
-  max_files_read: 5
-  max_lines_per_read: 150
-  max_shell_commands: 1
-  stop_early: true
-
-exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
----
-
-# qk-engineering-standard — Code Quality Enforcer
-
-> **⚠️ ARCHIVED (v9.2.1):** Downgraded thành rule. Nội dung đã được merge vào `.agents/rules/coding.md` (R-C-10). Không cần gọi trực tiếp — áp dụng tự động trong mọi skill có `side_effects: edit_files`.
-
-> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.

package/.agents/skills/qk-engineering-standard/capability.yaml

@@ -1,23 +0,0 @@
-# Auto-generated from SKILL.md frontmatter
-schema_version: 1
-id: "qk-engineering-standard"
-version: "9.1.0"
-description: "Ép buộc SOLID, DRY, Clean Code với ngưỡng số liệu cụ thể — không có rule mơ hồ."
-tools:
-  - "filesystem"
-  - "terminal"
-knowledge:
-  owns:
-    - "coding-standards"
-    - "best-practices"
-  references:
-    - "architecture"
-    - "security"
-    - "anti-patterns"
-eval:
-  scorecard: "evals/scorecard.yaml"
-decision_boundary:
-  owns:
-    - "qk-engineering-standard"
-  does_not_own: []
-  conflicts_with: []

package/.agents/skills/qk-engineering-standard/evals/scorecard.yaml

@@ -1,28 +0,0 @@
-name: qk-engineering-standard-eval
-description: Đánh giá việc áp dụng Tiêu chuẩn Kỹ thuật và Clean Code
-version: 9.1.0
-threshold: 80 # Đánh giá tính chính xác của việc tính điểm Health Score
-
-metrics:
-  - id: concrete_thresholds
-    name: Áp dụng Thresholds định lượng
-    description: Agent có áp dụng đúng các ngưỡng cứng (Concrete Thresholds) không?
-    weight: 40
-    criteria:
-      - Nhận diện đúng hàm > 30 dòng, độ phức tạp > 10, file > 300 dòng (20đ)
-      - Phát hiện mã trùng lặp (DRY violation) nếu lặp lại >= 3 lần (20đ)
-
-  - id: health_score_calculation
-    name: Chấm điểm Health Score
-    description: Báo cáo có tính toán điểm sức khỏe (Health Score) chuẩn xác không?
-    weight: 35
-    criteria:
-      - 'Trừ điểm đúng theo thang điểm (CRITICAL: -25, HIGH: -10, MEDIUM: -5, LOW: -2) (20đ)'
-      - 'Trả về đúng mức Exit Code tương ứng (SUCCESS nếu >=80, FAILED nếu <60) (15đ)'
-
-  - id: non_intrusive_reporting
-    name: Báo cáo không can thiệp (Read-only)
-    description: Agent có tuân thủ quy tắc chỉ report mà không tự ý sửa code không?
-    weight: 25
-    criteria:
-      - Giữ nguyên trạng thái read-only, chỉ cung cấp report và suggestion (không tự sửa file) (25đ)