ai-developer-skill-os 9.1.0 → 9.1.2

package/.agents/AGENTS.md

@@ -47,18 +47,18 @@ Khi thực thi BẤT KỲ kỹ năng nào (tất cả các lệnh `./qk-*` hoặ
    - *"Memory chỉ dùng để giảm thời gian tìm kiếm (Navigator), không thay thế việc đọc mã nguồn hiện tại (Not a Source of Truth)."*
    - *"AGENTS.md và knowledge/index.yaml là tài liệu kỹ thuật của dự án, tuyệt đối KHÔNG phải nhật ký hội thoại của AI."*
 
-2. **Cơ chế tra cứu trước khi làm (Pre-flight Load)**:
-   - Trước khi mò mẫm tìm kiếm toàn dự án (search_web/grep), BẮT BUỘC kiểm tra và tra cứu `index.yaml` (trong `.ai-local/knowledge/` cho Private Mode, hoặc `.agents/knowledge/` cho Shared Mode).
+2. **Cơ chế tự động khởi tạo & tra cứu (Self-Init & Pre-flight Load)**:
+   - **Tự động Khởi tạo & Gitignore:** Nếu thư mục `.ai-local/` chưa tồn tại trong project, AI BẮT BUỘC phải tự động tạo cấu trúc thư mục (`.ai-local/knowledge/`, `.ai-local/candidates/`) và tự động thêm dòng `.ai-local/` vào file `.gitignore` của dự án (nếu chưa có) để đảm bảo AI biết rõ nơi tra cứu/lưu trữ và tuyệt đối bảo mật tri thức cá nhân.
+   - **Tra cứu trước khi làm:** Trước khi mò mẫm tìm kiếm toàn dự án (search_web/grep), BẮT BUỘC kiểm tra và tra cứu tại `.ai-local/knowledge/index.yaml`.
    - Nếu tìm thấy Pattern/Fact liên quan có `status: Active`, áp dụng NGAY LẬP TỨC để bỏ qua bước search dài dòng.
 
-3. **Cơ chế thu hạch tri thức hậu task (Post-flight Harvest - AI Đề xuất, Con người Phê duyệt)**:
+3. **Cơ chế thu hoạch tri thức hậu task (Post-flight Harvest - AI Đề xuất, Con người Phê duyệt)**:
    - Sau khi hoàn thành task, tự đặt câu hỏi: *"Task này có thuộc 1 trong 4 loại (Architecture, Convention, Pattern, Hard Bug) và có đáng nhớ để giúp mở file nhanh hơn / tránh lỗi trả giá đắt không?"*
    - KHÔNG bao giờ tự động sửa ngầm file bộ nhớ. Nếu phát hiện tri thức đáng nhớ, trả về tóm tắt đề xuất và yêu cầu **Người dùng Phê Duyệt**. Các thao tác typo, CSS vặt, đổi text, CRUD thường BẮT BUỘC bỏ qua (Dismiss).
 
-4. **Kỷ luật lưu trữ (Two-Mode & Zero-Overwrite)**:
-   - *Mode 1 (Private - Mặc định cho cá nhân)*: Lưu tại `.ai-local/` (bắt buộc chèn vào `.gitignore`).
-   - *Mode 2 (Shared - Cho Team & CI/CD)*: Lưu tại `.agents/` (để commit & review qua Pull Request).
-   - *Giới hạn siêu gọn*: File `AGENTS.md` của dự án phải DƯỚI 100 dòng. `index.yaml` chỉ dùng đường dẫn tương đối (`src/...`) và tham chiếu biểu tượng (Symbol), tuyệt đối không fix cứng đường dẫn ổ đĩa tuyệt đối cá nhân. Khi tri thức cũ thay đổi, chuyển sang `status: Archived`, không được xóa đè lịch sử (Zero-Overwrite).
+4. **Kỷ luật lưu trữ Local Private (Zero-Overwrite)**:
+   - *Chế độ Local Private duy nhất:* Toàn bộ tri thức bộ nhớ dự án được lưu tại `.ai-local/` (bắt buộc chèn vào `.gitignore`). Đã loại bỏ hoàn toàn việc lưu trữ chung qua `.agents/knowledge/` (Shared Mode) để tập trung vào không gian làm việc cá nhân, tránh nhầm lẫn và không xâm lấn git.
+   - *Giới hạn siêu gọn*: File `.ai-local/AGENTS.md` phải DƯỚI 100 dòng. `index.yaml` chỉ dùng đường dẫn tương đối (`src/...`) và tham chiếu biểu tượng (Symbol), tuyệt đối không fix cứng đường dẫn ổ đĩa tuyệt đối cá nhân. Khi tri thức cũ thay đổi, chuyển sang `status: Archived`, không được xóa đè lịch sử (Zero-Overwrite).
 
 [Command Arguments]
 Người dùng có thể truyền thêm tham số vào lệnh (ví dụ: `./qk-ui-builder --fw=react --css=tailwind`).

package/.agents/registry/graph.json

@@ -1,11 +1,11 @@
 {
   "schema_version": 1,
   "manifest_version": "8.2",
-  "generated_at": "2026-08-03T03:45:24.184Z",
+  "generated_at": "2026-08-14T03:33:18.557Z",
   "nodes": {
     "qk-access-policy": {
       "path": ".agents/skills/qk-access-policy",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "access",
         "policy"
@@ -16,7 +16,7 @@
     },
     "qk-agent-observability": {
       "path": ".agents/skills/qk-agent-observability",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "agent",
         "observability"
@@ -27,7 +27,7 @@
     },
     "qk-ai-builder": {
       "path": ".agents/skills/qk-ai-builder",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "ai",
         "builder"
@@ -38,7 +38,7 @@
     },
     "qk-api-lifecycle": {
       "path": ".agents/skills/qk-api-lifecycle",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "api",
         "lifecycle"
@@ -49,7 +49,7 @@
     },
     "qk-bug-resolution": {
       "path": ".agents/skills/qk-bug-resolution",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "bug",
         "resolution"
@@ -60,7 +60,7 @@
     },
     "qk-code-review": {
       "path": ".agents/skills/qk-code-review",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "code",
         "review"
@@ -71,7 +71,7 @@
     },
     "qk-context-loader": {
       "path": ".agents/skills/qk-context-loader",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "context",
         "loader"
@@ -80,9 +80,22 @@
       "dependents": [],
       "is_orphan": true
     },
+    "qk-data-engineer": {
+      "path": ".agents/skills/qk-data-engineer",
+      "version": "9.1.0",
+      "tags": [
+        "data",
+        "engineer"
+      ],
+      "dependencies": [
+        "feature-delivery"
+      ],
+      "dependents": [],
+      "is_orphan": false
+    },
     "qk-data-lifecycle": {
       "path": ".agents/skills/qk-data-lifecycle",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "data",
         "lifecycle"
@@ -93,7 +106,7 @@
     },
     "qk-db-optimizer": {
       "path": ".agents/skills/qk-db-optimizer",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "db",
         "optimizer"
@@ -104,7 +117,7 @@
     },
     "qk-design-system-engineering": {
       "path": ".agents/skills/qk-design-system-engineering",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "design",
         "system",
@@ -116,7 +129,7 @@
     },
     "qk-devops-platform": {
       "path": ".agents/skills/qk-devops-platform",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "devops",
         "platform"
@@ -127,7 +140,7 @@
     },
     "qk-docs": {
       "path": ".agents/skills/qk-docs",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "docs"
       ],
@@ -137,7 +150,7 @@
     },
     "qk-engineering-standard": {
       "path": ".agents/skills/qk-engineering-standard",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "engineering",
         "standard"
@@ -148,7 +161,7 @@
     },
     "qk-fe-api-integration": {
       "path": ".agents/skills/qk-fe-api-integration",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "fe",
         "api",
@@ -160,7 +173,7 @@
     },
     "qk-feature-delivery": {
       "path": ".agents/skills/qk-feature-delivery",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "feature",
         "delivery"
@@ -171,7 +184,7 @@
     },
     "qk-frontend-architecture": {
       "path": ".agents/skills/qk-frontend-architecture",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "frontend",
         "architecture"
@@ -182,7 +195,7 @@
     },
     "qk-help": {
       "path": ".agents/skills/qk-help",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "help"
       ],
@@ -192,7 +205,7 @@
     },
     "qk-orchestrator": {
       "path": ".agents/skills/qk-orchestrator",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "orchestrator"
       ],
@@ -202,7 +215,7 @@
     },
     "qk-product-specification": {
       "path": ".agents/skills/qk-product-specification",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "product",
         "specification"
@@ -213,7 +226,7 @@
     },
     "qk-production-release": {
       "path": ".agents/skills/qk-production-release",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "production",
         "release"
@@ -224,7 +237,7 @@
     },
     "qk-project-bootstrap": {
       "path": ".agents/skills/qk-project-bootstrap",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "project",
         "bootstrap"
@@ -235,7 +248,7 @@
     },
     "qk-project-health": {
       "path": ".agents/skills/qk-project-health",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "project",
         "health"
@@ -246,7 +259,7 @@
     },
     "qk-project-memory": {
       "path": ".agents/skills/qk-project-memory",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "project",
         "memory"
@@ -257,7 +270,7 @@
     },
     "qk-refactor": {
       "path": ".agents/skills/qk-refactor",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "refactor"
       ],
@@ -269,7 +282,7 @@
     },
     "qk-security-audit": {
       "path": ".agents/skills/qk-security-audit",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "security",
         "audit"
@@ -280,7 +293,7 @@
     },
     "qk-system-evolution": {
       "path": ".agents/skills/qk-system-evolution",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "system",
         "evolution"
@@ -291,7 +304,7 @@
     },
     "qk-test-engineering": {
       "path": ".agents/skills/qk-test-engineering",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "test",
         "engineering"
@@ -302,7 +315,7 @@
     },
     "qk-ui-audit": {
       "path": ".agents/skills/qk-ui-audit",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "ui",
         "audit"
@@ -313,7 +326,7 @@
     },
     "qk-ui-builder": {
       "path": ".agents/skills/qk-ui-builder",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "ui",
         "builder"
@@ -326,7 +339,7 @@
     },
     "qk-ui-system-builder": {
       "path": ".agents/skills/qk-ui-system-builder",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "ui",
         "system",
@@ -338,7 +351,7 @@
     },
     "qk-validation-gate": {
       "path": ".agents/skills/qk-validation-gate",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "validation",
         "gate"
@@ -349,7 +362,7 @@
     },
     "qk-web-quality-gate": {
       "path": ".agents/skills/qk-web-quality-gate",
-      "version": "9.0.0",
+      "version": "9.1.0",
       "tags": [
         "web",
         "quality",
@@ -368,6 +381,9 @@
     "qk-bug-resolution": [],
     "qk-code-review": [],
     "qk-context-loader": [],
+    "qk-data-engineer": [
+      "feature-delivery"
+    ],
     "qk-data-lifecycle": [],
     "qk-db-optimizer": [],
     "qk-design-system-engineering": [],
@@ -399,7 +415,7 @@
     "qk-web-quality-gate": []
   },
   "stats": {
-    "total_capabilities": 32,
+    "total_capabilities": 33,
     "has_cycles": false
   }
 }

package/.agents/registry/index.yaml

@@ -2,74 +2,82 @@
 # DO NOT EDIT MANUALLY. THIS IS A GENERATED RUNTIME ARTIFACT.
 schema_version: 1
 manifest_version: '8.2'
-generated_at: '2026-08-03T03:45:24.184Z'
+generated_at: '2026-08-14T03:33:18.557Z'
 capabilities:
   qk-access-policy:
     path: .agents/skills/qk-access-policy
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - access
       - policy
     dependencies: []
   qk-agent-observability:
     path: .agents/skills/qk-agent-observability
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - agent
       - observability
     dependencies: []
   qk-ai-builder:
     path: .agents/skills/qk-ai-builder
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - ai
       - builder
     dependencies: []
   qk-api-lifecycle:
     path: .agents/skills/qk-api-lifecycle
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - api
       - lifecycle
     dependencies: []
   qk-bug-resolution:
     path: .agents/skills/qk-bug-resolution
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - bug
       - resolution
     dependencies: []
   qk-code-review:
     path: .agents/skills/qk-code-review
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - code
       - review
     dependencies: []
   qk-context-loader:
     path: .agents/skills/qk-context-loader
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - context
       - loader
     dependencies: []
+  qk-data-engineer:
+    path: .agents/skills/qk-data-engineer
+    version: 9.1.0
+    tags:
+      - data
+      - engineer
+    dependencies:
+      - feature-delivery
   qk-data-lifecycle:
     path: .agents/skills/qk-data-lifecycle
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - data
       - lifecycle
     dependencies: []
   qk-db-optimizer:
     path: .agents/skills/qk-db-optimizer
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - db
       - optimizer
     dependencies: []
   qk-design-system-engineering:
     path: .agents/skills/qk-design-system-engineering
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - design
       - system
@@ -77,27 +85,27 @@ capabilities:
     dependencies: []
   qk-devops-platform:
     path: .agents/skills/qk-devops-platform
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - devops
       - platform
     dependencies: []
   qk-docs:
     path: .agents/skills/qk-docs
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - docs
     dependencies: []
   qk-engineering-standard:
     path: .agents/skills/qk-engineering-standard
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - engineering
       - standard
     dependencies: []
   qk-fe-api-integration:
     path: .agents/skills/qk-fe-api-integration
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - fe
       - api
@@ -105,103 +113,103 @@ capabilities:
     dependencies: []
   qk-feature-delivery:
     path: .agents/skills/qk-feature-delivery
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - feature
       - delivery
     dependencies: []
   qk-frontend-architecture:
     path: .agents/skills/qk-frontend-architecture
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - frontend
       - architecture
     dependencies: []
   qk-help:
     path: .agents/skills/qk-help
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - help
     dependencies: []
   qk-orchestrator:
     path: .agents/skills/qk-orchestrator
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - orchestrator
     dependencies: []
   qk-product-specification:
     path: .agents/skills/qk-product-specification
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - product
       - specification
     dependencies: []
   qk-production-release:
     path: .agents/skills/qk-production-release
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - production
       - release
     dependencies: []
   qk-project-bootstrap:
     path: .agents/skills/qk-project-bootstrap
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - project
       - bootstrap
     dependencies: []
   qk-project-health:
     path: .agents/skills/qk-project-health
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - project
       - health
     dependencies: []
   qk-project-memory:
     path: .agents/skills/qk-project-memory
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - project
       - memory
     dependencies: []
   qk-refactor:
     path: .agents/skills/qk-refactor
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - refactor
     dependencies:
       - refactor
   qk-security-audit:
     path: .agents/skills/qk-security-audit
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - security
       - audit
     dependencies: []
   qk-system-evolution:
     path: .agents/skills/qk-system-evolution
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - system
       - evolution
     dependencies: []
   qk-test-engineering:
     path: .agents/skills/qk-test-engineering
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - test
       - engineering
     dependencies: []
   qk-ui-audit:
     path: .agents/skills/qk-ui-audit
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - ui
       - audit
     dependencies: []
   qk-ui-builder:
     path: .agents/skills/qk-ui-builder
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - ui
       - builder
@@ -209,7 +217,7 @@ capabilities:
       - feature-delivery
   qk-ui-system-builder:
     path: .agents/skills/qk-ui-system-builder
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - ui
       - system
@@ -217,14 +225,14 @@ capabilities:
     dependencies: []
   qk-validation-gate:
     path: .agents/skills/qk-validation-gate
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - validation
       - gate
     dependencies: []
   qk-web-quality-gate:
     path: .agents/skills/qk-web-quality-gate
-    version: 9.0.0
+    version: 9.1.0
     tags:
       - web
       - quality

package/.agents/rules/global.md

@@ -140,7 +140,7 @@ Agent **SHOULD**:
 
 **MUST** govern project memory like source code: simple, reviewable, updatable, and always human-approved.
 
-- **Dual-Mode Setup:** Prefer `.ai-local/` (Private Mode, gitignored) or `.agents/` (Shared Mode, git-commited).
+- **Self-Init & Local Private Mode:** Always use `.ai-local/` (Private Mode, gitignored) as the sole storage for learned knowledge and memory. If `.ai-local/` does not exist in the project root, the agent **MUST** automatically create the folder structure (`.ai-local/knowledge/`, `.ai-local/candidates/`) and add `.ai-local/` to the project's `.gitignore` file immediately before proceeding. Shared Mode (`.agents/knowledge/index.yaml`) is explicitly disabled and prohibited for dynamic project memory.
 - **Navigator ONLY:** Memory reduces discovery time; it is NOT a replacement for checking live source code.
 - **Strict Content Bounds:** Only store 4 categories in `knowledge/index.yaml`: `Architecture`, `Convention`, `Pattern`, and `Hard Bug`. Discard routine typos, trivial CSS, and standard CRUD.
 - **Zero-Overwrite & Portable:** Mark outdated facts as `status: Archived` (never overwrite history). Always use workspace-relative paths (`src/...`) and AST symbol names instead of hardcoded disk paths or rigid line numbers.