ai-developer-skill-os 5.0.0 → 6.0.1

package/skills/qk-data-lifecycle/SKILL.md

@@ -1,56 +1,35 @@
 ---
 name: qk-data-lifecycle
-version: 5.0.0
-updated: 2026-07-03
-description: Quản lý Database Schema, Migrations, và Repositories.
-category: database
-tags: [database, schema, migrations, orm]
-platforms: [claude-code, cursor, windsurf, gemini-cli]
+category: infrastructure
+version: 6.0.0
 ---
 
-# 🛠️ qk-data-lifecycle
+# qk-data-lifecycle
 
-> **Inheritance:** Kỹ năng này tuân thủ Kiến trúc v5.0 của `framework/KERNEL.md`.
-> Output bắt buộc là Decision Summary.
+## Scope
+- Database Schema, Migrations, and Repositories management (Plan & Execute)
 
----
-
-## 🎯 Mission (Scope)
-- ✅ Thiết kế cấu trúc CSDL và viết file Migration an toàn.
-- ❌ Do NOT xóa cột hoặc đổi tên cột đang dùng (DROP/RENAME) mà không dùng cơ chế "Expand & Contract".
-
----
-
-## ⚙️ Capabilities (Cognitive Pipeline)
+## Constraints
 ```yaml
-Pipeline:
-  - inference
-  - planning
-  - execution
-  - bias-review
-  - ship-check
+must:
+  - Ensure data schema matches application domain models
+  - Generate reversible migration scripts
+must_not:
+  - Perform destructive schema changes without explicit user approval
 ```
 
----
-
-## 🎛️ Dials (Hành vi)
+## Policies
 ```yaml
-Dials:
-  - id: strictness
+prefer:
+  - Declarative schema definitions over imperative scripts
 ```
 
----
-
-## 🛡️ Biases (Sửa lỗi mặc định)
+## Escalation
 ```yaml
-Biases:
-  - id: over-indexing # (Chống thói quen đánh index bừa bãi)
+stop:
+  - Migration script risks massive data loss
 ```
 
----
-
-## 🛫 Ship Criteria
-```yaml
-Rules:
-  - id: minimal-diff
+## Output
+- Database schemas and migration scripts
 ```

package/skills/qk-db-optimizer/SKILL.md

@@ -1,56 +1,35 @@
 ---
 name: qk-db-optimizer
-version: 5.0.0
-updated: 2026-07-03
-description: Tối ưu hóa Database (đánh Index, xử lý N+1 Queries, Slow Queries).
-category: database
-tags: [database, performance, optimization, queries]
-platforms: [claude-code, cursor, windsurf, gemini-cli]
+category: infrastructure
+version: 6.0.0
 ---
 
-# 🛠️ qk-db-optimizer
+# qk-db-optimizer
 
-> **Inheritance:** Kỹ năng này tuân thủ Kiến trúc v5.0 của `framework/KERNEL.md`.
-> Output bắt buộc là Decision Summary.
+## Scope
+- Database optimization (Indexes, N+1 Queries, Slow Queries) (Diagnose & Evaluate)
 
----
-
-## 🎯 Mission (Scope)
-- ✅ Tìm nguyên nhân gây nghẽn cổ chai DB và đề xuất Query Optimization.
-- ❌ Do NOT vội vàng đề xuất Redis/Cache trước khi fix tận gốc câu SQL lỗi.
-
----
-
-## ⚙️ Capabilities (Cognitive Pipeline)
+## Constraints
 ```yaml
-Pipeline:
-  - inference
-  - planning
-  - execution
-  - bias-review
-  - ship-check
+must:
+  - Analyze query execution plans if available
+  - Suggest non-breaking performance fixes
+must_not:
+  - Change database engine or major architecture without consent
 ```
 
----
-
-## 🎛️ Dials (Hành vi)
+## Policies
 ```yaml
-Dials:
-  - id: optimization-strategy
+prefer:
+  - Adding indexes before rewriting complex queries
 ```
 
----
-
-## 🛡️ Biases (Sửa lỗi mặc định)
+## Escalation
 ```yaml
-Biases:
-  - id: over-indexing
+ask:
+  - For exact slow query logs if not provided
 ```
 
----
-
-## 🛫 Ship Criteria
-```yaml
-Rules:
-  - id: minimal-diff
+## Output
+- Optimization plan and SQL patches
 ```

package/skills/qk-design-to-code/SKILL.md

@@ -1,58 +1,37 @@
 ---
 name: qk-design-to-code
-version: 5.0.0
-updated: 2026-07-03
-description: Chuyển đổi thiết kế từ Figma/Images thành các UI component hoàn chỉnh, chuẩn pixel.
 category: frontend
-tags: [ui, figma, frontend, styling, css]
-platforms: [claude-code, cursor, windsurf, gemini-cli]
+version: 6.0.0
 ---
 
-# 🛠️ qk-design-to-code
+# qk-design-to-code
 
-> **Inheritance:** Kỹ năng này tuân thủ Kiến trúc v5.0 của `framework/KERNEL.md`.
-> Output bắt buộc là Decision Summary.
+## Scope
+- Converting Figma/UI designs into pixel-perfect frontend code (Execute)
 
----
-
-## 🎯 Mission (Scope)
-- ✅ Dịch thiết kế thành mã nguồn pixel-perfect.
-- ❌ Do NOT lạm dụng thẻ `<div>` thay cho Semantic HTML.
-
----
-
-## ⚙️ Capabilities (Cognitive Pipeline)
+## Constraints
 ```yaml
-Pipeline:
-  - inference
-  - planning
-  - execution
-  - bias-review
-  - ship-check
+must:
+  - Use the project's existing design system / tokens
+  - Ensure responsive layouts
+must_not:
+  - Hardcode magic numbers for spacing/colors
+  - Invent new UI components if existing ones suffice
 ```
 
----
-
-## 🎛️ Dials (Hành vi)
+## Policies
 ```yaml
-Dials:
-  - id: aesthetic-vibe
-  - id: strictness
+prefer:
+  - Semantic HTML elements
+  - CSS Grid / Flexbox over absolute positioning
 ```
 
----
-
-## 🛡️ Biases (Sửa lỗi mặc định)
+## Escalation
 ```yaml
-Biases:
-  - id: fake-ui-slop # (Vẽ UI giả mạo không dùng ảnh placeholder thật)
-  - id: missing-ui-states # (Bỏ quên :active, :hover)
+stop:
+  - Design assets or requirements are ambiguous
 ```
 
----
-
-## 🛫 Ship Criteria
-```yaml
-Rules:
-  - id: end-to-end-validation
+## Output
+- Frontend components and stylesheets
 ```

package/skills/qk-docs/SKILL.md

@@ -1,56 +1,36 @@
 ---
 name: qk-docs
-version: 5.0.0
-updated: 2026-07-03
-description: Viết và duy trì tài liệu dự án để con người có thể dễ dàng đọc hiểu.
-category: documentation
-tags: [documentation, readme, comments]
-platforms: [claude-code, cursor, windsurf, gemini-cli]
+category: utilities
+version: 6.0.0
 ---
 
-# 🛠️ qk-docs
+# qk-docs
 
-> **Inheritance:** Kỹ năng này tuân thủ Kiến trúc v5.0 của `framework/KERNEL.md`.
-> Output bắt buộc là Decision Summary.
+## Scope
+- Writing and maintaining project documentation for human readability (Execute)
 
----
-
-## 🎯 Mission (Scope)
-- ✅ Dịch logic phức tạp thành giải thích tiếng Việt trong sáng cho con người.
-- ❌ Do NOT dịch nguyên xi các thuật ngữ chuyên ngành (Props, Hook, Cache).
-
----
-
-## ⚙️ Capabilities (Cognitive Pipeline)
+## Constraints
 ```yaml
-Pipeline:
-  - inference
-  - planning
-  - execution
-  - bias-review
-  - ship-check
+must:
+  - Keep documentation in sync with the actual codebase
+  - Use clear, accessible language
+must_not:
+  - Generate overly verbose or redundant docs
+  - Invent features that don't exist in the code
 ```
 
----
-
-## 🎛️ Dials (Hành vi)
+## Policies
 ```yaml
-Dials:
-  - id: strictness
+prefer:
+  - Examples and code snippets over pure text
 ```
 
----
-
-## 🛡️ Biases (Sửa lỗi mặc định)
+## Escalation
 ```yaml
-Biases:
-  - id: hallucinated-tools # (Tự bịa ra các step hướng dẫn không tồn tại)
+stop:
+  - The codebase logic is too ambiguous to document accurately
 ```
 
----
-
-## 🛫 Ship Criteria
-```yaml
-Rules:
-  - id: minimal-diff
+## Output
+- Markdown documentation files
 ```

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

@@ -1,57 +1,38 @@
 ---
 name: qk-engineering-standard
-version: 5.0.0
-updated: 2026-07-03
-description: Ép buộc áp dụng SOLID, DRY, Clean Code, và các quy tắc đặt tên.
 category: conventions
-tags: [clean-code, solid, refactoring, conventions]
-platforms: [claude-code, cursor, windsurf, gemini-cli]
+version: 6.0.0
 ---
 
-# 🛠️ qk-engineering-standard
+# qk-engineering-standard
 
-> **Inheritance:** Kỹ năng này tuân thủ Kiến trúc v5.0 của `framework/KERNEL.md`.
-> Output bắt buộc là Decision Summary.
+## Scope
+- Readability and structural improvements (Evaluate)
 
----
-
-## 🎯 Mission (Scope)
-- ✅ Refactor code để áp dụng Clean Architecture.
-- ❌ Do NOT thay đổi logic nghiệp vụ (business logic).
-
----
-
-## ⚙️ Capabilities (Cognitive Pipeline)
+## Constraints
 ```yaml
-Pipeline:
-  - inference
-  - planning
-  - execution
-  - bias-review
-  - ship-check
+must:
+  - Preserve business logic exactly
+  - Ensure tests pass after refactor
+must_not:
+  - Invent new requirements
+  - Change public API signature
 ```
 
----
-
-## 🎛️ Dials (Hành vi)
+## Policies
 ```yaml
-Dials:
-  - id: strictness
+prefer:
+  - Readability over cleverness
+  - Explain trade-offs
 ```
 
----
-
-## 🛡️ Biases (Sửa lỗi mặc định)
+## Escalation
 ```yaml
-Biases:
-  - id: cosmetic-refactor
-  - id: premature-abstraction
+stop:
+  - Tests fail
 ```
 
----
-
-## 🛫 Ship Criteria
-```yaml
-Rules:
-  - id: minimal-diff
+## Output
+- Evaluation summary
+- Refactored code
 ```

package/skills/qk-feature-delivery/SKILL.md

@@ -1,57 +1,39 @@
 ---
 name: qk-feature-delivery
-version: 5.0.0
-updated: 2026-07-03
-description: Phát triển tính năng mới hoàn chỉnh từ Frontend đến Backend.
 category: fullstack
-tags: [feature, frontend, backend, implementation]
-platforms: [claude-code, cursor, windsurf, gemini-cli]
+version: 6.0.0
 ---
 
-# 🛠️ qk-feature-delivery
+# qk-feature-delivery
 
-> **Inheritance:** Kỹ năng này tuân thủ Kiến trúc v5.0 của `framework/KERNEL.md`.
-> Output bắt buộc là Decision Summary.
+## Scope
+- New capabilities (Execute)
 
----
-
-## 🎯 Mission (Scope)
-- ✅ Code tính năng end-to-end (API, DB, UI).
-- ❌ Do NOT dùng lại các thư viện quá cũ hoặc deprecated.
-
----
-
-## ⚙️ Capabilities (Cognitive Pipeline)
+## Constraints
 ```yaml
-Pipeline:
-  - inference
-  - planning
-  - execution
-  - bias-review
-  - ship-check
+must:
+  - Clarify requirements if unclear
+  - Implement complete end-to-end flow
+must_not:
+  - Mix refactoring into feature work
+  - Ignore backward compatibility
 ```
 
----
-
-## 🎛️ Dials (Hành vi)
+## Policies
 ```yaml
-Dials:
-  - id: complexity-budget
+prefer:
+  - Plan before implementing
+  - Cover UI loading/error states
 ```
 
----
-
-## 🛡️ Biases (Sửa lỗi mặc định)
+## Escalation
 ```yaml
-Biases:
-  - id: enterprise-crud
-  - id: missing-ui-states
+stop:
+  - Requirements are ambiguous
+ask:
+  - Before adding heavy dependencies
 ```
 
----
-
-## 🛫 Ship Criteria
-```yaml
-Rules:
-  - id: end-to-end-validation
+## Output
+- Feature implementation
 ```

package/skills/qk-help/SKILL.md

@@ -1,52 +1,34 @@
 ---
 name: qk-help
-version: 5.0.0
-updated: 2026-07-03
-description: Hiển thị danh sách các kỹ năng hiện có và các mẹo sử dụng.
-category: utility
-tags: [help, menu, list]
-platforms: [claude-code, cursor, windsurf, gemini-cli]
+category: core
+version: 6.0.0
 ---
 
-# 🛠️ qk-help
+# qk-help
 
-> **Inheritance:** Kỹ năng này tuân thủ Kiến trúc v5.0 của `framework/KERNEL.md`.
-> Output bắt buộc là Decision Summary.
+## Scope
+- Displaying available skills and usage tips (Collect & Delegate)
 
----
-
-## 🎯 Mission (Scope)
-- ✅ Trình bày bảng hướng dẫn sử dụng nhanh gọn, dễ đọc.
-- ❌ Do NOT đưa ra những tường chữ dài dòng.
-
----
-
-## ⚙️ Capabilities (Cognitive Pipeline)
+## Constraints
 ```yaml
-Pipeline:
-  - execution # Bỏ qua Inference và Planning vì đây là skill cung cấp thông tin.
-  - ship-check
+must:
+  - Present information clearly and concisely
+must_not:
+  - Hallucinate skills that do not exist in the repository
 ```
 
----
-
-## 🎛️ Dials (Hành vi)
+## Policies
 ```yaml
-Dials:
-  - id: strictness
+prefer:
+  - Short, actionable examples over long descriptions
 ```
 
----
-
-## 🛡️ Biases (Sửa lỗi mặc định)
+## Escalation
 ```yaml
-Biases: []
+ask:
+  - If the user's intent is unclear when asking for help
 ```
 
----
-
-## 🛫 Ship Criteria
-```yaml
-Rules:
-  - id: delegation-only
+## Output
+- List of available skills and usage instructions
 ```

package/skills/qk-orchestrator/SKILL.md

@@ -1,58 +1,35 @@
 ---
 name: qk-orchestrator
-version: 5.0.0
-updated: 2026-07-03
-description: Điều hướng yêu cầu của người dùng, phân tích ý định và ủy quyền cho các sub-skills phù hợp.
 category: core
-tags: [orchestrator, routing, dispatch, core]
-platforms: [claude-code, cursor, windsurf, gemini-cli]
+version: 6.0.0
 ---
 
-# 🛠️ qk-orchestrator
+# qk-orchestrator
 
-> **Inheritance:** Kỹ năng này tuân thủ Kiến trúc v5.0 của `framework/KERNEL.md`.
-> Output bắt buộc là Decision Summary.
+## Scope
+- Request analysis and task delegation (Coordinate)
 
----
-
-## 🎯 Mission (Scope)
-- ✅ Phân tích yêu cầu và điều phối cho đúng Skill con.
-- ❌ Do NOT tự tay viết code hoặc thực hiện thay đổi hệ thống.
-
----
-
-## ⚙️ Capabilities (Cognitive Pipeline)
+## Constraints
 ```yaml
-Pipeline:
-  - inference
-  - planning
-  - delegation # <-- Core capability
-  - bias-review
-  - ship-check
+must:
+  - Route user request to the correct sub-skill
+must_not:
+  - Write code directly
+  - Hallucinate non-existent skills
 ```
 
----
-
-## 🎛️ Dials (Hành vi)
+## Policies
 ```yaml
-Dials:
-  - id: autonomy # (Tự động quyết định hay chờ lệnh)
-  - id: strictness
+prefer:
+  - Delegate to specialist skills
 ```
 
----
-
-## 🛡️ Biases (Sửa lỗi mặc định)
+## Escalation
 ```yaml
-Biases:
-  - id: hallucinated-tools # (Tự bịa ra các tool/skill không tồn tại)
-  - id: absent-delegation # (Tự nhảy vào code thay vì giao việc)
+stop:
+  - No matching skill is found
 ```
 
----
-
-## 🛫 Ship Criteria
-```yaml
-Rules:
-  - id: delegation-only
+## Output
+- Delegation plan
 ```

package/skills/qk-policy-engine/SKILL.md

@@ -1,55 +1,35 @@
 ---
 name: qk-policy-engine
-version: 5.0.0
-updated: 2026-07-03
-description: Hệ thống đánh giá chính sách để đảm bảo các hành động an toàn và được ủy quyền.
 category: security
-tags: [security, policy, safety, guardrails]
-platforms: [claude-code, cursor, windsurf, gemini-cli]
+version: 6.0.0
 ---
 
-# 🛠️ qk-policy-engine
+# qk-policy-engine
 
-> **Inheritance:** Kỹ năng này tuân thủ Kiến trúc v5.0 của `framework/KERNEL.md`.
-> Output bắt buộc là Decision Summary.
+## Scope
+- System policy evaluation for safe and authorized actions (Govern)
 
----
-
-## 🎯 Mission (Scope)
-- ✅ Đóng vai trò Guardrails, ngăn chặn các hành vi phá hoại trước khi chúng diễn ra.
-- ❌ Do NOT đồng ý thực thi lệnh nguy hiểm (drop table, rm -rf) trừ khi có sự xác nhận mạnh mẽ.
-
----
-
-## ⚙️ Capabilities (Cognitive Pipeline)
+## Constraints
 ```yaml
-Pipeline:
-  - inference
-  - planning
-  - bias-review
-  - ship-check
+must:
+  - Evaluate requested actions against defined system constraints
+  - Enforce OS-level invariants
+must_not:
+  - Allow destructive commands (e.g. rm -rf /) to bypass checks
 ```
 
----
-
-## 🎛️ Dials (Hành vi)
+## Policies
 ```yaml
-Dials:
-  - id: strictness
+prefer:
+  - Strict adherence to policy over convenience
 ```
 
----
-
-## 🛡️ Biases (Sửa lỗi mặc định)
+## Escalation
 ```yaml
-Biases:
-  - id: swallow-errors
+stop:
+  - Action explicitly violates core safety policies
 ```
 
----
-
-## 🛫 Ship Criteria
-```yaml
-Rules:
-  - id: delegation-only
+## Output
+- Policy evaluation result (Allow/Deny)
 ```