ai-developer-skill-os 8.2.1 → 8.3.1

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

@@ -1,117 +1,241 @@
----
-# ── Identity ───────────────────────────────────────────────
-name: qk-devops-platform
-version: 8.1.1
-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."
-platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
-
-# ── V8: 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:
-  - "cấu hình ci/cd"
-  - "deployment strategy"
-  - "quản lý môi trường"
-  - "devops platform"
-  - "dockerize"
-
-# ── 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
-
-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]
-
-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 Engineer
-
-> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
-
-## Preconditions
-- [ ] Requirements cho môi trường triển khai đã có sẵn.
-
-## Scope
-- Thiết kế và thiết lập luồng CI/CD (GitHub Actions, GitLab CI, v.v.).
-- Xây dựng kiến trúc deployment, quản lý các container (Docker, Kubernetes).
-- Đưa ra chiến lược Rollback an toàn khi có sự cố.
-- Quản lý và phân tách các môi trường (Dev, Staging, Prod).
-- KHÔNG thay thế `qk-production-release` (đóng gói và release app), skill này quản lý *hạ tầng và quy trình* bên dưới việc release đó.
+---
+# ── Identity ───────────────────────────────────────────────
+name: qk-devops-platform
+version: 8.3.1
+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."
+platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
+
+# ── V8: 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:
+  - "cấu hình ci/cd"
+  - "deployment strategy"
+  - "quản lý môi trường"
+  - "devops platform"
+  - "dockerize"
+
+# ── 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]
+
+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 Engineer
+
+> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
+
+## Preconditions
+- [ ] Requirements cho môi trường triển khai đã có sẵn.
+
+## Scope
+- Thiết kế và thiết lập luồng CI/CD (GitHub Actions, GitLab CI, v.v.).
+- Xây dựng kiến trúc deployment, quản lý các container (Docker, Kubernetes).
+- Đưa ra chiến lược Rollback an toàn khi có sự cố.
+- Quản lý và phân tách các môi trường (Dev, Staging, Prod).
+- **Bắt buộc tuân thủ R-SEC-04: Mọi secrets/credentials trong CI/CD phải được inject qua biến môi trường an toàn (Github Secrets/Vault), KHÔNG BAO GIỜ hardcode.**
+- KHÔNG thay thế `qk-production-release` (đóng gói và release app), skill này quản lý *hạ tầng và quy trình* bên dưới việc release đó.
+
+## Non-Goals
+- ❌ Provide implementation outside of DevOps & CI/CD scope
+- ❌ Override explicit user directives without explanation
+- ❌ Guess ambiguous requirements without asking
+
+## Priority Order
+
+| Priority | Task | Skip Threshold |
+|----------|------|----------------|
+| P1 | Core DevOps & CI/CD analysis and decision making | Never |
+| P2 | Validation of existing patterns | Budget < 30% |
+| P3 | Detailed documentation generation | Budget < 50% |
+| P4 | Edge case exploration | Budget < 70% |
+
+## Workflow
+
+### Phase 1 — Context Loading
+**Steps:**
+1. Read existing configuration and requirements related to DevOps & CI/CD.
+2. Check for missing preconditions.
+
+**Decision:**
+```
+IF context is clear
+  → Confidence: HIGH → go to Phase 2
+ELSE
+  → EXIT: BLOCKED — ask user
+```
+
+### Phase 2 — Analysis & Strategy
+**Steps:**
+1. Analyze the current state against DevOps & CI/CD best practices.
+2. Formulate strategy or audit report based on findings.
+
+**Decision:**
+```
+IF strategy/audit is complete
+  → Confidence: HIGH → go to Phase 3
+ELSE IF minor gaps exist
+  → Confidence: MEDIUM → proceed with assumptions noted
+```
+
+### Phase 3 — Finalization
+**Steps:**
+1. Generate final report or configuration.
+2. Prepare handoff data for subsequent skills.
+
+## Confidence Model
+
+| Level | Condition | Action |
+|-------|-----------|--------|
+| HIGH | All preconditions met, context fully understood | Proceed directly |
+| MEDIUM | Some context missing but safe defaults exist | Proceed and note assumptions |
+| LOW | Core requirements missing | EXIT: BLOCKED |
+
+## Severity (for findings)
+
+| Level | Definition |
+|-------|-----------|
+| CRITICAL | Severe violation of DevOps & CI/CD principles |
+| HIGH | Significant risk or technical debt |
+| MEDIUM | Suboptimal pattern but functional |
+| LOW | Minor style or documentation issue |
+
+## Evidence Format
+
+```
+[SEVERITY] Context/File
+Issue:      [what was found]
+Confidence: HIGH
+Recommendation: [actionable advice]
+```
+
+## Retry Policy
+```
+Task fails due to missing context
+  └─ Ask user for clarification
+       ├─ Provided → Retry Phase 1
+       └─ Not provided → EXIT: BLOCKED
+```
+
+## Escalation Rules
+
+```
+BLOCKED: Missing critical context for DevOps & CI/CD
+Missing:
+  - [Specific requirement]
+Questions:
+  1. Bạn có thể cung cấp thêm thông tin về yêu cầu này không?
+  2. Mục tiêu chính của bạn là gì?
+Recommended Assumptions: none
+```
+
+## Handoff Contract
+
+### Consumes
+```json
+{
+  "from": "user or qk-orchestrator",
+  "required_fields": ["context"],
+  "optional_fields": ["existing_config"]
+}
+```
+
+### Produces
+```json
+{
+  "to": "user or downstream skill",
+  "output_fields": ["strategy_report", "exit_code"]
+}
+```
+
+## Exit Codes
+
+| Code | Meaning | When |
+|------|---------|------|
+| SUCCESS | DevOps & CI/CD task completed successfully | Strategy/audit generated |
+| PARTIAL | Task completed with assumptions | Medium confidence |
+| BLOCKED | Missing context | Cannot proceed |
+| FAILED | Critical conflict or error | Unresolvable constraint |

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

@@ -0,0 +1,29 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-devops-platform"
+version: "8.3.1"
+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

@@ -0,0 +1,28 @@
+name: qk-devops-platform-eval
+description: Đánh giá chất lượng cấu trúc DevOps và CI/CD
+version: 8.3.1
+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,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-docs
-version: 8.0.0
+version: 8.3.1
 status: stable
 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."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
@@ -47,6 +47,8 @@ knowledge_scope:
     - architecture-docs
   references:
     - source-code
+    - security
+    - anti-patterns
 
 # ── V8: Verification ───────────────────────────────────────
 verification:
@@ -202,7 +204,7 @@ Fix:        [specific correction]
 ## Severity
 | Level | Definition | Example |
 |-------|-----------|---------|
-| CRITICAL | Docs instruct user to do something dangerous | Documenting destructive API without warnings |
+| CRITICAL | Docs instruct user to do something dangerous, bypass auth, or expose secrets | Documenting destructive API without warnings, or writing guides to call internal APIs unauthenticated |
 | HIGH | API params documented incorrectly | Says string instead of object |
 | MEDIUM | Missing docs for edge cases | Doesn't explain error throws |
 | LOW | Typo or poor formatting | Misaligned markdown table |

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

@@ -0,0 +1,23 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-docs"
+version: "8.3.1"
+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

@@ -0,0 +1,27 @@
+name: qk-docs-eval
+description: Đánh giá chất lượng tài liệu và kỹ năng viết Docs
+version: 8.3.1
+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,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-engineering-standard
-version: 8.0.0
+version: 8.3.1
 status: stable
 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]
@@ -49,6 +49,8 @@ knowledge_scope:
     - best-practices
   references:
     - architecture
+    - security
+    - anti-patterns
 
 # ── V8: Verification ───────────────────────────────────────
 verification:
@@ -93,11 +95,6 @@ On missing precondition:
   Message: "Vui lòng chỉ định file hoặc module cần kiểm tra."
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
 ## Scope
 - ✅ Detect violations with exact file:line references
 - ✅ Classify by severity with concrete thresholds
@@ -108,12 +105,8 @@ schema_version: 2
 - ❌ Rewrite architecture
 - ❌ Touch files outside the specified scope
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
 ## Concrete Thresholds (Non-Negotiable)
+**Các giới hạn dưới đây được dùng để định lượng vi phạm rác mã (R-C-09) và bảo mật (R-SEC-04):**
 
 ```yaml
 function:
@@ -139,11 +132,6 @@ dependency:
   max_imports_per_file: 15  # Beyond this: likely a God File
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
 ## Priority Order
 
 | Priority | Check | Severity | Skip Threshold |
@@ -156,11 +144,6 @@ schema_version: 2
 | P6 | Naming convention violations | LOW | Budget < 70% |
 | P7 | Excessive imports / coupling | LOW | Budget < 80% |
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
 ## Workflow
 
 ### Phase 1 — Scan for Critical & High Violations
@@ -187,11 +170,6 @@ IF file line count > 300
 - All P1+P2+P3 checks done → go to Phase 2
 - Token budget < 30% → go to Phase 3 directly with PARTIAL flag
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
 ### Phase 2 — Scan for Medium & Low Violations
 
 **Steps:**
@@ -211,11 +189,6 @@ IF token budget < 50%
   → Skip P6+P7, go to Phase 3
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
 ### Phase 3 — Score & Report
 
 **Steps:**
@@ -243,11 +216,6 @@ IF score < 60 OR any CRITICAL violations
   → EXIT: FAILED — requires immediate action
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
 ## Confidence Model
 
 | Level | Condition | Action |
@@ -256,11 +224,6 @@ schema_version: 2
 | MEDIUM | Inferred cyclomatic complexity without tool | Note estimate |
 | LOW | Architectural smell inferred from structure | Mark as "suspected — verify manually" |
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
 ## Severity
 
 | Level | Definition | Example |
@@ -270,11 +233,6 @@ schema_version: 2
 | MEDIUM | DRY or SoC violation, fixable in < 1 hour | Same validation logic in 3 components |
 | LOW | Style/naming issue, non-blocking | Single-letter variable `x` outside loop |
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
 ## Evidence Format
 
 ```
@@ -296,22 +254,12 @@ Fix:        Extract payment logic to `processPayment()`, shipping to `scheduleSh
 Deduction:  -10 pts
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
 ## Retry Policy
 ```
 Audit is read-only — no retry needed.
 If file is inaccessible → skip and note in report as PARTIAL.
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
 ## Escalation Rules
 
 ```
@@ -323,11 +271,6 @@ Questions:
   2. Có ngưỡng cụ thể nào bạn muốn thay đổi không? (mặc định: 30 lines/function)
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
 ## Handoff Contract
 
 ### Consumes
@@ -347,11 +290,6 @@ schema_version: 2
 }
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
 ## Output Format
 
 ```
@@ -375,11 +313,6 @@ Required Actions:
 Exit Code:   [SUCCESS | PARTIAL | FAILED]
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
 ## Exit Codes
 
 | Code | Meaning | When |
@@ -389,13 +322,9 @@ schema_version: 2
 | BLOCKED | No target specified | Cannot audit without scope |
 | FAILED | Score < 60 or CRITICAL found | Immediate action required |
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
 ## References
 - Detailed thresholds with rationale: `references/thresholds.md`
+- Anti-Patterns Blacklist: `references/anti-patterns.md`
 
 ---