@mrtrinhvn/ag-kit 1.0.6 → 1.0.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/.agent/agents/backend-specialist.md +2 -2
- package/.agent/agents/frontend-specialist.md +37 -74
- package/.agent/agents/quant-architect.md +31 -0
- package/.agent/rules/GEMINI.md +8 -1
- package/.agent/skills/app-builder/SKILL.md +1 -1
- package/.agent/skills/app-builder/scaffolding.md +3 -3
- package/.agent/skills/app-builder/tech-stack.md +3 -4
- package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +39 -79
- package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +53 -75
- package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +56 -119
- package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +61 -94
- package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +56 -82
- package/.agent/skills/brainstorming/SKILL.md +13 -8
- package/.agent/skills/business-ops/SKILL.md +26 -0
- package/.agent/skills/clean-code/SKILL.md +4 -3
- package/.agent/skills/cli-generator/SKILL.md +48 -0
- package/.agent/skills/data-science/SKILL.md +28 -0
- package/.agent/skills/doc.md +36 -36
- package/.agent/skills/frontend-design/SKILL.md +0 -34
- package/.agent/skills/frontend-design/ux-psychology.md +10 -585
- package/.agent/skills/knowledge-management/SKILL.md +66 -0
- package/.agent/skills/lint-and-validate/scripts/lint_runner.py +2 -14
- package/.agent/skills/memory-architecture/SKILL.md +107 -0
- package/.agent/skills/mini-antigravity-injection/SKILL.md +59 -0
- package/.agent/skills/nextjs-react-expert/1-async-eliminating-waterfalls.md +1 -40
- package/.agent/skills/nextjs-react-expert/SKILL.md +21 -47
- package/.agent/skills/nextjs-react-expert/scripts/convert_rules.py +1 -1
- package/.agent/skills/plan-writing/SKILL.md +32 -31
- package/.agent/skills/product-management/SKILL.md +30 -0
- package/.agent/skills/systematic-debugging/SKILL.md +11 -0
- package/.agent/skills/tdd-workflow/SKILL.md +6 -7
- package/.agent/workflows/orchestrate.md +6 -6
- package/package.json +1 -1
- package/template/.agent/skills/mini-antigravity-injection/SKILL.md +59 -0
package/.agent/skills/doc.md
CHANGED
|
@@ -1,26 +1,26 @@
|
|
|
1
1
|
# Antigravity Skills
|
|
2
2
|
|
|
3
|
-
> **
|
|
3
|
+
> **Hướng dẫn tạo và sử dụng Skills trong Antigravity Kit**
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
## 📋
|
|
7
|
+
## 📋 Giới thiệu
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
Mặc dù các mô hình cơ bản của Antigravity (như Gemini) là những mô hình đa năng mạnh mẽ, nhưng chúng không biết ngữ cảnh dự án cụ thể hoặc các tiêu chuẩn của nhóm bạn. Việc tải từng quy tắc hoặc công cụ vào cửa sổ ngữ cảnh của tác nhân sẽ dẫn đến tình trạng "phình to công cụ", chi phí cao hơn, độ trễ và sự nhầm lẫn.
|
|
10
10
|
|
|
11
|
-
**Antigravity Skills**
|
|
11
|
+
**Antigravity Skills** giải quyết vấn đề này thông qua tính năng **Progressive Disclosure**. Kỹ năng là một gói kiến thức chuyên biệt, ở trạng thái không hoạt động cho đến khi cần. Thông tin này chỉ được tải vào ngữ cảnh của tác nhân khi yêu cầu cụ thể của bạn khớp với nội dung mô tả của kỹ năng.
|
|
12
12
|
|
|
13
13
|
---
|
|
14
14
|
|
|
15
|
-
## 📁
|
|
15
|
+
## 📁 Cấu trúc và Phạm vi
|
|
16
16
|
|
|
17
|
-
|
|
17
|
+
Kỹ năng là các gói dựa trên thư mục. Bạn có thể xác định các phạm vi này tuỳ thuộc vào nhu cầu:
|
|
18
18
|
|
|
19
|
-
|
|
|
20
|
-
|
|
21
|
-
| **Workspace** | `<workspace-root>/.agent/skills/` |
|
|
19
|
+
| Phạm vi | Đường dẫn | Mô tả |
|
|
20
|
+
|---------|-----------|-------|
|
|
21
|
+
| **Workspace** | `<workspace-root>/.agent/skills/` | Chỉ có trong một dự án cụ thể |
|
|
22
22
|
|
|
23
|
-
###
|
|
23
|
+
### Cấu trúc thư mục kỹ năng
|
|
24
24
|
|
|
25
25
|
```
|
|
26
26
|
my-skill/
|
|
@@ -32,17 +32,17 @@ my-skill/
|
|
|
32
32
|
|
|
33
33
|
---
|
|
34
34
|
|
|
35
|
-
## 🔍
|
|
35
|
+
## 🔍 Ví dụ 1: Code Review Skill
|
|
36
36
|
|
|
37
|
-
|
|
37
|
+
Đây là một kỹ năng chỉ có hướng dẫn (instruction-only), chỉ cần tạo file `SKILL.md`.
|
|
38
38
|
|
|
39
|
-
###
|
|
39
|
+
### Bước 1: Tạo thư mục
|
|
40
40
|
|
|
41
41
|
```bash
|
|
42
|
-
mkdir -p
|
|
42
|
+
mkdir -p ~/.gemini/antigravity/skills/code-review
|
|
43
43
|
```
|
|
44
44
|
|
|
45
|
-
###
|
|
45
|
+
### Bước 2: Tạo SKILL.md
|
|
46
46
|
|
|
47
47
|
```markdown
|
|
48
48
|
---
|
|
@@ -68,11 +68,11 @@ When reviewing code, follow these steps:
|
|
|
68
68
|
- Suggest alternatives when possible
|
|
69
69
|
```
|
|
70
70
|
|
|
71
|
-
> **
|
|
71
|
+
> **Lưu ý**: File `SKILL.md` chứa siêu dữ liệu (name, description) ở trên cùng, sau đó là các chỉ dẫn. Agent sẽ chỉ đọc siêu dữ liệu và chỉ tải hướng dẫn khi cần.
|
|
72
72
|
|
|
73
|
-
###
|
|
73
|
+
### Dùng thử
|
|
74
74
|
|
|
75
|
-
|
|
75
|
+
Tạo file `demo_bad_code.py`:
|
|
76
76
|
|
|
77
77
|
```python
|
|
78
78
|
import time
|
|
@@ -96,10 +96,10 @@ def process_payments(items):
|
|
|
96
96
|
def run_batch():
|
|
97
97
|
users = [{'id': 1, 'name': 'Alice'}, {'id': 2, 'name': 'Bob'}]
|
|
98
98
|
items = [{'price': 10}, {'price': 20}, {'price': 100}]
|
|
99
|
-
|
|
99
|
+
|
|
100
100
|
u = get_user_data(users, 3)
|
|
101
101
|
print("User found: " + u['name']) # Will crash if None
|
|
102
|
-
|
|
102
|
+
|
|
103
103
|
print("Total: " + str(process_payments(items)))
|
|
104
104
|
|
|
105
105
|
if __name__ == "__main__":
|
|
@@ -108,21 +108,21 @@ if __name__ == "__main__":
|
|
|
108
108
|
|
|
109
109
|
**Prompt**: `review the @demo_bad_code.py file`
|
|
110
110
|
|
|
111
|
-
|
|
111
|
+
Agent sẽ tự động xác định kỹ năng `code-review`, tải thông tin và thực hiện theo hướng dẫn.
|
|
112
112
|
|
|
113
113
|
---
|
|
114
114
|
|
|
115
|
-
## 📄
|
|
115
|
+
## 📄 Ví dụ 2: License Header Skill
|
|
116
116
|
|
|
117
|
-
|
|
117
|
+
Kỹ năng này sử dụng file tham chiếu (reference file) trong thư mục `resources/`.
|
|
118
118
|
|
|
119
|
-
###
|
|
119
|
+
### Bước 1: Tạo thư mục
|
|
120
120
|
|
|
121
121
|
```bash
|
|
122
122
|
mkdir -p .agent/skills/license-header-adder/resources
|
|
123
123
|
```
|
|
124
124
|
|
|
125
|
-
###
|
|
125
|
+
### Bước 2: Tạo file template
|
|
126
126
|
|
|
127
127
|
**`.agent/skills/license-header-adder/resources/HEADER.txt`**:
|
|
128
128
|
|
|
@@ -134,7 +134,7 @@ mkdir -p .agent/skills/license-header-adder/resources
|
|
|
134
134
|
*/
|
|
135
135
|
```
|
|
136
136
|
|
|
137
|
-
###
|
|
137
|
+
### Bước 3: Tạo SKILL.md
|
|
138
138
|
|
|
139
139
|
**`.agent/skills/license-header-adder/SKILL.md`**:
|
|
140
140
|
|
|
@@ -152,26 +152,26 @@ This skill ensures that all new source files have the correct copyright header.
|
|
|
152
152
|
|
|
153
153
|
1. **Read the Template**: Read the content of `resources/HEADER.txt`.
|
|
154
154
|
2. **Apply to File**: When creating a new file, prepend this exact content.
|
|
155
|
-
3. **Adapt Syntax**:
|
|
155
|
+
3. **Adapt Syntax**:
|
|
156
156
|
- For C-style languages (Java, TS), keep the `/* */` block.
|
|
157
157
|
- For Python/Shell, convert to `#` comments.
|
|
158
158
|
```
|
|
159
159
|
|
|
160
|
-
###
|
|
160
|
+
### Dùng thử
|
|
161
161
|
|
|
162
162
|
**Prompt**: `Create a new Python script named data_processor.py that prints 'Hello World'.`
|
|
163
163
|
|
|
164
|
-
|
|
164
|
+
Agent sẽ đọc template, chuyển đổi comments theo kiểu Python và tự động thêm vào đầu file.
|
|
165
165
|
|
|
166
166
|
---
|
|
167
167
|
|
|
168
|
-
## 🎯
|
|
168
|
+
## 🎯 Kết luận
|
|
169
169
|
|
|
170
|
-
|
|
170
|
+
Bằng cách tạo Skills, bạn đã biến mô hình AI đa năng thành một chuyên gia cho dự án của mình:
|
|
171
171
|
|
|
172
|
-
- ✅
|
|
173
|
-
- ✅
|
|
174
|
-
- ✅
|
|
175
|
-
- ✅
|
|
172
|
+
- ✅ Hệ thống hoá các best practices
|
|
173
|
+
- ✅ Tuân theo quy tắc đánh giá code
|
|
174
|
+
- ✅ Tự động thêm license headers
|
|
175
|
+
- ✅ Agent tự động biết cách làm việc với nhóm của bạn
|
|
176
176
|
|
|
177
|
-
|
|
177
|
+
Thay vì liên tục nhắc AI "nhớ thêm license" hoặc "sửa format commit", giờ đây Agent sẽ tự động thực hiện!
|
|
@@ -416,37 +416,3 @@ After implementing your design, run the audit:
|
|
|
416
416
|
---
|
|
417
417
|
|
|
418
418
|
> **Remember:** Design is THINKING, not copying. Every project deserves fresh consideration based on its unique context and users. **Avoid the Modern SaaS Safe Harbor!**
|
|
419
|
-
|
|
420
|
-
---
|
|
421
|
-
|
|
422
|
-
## 5. Next.js 16+ Modern Form Patterns
|
|
423
|
-
|
|
424
|
-
> [!IMPORTANT]
|
|
425
|
-
> For Next.js 16+ projects, use the native `next/form` component instead of standard HTML `<form>` for all GET-based search/filter operations.
|
|
426
|
-
|
|
427
|
-
### The `<Form>` Component Advantage
|
|
428
|
-
- **Automatic Client Navigation:** Performs client-side transitions on submit.
|
|
429
|
-
- **Progressive Enhancement:** Works even without JavaScript.
|
|
430
|
-
- **URL Sync:** Automatically encodes input values into search params.
|
|
431
|
-
|
|
432
|
-
### Implementation Example (Search Bar)
|
|
433
|
-
```tsx
|
|
434
|
-
import Form from 'next/form'
|
|
435
|
-
|
|
436
|
-
export default function SearchBar() {
|
|
437
|
-
return (
|
|
438
|
-
<Form action="/search" className="flex gap-2">
|
|
439
|
-
<input
|
|
440
|
-
name="q"
|
|
441
|
-
placeholder="Search products..."
|
|
442
|
-
className="border p-2"
|
|
443
|
-
/>
|
|
444
|
-
<button type="submit">Search</button>
|
|
445
|
-
</Form>
|
|
446
|
-
)
|
|
447
|
-
}
|
|
448
|
-
```
|
|
449
|
-
|
|
450
|
-
### When to use `<Form>` vs. standard `<form>`:
|
|
451
|
-
- **Use `next/form`** for: Search, Filtering, Sorting, Pagination (GET requests).
|
|
452
|
-
- **Use standard `<form>`** for: Mutations, Login, Data Entry (POST requests via Server Actions).
|