needware-cli 1.7.15 → 1.7.16
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/package.json +1 -1
- package/skills/plan-mode/SKILL.md +95 -94
package/package.json
CHANGED
|
@@ -1,73 +1,74 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: plan
|
|
3
|
-
description: plan mode
|
|
3
|
+
description: Currently in plan mode, plan mode uses this guidance - plan mode provides as much product output as possible, only provides technical solutions when asking about specific technology, technical solutions are decided during implementation. Only plan mode uses this skill
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# Plan
|
|
6
|
+
# Plan Mode - Intelligent Task Planning and Execution
|
|
7
7
|
|
|
8
|
-
##
|
|
8
|
+
## Overview
|
|
9
9
|
|
|
10
|
-
Plan
|
|
10
|
+
Plan Mode is a **product-output-oriented** intelligent task planning system that breaks down complex tasks into clear product feature steps.
|
|
11
11
|
|
|
12
|
-
|
|
13
|
-
- 📦
|
|
14
|
-
- 🎯
|
|
15
|
-
- 🔧
|
|
16
|
-
- 📊
|
|
12
|
+
**Core Principles:**
|
|
13
|
+
- 📦 **Product Output First**: Planning focuses on describing product features, user value, and business goals
|
|
14
|
+
- 🎯 **On-Demand Technical Solutions**: Only provide technical solution details when users explicitly ask about specific technical implementations
|
|
15
|
+
- 🔧 **Implementation Decides Solutions**: Technology selection and implementation solutions are decided during the actual execution phase based on project environment
|
|
16
|
+
- 📊 **Value-Visible Delivery**: Every step is oriented towards visible product feature output
|
|
17
17
|
|
|
18
|
-
|
|
19
|
-
- 🎯
|
|
20
|
-
- 📋
|
|
21
|
-
- 🚀
|
|
22
|
-
- 🔧
|
|
23
|
-
- 📊
|
|
18
|
+
**Working Method:**
|
|
19
|
+
- 🎯 **Intelligent Decomposition**: Break down product requirements into user-understandable functional modules
|
|
20
|
+
- 📋 **Product Planning**: Display product feature plan before execution (what to do, why, what's the value)
|
|
21
|
+
- 🚀 **Visible Progress**: Display real-time completion status of each feature
|
|
22
|
+
- 🔧 **Flexible Implementation**: Choose the best technical solution based on actual situation during implementation
|
|
23
|
+
- 📊 **Product Report**: Generate product delivery report after execution (not technical implementation report)
|
|
24
24
|
|
|
25
|
-
|
|
26
|
-
- ✅
|
|
27
|
-
- ❌
|
|
28
|
-
- ✅
|
|
25
|
+
**Important Distinctions:**
|
|
26
|
+
- ✅ **Default Output**: Product feature descriptions ("Implement user login functionality", "Add product list display")
|
|
27
|
+
- ❌ **Avoid by Default**: Technical implementation details ("Use Supabase Auth", "Create ProductList component")
|
|
28
|
+
- ✅ **Special Cases**: Only explain technical solutions in detail when users explicitly ask "how to implement" or "what technology to use"
|
|
29
|
+
- ❌ **Avoid Output**: File structures and directory trees, unless user explicitly requests to view project structure
|
|
29
30
|
|
|
30
|
-
|
|
31
|
+
**Announce at Start:** "I will use Plan Mode to plan this task, focusing on product features and value delivery."
|
|
31
32
|
|
|
32
|
-
##
|
|
33
|
+
## Usage Conditions
|
|
33
34
|
|
|
34
|
-
|
|
35
|
+
**Trigger Condition: Only Use in Plan Mode**
|
|
35
36
|
|
|
36
37
|
```
|
|
37
|
-
✅
|
|
38
|
-
→
|
|
38
|
+
✅ When running in Plan Mode
|
|
39
|
+
→ Must use this Skill as execution guidance
|
|
39
40
|
|
|
40
|
-
❌
|
|
41
|
-
→
|
|
41
|
+
❌ Other cases
|
|
42
|
+
→ No need to use this Skill
|
|
42
43
|
```
|
|
43
44
|
|
|
44
|
-
##
|
|
45
|
+
## Project Initialization Structure Description
|
|
45
46
|
|
|
46
|
-
|
|
47
|
+
**Project is a standard React + Vite + TypeScript + shadcn/ui structure, components under components/ui do not need to be inspected, use directly.**
|
|
47
48
|
|
|
48
|
-
###
|
|
49
|
+
### Project Structure
|
|
49
50
|
|
|
50
51
|
```
|
|
51
52
|
app/
|
|
52
|
-
├── components.json # shadcn/ui
|
|
53
|
-
├── eslint.config.js # ESLint
|
|
54
|
-
├── index.html # HTML
|
|
55
|
-
├── package.json #
|
|
56
|
-
├── pnpm-lock.yaml # pnpm
|
|
57
|
-
├── postcss.config.js # PostCSS
|
|
58
|
-
├── tailwind.config.ts # Tailwind CSS
|
|
59
|
-
├── tsconfig.app.json # TypeScript
|
|
60
|
-
├── tsconfig.json # TypeScript
|
|
61
|
-
├── tsconfig.node.json # TypeScript Node
|
|
62
|
-
├── vite.config.ts # Vite
|
|
53
|
+
├── components.json # shadcn/ui configuration ✨
|
|
54
|
+
├── eslint.config.js # ESLint configuration
|
|
55
|
+
├── index.html # HTML entry
|
|
56
|
+
├── package.json # Dependency management
|
|
57
|
+
├── pnpm-lock.yaml # pnpm lock file (use pnpm)
|
|
58
|
+
├── postcss.config.js # PostCSS configuration
|
|
59
|
+
├── tailwind.config.ts # Tailwind CSS configuration ✨
|
|
60
|
+
├── tsconfig.app.json # TypeScript app configuration
|
|
61
|
+
├── tsconfig.json # TypeScript base configuration
|
|
62
|
+
├── tsconfig.node.json # TypeScript Node configuration
|
|
63
|
+
├── vite.config.ts # Vite configuration
|
|
63
64
|
└── src/
|
|
64
|
-
├── App.css #
|
|
65
|
-
├── App.tsx #
|
|
66
|
-
├── index.css #
|
|
67
|
-
├── main.tsx # React
|
|
68
|
-
├── vite-env.d.ts # Vite
|
|
65
|
+
├── App.css # App styles
|
|
66
|
+
├── App.tsx # Root component
|
|
67
|
+
├── index.css # Global styles
|
|
68
|
+
├── main.tsx # React entry
|
|
69
|
+
├── vite-env.d.ts # Vite type definitions
|
|
69
70
|
├── components/
|
|
70
|
-
│ └── ui/ # shadcn/ui
|
|
71
|
+
│ └── ui/ # shadcn/ui component library ✨ (50+ components)
|
|
71
72
|
│ ├── accordion.tsx
|
|
72
73
|
│ ├── alert-dialog.tsx
|
|
73
74
|
│ ├── alert.tsx
|
|
@@ -106,7 +107,7 @@ app/
|
|
|
106
107
|
│ ├── sidebar.tsx
|
|
107
108
|
│ ├── skeleton.tsx
|
|
108
109
|
│ ├── slider.tsx
|
|
109
|
-
│ ├── sonner.tsx # Toast
|
|
110
|
+
│ ├── sonner.tsx # Toast notifications
|
|
110
111
|
│ ├── switch.tsx
|
|
111
112
|
│ ├── table.tsx
|
|
112
113
|
│ ├── tabs.tsx
|
|
@@ -117,89 +118,89 @@ app/
|
|
|
117
118
|
│ ├── toggle.tsx
|
|
118
119
|
│ ├── tooltip.tsx
|
|
119
120
|
│ └── use-toast.ts
|
|
120
|
-
├── hooks/ #
|
|
121
|
+
├── hooks/ # Custom Hooks
|
|
121
122
|
│ ├── use-mobile.tsx
|
|
122
123
|
│ └── use-toast.ts
|
|
123
|
-
├── lib/ #
|
|
124
|
-
│ └── utils.ts #
|
|
125
|
-
└── pages/ #
|
|
126
|
-
├── Index.tsx #
|
|
127
|
-
└── NotFound.tsx # 404
|
|
124
|
+
├── lib/ # Utility library
|
|
125
|
+
│ └── utils.ts # Utility functions (includes cn() function)
|
|
126
|
+
└── pages/ # Pages directory
|
|
127
|
+
├── Index.tsx # Home page
|
|
128
|
+
└── NotFound.tsx # 404 page
|
|
128
129
|
```
|
|
129
130
|
|
|
130
|
-
|
|
131
|
-
- ✅ React 18 + TypeScript + Vite
|
|
132
|
-
- ✅ Tailwind CSS
|
|
133
|
-
- ✅ shadcn/ui
|
|
134
|
-
- ✅ pnpm
|
|
135
|
-
- ✅
|
|
136
|
-
- ⚠️
|
|
131
|
+
**Project Configuration Notes:**
|
|
132
|
+
- ✅ React 18 + TypeScript + Vite fully configured
|
|
133
|
+
- ✅ Tailwind CSS style framework ready to use
|
|
134
|
+
- ✅ shadcn/ui component library fully installed (50+ components)
|
|
135
|
+
- ✅ pnpm is the package manager (must use `pnpm add`)
|
|
136
|
+
- ✅ Basic page structure in `src/pages/` directory
|
|
137
|
+
- ⚠️ Backend services not integrated (if database, AI, or email features needed, use corresponding skills)
|
|
137
138
|
|
|
138
|
-
**⚠️
|
|
139
|
+
**⚠️ Important: shadcn/ui components under `components/ui/` do not need source code reading, import and use directly!**
|
|
139
140
|
|
|
140
141
|
```typescript
|
|
141
|
-
//
|
|
142
|
+
// Use directly, no need to read source code
|
|
142
143
|
import { Button } from '@/components/ui/button';
|
|
143
144
|
import { Card } from '@/components/ui/card';
|
|
144
145
|
import { Dialog } from '@/components/ui/dialog';
|
|
145
|
-
// ...
|
|
146
|
+
// ... Other 50+ components
|
|
146
147
|
```
|
|
147
148
|
|
|
148
149
|
|
|
149
|
-
###
|
|
150
|
+
### Backend Integration Check
|
|
150
151
|
|
|
151
|
-
#### Supabase
|
|
152
|
+
#### Supabase Integration
|
|
152
153
|
|
|
153
|
-
|
|
154
|
+
**If Supabase integration is needed, use the `supabase-integration` skill:**
|
|
154
155
|
|
|
155
156
|
```
|
|
156
|
-
|
|
157
|
-
1.
|
|
158
|
-
2. Skill
|
|
159
|
-
3.
|
|
160
|
-
- src/lib/supabase.ts
|
|
161
|
-
- .env
|
|
162
|
-
- supabase/
|
|
157
|
+
If the project needs database, authentication, or storage features:
|
|
158
|
+
1. Use supabase-integration skill for integration
|
|
159
|
+
2. Skill will automatically create necessary configurations and files
|
|
160
|
+
3. After integration completion, it will include:
|
|
161
|
+
- src/lib/supabase.ts client configuration
|
|
162
|
+
- .env environment variable configuration
|
|
163
|
+
- supabase/ directory (migrations, functions)
|
|
163
164
|
```
|
|
164
165
|
|
|
165
|
-
#### AI
|
|
166
|
+
#### AI Feature Integration
|
|
166
167
|
|
|
167
|
-
|
|
168
|
+
**If AI features are needed (image recognition, intelligent analysis, etc.), use the `ai-integration` skill:**
|
|
168
169
|
|
|
169
170
|
```
|
|
170
|
-
|
|
171
|
-
1.
|
|
172
|
-
2. Skill
|
|
171
|
+
If the project needs AI capabilities:
|
|
172
|
+
1. Use ai-integration skill for integration
|
|
173
|
+
2. Skill will create AI service functions and frontend calling code
|
|
173
174
|
```
|
|
174
175
|
|
|
175
|
-
####
|
|
176
|
+
#### Email Sending Feature
|
|
176
177
|
|
|
177
|
-
|
|
178
|
+
**If email sending feature is needed, use the `resend-integration` skill:**
|
|
178
179
|
|
|
179
180
|
```
|
|
180
|
-
|
|
181
|
-
1.
|
|
182
|
-
2. Skill
|
|
183
|
-
3.
|
|
181
|
+
If the project needs to send emails (welcome emails, notification emails, etc.):
|
|
182
|
+
1. Use resend-integration skill for integration
|
|
183
|
+
2. Skill will create email sending Edge Function
|
|
184
|
+
3. Configure Resend API Key environment variable
|
|
184
185
|
```
|
|
185
186
|
|
|
186
|
-
###
|
|
187
|
+
### Package Manager
|
|
187
188
|
|
|
188
|
-
|
|
189
|
-
- ✅
|
|
190
|
-
- ✅
|
|
191
|
-
- ❌
|
|
189
|
+
**Project uses pnpm:**
|
|
190
|
+
- ✅ Install dependencies: `pnpm add [package]`
|
|
191
|
+
- ✅ Install dev dependencies: `pnpm add -D [package]`
|
|
192
|
+
- ❌ Do not use npm or yarn
|
|
192
193
|
|
|
193
|
-
###
|
|
194
|
+
### Routing Solution
|
|
194
195
|
|
|
195
|
-
|
|
196
|
+
**If routing feature is needed, install React Router:**
|
|
196
197
|
```bash
|
|
197
198
|
pnpm add react-router-dom
|
|
198
199
|
```
|
|
199
200
|
|
|
200
201
|
|
|
201
|
-
|
|
202
|
-
⚠️
|
|
203
|
-
⚠️
|
|
202
|
+
**Important Reminders:**
|
|
203
|
+
⚠️ This project uses pnpm, all dependency installations must use `pnpm add`, do not use npm or yarn!
|
|
204
|
+
⚠️ No need to read source code of components under `components/ui/` directory, shadcn/ui components can be imported and used directly!
|
|
204
205
|
```
|
|
205
206
|
|