ai-developer-skill-os 9.3.1 → 10.2.0

package/.agents/skills/qk-production-release/SKILL.md

@@ -1,188 +0,0 @@
----
-# ── Identity ───────────────────────────────────────────────
-name: qk-production-release
-version: 9.2.0
-status: stable
-description: "Chuẩn bị release production với 8-gate checklist bắt buộc — không pass gate = không deploy. Dùng skill này khi user nhắc đến: deploy production, release checklist, go live, rollout, chuẩn bị release, kiểm tra release — kể cả khi chỉ hỏi 'đã đủ điều kiện đưa lên production chưa'."
-platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
-
-# ── V9: Classification ─────────────────────────────────────
-type: capability
-
-intent:
-  - release-management
-  - production-deployment
-
-complexity:
-  level: high
-  criteria:
-    files_affected: "1-5"
-    has_behavior_change: false
-    has_external_dependency: true
-    has_breaking_change: false
-
-triggers:
-  - "deploy production"
-  - "release checklist"
-  - "go live"
-  - "rollout"
-  - "chuẩn bị release"
-  - "kiểm tra release"
-
-
-# ── V8: References ─────────────────────────────────────────
-workflow: production-release
-
-rules:
-  - global
-  - safety
-
-tools:
-  - filesystem
-  - terminal
-
-related_skills:
-  - qk-devops-platform
-  - qk-security-audit
-
-knowledge_scope:
-  owns:
-    - release-checklist
-    - deployment-gate
-  references:
-    - architecture
-    - security
-    - anti-patterns
-
-decision_boundary:
-  owns:
-    - release-gate-checklist
-    - deployment-readiness-verdict
-  does_not_own:
-    - ci-cd-pipeline-design
-    - infrastructure-provisioning
-  conflicts_with:
-    - qk-devops-platform
-
-# ── V8: Verification ───────────────────────────────────────
-verification:
-  required: true
-  strategy: release-safety
-
-selection:
-  priority: high
-  confidence_threshold: 0.85
-
-examples: []
-learnings: []
-
-# ── V7 Runtime ─────────────────────────────────────────────
-execution_mode: deterministic
-cost: medium
-latency: slow
-risk: high
-side_effects: run_commands
-produces: [report, plan]
-consumes: [source-code, test-results]
-
-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-production-release — Production Release Gate & Readiness Auditor
-
-> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
-
-Chịu trách nhiệm thẩm tra toàn diện sự sẵn sàng của hệ thống trước khi đưa lên môi trường Production thông qua **8-Gate Checklist bắt buộc**. Nguyên tắc bất di bất dịch: **1 Gate không đạt = DỪNG DEPLOY**.
-
----
-
-## Preconditions
-
-Trước khi cấp quyền release, AI BẮT BUỘC kiểm tra:
-
-- [ ] Xác định commit hash hoặc release tag chuẩn bị deploy.
-- [ ] Xác định môi trường đích (Production) và biến môi trường cần thiết.
-- [ ] Đảm bảo có kế hoạch Rollback khẩn cấp (Rollback Runbook) đã được xác nhận.
-- [ ] Nếu có bất kỳ test suite nào thất bại hoặc phát hiện secret leak:
-  → **EXIT: BLOCKED**
-  → Từ chối release và lập báo cáo chi tiết các lỗi cần khắc phục.
-
----
-
-## Scope
-
-✅ Skill này làm:
-- Thẩm định 8 Cổng An toàn (8-Gate Checklist):
-  1. Build & Compile Gate (Build pass 100%, không type errors).
-  2. Test Suite Gate (Unit + Integration tests pass).
-  3. Security Gate (Không có critical CVE, không leak secrets trong code).
-  4. Database Migration Gate (Migration an toàn, backward-compatible).
-  5. Environment Config Gate (.env.production đầy đủ keys, không thiếu config).
-  6. Performance & Health Check Gate (Có endpoint /healthz, /readyz).
-  7. Rollback Plan Gate (Có lệnh hoặc pipeline rollback rõ ràng).
-  8. Observability Gate (Logging, Error monitoring Sentry/Datadog đã sẵn sàng).
-- Lập Báo cáo Thẩm định Sẵn sàng (Production Readiness Report).
-- Khuyến nghị quyết định: **GO** (Cho phép deploy) hoặc **NO-GO** (Chặn deploy).
-
-❌ Skill này KHÔNG làm:
-- Trực tiếp chạy lệnh deploy phá hủy môi trường live nếu chưa có xác nhận từ người dùng.
-- Thiết kế hạ tầng CI/CD pipeline từ đầu (→ `qk-devops-platform`).
-- Sửa lỗi code trực tiếp (→ `qk-bug-resolution`).
-
----
-
-## Execution Steps
-
-### Step 1 — Artifact & Build Verification
-```
-Inputs:  Commit hash/tag, Build scripts
-Actions:
-  - Kiểm tra trạng thái build và artifact tĩnh.
-  - Xác thực không có file nhạy cảm lọt vào distribution build (.map files nhạy cảm, dev configs).
-Output: Build status verdict
-```
-
-### Step 2 — 8-Gate Audit Execution
-```
-Inputs:  Source code, Config manifests, Test logs
-Actions:
-  - Kiểm tra lần lượt 8 cổng theo checklist.
-  - Ghi nhận chi tiết trạng thái (PASS / FAIL / WARN) cho từng cổng.
-Exit: BLOCKED ngay khi phát hiện Gate mang tính chặn (Security, Build, Test) bị FAIL.
-```
-
-### Step 3 — Rollback & Contingency Assessment
-```
-Inputs:  Deployment strategy (Blue/Green, Rolling, Canary)
-Actions:
-  - Xác nhận thời gian phục hồi tối đa (RTO) và kịch bản revert DB nếu migration lỗi.
-  - Soạn sẵn câu lệnh khôi phục trạng thái cũ.
-Output: Rollback verification checklist
-```
-
-### Step 4 — Readiness Verdict Delivery
-```
-Inputs:  Audit results
-Actions:
-  - Xuất bảng tổng kết 8-Gate với kết luận rõ ràng GO / NO-GO.
-  - Bàn giao hướng dẫn các bước release thủ công hoặc qua pipeline cho kỹ sư vận hành.
-Exit: SUCCESS
-```
-
----
-
-## Prompt Template
-
-```
-Phiên bản / Tag: [Release version — ví dụ: v2.4.0 hoặc commit hash]
-Môi trường:      [Production / Staging-to-Production]
-Thay đổi chính:  [Tóm tắt tính năng / bugfix trong đợt release này]
-DB Migration:    [Có migration không? Có thay đổi bảng dữ liệu nào?]
-Kế hoạch Rollback: [Đã có phương án revert chưa?]
-```

package/.agents/skills/qk-production-release/capability.yaml

@@ -1,27 +0,0 @@
-# Auto-generated from SKILL.md frontmatter
-schema_version: 1
-id: "qk-production-release"
-version: "9.1.0"
-description: "Chuẩn bị release production với 8-gate checklist bắt buộc — không pass gate = không deploy."
-tools:
-  - "filesystem"
-  - "terminal"
-knowledge:
-  owns:
-    - "release-checklist"
-    - "deployment-gate"
-  references:
-    - "architecture"
-    - "security"
-    - "anti-patterns"
-eval:
-  scorecard: "evals/scorecard.yaml"
-decision_boundary:
-  owns:
-    - "release-gate-checklist"
-    - "deployment-readiness-verdict"
-  does_not_own:
-    - "ci-cd-pipeline-design"
-    - "infrastructure-provisioning"
-  conflicts_with:
-    - "qk-devops-platform"

package/.agents/skills/qk-production-release/evals/scorecard.yaml

@@ -1,28 +0,0 @@
-name: qk-production-release-eval
-description: Đánh giá quá trình kiểm duyệt phát hành (Release Gate)
-version: 9.1.0
-threshold: 100 # Phải đạt 100 điểm vì lỗi ở Gate này có thể gây sập Production
-
-metrics:
-  - id: strict_gate_enforcement
-    name: Kỷ luật thi hành Checklist 8-Gate
-    description: Agent có nghiêm túc chặn việc release nếu phát hiện lỗi Hard-block không?
-    weight: 40
-    criteria:
-      - BẮT BUỘC chặn đứng (EXIT: FAILED) nếu các cổng P1–P5 hoặc P7 (CRITICAL security) thất bại (40đ)
-
-  - id: pre_flight_checks
-    name: Kiểm tra rác mã và Cấu hình (Pre-flight)
-    description: Agent có phát hiện được log rác và nhầm lẫn file môi trường không?
-    weight: 30
-    criteria:
-      - Rà soát thành công các tàn dư debug (console.log, debugger) trong mã nguồn (15đ)
-      - Xác minh chắc chắn biến môi trường đang trỏ về Production (.env.production) (15đ)
-
-  - id: build_and_security
-    name: Kiểm thử Build và Bảo mật
-    description: Phân tích Build Bundle và Dependency Audit có được chạy không?
-    weight: 30
-    criteria:
-      - Chạy lệnh build để đảm bảo source code không bị gãy (15đ)
-      - Chạy npm audit/yarn audit để chặn mã độc/vulnerabilities lên server (15đ)

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

@@ -1,174 +0,0 @@
----
-# ── Identity ───────────────────────────────────────────────
-name: qk-project-audit
-version: 9.2.0
-status: stable
-description: "Phân tích toàn diện dự án: Gap Analysis, Feasibility, Risk Assessment — báo cáo trước khi code, không tự ý implement. Dùng skill này khi user nhắc đến: phân tích dự án, gap analysis, feasibility, audit report, đánh giá rủi ro, risk assessment — kể cả khi chỉ hỏi 'hệ thống hiện tại có đáp ứng được yêu cầu X không' — KHÔNG dùng cho đo lường nợ kỹ thuật hay code smell của code đang chạy (dùng qk-project-health)."
-platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
-
-# ── V9: Classification ─────────────────────────────────────
-type: capability
-
-intent:
-  - project-analysis
-  - gap-analysis
-  - feasibility-study
-  - risk-assessment
-
-complexity:
-  level: medium
-  criteria:
-    files_affected: "1-10"
-    has_behavior_change: false
-    has_external_dependency: false
-    has_breaking_change: false
-
-triggers:
-  - "phân tích dự án"
-  - "gap analysis"
-  - "feasibility"
-  - "audit report"
-  - "đánh giá rủi ro"
-  - "risk assessment"
-
-selection:
-  priority: high
-  confidence_threshold: 0.85
-
-# ── V9: References ─────────────────────────────────────────
-workflow: feature-delivery
-
-rules:
-  - global
-  - safety
-
-tools:
-  - filesystem
-  - terminal
-
-related_skills:
-  - qk-context-loader
-  - qk-product-specification
-  - qk-feature-delivery
-  - qk-project-health
-
-knowledge_scope:
-  owns:
-    - project-analysis
-    - gap-analysis
-    - feasibility-assessment
-    - risk-report
-  references:
-    - architecture
-    - security
-    - performance
-
-# ── V9: Verification ───────────────────────────────────────
-verification:
-  required: true
-  strategy: review
-
-# ── Runtime ────────────────────────────────────────────────
-execution_mode: deterministic
-cost: low
-latency: fast
-risk: low
-side_effects: none
-produces: [report, plan]
-consumes: [user-description, source-code]
-
-token_budget:
-  max_files_read: 10
-  max_lines_per_read: 200
-  max_shell_commands: 3
-  stop_early: true
-
-exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
----
-
-# qk-project-audit — Project Analysis & Gap Report
-
-> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
-
-Chịu trách nhiệm phân tích khoảng cách kỹ thuật (Gap Analysis), tính khả thi (Feasibility) và đánh giá rủi ro (Risk Assessment) trước khi bắt tay vào triển khai một tính năng lớn hoặc thay đổi kiến trúc. **Hoạt động ở chế độ Read-Only, cam kết không tự ý sửa đổi code.**
-
----
-
-## Preconditions
-
-Trước khi lập báo cáo phân tích, AI BẮT BUỘC kiểm tra:
-
-- [ ] Đọc `.agents/DEV_PROFILE.md` để nắm stack, conventions và constraints.
-- [ ] Xác định rõ mục tiêu kinh doanh hoặc yêu cầu kỹ thuật mới cần phân tích tính khả thi.
-- [ ] Đảm bảo có quyền truy cập đọc mã nguồn liên quan trong dự án.
-- [ ] Nếu yêu cầu thay đổi hoàn toàn thiếu cơ sở kỹ thuật hoặc mâu thuẫn trực tiếp với kiến trúc cốt lõi:
-  → **EXIT: BLOCKED**
-  → Báo cáo user lý do kiến trúc không tương thích kèm các hướng đi thay thế.
-
----
-
-## Scope
-
-✅ Skill này làm:
-- Phân tích Gap giữa hiện trạng (As-Is) và mong muốn (To-Be).
-- Đánh giá tính khả thi kỹ thuật (Technical Feasibility): khả năng mở rộng, độ trễ, giới hạn công nghệ.
-- Đánh giá rủi ro (Risk Assessment): xung đột dữ liệu, phá vỡ hợp đồng API, hiệu năng, nợ kỹ thuật.
-- Lập ma trận đánh giá chi phí / lợi ích (Cost-Benefit & Effort Estimation) cho các giải pháp.
-- Đề xuất lộ trình triển khai từng bước (Phase-by-phase rollout).
-
-❌ Skill này KHÔNG làm:
-- Tự ý viết code tính năng hoặc tạo migration (→ `qk-feature-delivery`).
-- Chấm điểm chi tiết chỉ số code smell/God files (→ `qk-project-health`).
-- Scan lỗ hổng bảo mật chuyên sâu OWASP (→ `qk-security-audit`).
-
----
-
-## Execution Steps
-
-### Step 1 — As-Is Landscape Assessment
-```
-Inputs:  Yêu cầu từ user, Codebase hiện tại
-Actions:
-  - Rà soát các components, modules và data models liên quan trực tiếp đến yêu cầu mới.
-  - Phân tích luồng dữ liệu hiện hữu và các ràng buộc hệ thống.
-Output: As-Is Architecture Snapshot
-```
-
-### Step 2 — Gap Analysis & Feasibility Study
-```
-Inputs:  As-Is Snapshot, Yêu cầu To-Be
-Actions:
-  - Xác định các thành phần còn thiếu (Missing components, missing APIs, missing schemas).
-  - So sánh các phương án giải pháp kỹ thuật khả thi (Option A vs Option B).
-  - Đánh giá tương thích với thư viện hiện tại trong DEV_PROFILE.md.
-Output: Gap matrix & Feasibility verdict
-```
-
-### Step 3 — Risk Identification & Mitigation Matrix
-```
-Inputs:  Proposed solutions
-Actions:
-  - Liệt kê các rủi ro: Khóa bảng DB, nghẽn mạng, phá vỡ backward compatibility, độ phức tạp bảo trì.
-  - Xây dựng biện pháp giảm thiểu rủi ro (Mitigation plan) cho từng điểm nghẽn.
-Output: Risk & Mitigation table
-```
-
-### Step 4 — Executive Summary & Phasing Roadmap
-```
-Inputs:  Analysis results
-Actions:
-  - Tổng hợp báo cáo phân tích theo mẫu chuẩn.
-  - Đề xuất lộ trình phân kỳ (Phases: PoC → MVP → Production Ready).
-Exit: SUCCESS
-```
-
----
-
-## Prompt Template
-
-```
-Yêu cầu mới:   [Mô tả tính năng lớn hoặc thay đổi kiến trúc cần phân tích]
-Kỳ vọng:       [Mục tiêu kinh doanh, tải mong đợi, SLA]
-Hệ thống hiện tại: [Các module hoặc file liên quan đang hoạt động ra sao]
-Lo ngại chính: [Những rủi ro hoặc câu hỏi kỹ thuật bạn đang băn khoăn nhất]
-```