ai-developer-skill-os 9.1.0 → 9.1.2
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/AGENTS.md +7 -7
- package/.agents/registry/graph.json +50 -34
- package/.agents/registry/index.yaml +41 -33
- package/.agents/rules/global.md +1 -1
- package/.agents/skills/_template/SKILL.md +154 -0
- package/.agents/skills/qk-access-policy/SKILL.md +160 -0
- package/.agents/skills/qk-agent-observability/SKILL.md +160 -0
- package/.agents/skills/qk-ai-builder/SKILL.md +160 -0
- package/.agents/skills/qk-api-lifecycle/SKILL.md +160 -0
- package/.agents/skills/qk-bug-resolution/SKILL.md +160 -0
- package/.agents/skills/qk-code-review/SKILL.md +160 -0
- package/.agents/skills/qk-context-loader/SKILL.md +160 -0
- package/.agents/skills/qk-data-engineer/SKILL.md +474 -0
- package/.agents/skills/qk-data-lifecycle/SKILL.md +160 -0
- package/.agents/skills/qk-db-optimizer/SKILL.md +160 -0
- package/.agents/skills/qk-design-system-engineering/SKILL.md +160 -0
- package/.agents/skills/qk-devops-platform/SKILL.md +160 -0
- package/.agents/skills/qk-docs/SKILL.md +160 -0
- package/.agents/skills/qk-engineering-standard/SKILL.md +160 -0
- package/.agents/skills/qk-fe-api-integration/SKILL.md +160 -0
- package/.agents/skills/qk-feature-delivery/SKILL.md +160 -0
- package/.agents/skills/qk-frontend-architecture/SKILL.md +160 -0
- package/.agents/skills/qk-orchestrator/SKILL.md +160 -0
- package/.agents/skills/qk-product-specification/SKILL.md +160 -0
- package/.agents/skills/qk-production-release/SKILL.md +160 -0
- package/.agents/skills/qk-project-bootstrap/SKILL.md +421 -367
- package/.agents/skills/qk-project-health/SKILL.md +160 -0
- package/.agents/skills/qk-project-memory/SKILL.md +13 -17
- package/.agents/skills/qk-refactor/SKILL.md +160 -0
- package/.agents/skills/qk-security-audit/SKILL.md +160 -0
- package/.agents/skills/qk-system-evolution/SKILL.md +160 -0
- package/.agents/skills/qk-test-engineering/SKILL.md +160 -0
- package/.agents/skills/qk-ui-audit/SKILL.md +160 -0
- package/.agents/skills/qk-ui-system-builder/SKILL.md +160 -0
- package/.agents/skills/qk-validation-gate/SKILL.md +160 -0
- package/.agents/skills/qk-web-quality-gate/SKILL.md +160 -0
- package/README.md +10 -10
- package/package.json +1 -1
- package/tooling/sync-versions.js +10 -6
|
@@ -89,6 +89,166 @@ exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
|
|
|
89
89
|
|
|
90
90
|
## Memory Workflow
|
|
91
91
|
|
|
92
|
+
### 0. Self-Init Protocol (Khởi Tạo Bộ Nhớ Local & Gitignore)
|
|
93
|
+
- Trước khi tra cứu hoặc lưu trữ tri thức, BẮT BUỘC kiểm tra sự tồn tại của thư mục `.ai-local/` tại gốc dự án:
|
|
94
|
+
- **Tự động tạo mới:** Nếu `.ai-local/` chưa tồn tại, AI phải tự động tạo cấu trúc thư mục `.ai-local/knowledge/` (và file `index.yaml` nếu cần thiết) cùng `.ai-local/candidates/`. Tuyệt đối không ngưng chạy hay hỏi ý kiến người dùng về thao tác khởi tạo tiêu chuẩn này.
|
|
95
|
+
- **Bảo mật Gitignore:** BẮT BUỘC kiểm tra file `.gitignore` của dự án, nếu chưa có dòng `.ai-local/` thì phải tự động thêm vào để tuyệt đối bảo mật tri thức cá nhân và tránh lộ lọt lên Git.
|
|
96
|
+
|
|
97
|
+
---
|
|
98
|
+
|
|
99
|
+
### Pre-flight Retrieve (Trước khi thực thi)
|
|
100
|
+
- Trước các task có tính lặp lại, debug, refactor, kiến trúc hoặc rủi ro cao:
|
|
101
|
+
bắt buộc tra cứu:
|
|
102
|
+
- `.ai-local/knowledge/index.yaml` (Private Local Knowledge)
|
|
103
|
+
|
|
104
|
+
- Ưu tiên sử dụng các Knowledge đang có trạng thái `Active` thuộc:
|
|
105
|
+
- Architecture
|
|
106
|
+
- Hard Bug
|
|
107
|
+
- Convention
|
|
108
|
+
- Pattern
|
|
109
|
+
- Tech Debt Pattern
|
|
110
|
+
- 👉 *Domain Focus:* Architecture / Convention (vd: bảng điều hướng kỹ năng, ràng buộc ranh giới rõ ràng).
|
|
111
|
+
|
|
112
|
+
- Memory chỉ đóng vai trò **Navigator (bản đồ chỉ đường)**.
|
|
113
|
+
Không được xem Memory là Source of Truth.
|
|
114
|
+
Luôn xác minh lại bằng source code, configuration và trạng thái hiện tại của dự án trước khi áp dụng.
|
|
115
|
+
|
|
116
|
+
---
|
|
117
|
+
|
|
118
|
+
### Learning Flow (AI tự học có kiểm soát)
|
|
119
|
+
- Trong quá trình làm việc, AI được phép tự phát hiện và tạo **Candidate Memory** khi nhận thấy:
|
|
120
|
+
- Hard Bug có khả năng tái diễn.
|
|
121
|
+
- Pattern làm việc lặp lại trong dự án.
|
|
122
|
+
- Convention hoặc quy tắc kiến trúc mới.
|
|
123
|
+
- Quyết định Architecture quan trọng.
|
|
124
|
+
- Tech Debt Pattern hoặc Code Smell có tính hệ thống.
|
|
125
|
+
- 👉 *Domain Harvest:* Quy luật phân phối routing hiệu quả mới.
|
|
126
|
+
|
|
127
|
+
- Candidate Memory chỉ là bản nháp quan sát, chưa phải tri thức chính thức.
|
|
128
|
+
- Candidate Memory có thể lưu tạm tại: `.ai-local/candidates/`
|
|
129
|
+
- AI không được tự động Promote Candidate Memory thành Project Knowledge.
|
|
130
|
+
|
|
131
|
+
---
|
|
132
|
+
|
|
133
|
+
### Post-flight Harvest (Đề xuất → Phê duyệt)
|
|
134
|
+
Sau khi hoàn thành task:
|
|
135
|
+
- AI đánh giá các Candidate Memory đã tạo.
|
|
136
|
+
- Nếu phát hiện tri thức có giá trị tái sử dụng:
|
|
137
|
+
- Đề xuất người dùng xem xét.
|
|
138
|
+
- Gửi yêu cầu phê duyệt thông qua:
|
|
139
|
+
- `/learn`
|
|
140
|
+
- `qk-project-memory`
|
|
141
|
+
- Chỉ sau khi được phê duyệt, Candidate Memory mới được chuyển thành Knowledge chính thức:
|
|
142
|
+
|
|
143
|
+
```
|
|
144
|
+
.ai-local/candidates/ ──(Approve)──> .ai-local/knowledge/index.yaml
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
- Project Knowledge phải được xem như tài sản kỹ thuật của dự án:
|
|
148
|
+
- Có thể review, cập nhật, loại bỏ và có lịch sử thay đổi.
|
|
149
|
+
|
|
150
|
+
---
|
|
151
|
+
|
|
152
|
+
### Ignore (Không đưa vào Memory)
|
|
153
|
+
Không lưu:
|
|
154
|
+
- Trace log của một session đơn lẻ.
|
|
155
|
+
- Temporary debugging data.
|
|
156
|
+
- Output của một lần chạy test/scan.
|
|
157
|
+
- Report health tạm thời của một đợt kiểm tra.
|
|
158
|
+
- Lỗi nhỏ chỉ xảy ra một lần.
|
|
159
|
+
- Thông tin không có khả năng tái sử dụng.
|
|
160
|
+
- 👉 *Domain Ignore:* Trình tự gọi lệnh tạm thời của một prompt user.
|
|
161
|
+
|
|
162
|
+
---
|
|
163
|
+
|
|
164
|
+
### Golden Rule
|
|
165
|
+
> **AI được phép học, nhưng không được tự quyết định tri thức chính thức.**
|
|
166
|
+
> **AI quan sát → Đề xuất → Con người phê duyệt → Dự án tiến hóa.**
|
|
167
|
+
|
|
168
|
+
---
|
|
169
|
+
|
|
170
|
+
|
|
171
|
+
|
|
172
|
+
### 0. Self-Init Protocol (Khởi Tạo Bộ Nhớ Local & Gitignore)
|
|
173
|
+
- Trước khi tra cứu hoặc lưu trữ tri thức, BẮT BUỘC kiểm tra sự tồn tại của thư mục `.ai-local/` tại gốc dự án:
|
|
174
|
+
- **Tự động tạo mới:** Nếu `.ai-local/` chưa tồn tại, AI phải tự động tạo cấu trúc thư mục `.ai-local/knowledge/` (và file `index.yaml` nếu cần thiết) cùng `.ai-local/candidates/`. Tuyệt đối không ngưng chạy hay hỏi ý kiến người dùng về thao tác khởi tạo tiêu chuẩn này.
|
|
175
|
+
- **Bảo mật Gitignore:** BẮT BUỘC kiểm tra file `.gitignore` của dự án, nếu chưa có dòng `.ai-local/` thì phải tự động thêm vào để tuyệt đối bảo mật tri thức cá nhân và tránh lộ lọt lên Git.
|
|
176
|
+
|
|
177
|
+
---
|
|
178
|
+
|
|
179
|
+
### Pre-flight Retrieve (Trước khi thực thi)
|
|
180
|
+
- Trước các task có tính lặp lại, debug, refactor, kiến trúc hoặc rủi ro cao:
|
|
181
|
+
bắt buộc tra cứu:
|
|
182
|
+
- `.ai-local/knowledge/index.yaml` (Private Local Knowledge)
|
|
183
|
+
|
|
184
|
+
- Ưu tiên sử dụng các Knowledge đang có trạng thái `Active` thuộc:
|
|
185
|
+
- Architecture
|
|
186
|
+
- Hard Bug
|
|
187
|
+
- Convention
|
|
188
|
+
- Pattern
|
|
189
|
+
- Tech Debt Pattern
|
|
190
|
+
- 👉 *Domain Focus:* Architecture / Convention (vd: bảng điều hướng kỹ năng, ràng buộc ranh giới rõ ràng).
|
|
191
|
+
|
|
192
|
+
- Memory chỉ đóng vai trò **Navigator (bản đồ chỉ đường)**.
|
|
193
|
+
Không được xem Memory là Source of Truth.
|
|
194
|
+
Luôn xác minh lại bằng source code, configuration và trạng thái hiện tại của dự án trước khi áp dụng.
|
|
195
|
+
|
|
196
|
+
---
|
|
197
|
+
|
|
198
|
+
### Learning Flow (AI tự học có kiểm soát)
|
|
199
|
+
- Trong quá trình làm việc, AI được phép tự phát hiện và tạo **Candidate Memory** khi nhận thấy:
|
|
200
|
+
- Hard Bug có khả năng tái diễn.
|
|
201
|
+
- Pattern làm việc lặp lại trong dự án.
|
|
202
|
+
- Convention hoặc quy tắc kiến trúc mới.
|
|
203
|
+
- Quyết định Architecture quan trọng.
|
|
204
|
+
- Tech Debt Pattern hoặc Code Smell có tính hệ thống.
|
|
205
|
+
- 👉 *Domain Harvest:* Quy luật phân phối routing hiệu quả mới.
|
|
206
|
+
|
|
207
|
+
- Candidate Memory chỉ là bản nháp quan sát, chưa phải tri thức chính thức.
|
|
208
|
+
- Candidate Memory có thể lưu tạm tại: `.ai-local/candidates/`
|
|
209
|
+
- AI không được tự động Promote Candidate Memory thành Project Knowledge.
|
|
210
|
+
|
|
211
|
+
---
|
|
212
|
+
|
|
213
|
+
### Post-flight Harvest (Đề xuất → Phê duyệt)
|
|
214
|
+
Sau khi hoàn thành task:
|
|
215
|
+
- AI đánh giá các Candidate Memory đã tạo.
|
|
216
|
+
- Nếu phát hiện tri thức có giá trị tái sử dụng:
|
|
217
|
+
- Đề xuất người dùng xem xét.
|
|
218
|
+
- Gửi yêu cầu phê duyệt thông qua:
|
|
219
|
+
- `/learn`
|
|
220
|
+
- `qk-project-memory`
|
|
221
|
+
- Chỉ sau khi được phê duyệt, Candidate Memory mới được chuyển thành Knowledge chính thức:
|
|
222
|
+
|
|
223
|
+
```
|
|
224
|
+
.ai-local/candidates/ ──(Approve)──> .ai-local/knowledge/index.yaml
|
|
225
|
+
```
|
|
226
|
+
|
|
227
|
+
- Project Knowledge phải được xem như tài sản kỹ thuật của dự án:
|
|
228
|
+
- Có thể review, cập nhật, loại bỏ và có lịch sử thay đổi.
|
|
229
|
+
|
|
230
|
+
---
|
|
231
|
+
|
|
232
|
+
### Ignore (Không đưa vào Memory)
|
|
233
|
+
Không lưu:
|
|
234
|
+
- Trace log của một session đơn lẻ.
|
|
235
|
+
- Temporary debugging data.
|
|
236
|
+
- Output của một lần chạy test/scan.
|
|
237
|
+
- Report health tạm thời của một đợt kiểm tra.
|
|
238
|
+
- Lỗi nhỏ chỉ xảy ra một lần.
|
|
239
|
+
- Thông tin không có khả năng tái sử dụng.
|
|
240
|
+
- 👉 *Domain Ignore:* Trình tự gọi lệnh tạm thời của một prompt user.
|
|
241
|
+
|
|
242
|
+
---
|
|
243
|
+
|
|
244
|
+
### Golden Rule
|
|
245
|
+
> **AI được phép học, nhưng không được tự quyết định tri thức chính thức.**
|
|
246
|
+
> **AI quan sát → Đề xuất → Con người phê duyệt → Dự án tiến hóa.**
|
|
247
|
+
|
|
248
|
+
---
|
|
249
|
+
|
|
250
|
+
|
|
251
|
+
|
|
92
252
|
### Pre-flight Retrieve (Trước khi thực thi)
|
|
93
253
|
- Trước các task có tính lặp lại, debug, refactor, kiến trúc hoặc rủi ro cao:
|
|
94
254
|
bắt buộc tra cứu:
|
|
@@ -124,6 +124,166 @@ exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
|
|
|
124
124
|
|
|
125
125
|
## Memory Workflow
|
|
126
126
|
|
|
127
|
+
### 0. Self-Init Protocol (Khởi Tạo Bộ Nhớ Local & Gitignore)
|
|
128
|
+
- Trước khi tra cứu hoặc lưu trữ tri thức, BẮT BUỘC kiểm tra sự tồn tại của thư mục `.ai-local/` tại gốc dự án:
|
|
129
|
+
- **Tự động tạo mới:** Nếu `.ai-local/` chưa tồn tại, AI phải tự động tạo cấu trúc thư mục `.ai-local/knowledge/` (và file `index.yaml` nếu cần thiết) cùng `.ai-local/candidates/`. Tuyệt đối không ngưng chạy hay hỏi ý kiến người dùng về thao tác khởi tạo tiêu chuẩn này.
|
|
130
|
+
- **Bảo mật Gitignore:** BẮT BUỘC kiểm tra file `.gitignore` của dự án, nếu chưa có dòng `.ai-local/` thì phải tự động thêm vào để tuyệt đối bảo mật tri thức cá nhân và tránh lộ lọt lên Git.
|
|
131
|
+
|
|
132
|
+
---
|
|
133
|
+
|
|
134
|
+
### Pre-flight Retrieve (Trước khi thực thi)
|
|
135
|
+
- Trước các task có tính lặp lại, debug, refactor, kiến trúc hoặc rủi ro cao:
|
|
136
|
+
bắt buộc tra cứu:
|
|
137
|
+
- `.ai-local/knowledge/index.yaml` (Private Local Knowledge)
|
|
138
|
+
|
|
139
|
+
- Ưu tiên sử dụng các Knowledge đang có trạng thái `Active` thuộc:
|
|
140
|
+
- Architecture
|
|
141
|
+
- Hard Bug
|
|
142
|
+
- Convention
|
|
143
|
+
- Pattern
|
|
144
|
+
- Tech Debt Pattern
|
|
145
|
+
- 👉 *Domain Focus:* Convention / Pattern (vd: định dạng Acceptance Criteria, cấu trúc PRD).
|
|
146
|
+
|
|
147
|
+
- Memory chỉ đóng vai trò **Navigator (bản đồ chỉ đường)**.
|
|
148
|
+
Không được xem Memory là Source of Truth.
|
|
149
|
+
Luôn xác minh lại bằng source code, configuration và trạng thái hiện tại của dự án trước khi áp dụng.
|
|
150
|
+
|
|
151
|
+
---
|
|
152
|
+
|
|
153
|
+
### Learning Flow (AI tự học có kiểm soát)
|
|
154
|
+
- Trong quá trình làm việc, AI được phép tự phát hiện và tạo **Candidate Memory** khi nhận thấy:
|
|
155
|
+
- Hard Bug có khả năng tái diễn.
|
|
156
|
+
- Pattern làm việc lặp lại trong dự án.
|
|
157
|
+
- Convention hoặc quy tắc kiến trúc mới.
|
|
158
|
+
- Quyết định Architecture quan trọng.
|
|
159
|
+
- Tech Debt Pattern hoặc Code Smell có tính hệ thống.
|
|
160
|
+
- 👉 *Domain Harvest:* Thỏa thuận Product Spec hoặc cấu trúc requirement mới.
|
|
161
|
+
|
|
162
|
+
- Candidate Memory chỉ là bản nháp quan sát, chưa phải tri thức chính thức.
|
|
163
|
+
- Candidate Memory có thể lưu tạm tại: `.ai-local/candidates/`
|
|
164
|
+
- AI không được tự động Promote Candidate Memory thành Project Knowledge.
|
|
165
|
+
|
|
166
|
+
---
|
|
167
|
+
|
|
168
|
+
### Post-flight Harvest (Đề xuất → Phê duyệt)
|
|
169
|
+
Sau khi hoàn thành task:
|
|
170
|
+
- AI đánh giá các Candidate Memory đã tạo.
|
|
171
|
+
- Nếu phát hiện tri thức có giá trị tái sử dụng:
|
|
172
|
+
- Đề xuất người dùng xem xét.
|
|
173
|
+
- Gửi yêu cầu phê duyệt thông qua:
|
|
174
|
+
- `/learn`
|
|
175
|
+
- `qk-project-memory`
|
|
176
|
+
- Chỉ sau khi được phê duyệt, Candidate Memory mới được chuyển thành Knowledge chính thức:
|
|
177
|
+
|
|
178
|
+
```
|
|
179
|
+
.ai-local/candidates/ ──(Approve)──> .ai-local/knowledge/index.yaml
|
|
180
|
+
```
|
|
181
|
+
|
|
182
|
+
- Project Knowledge phải được xem như tài sản kỹ thuật của dự án:
|
|
183
|
+
- Có thể review, cập nhật, loại bỏ và có lịch sử thay đổi.
|
|
184
|
+
|
|
185
|
+
---
|
|
186
|
+
|
|
187
|
+
### Ignore (Không đưa vào Memory)
|
|
188
|
+
Không lưu:
|
|
189
|
+
- Trace log của một session đơn lẻ.
|
|
190
|
+
- Temporary debugging data.
|
|
191
|
+
- Output của một lần chạy test/scan.
|
|
192
|
+
- Report health tạm thời của một đợt kiểm tra.
|
|
193
|
+
- Lỗi nhỏ chỉ xảy ra một lần.
|
|
194
|
+
- Thông tin không có khả năng tái sử dụng.
|
|
195
|
+
- 👉 *Domain Ignore:* Ghi chú thảo luận ý tưởng thô ban đầu.
|
|
196
|
+
|
|
197
|
+
---
|
|
198
|
+
|
|
199
|
+
### Golden Rule
|
|
200
|
+
> **AI được phép học, nhưng không được tự quyết định tri thức chính thức.**
|
|
201
|
+
> **AI quan sát → Đề xuất → Con người phê duyệt → Dự án tiến hóa.**
|
|
202
|
+
|
|
203
|
+
---
|
|
204
|
+
|
|
205
|
+
|
|
206
|
+
|
|
207
|
+
### 0. Self-Init Protocol (Khởi Tạo Bộ Nhớ Local & Gitignore)
|
|
208
|
+
- Trước khi tra cứu hoặc lưu trữ tri thức, BẮT BUỘC kiểm tra sự tồn tại của thư mục `.ai-local/` tại gốc dự án:
|
|
209
|
+
- **Tự động tạo mới:** Nếu `.ai-local/` chưa tồn tại, AI phải tự động tạo cấu trúc thư mục `.ai-local/knowledge/` (và file `index.yaml` nếu cần thiết) cùng `.ai-local/candidates/`. Tuyệt đối không ngưng chạy hay hỏi ý kiến người dùng về thao tác khởi tạo tiêu chuẩn này.
|
|
210
|
+
- **Bảo mật Gitignore:** BẮT BUỘC kiểm tra file `.gitignore` của dự án, nếu chưa có dòng `.ai-local/` thì phải tự động thêm vào để tuyệt đối bảo mật tri thức cá nhân và tránh lộ lọt lên Git.
|
|
211
|
+
|
|
212
|
+
---
|
|
213
|
+
|
|
214
|
+
### Pre-flight Retrieve (Trước khi thực thi)
|
|
215
|
+
- Trước các task có tính lặp lại, debug, refactor, kiến trúc hoặc rủi ro cao:
|
|
216
|
+
bắt buộc tra cứu:
|
|
217
|
+
- `.ai-local/knowledge/index.yaml` (Private Local Knowledge)
|
|
218
|
+
|
|
219
|
+
- Ưu tiên sử dụng các Knowledge đang có trạng thái `Active` thuộc:
|
|
220
|
+
- Architecture
|
|
221
|
+
- Hard Bug
|
|
222
|
+
- Convention
|
|
223
|
+
- Pattern
|
|
224
|
+
- Tech Debt Pattern
|
|
225
|
+
- 👉 *Domain Focus:* Convention / Pattern (vd: định dạng Acceptance Criteria, cấu trúc PRD).
|
|
226
|
+
|
|
227
|
+
- Memory chỉ đóng vai trò **Navigator (bản đồ chỉ đường)**.
|
|
228
|
+
Không được xem Memory là Source of Truth.
|
|
229
|
+
Luôn xác minh lại bằng source code, configuration và trạng thái hiện tại của dự án trước khi áp dụng.
|
|
230
|
+
|
|
231
|
+
---
|
|
232
|
+
|
|
233
|
+
### Learning Flow (AI tự học có kiểm soát)
|
|
234
|
+
- Trong quá trình làm việc, AI được phép tự phát hiện và tạo **Candidate Memory** khi nhận thấy:
|
|
235
|
+
- Hard Bug có khả năng tái diễn.
|
|
236
|
+
- Pattern làm việc lặp lại trong dự án.
|
|
237
|
+
- Convention hoặc quy tắc kiến trúc mới.
|
|
238
|
+
- Quyết định Architecture quan trọng.
|
|
239
|
+
- Tech Debt Pattern hoặc Code Smell có tính hệ thống.
|
|
240
|
+
- 👉 *Domain Harvest:* Thỏa thuận Product Spec hoặc cấu trúc requirement mới.
|
|
241
|
+
|
|
242
|
+
- Candidate Memory chỉ là bản nháp quan sát, chưa phải tri thức chính thức.
|
|
243
|
+
- Candidate Memory có thể lưu tạm tại: `.ai-local/candidates/`
|
|
244
|
+
- AI không được tự động Promote Candidate Memory thành Project Knowledge.
|
|
245
|
+
|
|
246
|
+
---
|
|
247
|
+
|
|
248
|
+
### Post-flight Harvest (Đề xuất → Phê duyệt)
|
|
249
|
+
Sau khi hoàn thành task:
|
|
250
|
+
- AI đánh giá các Candidate Memory đã tạo.
|
|
251
|
+
- Nếu phát hiện tri thức có giá trị tái sử dụng:
|
|
252
|
+
- Đề xuất người dùng xem xét.
|
|
253
|
+
- Gửi yêu cầu phê duyệt thông qua:
|
|
254
|
+
- `/learn`
|
|
255
|
+
- `qk-project-memory`
|
|
256
|
+
- Chỉ sau khi được phê duyệt, Candidate Memory mới được chuyển thành Knowledge chính thức:
|
|
257
|
+
|
|
258
|
+
```
|
|
259
|
+
.ai-local/candidates/ ──(Approve)──> .ai-local/knowledge/index.yaml
|
|
260
|
+
```
|
|
261
|
+
|
|
262
|
+
- Project Knowledge phải được xem như tài sản kỹ thuật của dự án:
|
|
263
|
+
- Có thể review, cập nhật, loại bỏ và có lịch sử thay đổi.
|
|
264
|
+
|
|
265
|
+
---
|
|
266
|
+
|
|
267
|
+
### Ignore (Không đưa vào Memory)
|
|
268
|
+
Không lưu:
|
|
269
|
+
- Trace log của một session đơn lẻ.
|
|
270
|
+
- Temporary debugging data.
|
|
271
|
+
- Output của một lần chạy test/scan.
|
|
272
|
+
- Report health tạm thời của một đợt kiểm tra.
|
|
273
|
+
- Lỗi nhỏ chỉ xảy ra một lần.
|
|
274
|
+
- Thông tin không có khả năng tái sử dụng.
|
|
275
|
+
- 👉 *Domain Ignore:* Ghi chú thảo luận ý tưởng thô ban đầu.
|
|
276
|
+
|
|
277
|
+
---
|
|
278
|
+
|
|
279
|
+
### Golden Rule
|
|
280
|
+
> **AI được phép học, nhưng không được tự quyết định tri thức chính thức.**
|
|
281
|
+
> **AI quan sát → Đề xuất → Con người phê duyệt → Dự án tiến hóa.**
|
|
282
|
+
|
|
283
|
+
---
|
|
284
|
+
|
|
285
|
+
|
|
286
|
+
|
|
127
287
|
### Pre-flight Retrieve (Trước khi thực thi)
|
|
128
288
|
- Trước các task có tính lặp lại, debug, refactor, kiến trúc hoặc rủi ro cao:
|
|
129
289
|
bắt buộc tra cứu:
|
|
@@ -96,6 +96,166 @@ exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
|
|
|
96
96
|
|
|
97
97
|
## Memory Workflow
|
|
98
98
|
|
|
99
|
+
### 0. Self-Init Protocol (Khởi Tạo Bộ Nhớ Local & Gitignore)
|
|
100
|
+
- Trước khi tra cứu hoặc lưu trữ tri thức, BẮT BUỘC kiểm tra sự tồn tại của thư mục `.ai-local/` tại gốc dự án:
|
|
101
|
+
- **Tự động tạo mới:** Nếu `.ai-local/` chưa tồn tại, AI phải tự động tạo cấu trúc thư mục `.ai-local/knowledge/` (và file `index.yaml` nếu cần thiết) cùng `.ai-local/candidates/`. Tuyệt đối không ngưng chạy hay hỏi ý kiến người dùng về thao tác khởi tạo tiêu chuẩn này.
|
|
102
|
+
- **Bảo mật Gitignore:** BẮT BUỘC kiểm tra file `.gitignore` của dự án, nếu chưa có dòng `.ai-local/` thì phải tự động thêm vào để tuyệt đối bảo mật tri thức cá nhân và tránh lộ lọt lên Git.
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
### Pre-flight Retrieve (Trước khi thực thi)
|
|
107
|
+
- Trước các task có tính lặp lại, debug, refactor, kiến trúc hoặc rủi ro cao:
|
|
108
|
+
bắt buộc tra cứu:
|
|
109
|
+
- `.ai-local/knowledge/index.yaml` (Private Local Knowledge)
|
|
110
|
+
|
|
111
|
+
- Ưu tiên sử dụng các Knowledge đang có trạng thái `Active` thuộc:
|
|
112
|
+
- Architecture
|
|
113
|
+
- Hard Bug
|
|
114
|
+
- Convention
|
|
115
|
+
- Pattern
|
|
116
|
+
- Tech Debt Pattern
|
|
117
|
+
- 👉 *Domain Focus:* Convention / Hard Bug (vd: 8-gate checklist release, rủi ro production cũ).
|
|
118
|
+
|
|
119
|
+
- Memory chỉ đóng vai trò **Navigator (bản đồ chỉ đường)**.
|
|
120
|
+
Không được xem Memory là Source of Truth.
|
|
121
|
+
Luôn xác minh lại bằng source code, configuration và trạng thái hiện tại của dự án trước khi áp dụng.
|
|
122
|
+
|
|
123
|
+
---
|
|
124
|
+
|
|
125
|
+
### Learning Flow (AI tự học có kiểm soát)
|
|
126
|
+
- Trong quá trình làm việc, AI được phép tự phát hiện và tạo **Candidate Memory** khi nhận thấy:
|
|
127
|
+
- Hard Bug có khả năng tái diễn.
|
|
128
|
+
- Pattern làm việc lặp lại trong dự án.
|
|
129
|
+
- Convention hoặc quy tắc kiến trúc mới.
|
|
130
|
+
- Quyết định Architecture quan trọng.
|
|
131
|
+
- Tech Debt Pattern hoặc Code Smell có tính hệ thống.
|
|
132
|
+
- 👉 *Domain Harvest:* Checklist hoặc Gate bảo vệ Production mới được đưa ra từ post-mortem.
|
|
133
|
+
|
|
134
|
+
- Candidate Memory chỉ là bản nháp quan sát, chưa phải tri thức chính thức.
|
|
135
|
+
- Candidate Memory có thể lưu tạm tại: `.ai-local/candidates/`
|
|
136
|
+
- AI không được tự động Promote Candidate Memory thành Project Knowledge.
|
|
137
|
+
|
|
138
|
+
---
|
|
139
|
+
|
|
140
|
+
### Post-flight Harvest (Đề xuất → Phê duyệt)
|
|
141
|
+
Sau khi hoàn thành task:
|
|
142
|
+
- AI đánh giá các Candidate Memory đã tạo.
|
|
143
|
+
- Nếu phát hiện tri thức có giá trị tái sử dụng:
|
|
144
|
+
- Đề xuất người dùng xem xét.
|
|
145
|
+
- Gửi yêu cầu phê duyệt thông qua:
|
|
146
|
+
- `/learn`
|
|
147
|
+
- `qk-project-memory`
|
|
148
|
+
- Chỉ sau khi được phê duyệt, Candidate Memory mới được chuyển thành Knowledge chính thức:
|
|
149
|
+
|
|
150
|
+
```
|
|
151
|
+
.ai-local/candidates/ ──(Approve)──> .ai-local/knowledge/index.yaml
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
- Project Knowledge phải được xem như tài sản kỹ thuật của dự án:
|
|
155
|
+
- Có thể review, cập nhật, loại bỏ và có lịch sử thay đổi.
|
|
156
|
+
|
|
157
|
+
---
|
|
158
|
+
|
|
159
|
+
### Ignore (Không đưa vào Memory)
|
|
160
|
+
Không lưu:
|
|
161
|
+
- Trace log của một session đơn lẻ.
|
|
162
|
+
- Temporary debugging data.
|
|
163
|
+
- Output của một lần chạy test/scan.
|
|
164
|
+
- Report health tạm thời của một đợt kiểm tra.
|
|
165
|
+
- Lỗi nhỏ chỉ xảy ra một lần.
|
|
166
|
+
- Thông tin không có khả năng tái sử dụng.
|
|
167
|
+
- 👉 *Domain Ignore:* Log deploy staging tạm thời.
|
|
168
|
+
|
|
169
|
+
---
|
|
170
|
+
|
|
171
|
+
### Golden Rule
|
|
172
|
+
> **AI được phép học, nhưng không được tự quyết định tri thức chính thức.**
|
|
173
|
+
> **AI quan sát → Đề xuất → Con người phê duyệt → Dự án tiến hóa.**
|
|
174
|
+
|
|
175
|
+
---
|
|
176
|
+
|
|
177
|
+
|
|
178
|
+
|
|
179
|
+
### 0. Self-Init Protocol (Khởi Tạo Bộ Nhớ Local & Gitignore)
|
|
180
|
+
- Trước khi tra cứu hoặc lưu trữ tri thức, BẮT BUỘC kiểm tra sự tồn tại của thư mục `.ai-local/` tại gốc dự án:
|
|
181
|
+
- **Tự động tạo mới:** Nếu `.ai-local/` chưa tồn tại, AI phải tự động tạo cấu trúc thư mục `.ai-local/knowledge/` (và file `index.yaml` nếu cần thiết) cùng `.ai-local/candidates/`. Tuyệt đối không ngưng chạy hay hỏi ý kiến người dùng về thao tác khởi tạo tiêu chuẩn này.
|
|
182
|
+
- **Bảo mật Gitignore:** BẮT BUỘC kiểm tra file `.gitignore` của dự án, nếu chưa có dòng `.ai-local/` thì phải tự động thêm vào để tuyệt đối bảo mật tri thức cá nhân và tránh lộ lọt lên Git.
|
|
183
|
+
|
|
184
|
+
---
|
|
185
|
+
|
|
186
|
+
### Pre-flight Retrieve (Trước khi thực thi)
|
|
187
|
+
- Trước các task có tính lặp lại, debug, refactor, kiến trúc hoặc rủi ro cao:
|
|
188
|
+
bắt buộc tra cứu:
|
|
189
|
+
- `.ai-local/knowledge/index.yaml` (Private Local Knowledge)
|
|
190
|
+
|
|
191
|
+
- Ưu tiên sử dụng các Knowledge đang có trạng thái `Active` thuộc:
|
|
192
|
+
- Architecture
|
|
193
|
+
- Hard Bug
|
|
194
|
+
- Convention
|
|
195
|
+
- Pattern
|
|
196
|
+
- Tech Debt Pattern
|
|
197
|
+
- 👉 *Domain Focus:* Convention / Hard Bug (vd: 8-gate checklist release, rủi ro production cũ).
|
|
198
|
+
|
|
199
|
+
- Memory chỉ đóng vai trò **Navigator (bản đồ chỉ đường)**.
|
|
200
|
+
Không được xem Memory là Source of Truth.
|
|
201
|
+
Luôn xác minh lại bằng source code, configuration và trạng thái hiện tại của dự án trước khi áp dụng.
|
|
202
|
+
|
|
203
|
+
---
|
|
204
|
+
|
|
205
|
+
### Learning Flow (AI tự học có kiểm soát)
|
|
206
|
+
- Trong quá trình làm việc, AI được phép tự phát hiện và tạo **Candidate Memory** khi nhận thấy:
|
|
207
|
+
- Hard Bug có khả năng tái diễn.
|
|
208
|
+
- Pattern làm việc lặp lại trong dự án.
|
|
209
|
+
- Convention hoặc quy tắc kiến trúc mới.
|
|
210
|
+
- Quyết định Architecture quan trọng.
|
|
211
|
+
- Tech Debt Pattern hoặc Code Smell có tính hệ thống.
|
|
212
|
+
- 👉 *Domain Harvest:* Checklist hoặc Gate bảo vệ Production mới được đưa ra từ post-mortem.
|
|
213
|
+
|
|
214
|
+
- Candidate Memory chỉ là bản nháp quan sát, chưa phải tri thức chính thức.
|
|
215
|
+
- Candidate Memory có thể lưu tạm tại: `.ai-local/candidates/`
|
|
216
|
+
- AI không được tự động Promote Candidate Memory thành Project Knowledge.
|
|
217
|
+
|
|
218
|
+
---
|
|
219
|
+
|
|
220
|
+
### Post-flight Harvest (Đề xuất → Phê duyệt)
|
|
221
|
+
Sau khi hoàn thành task:
|
|
222
|
+
- AI đánh giá các Candidate Memory đã tạo.
|
|
223
|
+
- Nếu phát hiện tri thức có giá trị tái sử dụng:
|
|
224
|
+
- Đề xuất người dùng xem xét.
|
|
225
|
+
- Gửi yêu cầu phê duyệt thông qua:
|
|
226
|
+
- `/learn`
|
|
227
|
+
- `qk-project-memory`
|
|
228
|
+
- Chỉ sau khi được phê duyệt, Candidate Memory mới được chuyển thành Knowledge chính thức:
|
|
229
|
+
|
|
230
|
+
```
|
|
231
|
+
.ai-local/candidates/ ──(Approve)──> .ai-local/knowledge/index.yaml
|
|
232
|
+
```
|
|
233
|
+
|
|
234
|
+
- Project Knowledge phải được xem như tài sản kỹ thuật của dự án:
|
|
235
|
+
- Có thể review, cập nhật, loại bỏ và có lịch sử thay đổi.
|
|
236
|
+
|
|
237
|
+
---
|
|
238
|
+
|
|
239
|
+
### Ignore (Không đưa vào Memory)
|
|
240
|
+
Không lưu:
|
|
241
|
+
- Trace log của một session đơn lẻ.
|
|
242
|
+
- Temporary debugging data.
|
|
243
|
+
- Output của một lần chạy test/scan.
|
|
244
|
+
- Report health tạm thời của một đợt kiểm tra.
|
|
245
|
+
- Lỗi nhỏ chỉ xảy ra một lần.
|
|
246
|
+
- Thông tin không có khả năng tái sử dụng.
|
|
247
|
+
- 👉 *Domain Ignore:* Log deploy staging tạm thời.
|
|
248
|
+
|
|
249
|
+
---
|
|
250
|
+
|
|
251
|
+
### Golden Rule
|
|
252
|
+
> **AI được phép học, nhưng không được tự quyết định tri thức chính thức.**
|
|
253
|
+
> **AI quan sát → Đề xuất → Con người phê duyệt → Dự án tiến hóa.**
|
|
254
|
+
|
|
255
|
+
---
|
|
256
|
+
|
|
257
|
+
|
|
258
|
+
|
|
99
259
|
### Pre-flight Retrieve (Trước khi thực thi)
|
|
100
260
|
- Trước các task có tính lặp lại, debug, refactor, kiến trúc hoặc rủi ro cao:
|
|
101
261
|
bắt buộc tra cứu:
|