ai-developer-skill-os 3.1.0 → 3.1.2

package/skills/qk-system-evolution/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: qk-system-evolution
-version: 3.0.0
+version: 3.1.2
 updated: 2026-07-02
 description: Safely upgrade dependencies, migrate frameworks, and manage rollbacks.
 category: operations
@@ -21,6 +21,7 @@ pipeline: [analyze, plan, implement, validate, complete]
 > **Goal:** Quản lý các thay đổi lớn cấp hệ thống (Major Updates) một cách an toàn, luôn có đường lui (Rollback) nếu xảy ra sự cố.
 
 ## 🔄 1. Chain of Thought (SOP)
+
 1. **Analyze (Impact Analysis):**
    - Read the Changelog or Migration Guide for the new version.
    - Identify Breaking Changes and Deprecated APIs.
@@ -36,11 +37,13 @@ pipeline: [analyze, plan, implement, validate, complete]
    - Run the build process to ensure the system compiles.
 
 ## 🛡️ 3. Constraints & Rules
+
 - **Safety First:** Never run `npm update` blindly across all packages. Update only what was requested.
 - **Lockfiles:** Do not delete `package-lock.json` or `yarn.lock` unless resolving extreme merge conflicts.
 - **Always Rollback:** If the system produces >50 compilation errors after an upgrade and you cannot fix them in 1 turn, immediately trigger the Rollback Plan.
 
 ## 🌳 3. Decision Tree
+
 ```text
 Are there Breaking Changes in the target version?
   ├── YES → Create a migration checklist based on the official docs. Update code systematically.
@@ -54,11 +57,14 @@ Did the Build fail after the update?
 ```
 
 ## 🤝 4. Handoff Pipeline
+
 1. `validate`: Run the full test suite and `npm run build` via `qk-validation-gate`.
 2. `complete`: Generate the Evolution report.
 
 ## 📝 5. Output Format
+
 Vui lòng trả kết quả bằng Tiếng Việt.
+
 - **Tóm tắt (Summary):** Đã nâng cấp package nào, từ vX lên vY.
 - **Chi tiết (Changes):** Số lượng file phải sửa do Breaking Changes.
 - **Kế hoạch lùi (Reasoning/Risks):** Ghi rõ lệnh Rollback để User copy-paste nếu cần.

package/skills/qk-ui-audit/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: qk-ui-audit
-version: 3.0.0
+version: 3.1.2
 updated: 2026-07-02
 description: Audit UI for Consistency, Accessibility, Responsive, and Performance.
 category: validation
@@ -21,6 +21,7 @@ pipeline: [analyze, review, validate, complete]
 > **Goal:** Kiểm toán chất lượng Giao diện Người dùng (UI QA). Tìm ra các lỗi hiển thị, sự thiếu đồng nhất và vi phạm Accessibility (a11y).
 
 ## 🔄 1. Chain of Thought (SOP)
+
 1. **Analyze (Scan UI):**
    - Read the UI component's source code.
    - Look for inline styles (`style={{...}}`) and hardcoded magic numbers (e.g., `px`, `%` instead of standard tokens).
@@ -35,10 +36,12 @@ pipeline: [analyze, review, validate, complete]
    - Calculate a rough score (0-100) based on violations.
 
 ## 🛡️ 3. Constraints & Rules
+
 - **Audit Only:** Do not modify the code automatically unless the user explicitly requests you to apply the fixes.
 - **Evidence Based:** Point out the exact line number where the violation occurs.
 
 ## 🌳 3. Decision Tree
+
 ```text
 Does the component contain hardcoded `#hex` colors or `px` values?
   ├── YES → Deduct Consistency score. Recommend using Design Tokens.
@@ -50,10 +53,13 @@ Does the component have clickable `<div>` elements?
 ```
 
 ## 🤝 4. Handoff Pipeline
+
 1. `complete`: Generate the UI Audit Report.
 
 ## 📝 5. Output Format
+
 Vui lòng trả kết quả bằng Tiếng Việt.
+
 - **Tóm tắt (Summary):** Chấm điểm Giao diện (Score: X/100).
 - **Chi tiết (Changes):** Liệt kê các lỗi Consistency, A11y, Responsive (ghi rõ dòng).
 - **Nguyên nhân (Reasoning):** Tại sao lại đánh lỗi điểm đó.

package/skills/qk-ui-system-builder/SKILL.md

@@ -1,9 +1,11 @@
 ---
 name: qk-ui-system-builder
-version: 3.0.0
+version: 3.1.2
 updated: 2026-07-02
 description: Build and maintain Design Systems, Token extraction, and shared UI libraries.
 category: frontend
+behavior: development
+intent: implement-feature
 priority: medium
 tags: [design-system, tokens, shared-components, storybook]
 platforms: [claude-code, cursor, windsurf, gemini-cli]
@@ -19,6 +21,7 @@ pipeline: [analyze, implement, engineering-standard, validate, complete]
 > **Goal:** Đảm bảo tính Nhất quán Giao diện (Consistency). Quản lý Design Tokens và xây dựng thư viện Shared Components.
 
 ## 🔄 1. Chain of Thought (SOP)
+
 1. **Analyze (Token Extraction):**
    - Extract raw colors and typography into CSS Variables or Tailwind config.
 2. **Implement (Component Factory):**
@@ -27,14 +30,18 @@ pipeline: [analyze, implement, engineering-standard, validate, complete]
    - Ensure every variation (primary, secondary, disabled) is accounted for.
 
 ## 🛡️ 2. Constraints & Rules
+
 - **Stateless:** System UI components should NEVER have their own backend logic or hardcoded strings.
 - **Extendable:** Always allow users to pass `className` and `...props` to the base element.
 
 ## 🤝 3. Handoff Pipeline
+
 1. `engineering-standard`: Verify naming conventions.
 2. `complete`: Output the Design System Report.
 
 ## 📝 4. Output Format
+
 Vui lòng trả kết quả bằng Tiếng Việt.
+
 - **Tóm tắt (Summary):** Thư viện Component vừa cập nhật.
 - **Chi tiết (Changes):** Liệt kê các variant (màu sắc, kích cỡ).

package/skills/qk-validation-gate/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: qk-validation-gate
-version: 3.0.0
+version: 3.1.2
 updated: 2026-07-02
 description: Mandatory Quality Gate (Test, Lint, Security).
 category: validation
@@ -21,6 +21,7 @@ pipeline: [analyze, validate, complete]
 > **Goal:** Hoạt động như một "Người Gác Cổng" (Gatekeeper). Đảm bảo không có lỗi cú pháp, vi phạm bảo mật, hoặc code rác nào lọt qua trước khi báo cáo hoàn thành.
 
 ## 🔄 1. Chain of Thought (SOP)
+
 1. **Analyze (Static Sweep):**
    - Use `grep_search` to scan modified files for garbage code: `console.log(`, `debugger;`, `// TODO`, `@ts-ignore`.
    - Scan for hardcoded secrets: `API_KEY=`, `Bearer ey...`.
@@ -33,11 +34,13 @@ pipeline: [analyze, validate, complete]
    - If tests fail, report the exact failure to the user. Do NOT pretend it passed.
 
 ## 🛡️ 3. Constraints & Rules
+
 - **Zero Tolerance:** A failed test or a TypeScript error means the Gate is FAILED. Do not ignore errors.
 - **No Force:** Never use `--force` or `--no-verify` flags.
 - **Real Execution:** You MUST run the actual CLI commands using `run_command` and wait for the output.
 
 ## 🌳 3. Decision Tree
+
 ```text
 Did `npm run lint` return errors?
   ├── YES → Are they auto-fixable?
@@ -51,10 +54,13 @@ Did `tsc --noEmit` return errors?
 ```
 
 ## 🤝 4. Handoff Pipeline
+
 1. `complete`: Once all checks pass, output the Validation Report.
 
 ## 📝 5. Output Format
+
 Vui lòng trả kết quả bằng Tiếng Việt.
+
 - **Tóm tắt (Summary):** 🛡️ Đã chạy các cổng kiểm định (Lint, Test, Type).
 - **Chi tiết (Changes):** Liệt kê các lệnh đã chạy và kết quả.
 - **Xác thực (Verification):** Ghi rõ PASS (Xanh) hoặc FAIL (Đỏ).