@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.
Files changed (34) hide show
  1. package/.agent/agents/backend-specialist.md +2 -2
  2. package/.agent/agents/frontend-specialist.md +37 -74
  3. package/.agent/agents/quant-architect.md +31 -0
  4. package/.agent/rules/GEMINI.md +8 -1
  5. package/.agent/skills/app-builder/SKILL.md +1 -1
  6. package/.agent/skills/app-builder/scaffolding.md +3 -3
  7. package/.agent/skills/app-builder/tech-stack.md +3 -4
  8. package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +39 -79
  9. package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +53 -75
  10. package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +56 -119
  11. package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +61 -94
  12. package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +56 -82
  13. package/.agent/skills/brainstorming/SKILL.md +13 -8
  14. package/.agent/skills/business-ops/SKILL.md +26 -0
  15. package/.agent/skills/clean-code/SKILL.md +4 -3
  16. package/.agent/skills/cli-generator/SKILL.md +48 -0
  17. package/.agent/skills/data-science/SKILL.md +28 -0
  18. package/.agent/skills/doc.md +36 -36
  19. package/.agent/skills/frontend-design/SKILL.md +0 -34
  20. package/.agent/skills/frontend-design/ux-psychology.md +10 -585
  21. package/.agent/skills/knowledge-management/SKILL.md +66 -0
  22. package/.agent/skills/lint-and-validate/scripts/lint_runner.py +2 -14
  23. package/.agent/skills/memory-architecture/SKILL.md +107 -0
  24. package/.agent/skills/mini-antigravity-injection/SKILL.md +59 -0
  25. package/.agent/skills/nextjs-react-expert/1-async-eliminating-waterfalls.md +1 -40
  26. package/.agent/skills/nextjs-react-expert/SKILL.md +21 -47
  27. package/.agent/skills/nextjs-react-expert/scripts/convert_rules.py +1 -1
  28. package/.agent/skills/plan-writing/SKILL.md +32 -31
  29. package/.agent/skills/product-management/SKILL.md +30 -0
  30. package/.agent/skills/systematic-debugging/SKILL.md +11 -0
  31. package/.agent/skills/tdd-workflow/SKILL.md +6 -7
  32. package/.agent/workflows/orchestrate.md +6 -6
  33. package/package.json +1 -1
  34. package/template/.agent/skills/mini-antigravity-injection/SKILL.md +59 -0
@@ -1,26 +1,26 @@
1
1
  # Antigravity Skills
2
2
 
3
- > **Guide to creating and using Skills in the Antigravity Kit**
3
+ > **Hướng dẫn tạo sử dụng Skills trong Antigravity Kit**
4
4
 
5
5
  ---
6
6
 
7
- ## 📋 Overview
7
+ ## 📋 Giới thiệu
8
8
 
9
- While Antigravity's base models (like Gemini) are powerful generalists, they don't know your specific project context or your team's standards. Loading every rule or tool into the agent's context window leads to "tool bloat," higher costs, latency, and confusion.
9
+ Mặc các hình cơ bản của Antigravity (như Gemini) những 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** solve this through **Progressive Disclosure**. A Skill is a package of specialized knowledge that remains dormant until needed. This information is only loaded into the agent's context when your specific request matches the skill's description.
11
+ **Antigravity Skills** giải quyết vấn đề này thông qua tính năng **Progressive Disclosure**. Kỹ năng 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
- ## 📁 Structure and Scope
15
+ ## 📁 Cấu trúc và Phạm vi
16
16
 
17
- Skills are folder-based packages. You can define these scopes based on your needs:
17
+ Kỹ năng các gói dựa trên thư mục. Bạn thể xác định các phạm vi này tuỳ thuộc vào nhu cầu:
18
18
 
19
- | Scope | Path | Description |
20
- | ------------- | --------------------------------- | ------------------------------------ |
21
- | **Workspace** | `<workspace-root>/.agent/skills/` | Available only in a specific project |
19
+ | Phạm vi | Đường dẫn | Mô tả |
20
+ |---------|-----------|-------|
21
+ | **Workspace** | `<workspace-root>/.agent/skills/` | Chỉ trong một dự án cụ thể |
22
22
 
23
- ### Skill Directory Structure
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
- ## 🔍 Example 1: Code Review Skill
35
+ ## 🔍 dụ 1: Code Review Skill
36
36
 
37
- This is an instruction-only skill; you only need to create the `SKILL.md` file.
37
+ Đây một kỹ năng chỉ có hướng dẫn (instruction-only), chỉ cần tạo file `SKILL.md`.
38
38
 
39
- ### Step 1: Create the directory
39
+ ### Bước 1: Tạo thư mục
40
40
 
41
41
  ```bash
42
- mkdir -p .agent/skills/code-review
42
+ mkdir -p ~/.gemini/antigravity/skills/code-review
43
43
  ```
44
44
 
45
- ### Step 2: Create SKILL.md
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
- > **Note**: The `SKILL.md` file contains metadata (name, description) at the top, followed by the instructions. The agent will only read the metadata and load the full instructions only when needed.
71
+ > **Lưu ý**: File `SKILL.md` chứa siêu dữ liệu (name, description) trên cùng, sau đó các chỉ dẫn. Agent sẽ chỉ đọc siêu dữ liệu chỉ tải hướng dẫn khi cần.
72
72
 
73
- ### Try it out
73
+ ### Dùng thử
74
74
 
75
- Create a file `demo_bad_code.py`:
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
- The Agent will automatically identify the `code-review` skill, load the information, and follow the instructions.
111
+ Agent sẽ tự động xác định kỹ năng `code-review`, tải thông tin thực hiện theo hướng dẫn.
112
112
 
113
113
  ---
114
114
 
115
- ## 📄 Example 2: License Header Skill
115
+ ## 📄 dụ 2: License Header Skill
116
116
 
117
- This skill uses a reference file in the `resources/` (or `references/`) directory.
117
+ Kỹ năng này sử dụng file tham chiếu (reference file) trong thư mục `resources/`.
118
118
 
119
- ### Step 1: Create the directory
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
- ### Step 2: Create the template file
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
- ### Step 3: Create SKILL.md
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
- ### Try it out
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
- The Agent will read the template, convert the comments to Python style, and automatically add it to the top of the file.
164
+ Agent sẽ đọc template, chuyển đổi comments theo kiểu Python tự động thêm vào đầu file.
165
165
 
166
166
  ---
167
167
 
168
- ## 🎯 Conclusion
168
+ ## 🎯 Kết luận
169
169
 
170
- By creating Skills, you transform a general AI model into an expert for your project:
170
+ Bằng cách tạo Skills, bạn đã biến hình AI đa năng thành một chuyên gia cho dự án của mình:
171
171
 
172
- - ✅ Systematize best practices
173
- - ✅ Adhere to code review rules
174
- - ✅ Automatically add license headers
175
- - ✅ The Agent automatically knows how to work with your team
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
- Instead of constantly reminding the AI to "remember to add the license" or "fix the commit format," now the Agent will do it automatically!
177
+ Thay 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).