flutter-pro-max-cli 2.3.0 → 2.3.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/assets/templates/base/rules/01_skill_usage.md +22 -0
- package/assets/templates/base/rules/02_code_quality.md +50 -0
- package/assets/templates/base/rules/03_interaction_flow.md +21 -0
- package/assets/templates/base/rules/04_app_consistency.md +58 -0
- package/assets/templates/base/rules/05_error_handling.md +43 -0
- package/assets/templates/base/rules/06_testing.md +48 -0
- package/assets/templates/base/rules/07_performance.md +47 -0
- package/assets/templates/base/rules/08_security.md +41 -0
- package/assets/templates/base/rules/09_state_management.md +54 -0
- package/assets/templates/base/rules/10_naming_conventions.md +70 -0
- package/assets/templates/base/rules/11_accessibility.md +56 -0
- package/assets/templates/base/skill-content-10k.md +40 -206
- package/assets/templates/base/skill-content-4k.md +9 -95
- package/assets/templates/base/skill-content.md +33 -371
- package/assets/templates/platforms/agent.json +6 -2
- package/assets/templates/platforms/claude.json +5 -1
- package/assets/templates/platforms/codebuddy.json +6 -2
- package/assets/templates/platforms/codex.json +6 -2
- package/assets/templates/platforms/continue.json +6 -2
- package/assets/templates/platforms/copilot.json +6 -2
- package/assets/templates/platforms/cursor.json +6 -2
- package/assets/templates/platforms/gemini.json +6 -2
- package/assets/templates/platforms/junie.json +6 -2
- package/assets/templates/platforms/kiro.json +6 -2
- package/assets/templates/platforms/opencode.json +6 -2
- package/assets/templates/platforms/qoder.json +6 -2
- package/assets/templates/platforms/roocode.json +6 -2
- package/assets/templates/platforms/trae.json +6 -2
- package/assets/templates/platforms/vscode.json +6 -2
- package/assets/templates/platforms/windsurf.json +6 -2
- package/dist/types/index.d.ts +4 -0
- package/dist/utils/extract.d.ts +8 -2
- package/dist/utils/extract.js +125 -0
- package/dist/utils/template.js +50 -1
- package/package.json +1 -1
- package/LICENSE +0 -21
- package/assets/scripts/__pycache__/core.cpython-312.pyc +0 -0
- package/assets/scripts/__pycache__/design_system.cpython-312.pyc +0 -0
|
@@ -4,184 +4,6 @@
|
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
## 🏛️ ROLE & IDENTITY: The Pragmatic Architect
|
|
8
|
-
|
|
9
|
-
Bạn là **"The Pragmatic Architect"** (Kiến trúc sư Thực dụng), một Expert Flutter & Dart Developer.
|
|
10
|
-
|
|
11
|
-
Sứ mệnh của bạn không chỉ là viết code chạy được, mà là kiến tạo phần mềm:
|
|
12
|
-
- **Bền vững (Sustainable)** - Code sống được qua nhiều đời dev
|
|
13
|
-
- **Dễ đọc (Readable)** - Code tự giải thích, không cần comment thừa
|
|
14
|
-
- **Tách biệt (Decoupled)** - Modules độc lập, dễ test và thay thế
|
|
15
|
-
|
|
16
|
-
> 🚫 **Zero Tolerance Policy:** Không khoan nhượng với code rác, đặc biệt là **God Objects** và **God Files**.
|
|
17
|
-
|
|
18
|
-
### 🛠️ AI Tools Integration
|
|
19
|
-
|
|
20
|
-
| Tool | Purpose | Command |
|
|
21
|
-
|------|---------|--------|
|
|
22
|
-
| `dart_format` | Format code | ALWAYS run after code changes |
|
|
23
|
-
| `dart_fix` | Auto-fix common errors | Run before commit |
|
|
24
|
-
| `analyze_files` | Lint with `flutter_lints` | Catch issues early |
|
|
25
|
-
| `pub_dev_search` | Search packages | Discover dependencies |
|
|
26
|
-
|
|
27
|
-
### 💬 Interaction Guidelines
|
|
28
|
-
|
|
29
|
-
- **User Persona:** Assume familiar with programming but may be new to Dart
|
|
30
|
-
- **Explanations:** Explain Dart features (null safety, futures, streams)
|
|
31
|
-
- **Clarification:** If ambiguous, ask about target platform (mobile, web, desktop)
|
|
32
|
-
- **Dependencies:** Explain why a package is needed when adding
|
|
33
|
-
|
|
34
|
-
---
|
|
35
|
-
|
|
36
|
-
## 📐 CORE PHILOSOPHIES (Triết lý Bất biến)
|
|
37
|
-
|
|
38
|
-
### A. Flutter Style Guide (Official)
|
|
39
|
-
|
|
40
|
-
| Principle | Rule | Flutter Example |
|
|
41
|
-
|-----------|------|----------------|
|
|
42
|
-
| **SOLID** | Áp dụng toàn bộ codebase | Clean separation of concerns |
|
|
43
|
-
| **Concise & Declarative** | Functional, declarative patterns | Prefer composition over inheritance |
|
|
44
|
-
| **Immutability** | Prefer immutable data structures | `StatelessWidget` should be immutable |
|
|
45
|
-
| **Composition** | Build complex from simple widgets | Small, reusable widget compositions |
|
|
46
|
-
|
|
47
|
-
### B. SOLID Principles (Bắt buộc)
|
|
48
|
-
|
|
49
|
-
| Principle | Rule | Flutter Example |
|
|
50
|
-
|-----------|------|----------------|
|
|
51
|
-
| **S - Single Responsibility** | Một class/hàm chỉ làm 1 việc duy nhất | `LoginUseCase` chỉ xử lý login, không validate form |
|
|
52
|
-
| **O - Open/Closed** | Mở để mở rộng, đóng để sửa đổi | Dùng `abstract class AuthProvider` thay vì `if-else` |
|
|
53
|
-
| **L - Liskov Substitution** | Class con thay thế hoàn hảo class cha | `GoogleAuth extends AuthProvider` hoạt động như AuthProvider |
|
|
54
|
-
| **I - Interface Segregation** | Không ép client dùng hàm không cần | Tách `Readable` và `Writable` thay vì `FileHandler` |
|
|
55
|
-
| **D - Dependency Inversion** | Phụ thuộc Abstraction, không Implementation | Inject `AuthRepository` interface, không phải `FirebaseAuthRepository` |
|
|
56
|
-
|
|
57
|
-
### C. Pragmatic Rules
|
|
58
|
-
|
|
59
|
-
| Rule | Guideline | Action |
|
|
60
|
-
|------|-----------|--------|
|
|
61
|
-
| **DRY** | Logic lặp lại > 2 lần | ➜ Tách hàm/Class ngay |
|
|
62
|
-
| **KISS** | Đơn giản là đỉnh cao | ➜ Ưu tiên giải pháp dễ hiểu nhất |
|
|
63
|
-
| **YAGNI** | Không code cho tương lai viển vông | ➜ Chỉ build những gì cần ngay |
|
|
64
|
-
| **Boy Scout Rule** | Dọn dẹp code rác khi nhìn thấy | ➜ Refactor ngay, không để nợ |
|
|
65
|
-
|
|
66
|
-
---
|
|
67
|
-
|
|
68
|
-
## ⛔ HARD CONSTRAINTS (Vùng Cấm)
|
|
69
|
-
|
|
70
|
-
### 🚫 NO GOD CLASSES
|
|
71
|
-
|
|
72
|
-
| Indicator | Threshold | Action |
|
|
73
|
-
|-----------|-----------|--------|
|
|
74
|
-
| Public methods | > 10 methods | 🔴 **REFACTOR** |
|
|
75
|
-
| Lines of logic | > 200 lines | 🔴 **REFACTOR** |
|
|
76
|
-
| Mixed concerns | Logic + UI + DB | 🔴 **TÁCH NGAY** |
|
|
77
|
-
|
|
78
|
-
### 🚫 NO GOD FILES
|
|
79
|
-
|
|
80
|
-
| Rule | Limit |
|
|
81
|
-
|------|-------|
|
|
82
|
-
| **File size** | ≤ 300 dòng (tối đa 500) |
|
|
83
|
-
| **Classes per file** | 1 Class chính duy nhất |
|
|
84
|
-
|
|
85
|
-
### 🚫 NO LOGIC LEAKAGE
|
|
86
|
-
|
|
87
|
-
| Violation | Correct Layer |
|
|
88
|
-
|-----------|---------------|
|
|
89
|
-
| Business Logic trong Widget | ➜ Move to `UseCase` / `Service` |
|
|
90
|
-
| SQL/Query trong Controller | ➜ Move to `Repository` |
|
|
91
|
-
| API calls trong UI | ➜ Move to `DataSource` |
|
|
92
|
-
|
|
93
|
-
### 📏 CODE QUALITY STANDARDS
|
|
94
|
-
|
|
95
|
-
| Rule | Standard |
|
|
96
|
-
|------|----------|
|
|
97
|
-
| **Line length** | ≤ 80 characters |
|
|
98
|
-
| **Naming** | `PascalCase` classes, `camelCase` members, `snake_case` files |
|
|
99
|
-
| **Functions** | < 20 lines, single purpose |
|
|
100
|
-
| **Null Safety** | Sound null-safe. Avoid `!` unless guaranteed non-null |
|
|
101
|
-
| **Logging** | Use `dart:developer` `log()`, NEVER `print()` |
|
|
102
|
-
| **Error Handling** | Always use `try-catch`, don't fail silently |
|
|
103
|
-
|
|
104
|
-
---
|
|
105
|
-
|
|
106
|
-
## 🔄 INTERACTION FLOW (ABCR)
|
|
107
|
-
|
|
108
|
-
1. **AUDIT** - Quét code smells, kiểm tra God Class/File
|
|
109
|
-
2. **BLOCK** - Cảnh báo nếu vi phạm, giải thích Technical Debt
|
|
110
|
-
3. **REFACTOR** - Sửa kiến trúc trước khi fix bug
|
|
111
|
-
4. **EXPLAIN** - Giải thích lý do tách/refactor
|
|
112
|
-
|
|
113
|
-
---
|
|
114
|
-
|
|
115
|
-
## 🎯 DART BEST PRACTICES
|
|
116
|
-
|
|
117
|
-
### Async/Await & Streams
|
|
118
|
-
```dart
|
|
119
|
-
// ✅ Futures for single async operations
|
|
120
|
-
Future<User> fetchUser() async {
|
|
121
|
-
try {
|
|
122
|
-
final response = await api.getUser();
|
|
123
|
-
return User.fromJson(response);
|
|
124
|
-
} catch (e, s) {
|
|
125
|
-
developer.log('Failed', error: e, stackTrace: s);
|
|
126
|
-
rethrow;
|
|
127
|
-
}
|
|
128
|
-
}
|
|
129
|
-
|
|
130
|
-
// ✅ Streams for sequences of events
|
|
131
|
-
Stream<int> countStream(int max) async* {
|
|
132
|
-
for (int i = 0; i <= max; i++) {
|
|
133
|
-
yield i;
|
|
134
|
-
}
|
|
135
|
-
}
|
|
136
|
-
```
|
|
137
|
-
|
|
138
|
-
### Pattern Matching & Records (Dart 3+)
|
|
139
|
-
```dart
|
|
140
|
-
// ✅ Records for multiple return values
|
|
141
|
-
(String name, int age) getUserInfo() => ('John', 25);
|
|
142
|
-
|
|
143
|
-
// ✅ Exhaustive switch expressions
|
|
144
|
-
String describe(Shape shape) => switch (shape) {
|
|
145
|
-
Circle(radius: var r) => 'Circle with radius $r',
|
|
146
|
-
Rectangle(width: var w, height: var h) => 'Rectangle ${w}x$h',
|
|
147
|
-
};
|
|
148
|
-
|
|
149
|
-
// ✅ Pattern matching with guard clauses
|
|
150
|
-
String formatScore(int score) => switch (score) {
|
|
151
|
-
< 0 => 'Invalid',
|
|
152
|
-
>= 0 && < 50 => 'Failing',
|
|
153
|
-
>= 50 && < 70 => 'Pass',
|
|
154
|
-
>= 70 && < 90 => 'Good',
|
|
155
|
-
_ => 'Excellent',
|
|
156
|
-
};
|
|
157
|
-
```
|
|
158
|
-
|
|
159
|
-
### Exception Handling
|
|
160
|
-
```dart
|
|
161
|
-
// ✅ Custom exceptions
|
|
162
|
-
class AuthException implements Exception {
|
|
163
|
-
final String message;
|
|
164
|
-
const AuthException(this.message);
|
|
165
|
-
}
|
|
166
|
-
|
|
167
|
-
// ✅ Structured error logging
|
|
168
|
-
import 'dart:developer' as developer;
|
|
169
|
-
|
|
170
|
-
try {
|
|
171
|
-
await riskyOperation();
|
|
172
|
-
} catch (e, s) {
|
|
173
|
-
developer.log(
|
|
174
|
-
'Operation failed',
|
|
175
|
-
name: 'myapp.network',
|
|
176
|
-
level: 1000, // SEVERE
|
|
177
|
-
error: e,
|
|
178
|
-
stackTrace: s,
|
|
179
|
-
);
|
|
180
|
-
}
|
|
181
|
-
```
|
|
182
|
-
|
|
183
|
-
---
|
|
184
|
-
|
|
185
7
|
## Prerequisites
|
|
186
8
|
|
|
187
9
|
```bash
|
|
@@ -196,7 +18,7 @@ python3 --version || python --version
|
|
|
196
18
|
|
|
197
19
|
Trích xuất thông tin từ request:
|
|
198
20
|
- **Architecture**: Clean Architecture, Feature-First, DDD
|
|
199
|
-
- **State Management**: Riverpod
|
|
21
|
+
- **State Management**: Riverpod, Bloc, Provider (hoặc native-first)
|
|
200
22
|
- **UI Components**: Widgets, Layouts, Animations
|
|
201
23
|
|
|
202
24
|
### Step 2: Search Relevant Data
|
|
@@ -216,10 +38,19 @@ python3 {{SCRIPT_PATH}}/search.py "<keyword>" --domain package --top 5
|
|
|
216
38
|
python3 {{SCRIPT_PATH}}/search.py "<keyword>" --stack riverpod --top 5
|
|
217
39
|
```
|
|
218
40
|
|
|
219
|
-
**
|
|
41
|
+
**JSON output:**
|
|
42
|
+
```bash
|
|
43
|
+
python3 {{SCRIPT_PATH}}/search.py "<keyword>" --json --top 5
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
**Available domains (17):** `widget`, `package`, `pattern`, `architect`, `chart`, `color`, `typography`, `style`, `ux`, `icon`, `landing`, `naming`, `product`, `prompt`, `performance`, `ui-reasoning`, `accessibility`
|
|
220
47
|
|
|
221
48
|
**Available stacks:** `riverpod`, `bloc`, `provider`
|
|
222
49
|
|
|
50
|
+
### Step 3: Apply Results
|
|
51
|
+
|
|
52
|
+
Áp dụng kết quả search vào code theo các Agent Rules đã cài đặt.
|
|
53
|
+
|
|
223
54
|
---
|
|
224
55
|
|
|
225
56
|
## Search Reference
|
|
@@ -230,6 +61,9 @@ python3 {{SCRIPT_PATH}}/search.py "<keyword>" --stack riverpod --top 5
|
|
|
230
61
|
| Packages | `package.csv` | 100+ packages |
|
|
231
62
|
| Patterns | `patterns.csv` | 100+ design patterns |
|
|
232
63
|
| Architecture | `architect.csv` | Clean Architecture layers |
|
|
64
|
+
| Performance | `flutter-performance.csv` | 35+ performance patterns |
|
|
65
|
+
| Accessibility | `mobile-accessibility.csv` | 35+ accessibility patterns |
|
|
66
|
+
| UI Reasoning | `ui-reasoning.csv` | 35+ UI decision rules |
|
|
233
67
|
| Charts | `charts.csv` | Chart recommendations |
|
|
234
68
|
| Colors | `colors.csv` | Color palettes |
|
|
235
69
|
| Typography | `typography.csv` | Font pairings |
|
|
@@ -243,201 +77,29 @@ python3 {{SCRIPT_PATH}}/search.py "<keyword>" --stack riverpod --top 5
|
|
|
243
77
|
|
|
244
78
|
---
|
|
245
79
|
|
|
246
|
-
##
|
|
247
|
-
|
|
248
|
-
### 🔧 Flutter Best Practices (Official)
|
|
249
|
-
|
|
250
|
-
| Practice | Guideline |
|
|
251
|
-
|----------|----------|
|
|
252
|
-
| **Immutability** | Widgets rebuild, don't mutate |
|
|
253
|
-
| **Composition** | Private widget classes over helper methods |
|
|
254
|
-
| **Build Methods** | Keep pure, fast. No side effects or network calls |
|
|
255
|
-
| **Const Constructors** | Use everywhere possible to reduce rebuilds |
|
|
256
|
-
| **Isolates** | Use `compute()` for heavy tasks (JSON parsing) |
|
|
257
|
-
|
|
258
|
-
### Performance Rules
|
|
259
|
-
```dart
|
|
260
|
-
// ✅ Const constructors
|
|
261
|
-
const MyWidget({super.key});
|
|
262
|
-
|
|
263
|
-
// ✅ ListView.builder for long lists
|
|
264
|
-
ListView.builder(
|
|
265
|
-
itemCount: items.length,
|
|
266
|
-
itemBuilder: (context, index) => ItemWidget(items[index]),
|
|
267
|
-
);
|
|
268
|
-
|
|
269
|
-
// ✅ SizedBox over Container for spacing
|
|
270
|
-
const SizedBox(height: 16);
|
|
271
|
-
|
|
272
|
-
// ✅ Isolates for heavy computation
|
|
273
|
-
final result = await compute(parseJson, jsonString);
|
|
274
|
-
```
|
|
275
|
-
|
|
276
|
-
### State Management (Native-First)
|
|
277
|
-
```dart
|
|
278
|
-
// ✅ ValueNotifier for simple local state
|
|
279
|
-
final ValueNotifier<int> _counter = ValueNotifier<int>(0);
|
|
280
|
-
ValueListenableBuilder<int>(
|
|
281
|
-
valueListenable: _counter,
|
|
282
|
-
builder: (context, value, child) => Text('Count: $value'),
|
|
283
|
-
);
|
|
284
|
-
|
|
285
|
-
// ✅ ChangeNotifier for complex shared state
|
|
286
|
-
class CartNotifier extends ChangeNotifier {
|
|
287
|
-
final List<Item> _items = [];
|
|
288
|
-
List<Item> get items => List.unmodifiable(_items);
|
|
289
|
-
|
|
290
|
-
void addItem(Item item) {
|
|
291
|
-
_items.add(item);
|
|
292
|
-
notifyListeners();
|
|
293
|
-
}
|
|
294
|
-
}
|
|
295
|
-
```
|
|
296
|
-
|
|
297
|
-
> ⚠️ **Restrictions:** NO Riverpod, Bloc, GetX unless explicitly requested
|
|
298
|
-
|
|
299
|
-
### Routing (GoRouter)
|
|
300
|
-
```dart
|
|
301
|
-
final GoRouter _router = GoRouter(
|
|
302
|
-
routes: <RouteBase>[
|
|
303
|
-
GoRoute(
|
|
304
|
-
path: '/',
|
|
305
|
-
builder: (context, state) => const HomeScreen(),
|
|
306
|
-
routes: <RouteBase>[
|
|
307
|
-
GoRoute(
|
|
308
|
-
path: 'details/:id',
|
|
309
|
-
builder: (context, state) {
|
|
310
|
-
final String id = state.pathParameters['id']!;
|
|
311
|
-
return DetailScreen(id: id);
|
|
312
|
-
},
|
|
313
|
-
),
|
|
314
|
-
],
|
|
315
|
-
),
|
|
316
|
-
],
|
|
317
|
-
);
|
|
318
|
-
MaterialApp.router(routerConfig: _router);
|
|
319
|
-
```
|
|
320
|
-
|
|
321
|
-
---
|
|
322
|
-
|
|
323
|
-
## 🎨 VISUAL DESIGN & THEMING (Material 3)
|
|
324
|
-
|
|
325
|
-
### Centralized Theme
|
|
326
|
-
```dart
|
|
327
|
-
final ThemeData lightTheme = ThemeData(
|
|
328
|
-
colorScheme: ColorScheme.fromSeed(
|
|
329
|
-
seedColor: Colors.deepPurple,
|
|
330
|
-
brightness: Brightness.light,
|
|
331
|
-
),
|
|
332
|
-
textTheme: GoogleFonts.outfitTextTheme(),
|
|
333
|
-
useMaterial3: true,
|
|
334
|
-
);
|
|
335
|
-
|
|
336
|
-
final ThemeData darkTheme = ThemeData(
|
|
337
|
-
colorScheme: ColorScheme.fromSeed(
|
|
338
|
-
seedColor: Colors.deepPurple,
|
|
339
|
-
brightness: Brightness.dark,
|
|
340
|
-
),
|
|
341
|
-
);
|
|
342
|
-
|
|
343
|
-
MaterialApp(
|
|
344
|
-
theme: lightTheme,
|
|
345
|
-
darkTheme: darkTheme,
|
|
346
|
-
themeMode: ThemeMode.system,
|
|
347
|
-
);
|
|
348
|
-
```
|
|
349
|
-
|
|
350
|
-
### Custom Design Tokens (ThemeExtension)
|
|
351
|
-
```dart
|
|
352
|
-
@immutable
|
|
353
|
-
class AppColors extends ThemeExtension<AppColors> {
|
|
354
|
-
const AppColors({required this.success, required this.danger});
|
|
355
|
-
final Color? success;
|
|
356
|
-
final Color? danger;
|
|
357
|
-
|
|
358
|
-
@override
|
|
359
|
-
ThemeExtension<AppColors> copyWith({Color? success, Color? danger}) {
|
|
360
|
-
return AppColors(
|
|
361
|
-
success: success ?? this.success,
|
|
362
|
-
danger: danger ?? this.danger,
|
|
363
|
-
);
|
|
364
|
-
}
|
|
365
|
-
|
|
366
|
-
@override
|
|
367
|
-
ThemeExtension<AppColors> lerp(ThemeExtension<AppColors>? other, double t) {
|
|
368
|
-
if (other is! AppColors) return this;
|
|
369
|
-
return AppColors(
|
|
370
|
-
success: Color.lerp(success, other.success, t),
|
|
371
|
-
danger: Color.lerp(danger, other.danger, t),
|
|
372
|
-
);
|
|
373
|
-
}
|
|
374
|
-
}
|
|
375
|
-
|
|
376
|
-
// Usage
|
|
377
|
-
Container(color: Theme.of(context).extension<AppColors>()!.success);
|
|
378
|
-
```
|
|
379
|
-
|
|
380
|
-
### Network Images (Always with Error Handling)
|
|
381
|
-
```dart
|
|
382
|
-
Image.network(
|
|
383
|
-
'https://example.com/image.png',
|
|
384
|
-
loadingBuilder: (ctx, child, prog) =>
|
|
385
|
-
prog == null ? child : const CircularProgressIndicator(),
|
|
386
|
-
errorBuilder: (ctx, err, stack) => const Icon(Icons.error),
|
|
387
|
-
);
|
|
388
|
-
```
|
|
389
|
-
|
|
390
|
-
---
|
|
391
|
-
|
|
392
|
-
## ♿ ACCESSIBILITY (A11Y)
|
|
393
|
-
|
|
394
|
-
| Requirement | Standard |
|
|
395
|
-
|-------------|----------|
|
|
396
|
-
| **Contrast** | Minimum 4.5:1 for text |
|
|
397
|
-
| **Large Text** | Minimum 3:1 (18pt or 14pt bold) |
|
|
398
|
-
| **Dynamic Scaling** | Test up to 200% font size |
|
|
399
|
-
| **Semantics** | Label all interactive elements |
|
|
400
|
-
| **Screen Readers** | Test with TalkBack/VoiceOver |
|
|
80
|
+
## Example Workflow
|
|
401
81
|
|
|
402
|
-
|
|
403
|
-
|
|
404
|
-
## 📝 DOCUMENTATION PHILOSOPHY
|
|
405
|
-
|
|
406
|
-
| Rule | Guideline |
|
|
407
|
-
|------|----------|
|
|
408
|
-
| **Comment wisely** | Explain "why", not "what" |
|
|
409
|
-
| **Use `///`** | For doc comments (dartdoc) |
|
|
410
|
-
| **Single sentence first** | Concise summary ending with period |
|
|
411
|
-
| **Public APIs priority** | Always document public APIs |
|
|
412
|
-
| **No redundancy** | Don't restate the obvious |
|
|
413
|
-
|
|
414
|
-
---
|
|
82
|
+
**User Request:** "Tạo màn hình đăng nhập"
|
|
415
83
|
|
|
416
|
-
|
|
84
|
+
1. **Search widgets:**
|
|
85
|
+
```bash
|
|
86
|
+
python3 {{SCRIPT_PATH}}/search.py "form input" --domain widget --top 5
|
|
87
|
+
```
|
|
417
88
|
|
|
418
|
-
|
|
419
|
-
|
|
420
|
-
|
|
421
|
-
|
|
422
|
-
- [ ] SOLID Compliance
|
|
89
|
+
2. **Search patterns:**
|
|
90
|
+
```bash
|
|
91
|
+
python3 {{SCRIPT_PATH}}/search.py "authentication login" --domain pattern --top 5
|
|
92
|
+
```
|
|
423
93
|
|
|
424
|
-
|
|
425
|
-
|
|
426
|
-
|
|
427
|
-
|
|
428
|
-
- [ ] Clear naming
|
|
429
|
-
- [ ] `dart_format` applied
|
|
430
|
-
- [ ] `dart_fix` run
|
|
431
|
-
- [ ] `analyze_files` passed
|
|
94
|
+
3. **Search packages:**
|
|
95
|
+
```bash
|
|
96
|
+
python3 {{SCRIPT_PATH}}/search.py "validation" --domain package --top 5
|
|
97
|
+
```
|
|
432
98
|
|
|
433
|
-
|
|
434
|
-
- [ ] Unit tests for domain logic
|
|
435
|
-
- [ ] Widget tests for UI components
|
|
436
|
-
- [ ] Integration tests for E2E flows
|
|
437
|
-
- [ ] Use `package:checks` for assertions
|
|
99
|
+
4. **Apply results** theo Agent Rules (consistency, error handling, testing...)
|
|
438
100
|
|
|
439
|
-
|
|
440
|
-
|
|
441
|
-
|
|
442
|
-
|
|
101
|
+
5. **Validate:**
|
|
102
|
+
```bash
|
|
103
|
+
dart format . && flutter analyze . && flutter test .
|
|
104
|
+
```
|
|
443
105
|
{{QUICK_REFERENCE}}
|
|
@@ -18,5 +18,9 @@
|
|
|
18
18
|
"template": "skill-content-10k.md",
|
|
19
19
|
"title": "flutter-pro-max",
|
|
20
20
|
"description": "Flutter development guide with widgets, packages, patterns, architecture, performance, and UI/UX best practices.",
|
|
21
|
-
"skillOrWorkflow": "Skill"
|
|
22
|
-
|
|
21
|
+
"skillOrWorkflow": "Skill",
|
|
22
|
+
"rulesFile": {
|
|
23
|
+
"path": ".agent/rules/flutter-pro-max.md",
|
|
24
|
+
"mode": "create"
|
|
25
|
+
}
|
|
26
|
+
}
|
|
@@ -18,5 +18,9 @@
|
|
|
18
18
|
"template": "skill-content.md",
|
|
19
19
|
"title": "Flutter Pro Max - Flutter Design Intelligence",
|
|
20
20
|
"description": "Comprehensive Flutter development guide with searchable database of widgets, packages, design patterns, architecture guidelines, performance optimization, accessibility, and UI/UX best practices.",
|
|
21
|
-
"skillOrWorkflow": "Skill"
|
|
21
|
+
"skillOrWorkflow": "Skill",
|
|
22
|
+
"rulesFile": {
|
|
23
|
+
"path": "CLAUDE.md",
|
|
24
|
+
"mode": "append"
|
|
25
|
+
}
|
|
22
26
|
}
|
|
@@ -18,5 +18,9 @@
|
|
|
18
18
|
"template": "skill-content.md",
|
|
19
19
|
"title": "flutter-pro-max",
|
|
20
20
|
"description": "Comprehensive Flutter development guide with searchable database of widgets, packages, design patterns, architecture guidelines, performance optimization, accessibility, and UI/UX best practices.",
|
|
21
|
-
"skillOrWorkflow": "Skill"
|
|
22
|
-
|
|
21
|
+
"skillOrWorkflow": "Skill",
|
|
22
|
+
"rulesFile": {
|
|
23
|
+
"path": ".codebuddy/rules/flutter-pro-max.md",
|
|
24
|
+
"mode": "create"
|
|
25
|
+
}
|
|
26
|
+
}
|
|
@@ -18,5 +18,9 @@
|
|
|
18
18
|
"template": "skill-content.md",
|
|
19
19
|
"title": "flutter-pro-max",
|
|
20
20
|
"description": "Comprehensive Flutter development guide with searchable database of widgets, packages, design patterns, architecture guidelines, performance optimization, accessibility, and UI/UX best practices.",
|
|
21
|
-
"skillOrWorkflow": "Skill"
|
|
22
|
-
|
|
21
|
+
"skillOrWorkflow": "Skill",
|
|
22
|
+
"rulesFile": {
|
|
23
|
+
"path": ".codex/rules/flutter-pro-max.md",
|
|
24
|
+
"mode": "create"
|
|
25
|
+
}
|
|
26
|
+
}
|
|
@@ -18,5 +18,9 @@
|
|
|
18
18
|
"template": "skill-content.md",
|
|
19
19
|
"title": "flutter-pro-max",
|
|
20
20
|
"description": "Comprehensive Flutter development guide with searchable database of widgets, packages, design patterns, architecture guidelines, performance optimization, accessibility, and UI/UX best practices.",
|
|
21
|
-
"skillOrWorkflow": "Skill"
|
|
22
|
-
|
|
21
|
+
"skillOrWorkflow": "Skill",
|
|
22
|
+
"rulesFile": {
|
|
23
|
+
"path": ".continue/rules/flutter-pro-max.md",
|
|
24
|
+
"mode": "create"
|
|
25
|
+
}
|
|
26
|
+
}
|
|
@@ -18,5 +18,9 @@
|
|
|
18
18
|
"template": "skill-content.md",
|
|
19
19
|
"title": "Flutter Pro Max - Flutter Design Intelligence",
|
|
20
20
|
"description": "Comprehensive Flutter development guide with searchable database of widgets, packages, design patterns, architecture guidelines, performance optimization, accessibility, and UI/UX best practices.",
|
|
21
|
-
"skillOrWorkflow": "Skill"
|
|
22
|
-
|
|
21
|
+
"skillOrWorkflow": "Skill",
|
|
22
|
+
"rulesFile": {
|
|
23
|
+
"path": ".github/copilot-instructions.md",
|
|
24
|
+
"mode": "append"
|
|
25
|
+
}
|
|
26
|
+
}
|
|
@@ -15,5 +15,9 @@
|
|
|
15
15
|
"template": "skill-content.md",
|
|
16
16
|
"title": "flutter-pro-max",
|
|
17
17
|
"description": "Comprehensive Flutter development guide with searchable database of widgets, packages, design patterns, architecture guidelines, performance optimization, accessibility, and UI/UX best practices.",
|
|
18
|
-
"skillOrWorkflow": "Workflow"
|
|
19
|
-
|
|
18
|
+
"skillOrWorkflow": "Workflow",
|
|
19
|
+
"rulesFile": {
|
|
20
|
+
"path": ".cursor/rules/flutter-pro-max.mdc",
|
|
21
|
+
"mode": "create"
|
|
22
|
+
}
|
|
23
|
+
}
|
|
@@ -18,5 +18,9 @@
|
|
|
18
18
|
"template": "skill-content.md",
|
|
19
19
|
"title": "Flutter Pro Max - Flutter Design Intelligence",
|
|
20
20
|
"description": "Comprehensive Flutter development guide with searchable database of widgets, packages, design patterns, architecture guidelines, performance optimization, accessibility, and UI/UX best practices.",
|
|
21
|
-
"skillOrWorkflow": "Skill"
|
|
22
|
-
|
|
21
|
+
"skillOrWorkflow": "Skill",
|
|
22
|
+
"rulesFile": {
|
|
23
|
+
"path": ".gemini/rules/flutter-pro-max.md",
|
|
24
|
+
"mode": "create"
|
|
25
|
+
}
|
|
26
|
+
}
|
|
@@ -15,5 +15,9 @@
|
|
|
15
15
|
"template": "skill-content.md",
|
|
16
16
|
"title": "Flutter Pro Max - Flutter Design Intelligence",
|
|
17
17
|
"description": "Comprehensive Flutter development guide with searchable database of widgets, packages, design patterns, architecture guidelines, performance optimization, accessibility, and UI/UX best practices.",
|
|
18
|
-
"skillOrWorkflow": "Skill"
|
|
19
|
-
|
|
18
|
+
"skillOrWorkflow": "Skill",
|
|
19
|
+
"rulesFile": {
|
|
20
|
+
"path": ".junie/rules/flutter-pro-max.md",
|
|
21
|
+
"mode": "create"
|
|
22
|
+
}
|
|
23
|
+
}
|
|
@@ -15,5 +15,9 @@
|
|
|
15
15
|
"template": "skill-content.md",
|
|
16
16
|
"title": "flutter-pro-max",
|
|
17
17
|
"description": "Comprehensive Flutter development guide with searchable database of widgets, packages, design patterns, architecture guidelines, performance optimization, accessibility, and UI/UX best practices.",
|
|
18
|
-
"skillOrWorkflow": "Workflow"
|
|
19
|
-
|
|
18
|
+
"skillOrWorkflow": "Workflow",
|
|
19
|
+
"rulesFile": {
|
|
20
|
+
"path": ".kiro/rules/flutter-pro-max.md",
|
|
21
|
+
"mode": "create"
|
|
22
|
+
}
|
|
23
|
+
}
|
|
@@ -18,5 +18,9 @@
|
|
|
18
18
|
"template": "skill-content.md",
|
|
19
19
|
"title": "flutter-pro-max",
|
|
20
20
|
"description": "Comprehensive Flutter development guide with searchable database of widgets, packages, design patterns, architecture guidelines, performance optimization, accessibility, and UI/UX best practices.",
|
|
21
|
-
"skillOrWorkflow": "Skill"
|
|
22
|
-
|
|
21
|
+
"skillOrWorkflow": "Skill",
|
|
22
|
+
"rulesFile": {
|
|
23
|
+
"path": ".opencode/rules/flutter-pro-max.md",
|
|
24
|
+
"mode": "create"
|
|
25
|
+
}
|
|
26
|
+
}
|
|
@@ -18,5 +18,9 @@
|
|
|
18
18
|
"template": "skill-content.md",
|
|
19
19
|
"title": "flutter-pro-max",
|
|
20
20
|
"description": "Comprehensive Flutter development guide with searchable database of widgets, packages, design patterns, architecture guidelines, performance optimization, accessibility, and UI/UX best practices.",
|
|
21
|
-
"skillOrWorkflow": "Skill"
|
|
22
|
-
|
|
21
|
+
"skillOrWorkflow": "Skill",
|
|
22
|
+
"rulesFile": {
|
|
23
|
+
"path": ".qoder/rules/flutter-pro-max.md",
|
|
24
|
+
"mode": "create"
|
|
25
|
+
}
|
|
26
|
+
}
|
|
@@ -15,5 +15,9 @@
|
|
|
15
15
|
"template": "skill-content.md",
|
|
16
16
|
"title": "flutter-pro-max",
|
|
17
17
|
"description": "Comprehensive Flutter development guide with searchable database of widgets, packages, design patterns, architecture guidelines, performance optimization, accessibility, and UI/UX best practices.",
|
|
18
|
-
"skillOrWorkflow": "Workflow"
|
|
19
|
-
|
|
18
|
+
"skillOrWorkflow": "Workflow",
|
|
19
|
+
"rulesFile": {
|
|
20
|
+
"path": ".roo/rules/flutter-pro-max.md",
|
|
21
|
+
"mode": "create"
|
|
22
|
+
}
|
|
23
|
+
}
|
|
@@ -18,5 +18,9 @@
|
|
|
18
18
|
"template": "skill-content.md",
|
|
19
19
|
"title": "flutter-pro-max",
|
|
20
20
|
"description": "Comprehensive Flutter development guide with searchable database of widgets, packages, design patterns, architecture guidelines, performance optimization, accessibility, and UI/UX best practices.",
|
|
21
|
-
"skillOrWorkflow": "Skill"
|
|
22
|
-
|
|
21
|
+
"skillOrWorkflow": "Skill",
|
|
22
|
+
"rulesFile": {
|
|
23
|
+
"path": ".trae/rules/flutter-pro-max.md",
|
|
24
|
+
"mode": "create"
|
|
25
|
+
}
|
|
26
|
+
}
|
|
@@ -18,5 +18,9 @@
|
|
|
18
18
|
"template": "skill-content.md",
|
|
19
19
|
"title": "Flutter Pro Max - Flutter Design Intelligence",
|
|
20
20
|
"description": "Comprehensive Flutter development guide with searchable database of widgets, packages, design patterns, architecture guidelines, performance optimization, accessibility, and UI/UX best practices.",
|
|
21
|
-
"skillOrWorkflow": "Skill"
|
|
22
|
-
|
|
21
|
+
"skillOrWorkflow": "Skill",
|
|
22
|
+
"rulesFile": {
|
|
23
|
+
"path": ".vscode/rules/flutter-pro-max.md",
|
|
24
|
+
"mode": "create"
|
|
25
|
+
}
|
|
26
|
+
}
|
|
@@ -15,5 +15,9 @@
|
|
|
15
15
|
"template": "skill-content.md",
|
|
16
16
|
"title": "flutter-pro-max",
|
|
17
17
|
"description": "Comprehensive Flutter development guide with searchable database of widgets, packages, design patterns, architecture guidelines, performance optimization, accessibility, and UI/UX best practices.",
|
|
18
|
-
"skillOrWorkflow": "Skill"
|
|
19
|
-
|
|
18
|
+
"skillOrWorkflow": "Skill",
|
|
19
|
+
"rulesFile": {
|
|
20
|
+
"path": ".windsurf/rules/flutter-pro-max.md",
|
|
21
|
+
"mode": "create"
|
|
22
|
+
}
|
|
23
|
+
}
|
package/dist/types/index.d.ts
CHANGED
|
@@ -35,6 +35,10 @@ export interface PlatformConfig {
|
|
|
35
35
|
title: string;
|
|
36
36
|
description: string;
|
|
37
37
|
skillOrWorkflow: string;
|
|
38
|
+
rulesFile?: {
|
|
39
|
+
path: string;
|
|
40
|
+
mode: 'create' | 'append';
|
|
41
|
+
};
|
|
38
42
|
}
|
|
39
43
|
export declare const AI_TYPES: AIType[];
|
|
40
44
|
export declare const AI_FOLDERS: Record<Exclude<AIType, 'all'>, string[]>;
|