ai-developer-skill-os 7.0.0 → 7.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +59 -93
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,93 +1,59 @@
1
- # 🚀 AI Developer Skill OS (ai-developer-skill-os) v6.0
2
-
3
- > **Rule-Skins v6 is a Behavior Specification Format (BSF), not a prompt library, not an agent framework, and not a programming language. It defines reusable behavioral contracts that can be interpreted by different AI runtimes while remaining implementation-agnostic.**
4
-
5
- Thay vì cung cấp các "công cụ rời rạc" (Toolbox) hoặc những prompt cồng kềnh, **Rule-Skins v6** được tái thiết kế hoàn toàn theo chuẩn **Behavior Specification Format**. Các hành vi (Behaviors) giờ đây là các bản Hợp đồng (Contracts) rõ ràng, bao gồm Policies, Capabilities, và Reasoning Boundaries.
6
-
7
- ---
8
-
9
- ## 🏗️ Kiến Trúc 5 Tầng (Agent OS Kernel)
10
-
11
- Hệ thống được thiết kế decoupled hoàn hảo:
12
-
13
- ### 1. BSF Kernel (`framework/KERNEL.md`)
14
- Trái tim của hệ thống định nghĩa BSF Meta-Model, OS Policy (Invariants), Knowledge Layer, Validation Rules, và Design Principles.
15
-
16
- ### 2. Thư Viện Độc Lập (Library Modules)
17
- - `framework/bias-library/`: Sửa các lỗi tư duy mặc định của AI.
18
- - `framework/dial-library/`: Định nghĩa các cấu hình điều khiển hành vi.
19
- - `framework/rule-library/`: Các tiêu chí xuất xưởng bắt buộc.
20
-
21
- ### 3. Behavior Specifications (`skills/`)
22
- Bộ 23 Behavior cốt lõi được cấu trúc theo chuẩn BSF (`_template/BEHAVIOR_SPEC.md`). Toàn bộ logic nội bộ được quy hoạch thành các Contracts (Quyền hạn), Policies (Quyết định, Bằng chứng) và Protocol (State Machine tùy chọn).
23
-
24
- ### 4. Output Contract (Decision Summary)
25
- Toàn bộ kết quả trả về cho bạn đều tuân thủ Output Contract: Báo cáo bằng Tiếng Việt, bảo đảm Invariants, và vượt qua các Quality Gates.
26
-
27
- ---
28
-
29
- ## 🧩 Danh sách 20+ Master Skills
30
-
31
- Các skill được chia thành các nhóm (Category) rõ ràng:
32
- - **Orchestration:** `qk-orchestrator`, `qk-context-loader`, `qk-policy-engine`, `qk-access-policy`
33
- - **Engineering / Dev:** `qk-feature-delivery`, `qk-api-lifecycle`, `qk-data-lifecycle`, `qk-design-to-code`, `qk-ui-system-builder`
34
- - **Validation & Standards:** `qk-validation-gate`, `qk-engineering-standard`, `qk-ui-audit`, `qk-project-health`, `qk-bug-resolution`
35
- - **Ops & AI:** `qk-system-evolution`, `qk-production-release`, `qk-ai-builder`, `qk-project-bootstrap`
36
- - **Docs & Utils:** `qk-docs`, `qk-documentation-system`, `qk-project-memory`, `qk-help`
37
-
38
- ---
39
-
40
- ## 🔄 Luồng Handoff Pipeline Khép Kín
41
-
42
- Bất cứ một tính năng hay lỗi nào cũng được đi qua một đường ống khép kín (Abstract Pipeline):
43
- ```text
44
- analyze
45
- ↓
46
- implement
47
- ↓
48
- engineering-standard (Ép chuẩn Code, Naming, SOLID)
49
- ↓
50
- validate (Chạy Linter, Tests, Security Check)
51
- ↓
52
- complete (Tạo báo cáo bằng tiếng Việt)
53
- ```
54
-
55
- ---
56
-
57
- ## 💻 Cách Cài Đặt (Installation)
58
-
59
- Sử dụng npm:
60
- ```bash
61
- npm i -g ai-developer-skill-os
62
- ```
63
- Hoặc sử dụng qua `npx`:
64
- ```bash
65
- npx ai-developer-skill-os init
66
- ```
67
-
68
- ## 🧪 Testing
69
-
70
- This project includes a full test suite to ensure registry integrity and SKILL.md spec compliance:
71
-
72
- ```bash
73
- npm test
74
- ```
75
-
76
- CI runs automatically on every PR via GitHub Actions, enforcing:
77
- - Registry matches filesystem
78
- - All SKILL.md frontmatters comply with `docs/SPEC.md`
79
- - Install script idempotency
80
-
81
- ## 🗑️ Cách Gỡ Cài Đặt (Uninstallation)
82
-
83
- Nếu bạn đã cài đặt thông qua npm global, bạn có thể gỡ bỏ bằng lệnh:
84
- ```bash
85
- npm uninstall -g ai-developer-skill-os
86
- ```
87
-
88
- ## 🚀 Tra Cứu (Help)
89
-
90
- Để tra cứu danh sách toàn bộ 20+ Kỹ năng và các mẹo sử dụng, hãy gọi:
91
- ```bash
92
- ./qk-help "Hiển thị tất cả các skill"
93
- ```
1
+ # 🚀 AI Developer Skill OS (ai-developer-skill-os) v7.0.0
2
+
3
+ > **V7.0.0 "Anti-Slop & Zero-Trust Architecture"**
4
+
5
+ Hệ sinh thái AI Developer Skill OS đã được tái cấu trúc hoàn toàn. Thay vì cung cấp các "công cụ rời rạc" (Toolbox), phiên bản V7 được thiết kế như một **Hệ điều hành khép kín, hoạt động theo kỷ luật của một Kiến trúc sư Hệ thống (50 năm kinh nghiệm)**.
6
+
7
+ ---
8
+
9
+ ## 🏗️ Triết Lý Hoạt Động Cốt Lõi (V7 Kernel)
10
+
11
+ ### 1. Zero-Trust Context (Không bao giờ đoán mò)
12
+ Mọi kỹ năng phân tích logic và backend (như `qk-feature-delivery`, `qk-orchestrator`) đều bị khoá chặt, không được phép hoạt động nếu chưa có **Dependency Graph** (Bản đồ cấu trúc) từ `qk-context-loader`. AI không được phép thay đổi code dựa trên trí tưởng tượng.
13
+
14
+ ### 2. Contract-First (Khế ước đi đầu)
15
+ - **Frontend / UI**: Mọi sửa đổi giao diện đều phải dựa trên `DESIGN.md`. Nếu vi phạm (tạo ra giao diện lười biếng "slop", dùng màu mặc định sai lệch), AI sẽ tự động bị đánh trượt bài kiểm toán.
16
+ - **Backend / API**: Mọi API phải được viết `OpenAPI/Swagger` schema trước khi viết logic thực tế (`qk-api-lifecycle`).
17
+ - **Database**: Cấm truy vấn mù. Bắt buộc phải có Schema định nghĩa rõ ràng trước (`qk-data-lifecycle`).
18
+
19
+ ### 3. Repair Loop (Chu trình Sửa Lỗi Khép Kín)
20
+ Bảo vệ mã nguồn khỏi thói quen "sửa vội" của AI. Lỗi bắt buộc phải qua chu trình điều tra nghiêm ngặt: `Observe -> Hypothesis -> Evidence -> Fix -> Verify` (`qk-bug-resolution`).
21
+
22
+ ---
23
+
24
+ ## 🧩 Danh sách 22 Master Skills
25
+
26
+ Các kỹ năng được quản lý cực kỳ chặt chẽ với bài kiểm tra tự động (Vitest) để đảm bảo tính nhất quán của luật lệ:
27
+ - **Orchestration:** `qk-orchestrator`, `qk-context-loader`, `qk-policy-engine`, `qk-access-policy`
28
+ - **Engineering / Dev:** `qk-feature-delivery`, `qk-api-lifecycle`, `qk-data-lifecycle`, `qk-design-to-code`, `qk-ui-system-builder`
29
+ - **Validation & Standards:** `qk-validation-gate`, `qk-engineering-standard`, `qk-ui-audit`, `qk-project-health`, `qk-bug-resolution`
30
+ - **Ops & AI:** `qk-system-evolution`, `qk-production-release`, `qk-ai-builder`, `qk-project-bootstrap`
31
+ - **Docs & Utils:** `qk-docs`, `qk-project-memory`, `qk-help`
32
+
33
+ ---
34
+
35
+ ## 💻 Cách Cài Đặt (Installation)
36
+
37
+ Sử dụng npm:
38
+ ```bash
39
+ npm i -g ai-developer-skill-os
40
+ ```
41
+ Hoặc khởi tạo thông qua `npx`:
42
+ ```bash
43
+ npx ai-developer-skill-os init
44
+ ```
45
+
46
+ ## 🧪 Testing
47
+
48
+ Hệ thống được bảo vệ bằng bộ Test Suite (Vitest) để tự động kiểm toán tính hợp lệ của toàn bộ 22 file Kỹ năng trước khi xuất bản:
49
+
50
+ ```bash
51
+ npm test
52
+ ```
53
+
54
+ ## 🚀 Tra Cứu (Help)
55
+
56
+ Để tra cứu danh sách các Kỹ năng và luật lệ khắt khe của hệ thống V7, hãy gọi:
57
+ ```bash
58
+ ./qk-help
59
+ ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ai-developer-skill-os",
3
- "version": "7.0.0",
3
+ "version": "7.0.1",
4
4
  "description": "Behavior Specification Format Framework, AI coding agents (Claude, Cursor, Windsurf, Antigravity) với 23 skills chuyên nghiệp.",
5
5
  "main": "bin/install.js",
6
6
  "bin": {