ai-developer-skill-os 8.2.0 → 8.2.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.
- package/.agents/skills/qk-code-review/SKILL.md +6 -9
- package/.agents/skills/qk-context-loader/SKILL.md +0 -36
- package/.agents/skills/qk-data-lifecycle/SKILL.md +1 -1
- package/.agents/skills/qk-design-system-engineering/SKILL.md +1 -1
- package/.agents/skills/qk-devops-platform/SKILL.md +1 -1
- package/.agents/skills/qk-feature-delivery/SKILL.md +21 -1
- package/.agents/skills/qk-frontend-architecture/SKILL.md +1 -1
- package/.agents/skills/qk-orchestrator/SKILL.md +0 -44
- package/.agents/skills/qk-product-specification/SKILL.md +1 -1
- package/.agents/skills/qk-production-release/SKILL.md +1 -1
- package/.agents/skills/qk-project-bootstrap/SKILL.md +1 -1
- package/.agents/skills/qk-security-audit/SKILL.md +1 -1
- package/.agents/skills/qk-system-evolution/SKILL.md +1 -1
- package/.agents/skills/qk-test-engineering/SKILL.md +1 -1
- package/.agents/skills/qk-ui-builder/SKILL.md +1 -1
- package/.agents/skills/qk-web-quality-gate/SKILL.md +1 -1
- package/CHANGELOG.md +10 -0
- package/package.json +1 -1
|
@@ -81,7 +81,7 @@ token_budget:
|
|
|
81
81
|
max_files_read: 10
|
|
82
82
|
max_lines_per_read: 300
|
|
83
83
|
max_shell_commands: 2
|
|
84
|
-
stop_early:
|
|
84
|
+
stop_early: true
|
|
85
85
|
|
|
86
86
|
exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
|
|
87
87
|
---
|
|
@@ -108,15 +108,12 @@ Report: "Missing: Vui lòng cung cấp ngữ cảnh hoặc chỉ định rõ fil
|
|
|
108
108
|
|
|
109
109
|
## Dynamic Context Loading (Tải Ngữ Cảnh Động)
|
|
110
110
|
|
|
111
|
-
> **
|
|
111
|
+
> **CHỈ ĐỌC KHI CẦN (on-demand):** Chỉ mở file references/ nếu có vấn đề cụ thể cần xác minh. Đừng đọc trước khi chưa thấy vấn đề.
|
|
112
112
|
|
|
113
|
-
- **Nếu review AI Config (
|
|
114
|
-
|
|
115
|
-
- **Nếu review
|
|
116
|
-
|
|
117
|
-
- Mở đọc file tương ứng: `references/languages/[tên-ngôn-ngữ].md` (VD: `react.md`, `java.md`).
|
|
118
|
-
- **Nếu review ở mức tổng quát hoặc PR lớn (Cross-cutting):**
|
|
119
|
-
- Đọc thêm: `references/cross-cutting/architecture-review-guide.md`, hoặc các file về security/performance nếu phù hợp.
|
|
113
|
+
- **Nếu review AI Config** và phát hiện vấn đề schema/anti-pattern → đọc `references/ai/v8-schema-validation.md` HOẶC `references/ai/ai-anti-patterns.md` (không cần đọc cả 2 nếu không liên quan).
|
|
114
|
+
- **Nếu review Code** và gặp vấn đề ngôn ngữ cụ thể → đọc `references/languages/[tên-ngôn-ngữ].md`.
|
|
115
|
+
- **Nếu review cross-cutting** và cần xác minh architecture → đọc `references/cross-cutting/architecture-review-guide.md`.
|
|
116
|
+
- **Default (80% trường hợp):** Dùng kiến thức có sẵn, không đọc references.
|
|
120
117
|
|
|
121
118
|
---
|
|
122
119
|
|
|
@@ -96,10 +96,6 @@ On missing precondition:
|
|
|
96
96
|
Message: "Vui lòng chỉ định entry point (file hoặc module cần map)."
|
|
97
97
|
```
|
|
98
98
|
|
|
99
|
-
skill_version: 7.5.0
|
|
100
|
-
runtime_version: 1
|
|
101
|
-
schema_version: 2
|
|
102
|
-
---
|
|
103
99
|
|
|
104
100
|
## Scope
|
|
105
101
|
- ✅ Trace imports/exports from entry point
|
|
@@ -112,10 +108,6 @@ schema_version: 2
|
|
|
112
108
|
- ❌ Guess file names — only follow explicit imports
|
|
113
109
|
- ❌ Load entire repo (max 5 files)
|
|
114
110
|
|
|
115
|
-
skill_version: 7.5.0
|
|
116
|
-
runtime_version: 1
|
|
117
|
-
schema_version: 2
|
|
118
|
-
---
|
|
119
111
|
|
|
120
112
|
## Priority Order
|
|
121
113
|
|
|
@@ -126,10 +118,6 @@ schema_version: 2
|
|
|
126
118
|
| P3 | Identify shared/risky modules | Budget < 60% |
|
|
127
119
|
| P4 | Annotate with risk levels | Budget < 70% |
|
|
128
120
|
|
|
129
|
-
skill_version: 7.5.0
|
|
130
|
-
runtime_version: 1
|
|
131
|
-
schema_version: 2
|
|
132
|
-
---
|
|
133
121
|
|
|
134
122
|
## Workflow
|
|
135
123
|
|
|
@@ -149,10 +137,6 @@ ELSE IF entry file not found
|
|
|
149
137
|
→ EXIT: BLOCKED — ask for correct path
|
|
150
138
|
```
|
|
151
139
|
|
|
152
|
-
skill_version: 7.5.0
|
|
153
|
-
runtime_version: 1
|
|
154
|
-
schema_version: 2
|
|
155
|
-
---
|
|
156
140
|
|
|
157
141
|
### Phase 2 — Graph Traversal (Max Depth 3)
|
|
158
142
|
|
|
@@ -171,10 +155,6 @@ IF circular dependency detected
|
|
|
171
155
|
→ Continue building rest of graph
|
|
172
156
|
```
|
|
173
157
|
|
|
174
|
-
skill_version: 7.5.0
|
|
175
|
-
runtime_version: 1
|
|
176
|
-
schema_version: 2
|
|
177
|
-
---
|
|
178
158
|
|
|
179
159
|
### Phase 3 — Risk Assessment & Output
|
|
180
160
|
|
|
@@ -183,10 +163,6 @@ schema_version: 2
|
|
|
183
163
|
2. Identify: entry points with many dependents = CRITICAL to change carefully
|
|
184
164
|
3. Generate graph in standard JSON + Markdown format
|
|
185
165
|
|
|
186
|
-
skill_version: 7.5.0
|
|
187
|
-
runtime_version: 1
|
|
188
|
-
schema_version: 2
|
|
189
|
-
---
|
|
190
166
|
|
|
191
167
|
## Output Format (Mandatory Schema)
|
|
192
168
|
|
|
@@ -214,10 +190,6 @@ schema_version: 2
|
|
|
214
190
|
}
|
|
215
191
|
```
|
|
216
192
|
|
|
217
|
-
skill_version: 7.5.0
|
|
218
|
-
runtime_version: 1
|
|
219
|
-
schema_version: 2
|
|
220
|
-
---
|
|
221
193
|
|
|
222
194
|
## Evidence Format
|
|
223
195
|
|
|
@@ -228,10 +200,6 @@ Imported by: [N files]
|
|
|
228
200
|
Exports: [key exports]
|
|
229
201
|
```
|
|
230
202
|
|
|
231
|
-
skill_version: 7.5.0
|
|
232
|
-
runtime_version: 1
|
|
233
|
-
schema_version: 2
|
|
234
|
-
---
|
|
235
203
|
|
|
236
204
|
## Handoff Contract
|
|
237
205
|
|
|
@@ -252,10 +220,6 @@ schema_version: 2
|
|
|
252
220
|
}
|
|
253
221
|
```
|
|
254
222
|
|
|
255
|
-
skill_version: 7.5.0
|
|
256
|
-
runtime_version: 1
|
|
257
|
-
schema_version: 2
|
|
258
|
-
---
|
|
259
223
|
|
|
260
224
|
## Exit Codes
|
|
261
225
|
|
|
@@ -79,7 +79,7 @@ token_budget:
|
|
|
79
79
|
max_files_read: 5
|
|
80
80
|
max_lines_per_read: 150
|
|
81
81
|
max_shell_commands: 2
|
|
82
|
-
stop_early:
|
|
82
|
+
stop_early: true
|
|
83
83
|
|
|
84
84
|
exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
|
|
85
85
|
---
|
|
@@ -132,6 +132,26 @@ On missing precondition:
|
|
|
132
132
|
|
|
133
133
|
---
|
|
134
134
|
|
|
135
|
+
## ⚡ FAST PATH (Đọc trước — quyết định ngay)
|
|
136
|
+
|
|
137
|
+
```
|
|
138
|
+
FAST PATH: Áp dụng nếu task đơn giản (sửa ≤ 1 file, không API mới, không migration DB)
|
|
139
|
+
→ BỎ QUA qk-context-loader
|
|
140
|
+
→ BỎ QUA Phase 1 clarification nếu requirement đã rõ
|
|
141
|
+
→ ĐI THẲNG vào Phase 3 — Implementation
|
|
142
|
+
→ Tiết kiệm 2-3 turn hỏi đáp không cần thiết
|
|
143
|
+
|
|
144
|
+
VÍ DỤ FAST PATH:
|
|
145
|
+
✅ "Sửa label trên button này thành X"
|
|
146
|
+
✅ "Thêm validation email vào form"
|
|
147
|
+
✅ "Fix bug: hàm này trả về null"
|
|
148
|
+
|
|
149
|
+
KHÔNG DÙNG FAST PATH:
|
|
150
|
+
❌ Tính năng mới span nhiều file (≥ 3 files)
|
|
151
|
+
❌ Thay đổi API contract
|
|
152
|
+
❌ Migration database
|
|
153
|
+
```
|
|
154
|
+
|
|
135
155
|
## Workflow
|
|
136
156
|
|
|
137
157
|
### Phase 1 — Requirements Clarification
|
|
@@ -96,10 +96,6 @@ On missing precondition:
|
|
|
96
96
|
Message: "Vui lòng mô tả yêu cầu của bạn."
|
|
97
97
|
```
|
|
98
98
|
|
|
99
|
-
skill_version: 7.5.0
|
|
100
|
-
runtime_version: 1
|
|
101
|
-
schema_version: 2
|
|
102
|
-
---
|
|
103
99
|
|
|
104
100
|
## Scope
|
|
105
101
|
- ✅ Analyze user intent and route to the correct skill
|
|
@@ -112,10 +108,6 @@ schema_version: 2
|
|
|
112
108
|
- ❌ Allow UI work without `DESIGN.md` verified
|
|
113
109
|
- ❌ Allow logic work without context graph from `qk-context-loader`
|
|
114
110
|
|
|
115
|
-
skill_version: 7.5.0
|
|
116
|
-
runtime_version: 1
|
|
117
|
-
schema_version: 2
|
|
118
|
-
---
|
|
119
111
|
|
|
120
112
|
## Priority Order
|
|
121
113
|
|
|
@@ -126,10 +118,6 @@ schema_version: 2
|
|
|
126
118
|
| P3 | Check pipeline dependencies (e.g., context-loader first) | Never for logic tasks |
|
|
127
119
|
| P4 | Estimate cost/latency for user info | Budget < 70% |
|
|
128
120
|
|
|
129
|
-
skill_version: 7.5.0
|
|
130
|
-
runtime_version: 1
|
|
131
|
-
schema_version: 2
|
|
132
|
-
---
|
|
133
121
|
|
|
134
122
|
## Workflow
|
|
135
123
|
|
|
@@ -157,10 +145,6 @@ ELSE IF no match
|
|
|
157
145
|
- Skill identified → go to Phase 2
|
|
158
146
|
- No matching skill → EXIT: BLOCKED
|
|
159
147
|
|
|
160
|
-
skill_version: 7.5.0
|
|
161
|
-
runtime_version: 1
|
|
162
|
-
schema_version: 2
|
|
163
|
-
---
|
|
164
148
|
|
|
165
149
|
### Phase 2 — Precondition Check
|
|
166
150
|
|
|
@@ -181,10 +165,6 @@ ELSE
|
|
|
181
165
|
→ EXIT: BLOCKED
|
|
182
166
|
```
|
|
183
167
|
|
|
184
|
-
skill_version: 7.5.0
|
|
185
|
-
runtime_version: 1
|
|
186
|
-
schema_version: 2
|
|
187
|
-
---
|
|
188
168
|
|
|
189
169
|
### Phase 3 — Pipeline Enforcement
|
|
190
170
|
|
|
@@ -208,10 +188,6 @@ Release tasks:
|
|
|
208
188
|
[qk-validation-gate] → [qk-production-release]
|
|
209
189
|
```
|
|
210
190
|
|
|
211
|
-
skill_version: 7.5.0
|
|
212
|
-
runtime_version: 1
|
|
213
|
-
schema_version: 2
|
|
214
|
-
---
|
|
215
191
|
|
|
216
192
|
## Routing Table (Quick Reference)
|
|
217
193
|
Full table: see `references/routing-table.md`
|
|
@@ -236,10 +212,6 @@ Full table: see `references/routing-table.md`
|
|
|
236
212
|
| new project, bootstrap, init | `qk-project-bootstrap` | direct |
|
|
237
213
|
| memory, context, recall, lưu | `qk-project-memory` | direct |
|
|
238
214
|
|
|
239
|
-
skill_version: 7.5.0
|
|
240
|
-
runtime_version: 1
|
|
241
|
-
schema_version: 2
|
|
242
|
-
---
|
|
243
215
|
|
|
244
216
|
## Confidence Model
|
|
245
217
|
|
|
@@ -249,10 +221,6 @@ schema_version: 2
|
|
|
249
221
|
| MEDIUM | Multiple possible skills | Route to most likely, note ambiguity |
|
|
250
222
|
| LOW | Request is too vague | Ask clarifying question |
|
|
251
223
|
|
|
252
|
-
skill_version: 7.5.0
|
|
253
|
-
runtime_version: 1
|
|
254
|
-
schema_version: 2
|
|
255
|
-
---
|
|
256
224
|
|
|
257
225
|
## Escalation Rules
|
|
258
226
|
|
|
@@ -266,10 +234,6 @@ Questions:
|
|
|
266
234
|
Recommended Assumptions: none — routing requires clear intent
|
|
267
235
|
```
|
|
268
236
|
|
|
269
|
-
skill_version: 7.5.0
|
|
270
|
-
runtime_version: 1
|
|
271
|
-
schema_version: 2
|
|
272
|
-
---
|
|
273
237
|
|
|
274
238
|
## Handoff Contract
|
|
275
239
|
|
|
@@ -290,10 +254,6 @@ schema_version: 2
|
|
|
290
254
|
}
|
|
291
255
|
```
|
|
292
256
|
|
|
293
|
-
skill_version: 7.5.0
|
|
294
|
-
runtime_version: 1
|
|
295
|
-
schema_version: 2
|
|
296
|
-
---
|
|
297
257
|
|
|
298
258
|
## Output Format
|
|
299
259
|
|
|
@@ -312,10 +272,6 @@ Preconditions:
|
|
|
312
272
|
Exit Code: SUCCESS
|
|
313
273
|
```
|
|
314
274
|
|
|
315
|
-
skill_version: 7.5.0
|
|
316
|
-
runtime_version: 1
|
|
317
|
-
schema_version: 2
|
|
318
|
-
---
|
|
319
275
|
|
|
320
276
|
## Exit Codes
|
|
321
277
|
|
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,16 @@ Format: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
|
|
|
5
5
|
|
|
6
6
|
---
|
|
7
7
|
|
|
8
|
+
## [8.2.1] — 2026-07 — Token Optimization Patch
|
|
9
|
+
|
|
10
|
+
### Fixed
|
|
11
|
+
- **`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.
|
|
12
|
+
- **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.
|
|
13
|
+
- **`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.
|
|
14
|
+
- **`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.
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
8
18
|
## [8.2.0] — 2026-07 — EDAOS v8.2: Governed Capability Metadata & Eval Platform
|
|
9
19
|
|
|
10
20
|
### Added
|
package/package.json
CHANGED