ai-developer-skill-os 8.1.5 → 8.1.7
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.
- package/.agents/CHANGELOG.md +113 -70
- package/.agents/README.md +44 -58
- package/CHANGELOG.md +22 -0
- package/package.json +1 -1
package/.agents/CHANGELOG.md
CHANGED
|
@@ -1,70 +1,113 @@
|
|
|
1
|
-
# Changelog
|
|
2
|
-
|
|
3
|
-
All notable changes to
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
## [
|
|
9
|
-
|
|
10
|
-
###
|
|
11
|
-
- **
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
- **
|
|
20
|
-
- **
|
|
21
|
-
- **
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
- **
|
|
35
|
-
- **
|
|
36
|
-
- **
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
- **
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
-
|
|
50
|
-
- **
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
- **
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
-
|
|
68
|
-
-
|
|
69
|
-
-
|
|
70
|
-
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to AI Developer Skill OS are documented here.
|
|
4
|
+
Format: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## [8.1.7] — 2026-07 — README Sync
|
|
9
|
+
|
|
10
|
+
### Changed
|
|
11
|
+
- **README Sync**: Synced `.agents/README.md` with root `README.md` so the installed documentation is fully up-to-date with V8.1 architecture.
|
|
12
|
+
- Bumped version to `8.1.7`.
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## [8.1.6] — 2026-07 — Design Intelligence Content & Sync
|
|
17
|
+
|
|
18
|
+
### Added
|
|
19
|
+
- **Design Intelligence Populated**: Sourced core market-standard knowledge (Tailwind, Radix, Apple, Vercel-like principles) into `.agents/knowledge/design-intelligence/` covering components, patterns, industries, themes, and references.
|
|
20
|
+
- **Animation Knowledge**: Added `visual-language/animation.md` for micro-interactions and transition durations.
|
|
21
|
+
- **Dependency Wiring**: Linked `qk-ui-system-builder` to `design-intelligence` so it utilizes the newly generated design constraints.
|
|
22
|
+
- **Changelog Sync**: Synced `.agents/CHANGELOG.md` with root `CHANGELOG.md` so the installed copy reflects the true V8 evolution.
|
|
23
|
+
|
|
24
|
+
### Changed
|
|
25
|
+
- All skill descriptions properly translated to Vietnamese for ecosystem consistency.
|
|
26
|
+
- Bumped version to `8.1.6` for final, truly complete Design Intelligence NPM Release.
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## [8.1.4] — 2026-07 — Design Intelligence Pack
|
|
31
|
+
|
|
32
|
+
### Added
|
|
33
|
+
- **Design Intelligence Layer**: `.agents/knowledge/design-intelligence/` (industries, themes, patterns, visual-language, components, templates)
|
|
34
|
+
- **Knowledge Dependencies**: `qk-design-system-engineering` and `qk-ui-builder` now have strict dependency bounds tied to Design Intelligence without bloating the Capability Graph.
|
|
35
|
+
- **Design Routing Test Cases**: `design-intel-01`, `02`, `03` for validating routing logic in design scenarios.
|
|
36
|
+
- **Re-introduced CLI Installer**: Restored and refactored `bin/install.js` to correctly copy `.agents` across global/local directories for easy NPM setup.
|
|
37
|
+
|
|
38
|
+
### Changed
|
|
39
|
+
- Refined **Decision Boundaries**: `qk-ui-builder` explicitly forbidden from defining visual direction or brand identity (strict capability bounds).
|
|
40
|
+
- **README.md** reflects 30 Master Skills and the "Agent Engineering OS" mindset.
|
|
41
|
+
- **package.json**: Version bump `8.1.4` and whitelisted files for npm publish.
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## [8.1.3] — 2026-07 — Architecture Freeze & Governance
|
|
46
|
+
|
|
47
|
+
### Added
|
|
48
|
+
- **Capability Graph & Routing**: `.agents/registry/capability-graph.yml` to define skill relations (`depends_on`, `delegates_to`).
|
|
49
|
+
- **Priority Governance**: `.agents/rules/priorities.yml` enforcing safety layers (`P1: System Integrity`, `P2: Guardrails`).
|
|
50
|
+
- **Audit Tools**: `tooling/run-aar.js` for architectural acceptance testing.
|
|
51
|
+
- Test cases for routing and boundary attacks.
|
|
52
|
+
|
|
53
|
+
### Changed
|
|
54
|
+
- Name transition from "Self-Improving" to **Adaptive Agent OS** (Self Optimizing ≠ Self Modifying).
|
|
55
|
+
- Enforced hard cap of **30 Skills** to prevent Skill Inflation.
|
|
56
|
+
- Frozen Baseline achieved: `v8.1.3-agent-os-production`.
|
|
57
|
+
|
|
58
|
+
---
|
|
59
|
+
|
|
60
|
+
## [8.0.0] — 2026-07 — Agent Knowledge System
|
|
61
|
+
|
|
62
|
+
### Philosophy shift
|
|
63
|
+
- **V7:** Skill Repository — human selects skill, AI executes
|
|
64
|
+
- **V8:** Agent Knowledge System — AI retrieves context, selects capability, executes workflow, verifies
|
|
65
|
+
|
|
66
|
+
### Added
|
|
67
|
+
- `rules/` — Agent behavior policies (global, coding, safety)
|
|
68
|
+
- `workflows/` — Reusable execution pipelines (YAML, with inputs/outputs per step)
|
|
69
|
+
- `examples/` — Few-shot knowledge (good/, bad/)
|
|
70
|
+
- `learnings/` — Evidence-based learning lifecycle (draft/, validated/, deprecated/)
|
|
71
|
+
- `registry/` — Generated AI retrieval index (skills-index.yml)
|
|
72
|
+
- `docs/ARCHITECTURE.md` — Agent request flow diagram
|
|
73
|
+
- `docs/VERSIONING.md` — Semantic versioning policy
|
|
74
|
+
- `docs/schemas/` — Schema definitions for all knowledge objects
|
|
75
|
+
- `docs/decisions/` — Architecture Decision Records (ADRs)
|
|
76
|
+
- `.agentsignore` — AI boundary file (what agents should NOT load)
|
|
77
|
+
- `tooling/` — Dev automation (generate-registry.js, validate-skills.js)
|
|
78
|
+
- `tests/agent-evaluation/` — Agent behavior test harness
|
|
79
|
+
|
|
80
|
+
### Changed
|
|
81
|
+
- SKILL.md schema upgraded to V8: added `type`, `intent`, `triggers`, `complexity`, `workflow`, `verification`, `related_skills`
|
|
82
|
+
- `skills.json` demoted to **generated compatibility manifest** (source of truth = SKILL.md)
|
|
83
|
+
- Workflows extracted from individual skills → shared reusable templates
|
|
84
|
+
|
|
85
|
+
### Removed
|
|
86
|
+
- Embedded workflows inside SKILL.md body (moved to workflows/)
|
|
87
|
+
- Old migration scripts (migrate-v*.js, patch*.py, add_lang.*, etc.)
|
|
88
|
+
- Duplicate documentation (CLAUDE.md, old docs/)
|
|
89
|
+
- Experimental packages (packages/edaos-sdk)
|
|
90
|
+
- framework/, knowledge/, specs/, templates/ directories
|
|
91
|
+
|
|
92
|
+
### Migration
|
|
93
|
+
- V7.5.1 tagged at git: `v7.5.1`
|
|
94
|
+
- V7 skills preserved in git history; migration is additive schema upgrade
|
|
95
|
+
|
|
96
|
+
---
|
|
97
|
+
|
|
98
|
+
## [7.5.1] — 2026-07 — Final V7 Release
|
|
99
|
+
|
|
100
|
+
- Bumped all skill versions to 7.5.1
|
|
101
|
+
- Added qk-fe-api-integration skill
|
|
102
|
+
- Added qk-performance-tuner (global config)
|
|
103
|
+
- Stabilized frontmatter schema across all 22 skills
|
|
104
|
+
|
|
105
|
+
## [7.5.0] — 2026-07
|
|
106
|
+
|
|
107
|
+
- Major skills refactor with EDAOS runtime adapter
|
|
108
|
+
- Added MCP server integration
|
|
109
|
+
- Added qk-bug-resolution workflow contracts
|
|
110
|
+
|
|
111
|
+
## [7.0.0] — 2026
|
|
112
|
+
|
|
113
|
+
- V7 release: 22 skills, YAML frontmatter, token budget system
|
package/.agents/README.md
CHANGED
|
@@ -1,74 +1,52 @@
|
|
|
1
|
-
# 🚀 AI Developer Skill OS (ai-developer-skill-os)
|
|
1
|
+
# 🚀 AI Developer Skill OS (ai-developer-skill-os) v8.1.4
|
|
2
2
|
|
|
3
|
-
> **
|
|
3
|
+
> **v8.1.4 "Agent Engineering OS + Design Intelligence"**
|
|
4
4
|
|
|
5
|
-
Hệ sinh thái AI Developer Skill OS đã
|
|
5
|
+
Hệ sinh thái AI Developer Skill OS đã lột xác hoàn toàn. Từ một bộ "công cụ phân tán" (Toolbox) ở V7, phiên bản V8.1.4 được thiết kế như một **Hệ điều hành khép kín (Agent Engineering OS)**, sở hữu năng lực giám sát, bảo vệ ranh giới quyết định (Decision Boundaries) và được trang bị thêm tầng **Design Intelligence**.
|
|
6
6
|
|
|
7
7
|
---
|
|
8
8
|
|
|
9
|
-
## 🏗️ Triết Lý Hoạt Động Cốt Lõi (
|
|
9
|
+
## 🏗️ Triết Lý Hoạt Động Cốt Lõi (V8 Kernel)
|
|
10
10
|
|
|
11
|
-
### 1.
|
|
12
|
-
|
|
11
|
+
### 1. Decision Boundary (Ranh giới Thẩm quyền)
|
|
12
|
+
Không còn tình trạng một Skill ôm đồm mọi việc. Mọi Skill (Kỹ năng) hiện tại bị quản lý bởi các trường `owns`, `does_not_own`, `conflicts_with`, `delegates_to`. Thợ code UI (`qk-ui-builder`) không được phép tự ra quyết định kiến trúc, và ngược lại.
|
|
13
13
|
|
|
14
|
-
### 2.
|
|
15
|
-
|
|
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`).
|
|
14
|
+
### 2. Design Intelligence Layer
|
|
15
|
+
Khắc phục điểm yếu "mù thẩm mỹ" của AI. Agent giờ đây không chỉ biết code mà còn có Gu Thẩm Mỹ (Design Taste). Dựa trên yêu cầu của bạn, hệ thống tự động tra cứu **Knowledge Graph** để chọn đúng Theme (Fintech, Healthcare, SaaS...), Typography và Visual Patterns trước khi giao việc cho UI Builder.
|
|
18
16
|
|
|
19
|
-
### 3.
|
|
20
|
-
|
|
17
|
+
### 3. Khế Ước Đi Đầu (Contract-First & Zero-Trust)
|
|
18
|
+
- **Frontend / UI**: Mọi sửa đổi phải tuân thủ Design System (được `qk-design-system-engineering` kiểm duyệt).
|
|
19
|
+
- **Backend / API**: Phải viết OpenAPI/Swagger contract trước (`qk-api-lifecycle`).
|
|
20
|
+
- **Data**: Cấm AI tự đoán cấu trúc DB, mọi truy vấn phải có Schema (`qk-data-lifecycle`).
|
|
21
21
|
|
|
22
22
|
---
|
|
23
23
|
|
|
24
|
-
## 🧩 Danh sách
|
|
24
|
+
## 🧩 Danh sách 30 Master Skills
|
|
25
25
|
|
|
26
|
-
Các kỹ năng được quản lý
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
26
|
+
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:
|
|
27
|
+
1. **Core & Orchestration:** `qk-orchestrator`, `qk-context-loader`, `qk-project-memory`, `qk-help`
|
|
28
|
+
2. **Product & Architecture:** `qk-product-specification`, `qk-project-bootstrap`, `qk-frontend-architecture`
|
|
29
|
+
3. **Frontend & UI:** `qk-design-system-engineering`, `qk-ui-system-builder`, `qk-ui-builder`, `qk-fe-api-integration`, `qk-ui-audit`
|
|
30
|
+
4. **Backend & Data:** `qk-api-lifecycle`, `qk-data-lifecycle`, `qk-access-policy`
|
|
31
|
+
5. **Engineering & Delivery:** `qk-feature-delivery`, `qk-bug-resolution`, `qk-engineering-standard`, `qk-system-evolution`, `qk-docs`
|
|
32
|
+
6. **Quality & Testing:** `qk-test-engineering`, `qk-validation-gate`, `qk-web-quality-gate`, `qk-project-health`
|
|
33
|
+
7. **Security, DevOps & Analytics:** `qk-security-audit`, `qk-db-optimizer`, `qk-devops-platform`, `qk-production-release`, `qk-agent-observability`, `qk-ai-builder`
|
|
32
34
|
|
|
33
35
|
---
|
|
34
36
|
|
|
35
37
|
## 💻 Cách Cài Đặt (Installation)
|
|
36
38
|
|
|
37
|
-
### Cách 1:
|
|
39
|
+
### Cách 1: NXP (Không cần cài global) - MỚI
|
|
38
40
|
```bash
|
|
39
|
-
|
|
41
|
+
npx ai-developer-skill-os init
|
|
40
42
|
```
|
|
41
43
|
|
|
42
|
-
### Cách 2:
|
|
44
|
+
### Cách 2: NPM Global (Khuyên dùng cho cá nhân)
|
|
43
45
|
```bash
|
|
44
|
-
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
### Cách 3: NPM Scripts (Trong dự án)
|
|
48
|
-
```bash
|
|
49
|
-
# Antigravity Global — 1 lần cài, mọi dự án dùng chung
|
|
50
|
-
npm run install:antigravity
|
|
51
|
-
|
|
52
|
-
# Antigravity Local — cài riêng cho dự án này
|
|
53
|
-
npm run install:antigravity:local
|
|
54
|
-
|
|
55
|
-
# Các IDE khác
|
|
56
|
-
npm run install:cursor # Global Cursor
|
|
57
|
-
npm run install:windsurf # Global Windsurf
|
|
58
|
-
npm run install:claude # Global Claude Code
|
|
59
|
-
npm run install:kilo # Global Kilo Code
|
|
60
|
-
npm run install:multi # Multi-IDE
|
|
46
|
+
npm i -g ai-developer-skill-os
|
|
61
47
|
```
|
|
62
48
|
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
| Tham số | Giá trị | Mô tả |
|
|
66
|
-
|---------|---------|-------|
|
|
67
|
-
| `--ide` | `antigravity`, `cursor`, `windsurf`, `claude`, `kilo`, `multi-ide` | IDE/AI Assistant |
|
|
68
|
-
| `--scope` | `1` = Local, `2` = Global | Phạm vi cài đặt |
|
|
69
|
-
|
|
70
|
-
### Ví dụ thực tế
|
|
71
|
-
|
|
49
|
+
### Chạy bằng tham số (Command Line Arguments)
|
|
72
50
|
```bash
|
|
73
51
|
# Cài Antigravity Global (toàn máy)
|
|
74
52
|
npx ai-developer-skill-os init --ide=antigravity --scope=2
|
|
@@ -78,23 +56,31 @@ npx ai-developer-skill-os init --ide=antigravity --scope=1
|
|
|
78
56
|
|
|
79
57
|
# Cài Cursor Local
|
|
80
58
|
npx ai-developer-skill-os init --ide=cursor --scope=1
|
|
81
|
-
|
|
82
|
-
# Cài Multi-IDE (tạo CLAUDE.md + .qk-ai-skill-os)
|
|
83
|
-
npx ai-developer-skill-os init --ide=multi-ide --scope=2
|
|
84
59
|
```
|
|
85
60
|
|
|
86
|
-
##
|
|
61
|
+
## 📦 Các IDE/AI Assistant Được Hỗ Trợ
|
|
62
|
+
- (1) Cursor
|
|
63
|
+
- (2) Windsurf
|
|
64
|
+
- (3) Cline / Roo Code
|
|
65
|
+
- (4) Antigravity / Gemini
|
|
66
|
+
- (5) Codex
|
|
67
|
+
- (6) Kilo Code
|
|
87
68
|
|
|
88
|
-
|
|
69
|
+
---
|
|
70
|
+
|
|
71
|
+
## 🧪 Đánh Giá Tự Động (Agent Evaluation)
|
|
72
|
+
|
|
73
|
+
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):
|
|
89
74
|
|
|
90
75
|
```bash
|
|
91
|
-
npm test
|
|
76
|
+
npm run test:agent
|
|
77
|
+
npm run test:graph
|
|
78
|
+
npm run test:registry
|
|
92
79
|
```
|
|
93
80
|
|
|
94
|
-
## 🚀
|
|
95
|
-
|
|
96
|
-
Để 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:
|
|
81
|
+
## 🚀 Hướng Dẫn Sử Dụng
|
|
82
|
+
Sau khi cài đặt thành công, hãy gõ lệnh:
|
|
97
83
|
```bash
|
|
98
84
|
./qk-help
|
|
99
85
|
```
|
|
100
|
-
|
|
86
|
+
để kích hoạt AI Orchestrator và khám phá sức mạnh của hệ điều hành!
|
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,28 @@ Format: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
|
|
|
5
5
|
|
|
6
6
|
---
|
|
7
7
|
|
|
8
|
+
## [8.1.7] — 2026-07 — README Sync
|
|
9
|
+
|
|
10
|
+
### Changed
|
|
11
|
+
- **README Sync**: Synced `.agents/README.md` with root `README.md` so the installed documentation is fully up-to-date with V8.1 architecture.
|
|
12
|
+
- Bumped version to `8.1.7`.
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## [8.1.6] — 2026-07 — Design Intelligence Content & Sync
|
|
17
|
+
|
|
18
|
+
### Added
|
|
19
|
+
- **Design Intelligence Populated**: Sourced core market-standard knowledge (Tailwind, Radix, Apple, Vercel-like principles) into `.agents/knowledge/design-intelligence/` covering components, patterns, industries, themes, and references.
|
|
20
|
+
- **Animation Knowledge**: Added `visual-language/animation.md` for micro-interactions and transition durations.
|
|
21
|
+
- **Dependency Wiring**: Linked `qk-ui-system-builder` to `design-intelligence` so it utilizes the newly generated design constraints.
|
|
22
|
+
- **Changelog Sync**: Synced `.agents/CHANGELOG.md` with root `CHANGELOG.md` so the installed copy reflects the true V8 evolution.
|
|
23
|
+
|
|
24
|
+
### Changed
|
|
25
|
+
- All skill descriptions properly translated to Vietnamese for ecosystem consistency.
|
|
26
|
+
- Bumped version to `8.1.6` for final, truly complete Design Intelligence NPM Release.
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
8
30
|
## [8.1.4] — 2026-07 — Design Intelligence Pack
|
|
9
31
|
|
|
10
32
|
### Added
|
package/package.json
CHANGED