ai-developer-skill-os 8.2.0 → 8.3.0

package/.agents/workflows/skill-evolution.yml

@@ -1,65 +1,97 @@
-name: skill-evolution
-description: "Workflow vòng lặp tiến hóa và tối ưu hóa skill (Skill Evolution)."
-version: 1.0.0
-
-steps:
-  - id: observe_usage
-    name: "Observe Usage"
-    purpose: "Theo dõi cách skill được sử dụng"
-    required: true
-    inputs: [skill_logs]
-    outputs: [usage_metrics]
-    actions:
-      - "Thống kê trigger rate và token usage"
-
-  - id: measure_success
-    name: "Measure Success"
-    purpose: "Đánh giá tỷ lệ thành công"
-    required: true
-    inputs: [usage_metrics, execution_results]
-    outputs: [success_rate]
-    actions:
-      - "Xác định các lần exit SUCCESS vs FAILED/PARTIAL"
-
-  - id: detect_failure
-    name: "Detect Failure Patterns"
-    purpose: "Phát hiện lý do thất bại"
-    required: true
-    inputs: [execution_results]
-    outputs: [failure_patterns]
-    actions:
-      - "Phân tích log lỗi, hallucination, out of budget"
-
-  - id: improve_skill
-    name: "Improve Skill"
-    purpose: "Đề xuất tối ưu skill"
-    required: true
-    inputs: [failure_patterns, skill_body]
-    outputs: [improved_skill_proposal]
-    actions:
-      - "Giảm noise trong instruction"
-      - "Cập nhật examples và learnings"
-      - "Tinh chỉnh token budget"
-
-  - id: validate_improvement
-    name: "Validate Improvement"
-    purpose: "Xác thực bản nâng cấp"
-    required: true
-    inputs: [improved_skill_proposal]
-    outputs: [validation_result]
-    actions:
-      - "Chạy qua validate-skills.js"
-      - "Kiểm tra schema compliance"
-
-  - id: promote
-    name: "Promote Skill"
-    purpose: "Đưa bản cải tiến vào sử dụng"
-    required: true
-    inputs: [validation_result]
-    outputs: [stable_skill]
-    actions:
-      - "Chuyển status thành stable"
-
-escalation:
-  max_retries: 1
-  on_failure: "Hủy bỏ bản cải tiến nếu validation thất bại"
+name: skill-evolution
+version: 8.0.0
+description: "Workflow vòng lặp tiến hóa và tối ưu hóa skill (Skill Evolution)."
+
+owner:
+  type: engineering
+  maintained_by: qk-team
+
+verification_profile: skill-evolution
+
+triggers:
+  - "improve this skill"
+  - "tối ưu skill"
+  - "why does this skill keep failing"
+  - "optimize this workflow"
+  - "phân tích usage skill"
+
+ide_binding:
+  slash_command: "/evolve-skill"
+  aliases: ["/skill-tune"]
+
+steps:
+  - id: observe_usage
+    name: "Observe Usage"
+    purpose: "Theo dõi cách skill được sử dụng"
+    required: true
+    inputs:
+      - skill_logs
+    outputs:
+      - usage_metrics
+    actions:
+      - "Thống kê trigger rate và token usage"
+
+  - id: measure_success
+    name: "Measure Success"
+    purpose: "Đánh giá tỷ lệ thành công"
+    required: true
+    inputs:
+      - usage_metrics
+      - execution_results
+    outputs:
+      - success_rate
+    actions:
+      - "Xác định các lần exit SUCCESS vs FAILED/PARTIAL"
+
+  - id: detect_failure
+    name: "Detect Failure Patterns"
+    purpose: "Phát hiện lý do thất bại"
+    required: true
+    inputs:
+      - execution_results
+    outputs:
+      - failure_patterns
+    actions:
+      - "Phân tích log lỗi, hallucination, out of budget"
+
+  - id: improve_skill
+    name: "Improve Skill"
+    purpose: "Đề xuất tối ưu skill"
+    required: true
+    inputs:
+      - failure_patterns
+      - skill_body
+    outputs:
+      - improved_skill_proposal
+    actions:
+      - "Giảm noise trong instruction"
+      - "Cập nhật examples và learnings"
+      - "Tinh chỉnh token budget"
+
+  - id: validate_improvement
+    name: "Validate Improvement"
+    purpose: "Xác thực bản nâng cấp"
+    required: true
+    inputs:
+      - improved_skill_proposal
+    outputs:
+      - validation_result
+    actions:
+      - "Chạy qua validate-skills.js"
+      - "Đảm bảo skill không vi phạm R-C-09"
+      - "Kiểm tra schema compliance"
+
+  - id: promote
+    name: "Promote Skill"
+    purpose: "Đưa bản cải tiến vào sử dụng"
+    required: true
+    inputs:
+      - validation_result
+    outputs:
+      - stable_skill
+    actions:
+      - "Chuyển status thành stable"
+
+escalation:
+  max_retries: 1
+  on_failure: "Hủy bỏ bản cải tiến nếu validation thất bại"

package/.agents/workflows/spec-driven-development.yml

@@ -1,57 +1,87 @@
-name: spec-driven-development
-description: "Workflow phát triển dựa trên đặc tả (Specification-Driven Development)."
-version: 1.0.0
-
-steps:
-  - id: clarify_requirement
-    name: "Clarify Requirements"
-    purpose: "Làm rõ yêu cầu từ ý tưởng ban đầu"
-    required: true
-    inputs: [user_idea]
-    outputs: [clarified_requirement]
-    actions:
-      - "Hỏi các câu hỏi làm rõ scope và constraints"
-      - "Xác định rõ outcome mong muốn"
-
-  - id: create_spec
-    name: "Create Specification"
-    purpose: "Viết tài liệu đặc tả kỹ thuật"
-    required: true
-    inputs: [clarified_requirement]
-    outputs: [technical_spec]
-    actions:
-      - "Thiết kế API contracts, data models"
-      - "Xác định UI/UX heuristics"
-      - "Xác định edge cases"
-
-  - id: create_plan
-    name: "Create Plan"
-    purpose: "Lên kế hoạch triển khai"
-    required: true
-    inputs: [technical_spec]
-    outputs: [implementation_plan]
-    actions:
-      - "Chia nhỏ spec thành các task cụ thể"
-      - "Đánh giá rủi ro và thứ tự ưu tiên"
-
-  - id: implement
-    name: "Implement"
-    purpose: "Triển khai mã nguồn"
-    required: true
-    inputs: [implementation_plan, technical_spec]
-    outputs: [source_code]
-    actions:
-      - "Code theo đúng spec"
-
-  - id: verify
-    name: "Verify Implementation"
-    purpose: "Kiểm tra mã nguồn với đặc tả"
-    required: true
-    inputs: [source_code, technical_spec]
-    outputs: [verification_result]
-    actions:
-      - "Đối chiếu kết quả code với acceptance criteria"
-
-escalation:
-  max_retries: 2
-  on_failure: "Báo cáo lệch spec và xin chỉ thị"
+name: spec-driven-development
+version: 8.0.0
+description: "Workflow phát triển dựa trên đặc tả (Specification-Driven Development)."
+
+owner:
+  type: engineering
+  maintained_by: qk-team
+
+verification_profile: spec-driven
+
+triggers:
+  - "write a spec"
+  - "viết đặc tả"
+  - "spec this out"
+  - "design before implementing"
+  - "technical spec for"
+
+ide_binding:
+  slash_command: "/spec"
+  aliases: ["/spec-driven"]
+
+steps:
+  - id: clarify_requirement
+    name: "Clarify Requirements"
+    purpose: "Làm rõ yêu cầu từ ý tưởng ban đầu"
+    required: true
+    inputs:
+      - user_idea
+    outputs:
+      - clarified_requirement
+    actions:
+      - "Hỏi các câu hỏi làm rõ scope và constraints"
+      - "Xác định rõ outcome mong muốn"
+
+  - id: create_spec
+    name: "Create Specification"
+    purpose: "Viết tài liệu đặc tả kỹ thuật"
+    required: true
+    inputs:
+      - clarified_requirement
+    outputs:
+      - technical_spec
+    actions:
+      - "Thiết kế API contracts, data models"
+      - "Xác định UI/UX heuristics"
+      - "Spec phải quy định rõ boundary validation (R-SEC-04)"
+      - "Xác định edge cases"
+
+  - id: create_plan
+    name: "Create Plan"
+    purpose: "Lên kế hoạch triển khai"
+    required: true
+    inputs:
+      - technical_spec
+    outputs:
+      - implementation_plan
+    actions:
+      - "Chia nhỏ spec thành các task cụ thể"
+      - "Đánh giá rủi ro và thứ tự ưu tiên"
+
+  - id: implement
+    name: "Implement"
+    purpose: "Triển khai mã nguồn"
+    required: true
+    inputs:
+      - implementation_plan
+      - technical_spec
+    outputs:
+      - source_code
+    actions:
+      - "Code theo đúng spec"
+
+  - id: verify
+    name: "Verify Implementation"
+    purpose: "Kiểm tra mã nguồn với đặc tả"
+    required: true
+    inputs:
+      - source_code
+      - technical_spec
+    outputs:
+      - verification_result
+    actions:
+      - "Đối chiếu kết quả code với acceptance criteria"
+
+escalation:
+  max_retries: 2
+  on_failure: "Báo cáo lệch spec và xin chỉ thị"

package/CHANGELOG.md

@@ -5,6 +5,16 @@ Format: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 
 ---
 
+## [8.2.1] — 2026-07 — Token Optimization Patch
+
+### Fixed
+- **`stop_early: false` → `true` in 13 skills**: `qk-code-review`, `qk-data-lifecycle`, `qk-design-system-engineering`, `qk-devops-platform`, `qk-feature-delivery`, `qk-frontend-architecture`, `qk-production-release`, `qk-product-specification`, `qk-project-bootstrap`, `qk-security-audit`, `qk-system-evolution`, `qk-test-engineering`, `qk-ui-builder`, `qk-web-quality-gate` — skills now self-terminate when token budget is exhausted instead of running indefinitely.
+- **Removed 20 duplicate metadata blocks**: Stripped repeated `skill_version/runtime_version/schema_version` YAML blocks from `qk-orchestrator` (11×) and `qk-context-loader` (9×) — saves ~1320 chars per context load.
+- **`qk-code-review` Dynamic Context Loading: mandatory → on-demand**: References are now only read when a specific issue is found, not before every review. Eliminates 2 forced `view_file` calls per review session.
+- **`qk-feature-delivery` FAST PATH**: Simple tasks (≤1 file, no new API, no DB migration) now bypass `qk-context-loader` and Phase 1 clarification — saves 2–3 turns per simple fix.
+
+---
+
 ## [8.2.0] — 2026-07 — EDAOS v8.2: Governed Capability Metadata & Eval Platform
 
 ### Added

package/README.md

@@ -1,90 +1,90 @@
-# 🚀 AI Developer Skill OS (ai-developer-skill-os) v8.2.0
-
-> **v8.2.0 "EDAOS v8.2 — Governed Capability Metadata & Eval Platform"**
-
-Hệ sinh thái AI Developer Skill OS tiến hóa lên phiên bản **V8.2.0 (EDAOS v8.2)** với kiến trúc **Manifest-First & Eval Platform**, giúp giảm tối đa chi phí nhận thức (cognitive load) cho các AI Agent thế hệ mới (như Antigravity) nhờ chỉ định ranh giới định lượng, đồ thị phụ thuộc O(1), và các Blueprint Plugins quy chuẩn cho từng ngành nghề kỹ thuật.
-
----
-
-## 🏗️ 4 Trụ Cột Kiến Trúc Cốt Lõi (EDAOS v8.2 Architecture)
-
-### 1. Manifest-First & O(1) Registry Engine
-Không còn phụ thuộc vào việc đọc/scan toàn bộ markdown mệt mỏi. AI Agent tra cứu siêu dữ liệu từ `.agents/registry/index.yaml` và kiểm duyệt chu trình không lặp (acyclic validation) thông qua O(1) graph JSON (`.agents/registry/graph.json`). Tốc độ hiểu và phân công năng lực đạt ngưỡng sub-second!
-
-### 2. V8.2 Blueprint Plugins & Universal 4-Folder Architecture
-Khởi tạo dự án (chỉ đạo qua `qk-project-bootstrap`) hỗ trợ sinh file `project.yaml` gốc từ thư viện Blueprint Plugins:
-- **RAG / AI Agents:** Cấu trúc 4 thư mục chuẩn thực chiến: `prompts/`, `data/` (bảo vệ `data/raw` bất biến), `agents/`, và `evals/`.
-- **Standard Software Coding:** Kiến trúc module sạch vững chắc với `DESIGN.md` và rào cản kiểm duyệt tự động.
-- **Automation Workflows:** Các luồng tích hợp n8n và dữ liệu lớn.
-
-### 3. Eval Pipeline Platform (Khép Kín Kiểm Định)
-Chấm dứt việc tin tưởng AI blindly. Mọi Capability đều có thẻ điểm định lượng (`scorecard.yaml`), kết nối log thực thi thực tế từ thư mục `evals/traces/` qua cổng thẩm định sắt đá `qk-validation-gate`. Trách nhiệm định lượng 0–100 với sai số 0% (zero tolerance for fabrication).
-
-### 4. Domain Patterns Separation (Bảo Vệ Kernel)
-Các hệ thống AI chuyên sâu (như **Xây dựng DDC 192 skills**, bóc tách BIM/IFC, ERP) được tải lập trình viên cấu hình dạng Module dưới `knowledge/domain-patterns/` thay vì phơi bày trực tiếp vào 30 Core Developer Skills, giữ cho đồ thị cốt lõi luôn nhanh bén mượt mà!
-
----
-
-## 🧩 Danh sách 30 Master Skills (Core Developer Capabilities)
-
-Các kỹ năng được quản lý bằng **Capability Graph** và được đánh giá liên tục thông qua Evaluation Suite. Bao gồm 7 lĩnh vực:
-1. **Core & Orchestration:** `qk-orchestrator`, `qk-context-loader`, `qk-project-memory`, `qk-help`
-2. **Product & Architecture:** `qk-product-specification`, `qk-project-bootstrap`, `qk-frontend-architecture`
-3. **Frontend & UI:** `qk-design-system-engineering`, `qk-ui-system-builder`, `qk-ui-builder`, `qk-fe-api-integration`, `qk-ui-audit`
-4. **Backend & Data:** `qk-api-lifecycle`, `qk-data-lifecycle`, `qk-access-policy`
-5. **Engineering & Delivery:** `qk-feature-delivery`, `qk-bug-resolution`, `qk-engineering-standard`, `qk-system-evolution`, `qk-docs`
-6. **Quality & Testing:** `qk-test-engineering`, `qk-validation-gate`, `qk-web-quality-gate`, `qk-project-health`
-7. **Security, DevOps & Analytics:** `qk-security-audit`, `qk-db-optimizer`, `qk-devops-platform`, `qk-production-release`, `qk-agent-observability`, `qk-ai-builder`
-
----
-
-## 💻 Cách Cài Đặt (Installation)
-
-### Cách 1: NXP (Không cần cài global) - MỚI
-```bash
-npx ai-developer-skill-os init
-```
-
-### Cách 2: NPM Global (Khuyên dùng cho cá nhân)
-```bash
-npm i -g ai-developer-skill-os
-```
-
-### Chạy bằng tham số (Command Line Arguments)
-```bash
-# Cài Antigravity Global (toàn máy)
-npx ai-developer-skill-os init --ide=antigravity --scope=2
-
-# Cài Antigravity Local (chỉ dự án này)
-npx ai-developer-skill-os init --ide=antigravity --scope=1
-
-# Cài Cursor Local
-npx ai-developer-skill-os init --ide=cursor --scope=1
-```
-
-## 📦 Các IDE/AI Assistant Được Hỗ Trợ
-- (1) Cursor
-- (2) Windsurf
-- (3) Cline / Roo Code
-- (4) Antigravity / Gemini
-- (5) Codex
-- (6) Kilo Code
-
----
-
-## 🧪 Đánh Giá Tự Động (Agent Evaluation)
-
-Hệ thống đi kèm một bộ Runner nội bộ để kiểm toán **Routing Intelligence**. Bất kỳ cập nhật nào vào hệ thống Kỹ năng đều phải vượt qua bài kiểm tra hóc búa (Bypass Security, Boundary Attacks, Ambiguous Prompts):
-
-```bash
-npm run test:agent
-npm run test:graph
-npm run test:registry
-```
-
-## 🚀 Hướng Dẫn Sử Dụng
-Sau khi cài đặt thành công, hãy gõ lệnh:
-```bash
-./qk-help
-```
-để kích hoạt AI Orchestrator và khám phá sức mạnh của hệ điều hành!
+# 🚀 AI Developer Skill OS (ai-developer-skill-os) v8.3.0
+
+> **v8.3.0 "EDAOS v8.3 — Governed Capability Metadata & Eval Platform"**
+
+Hệ sinh thái AI Developer Skill OS tiến hóa lên phiên bản **V8.3.0 (EDAOS v8.3)** với kiến trúc **Manifest-First & Eval Platform**, giúp giảm tối đa chi phí nhận thức (cognitive load) cho các AI Agent thế hệ mới (như Antigravity) nhờ chỉ định ranh giới định lượng, đồ thị phụ thuộc O(1), và các Blueprint Plugins quy chuẩn cho từng ngành nghề kỹ thuật.
+
+---
+
+## 🏗️ 4 Trụ Cột Kiến Trúc Cốt Lõi (EDAOS v8.2 Architecture)
+
+### 1. Manifest-First & O(1) Registry Engine
+Không còn phụ thuộc vào việc đọc/scan toàn bộ markdown mệt mỏi. AI Agent tra cứu siêu dữ liệu từ `.agents/registry/index.yaml` và kiểm duyệt chu trình không lặp (acyclic validation) thông qua O(1) graph JSON (`.agents/registry/graph.json`). Tốc độ hiểu và phân công năng lực đạt ngưỡng sub-second!
+
+### 2. V8.2 Blueprint Plugins & Universal 4-Folder Architecture
+Khởi tạo dự án (chỉ đạo qua `qk-project-bootstrap`) hỗ trợ sinh file `project.yaml` gốc từ thư viện Blueprint Plugins:
+- **RAG / AI Agents:** Cấu trúc 4 thư mục chuẩn thực chiến: `prompts/`, `data/` (bảo vệ `data/raw` bất biến), `agents/`, và `evals/`.
+- **Standard Software Coding:** Kiến trúc module sạch vững chắc với `DESIGN.md` và rào cản kiểm duyệt tự động.
+- **Automation Workflows:** Các luồng tích hợp n8n và dữ liệu lớn.
+
+### 3. Eval Pipeline Platform (Khép Kín Kiểm Định)
+Chấm dứt việc tin tưởng AI blindly. Mọi Capability đều có thẻ điểm định lượng (`scorecard.yaml`), kết nối log thực thi thực tế từ thư mục `evals/traces/` qua cổng thẩm định sắt đá `qk-validation-gate`. Trách nhiệm định lượng 0–100 với sai số 0% (zero tolerance for fabrication).
+
+### 4. Domain Patterns Separation (Bảo Vệ Kernel)
+Các hệ thống AI chuyên sâu (như **Xây dựng DDC 192 skills**, bóc tách BIM/IFC, ERP) được tải lập trình viên cấu hình dạng Module dưới `knowledge/domain-patterns/` thay vì phơi bày trực tiếp vào 30 Core Developer Skills, giữ cho đồ thị cốt lõi luôn nhanh bén mượt mà!
+
+---
+
+## 🧩 Danh sách 30 Master Skills (Core Developer Capabilities)
+
+Các kỹ năng được quản lý bằng **Capability Graph** và được đánh giá liên tục thông qua Evaluation Suite. Bao gồm 7 lĩnh vực:
+1. **Core & Orchestration:** `qk-orchestrator`, `qk-context-loader`, `qk-project-memory`, `qk-help`
+2. **Product & Architecture:** `qk-product-specification`, `qk-project-bootstrap`, `qk-frontend-architecture`
+3. **Frontend & UI:** `qk-design-system-engineering`, `qk-ui-system-builder`, `qk-ui-builder`, `qk-fe-api-integration`, `qk-ui-audit`
+4. **Backend & Data:** `qk-api-lifecycle`, `qk-data-lifecycle`, `qk-access-policy`
+5. **Engineering & Delivery:** `qk-feature-delivery`, `qk-bug-resolution`, `qk-engineering-standard`, `qk-system-evolution`, `qk-docs`
+6. **Quality & Testing:** `qk-test-engineering`, `qk-validation-gate`, `qk-web-quality-gate`, `qk-project-health`
+7. **Security, DevOps & Analytics:** `qk-security-audit`, `qk-db-optimizer`, `qk-devops-platform`, `qk-production-release`, `qk-agent-observability`, `qk-ai-builder`
+
+---
+
+## 💻 Cách Cài Đặt (Installation)
+
+### Cách 1: NXP (Không cần cài global) - MỚI
+```bash
+npx ai-developer-skill-os init
+```
+
+### Cách 2: NPM Global (Khuyên dùng cho cá nhân)
+```bash
+npm i -g ai-developer-skill-os
+```
+
+### Chạy bằng tham số (Command Line Arguments)
+```bash
+# Cài Antigravity Global (toàn máy)
+npx ai-developer-skill-os init --ide=antigravity --scope=2
+
+# Cài Antigravity Local (chỉ dự án này)
+npx ai-developer-skill-os init --ide=antigravity --scope=1
+
+# Cài Cursor Local
+npx ai-developer-skill-os init --ide=cursor --scope=1
+```
+
+## 📦 Các IDE/AI Assistant Được Hỗ Trợ
+- (1) Cursor
+- (2) Windsurf
+- (3) Cline / Roo Code
+- (4) Antigravity / Gemini
+- (5) Codex
+- (6) Kilo Code
+
+---
+
+## 🧪 Đánh Giá Tự Động (Agent Evaluation)
+
+Hệ thống đi kèm một bộ Runner nội bộ để kiểm toán **Routing Intelligence**. Bất kỳ cập nhật nào vào hệ thống Kỹ năng đều phải vượt qua bài kiểm tra hóc búa (Bypass Security, Boundary Attacks, Ambiguous Prompts):
+
+```bash
+npm run test:agent
+npm run test:graph
+npm run test:registry
+```
+
+## 🚀 Hướng Dẫn Sử Dụng
+Sau khi cài đặt thành công, hãy gõ lệnh:
+```bash
+./qk-help
+```
+để kích hoạt AI Orchestrator và khám phá sức mạnh của hệ điều hành!