@musashishao/agent-kit 1.6.2 → 1.8.0
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/rules/CODEX.md +8 -7
- package/.agent/rules/CODE_RULES.md +15 -0
- package/.agent/rules/REFERENCE.md +7 -2
- package/.agent/skills/brainstorming/SKILL.md +52 -0
- package/.agent/skills/frontend-design/SKILL.md +30 -0
- package/.agent/skills/git-worktrees/SKILL.md +181 -0
- package/.agent/skills/parallel-agents/SKILL.md +89 -0
- package/.agent/skills/react-patterns/SKILL.md +31 -0
- package/.agent/skills/react-patterns/bundle-patterns.md +129 -0
- package/.agent/skills/react-patterns/rerender-patterns.md +163 -0
- package/.agent/skills/react-patterns/server-patterns.md +146 -0
- package/.agent/skills/react-patterns/waterfall-patterns.md +102 -0
- package/.agent/skills/reader-testing/SKILL.md +183 -0
- package/.agent/skills/verification-gate/SKILL.md +129 -0
- package/.agent/skills/web-interface-guidelines/SKILL.md +94 -0
- package/.agent/skills/web-interface-guidelines/animation.md +153 -0
- package/.agent/skills/web-interface-guidelines/anti-patterns.md +204 -0
- package/.agent/skills/web-interface-guidelines/focus-states.md +104 -0
- package/.agent/skills/web-interface-guidelines/forms.md +154 -0
- package/.agent/skills/web-interface-guidelines/touch-interaction.md +150 -0
- package/.agent/workflows/autofix.md +4 -1
- package/.agent/workflows/brainstorm.md +1 -1
- package/.agent/workflows/context.md +3 -1
- package/.agent/workflows/create.md +1 -1
- package/.agent/workflows/dashboard.md +4 -1
- package/.agent/workflows/debug.md +1 -1
- package/.agent/workflows/deploy.md +1 -1
- package/.agent/workflows/enhance.md +1 -1
- package/.agent/workflows/next.md +4 -1
- package/.agent/workflows/orchestrate.md +1 -1
- package/.agent/workflows/plan.md +1 -1
- package/.agent/workflows/preview.md +1 -1
- package/.agent/workflows/quality.md +1 -1
- package/.agent/workflows/spec.md +1 -1
- package/.agent/workflows/status.md +1 -1
- package/.agent/workflows/test.md +1 -1
- package/.agent/workflows/ui-ux-pro-max.md +1 -1
- package/README.md +3 -3
- package/package.json +1 -1
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
# Touch & Interaction Guidelines
|
|
2
|
+
|
|
3
|
+
> Mobile-first patterns for touch interfaces.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Touch Action
|
|
8
|
+
|
|
9
|
+
**Prevent double-tap zoom delay.**
|
|
10
|
+
|
|
11
|
+
```css
|
|
12
|
+
/* ✅ On interactive elements */
|
|
13
|
+
button, a, [role="button"] {
|
|
14
|
+
touch-action: manipulation;
|
|
15
|
+
}
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
| Value | Effect |
|
|
19
|
+
|-------|--------|
|
|
20
|
+
| `manipulation` | Disables double-tap zoom |
|
|
21
|
+
| `pan-x` | Only horizontal scroll |
|
|
22
|
+
| `pan-y` | Only vertical scroll |
|
|
23
|
+
| `none` | Disable all gestures |
|
|
24
|
+
|
|
25
|
+
---
|
|
26
|
+
|
|
27
|
+
## Tap Highlight
|
|
28
|
+
|
|
29
|
+
**Set intentionally, not accidentally.**
|
|
30
|
+
|
|
31
|
+
```css
|
|
32
|
+
/* ✅ Remove or customize */
|
|
33
|
+
button {
|
|
34
|
+
-webkit-tap-highlight-color: transparent;
|
|
35
|
+
/* Or: -webkit-tap-highlight-color: rgba(0, 0, 0, 0.1); */
|
|
36
|
+
}
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
---
|
|
40
|
+
|
|
41
|
+
## Overscroll Behavior
|
|
42
|
+
|
|
43
|
+
**Contain scroll in modals and drawers.**
|
|
44
|
+
|
|
45
|
+
```css
|
|
46
|
+
/* ✅ Modal content */
|
|
47
|
+
.modal-content {
|
|
48
|
+
overscroll-behavior: contain;
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
/* ✅ Drawer/sheet */
|
|
52
|
+
.drawer {
|
|
53
|
+
overscroll-behavior-y: contain;
|
|
54
|
+
}
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
This prevents:
|
|
58
|
+
- Pull-to-refresh triggering inside modal
|
|
59
|
+
- Scroll chaining to body
|
|
60
|
+
- Rubber-band bounce on iOS
|
|
61
|
+
|
|
62
|
+
---
|
|
63
|
+
|
|
64
|
+
## Safe Areas
|
|
65
|
+
|
|
66
|
+
**Full-bleed layouts need notch handling.**
|
|
67
|
+
|
|
68
|
+
```css
|
|
69
|
+
/* ✅ Account for notch/home indicator */
|
|
70
|
+
.full-bleed {
|
|
71
|
+
padding-left: env(safe-area-inset-left);
|
|
72
|
+
padding-right: env(safe-area-inset-right);
|
|
73
|
+
padding-bottom: env(safe-area-inset-bottom);
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
/* ✅ Fixed bottom bar */
|
|
77
|
+
.bottom-bar {
|
|
78
|
+
padding-bottom: max(1rem, env(safe-area-inset-bottom));
|
|
79
|
+
}
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
| Device | Safe Area Needed |
|
|
83
|
+
|--------|------------------|
|
|
84
|
+
| iPhone X+ | Notch, home indicator |
|
|
85
|
+
| Android | Navigation bar |
|
|
86
|
+
| iPad | Corners on newer models |
|
|
87
|
+
|
|
88
|
+
---
|
|
89
|
+
|
|
90
|
+
## Drag Interactions
|
|
91
|
+
|
|
92
|
+
**Disable selection during drag.**
|
|
93
|
+
|
|
94
|
+
```tsx
|
|
95
|
+
// ✅ During drag operations
|
|
96
|
+
const handleDragStart = () => {
|
|
97
|
+
document.body.style.userSelect = 'none';
|
|
98
|
+
};
|
|
99
|
+
|
|
100
|
+
const handleDragEnd = () => {
|
|
101
|
+
document.body.style.userSelect = '';
|
|
102
|
+
};
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
Also use `inert` on dragged elements:
|
|
106
|
+
```tsx
|
|
107
|
+
<div inert={isDragging}>
|
|
108
|
+
{/* Content that shouldn't be interactive while dragging */}
|
|
109
|
+
</div>
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
---
|
|
113
|
+
|
|
114
|
+
## AutoFocus
|
|
115
|
+
|
|
116
|
+
**Use sparingly, desktop only.**
|
|
117
|
+
|
|
118
|
+
```tsx
|
|
119
|
+
// ✅ Single primary input, desktop
|
|
120
|
+
<input autoFocus={!isMobile} />
|
|
121
|
+
|
|
122
|
+
// ❌ Avoid on mobile (keyboard popup)
|
|
123
|
+
<input autoFocus /> // Opens keyboard unexpectedly
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
| Use autoFocus | Avoid autoFocus |
|
|
127
|
+
|---------------|-----------------|
|
|
128
|
+
| Search modal | Mobile forms |
|
|
129
|
+
| Command palette | Multi-step forms |
|
|
130
|
+
| Login (desktop) | Login (mobile) |
|
|
131
|
+
|
|
132
|
+
---
|
|
133
|
+
|
|
134
|
+
## Touch Target Size
|
|
135
|
+
|
|
136
|
+
**Minimum 44x44px for touch targets.**
|
|
137
|
+
|
|
138
|
+
```css
|
|
139
|
+
/* ✅ Comfortable touch target */
|
|
140
|
+
button {
|
|
141
|
+
min-height: 44px;
|
|
142
|
+
min-width: 44px;
|
|
143
|
+
padding: 12px 16px;
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
/* ✅ Icon button with adequate padding */
|
|
147
|
+
.icon-button {
|
|
148
|
+
padding: 12px;
|
|
149
|
+
}
|
|
150
|
+
```
|
|
@@ -1,9 +1,12 @@
|
|
|
1
1
|
---
|
|
2
|
-
description:
|
|
2
|
+
description: Vòng lặp tự sửa lỗi autonomous cho các lệnh thất bại
|
|
3
3
|
---
|
|
4
4
|
|
|
5
5
|
# /autofix - Autonomous Self-Healing Loop
|
|
6
6
|
|
|
7
|
+
$ARGUMENTS
|
|
8
|
+
|
|
9
|
+
|
|
7
10
|
## Purpose
|
|
8
11
|
Attempts to automatically fix a failing command (test, build, or script) by entering a "Run -> Analyze -> Fix -> Verify" loop. This workflow leverages the Agent's ability to read error logs and edit code autonomously.
|
|
9
12
|
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
description:
|
|
2
|
+
description: Brainstorming có cấu trúc cho dự án và tính năng. Khám phá nhiều phương án trước khi triển khai.
|
|
3
3
|
---
|
|
4
4
|
|
|
5
5
|
# /brainstorm - Structured Idea Exploration
|
|
@@ -1,9 +1,11 @@
|
|
|
1
1
|
---
|
|
2
|
-
description:
|
|
2
|
+
description: Tự động tạo context tối ưu cho các tác vụ phức tạp sử dụng chiến lược Context Engineering.
|
|
3
3
|
---
|
|
4
4
|
|
|
5
5
|
# Context Optimization Workflow
|
|
6
6
|
|
|
7
|
+
$ARGUMENTS
|
|
8
|
+
|
|
7
9
|
This workflow automates the "Context Engineering" process. It analyzes your request, maps the project structure, summarizes relevant files, and wraps everything in a high-performance XML prompt structure for the AI.
|
|
8
10
|
|
|
9
11
|
**Trigger:** `/context [your task description]`
|
|
@@ -1,9 +1,12 @@
|
|
|
1
1
|
---
|
|
2
|
-
description:
|
|
2
|
+
description: Tạo và xem dashboard trực quan của dự án
|
|
3
3
|
---
|
|
4
4
|
|
|
5
5
|
# /dashboard - Visual Project Overview
|
|
6
6
|
|
|
7
|
+
$ARGUMENTS
|
|
8
|
+
|
|
9
|
+
|
|
7
10
|
## Purpose
|
|
8
11
|
Generates a rich, interactive HTML dashboard that visualizes the project's status, agents, active plans, and dependency graphs. Provides a high-level view for "Vibe Coders" and stakeholders.
|
|
9
12
|
|
package/.agent/workflows/next.md
CHANGED
|
@@ -1,9 +1,12 @@
|
|
|
1
1
|
---
|
|
2
|
-
description:
|
|
2
|
+
description: Đề xuất bước tiếp theo cho developer
|
|
3
3
|
---
|
|
4
4
|
|
|
5
5
|
# /next - What Should I Do Next?
|
|
6
6
|
|
|
7
|
+
$ARGUMENTS
|
|
8
|
+
|
|
9
|
+
|
|
7
10
|
## Purpose
|
|
8
11
|
This command analyzes the current project state, active plans, and recent context to determine the most impactful immediate next step. Use this when you are stuck, returning to a project after a break, or unsure of the priority.
|
|
9
12
|
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
description:
|
|
2
|
+
description: Điều phối nhiều agents cho các tác vụ phức tạp. Dùng cho phân tích đa góc nhìn, review toàn diện, hoặc các tác vụ cần nhiều chuyên môn khác nhau.
|
|
3
3
|
---
|
|
4
4
|
|
|
5
5
|
# Multi-Agent Orchestration
|
package/.agent/workflows/plan.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
description:
|
|
2
|
+
description: Tối ưu hóa context và chất lượng output cho Codex CLI. Dùng cho các tác vụ phức tạp cần kết quả chất lượng cao.
|
|
3
3
|
---
|
|
4
4
|
|
|
5
5
|
# /quality - Quality Optimization Workflow
|
package/.agent/workflows/spec.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
description:
|
|
2
|
+
description: Tạo tài liệu đặc tả (specification) trước khi lập kế hoạch. Dùng cho các tính năng phức tạp cần yêu cầu rõ ràng trước khi triển khai.
|
|
3
3
|
---
|
|
4
4
|
|
|
5
5
|
# /spec - Specification Writing Mode
|
package/.agent/workflows/test.md
CHANGED
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
> 🚀 The Ultimate AI Agent System for Modern Development
|
|
4
4
|
>
|
|
5
|
-
> **16 Agents** • **
|
|
5
|
+
> **16 Agents** • **58 Skills** • **13 Workflows** • **Multi-Platform Support**
|
|
6
6
|
|
|
7
7
|
[](https://www.npmjs.com/package/@musashishao/agent-kit)
|
|
8
8
|
[](https://opensource.org/licenses/MIT)
|
|
@@ -27,8 +27,8 @@ This installs the `.agent` folder containing all templates into your project.
|
|
|
27
27
|
| Component | Count | Description |
|
|
28
28
|
|-----------|-------|-------------|
|
|
29
29
|
| **Agents** | 16 | Specialist AI personas (frontend, backend, security, etc.) |
|
|
30
|
-
| **Skills** |
|
|
31
|
-
| **Intelligence** |
|
|
30
|
+
| **Skills** | 58 | Domain-specific knowledge modules |
|
|
31
|
+
| **Intelligence** | 4 | RAG, Knowledge Graph, Memory, and **Verification Gate** |
|
|
32
32
|
| **Workflows** | 13 | Slash command procedures |
|
|
33
33
|
| **Templates** | 4 | Project templates (web, mobile, backend) |
|
|
34
34
|
|