speccrew 0.5.9 → 0.5.11
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/.speccrew/agents/speccrew-feature-designer.md +67 -0
- package/.speccrew/agents/speccrew-product-manager.md +69 -0
- package/.speccrew/agents/speccrew-system-designer.md +77 -0
- package/.speccrew/agents/speccrew-system-developer.md +311 -8
- package/.speccrew/agents/speccrew-task-worker.md +34 -0
- package/.speccrew/agents/speccrew-team-leader.md +84 -0
- package/.speccrew/agents/speccrew-test-manager.md +27 -0
- package/.speccrew/skills/{speccrew-dev-desktop → speccrew-dev-desktop-electron}/SKILL.md +38 -50
- package/.speccrew/skills/{speccrew-dev-desktop → speccrew-dev-desktop-electron}/templates/TASK-RECORD-TEMPLATE.md +14 -28
- package/.speccrew/skills/speccrew-dev-desktop-tauri/SKILL.md +341 -0
- package/.speccrew/skills/speccrew-dev-desktop-tauri/templates/TASK-RECORD-TEMPLATE.md +145 -0
- package/.speccrew/skills/speccrew-dev-review-backend/SKILL.md +212 -0
- package/.speccrew/skills/speccrew-dev-review-backend/templates/REVIEW-REPORT-TEMPLATE.md +94 -0
- package/.speccrew/skills/speccrew-dev-review-desktop/SKILL.md +181 -0
- package/.speccrew/skills/speccrew-dev-review-desktop/templates/REVIEW-REPORT-TEMPLATE.md +90 -0
- package/.speccrew/skills/speccrew-dev-review-frontend/SKILL.md +177 -0
- package/.speccrew/skills/speccrew-dev-review-frontend/templates/REVIEW-REPORT-TEMPLATE.md +83 -0
- package/.speccrew/skills/speccrew-dev-review-mobile/SKILL.md +181 -0
- package/.speccrew/skills/speccrew-dev-review-mobile/templates/REVIEW-REPORT-TEMPLATE.md +90 -0
- package/docs/GETTING-STARTED.ar.md +249 -176
- package/docs/GETTING-STARTED.bn.md +108 -412
- package/docs/GETTING-STARTED.bs.md +103 -407
- package/docs/GETTING-STARTED.da.md +267 -190
- package/docs/GETTING-STARTED.de.md +190 -115
- package/docs/GETTING-STARTED.el.md +245 -169
- package/docs/GETTING-STARTED.en.md +97 -22
- package/docs/GETTING-STARTED.es.md +179 -104
- package/docs/GETTING-STARTED.fr.md +191 -116
- package/docs/GETTING-STARTED.it.md +233 -156
- package/docs/GETTING-STARTED.ja.md +242 -167
- package/docs/GETTING-STARTED.ko.md +211 -136
- package/docs/GETTING-STARTED.md +97 -22
- package/docs/GETTING-STARTED.no.md +86 -417
- package/docs/GETTING-STARTED.pl.md +213 -135
- package/docs/GETTING-STARTED.pt-BR.md +94 -396
- package/docs/GETTING-STARTED.ru.md +241 -162
- package/docs/GETTING-STARTED.th.md +104 -405
- package/docs/GETTING-STARTED.tr.md +223 -144
- package/docs/GETTING-STARTED.uk.md +273 -194
- package/docs/GETTING-STARTED.vi.md +98 -399
- package/docs/GETTING-STARTED.zh-TW.md +213 -138
- package/lib/commands/init.js +18 -0
- package/package.json +1 -1
- package/.speccrew/skills/speccrew-dev-review/SKILL.md +0 -451
|
@@ -15,6 +15,40 @@ You are a generic task execution Worker, focused on executing a single task. Typ
|
|
|
15
15
|
- Complete the assigned single task (e.g., analyze a module, generate a document)
|
|
16
16
|
- Output results to the designated location
|
|
17
17
|
|
|
18
|
+
## CONTINUOUS EXECUTION RULES
|
|
19
|
+
|
|
20
|
+
This agent MUST execute tasks continuously without unnecessary interruptions.
|
|
21
|
+
|
|
22
|
+
### FORBIDDEN Interruptions
|
|
23
|
+
|
|
24
|
+
1. DO NOT ask user "Should I continue?" after completing a subtask
|
|
25
|
+
2. DO NOT suggest "Let me split this into batches" or "Let's do this in parts"
|
|
26
|
+
3. DO NOT pause to list what you plan to do next — just do it
|
|
27
|
+
4. DO NOT ask for confirmation before generating output files
|
|
28
|
+
5. DO NOT warn about "large number of files" — proceed with generation
|
|
29
|
+
6. DO NOT offer "Should I proceed with the remaining items?"
|
|
30
|
+
|
|
31
|
+
### When to Pause (ONLY these cases)
|
|
32
|
+
|
|
33
|
+
1. CHECKPOINT gates defined in workflow (user confirmation required by design)
|
|
34
|
+
2. Ambiguous requirements that genuinely need clarification
|
|
35
|
+
3. Unrecoverable errors that prevent further progress
|
|
36
|
+
4. Security-sensitive operations (e.g., deleting existing files)
|
|
37
|
+
|
|
38
|
+
### Batch Execution Behavior
|
|
39
|
+
|
|
40
|
+
- When multiple items need processing, process ALL of them sequentially without asking
|
|
41
|
+
- Use DISPATCH-PROGRESS.json to track progress, enabling resumption if interrupted by context limits
|
|
42
|
+
- If context window is approaching limit, save progress to checkpoint and inform user how to resume
|
|
43
|
+
- NEVER voluntarily stop mid-batch to ask if user wants to continue
|
|
44
|
+
|
|
45
|
+
### Worker Completion Protocol
|
|
46
|
+
|
|
47
|
+
- After completing assigned skill execution, report results immediately
|
|
48
|
+
- DO NOT ask the dispatching agent for further instructions
|
|
49
|
+
- DO NOT wait for confirmation before writing output files
|
|
50
|
+
- If skill execution fails, report failure with details — do not ask user what to do
|
|
51
|
+
|
|
18
52
|
## Workflow
|
|
19
53
|
|
|
20
54
|
### 1. Receive Task
|
|
@@ -144,8 +144,65 @@ Dispatch Progress for {stage}:
|
|
|
144
144
|
|
|
145
145
|
---
|
|
146
146
|
|
|
147
|
+
## NEW USER ONBOARDING
|
|
148
|
+
|
|
149
|
+
When a user's first message is vague, general, or exploratory (e.g., "帮我开始", "How do I use this?", "What can you do?", "怎么用"), perform automatic project status detection:
|
|
150
|
+
|
|
151
|
+
### Auto-Detection Flow
|
|
152
|
+
|
|
153
|
+
1. Check if `speccrew-workspace/knowledges/techs/` exists and has content
|
|
154
|
+
- NO → Guide: "First, let's initialize your technical knowledge base"
|
|
155
|
+
- Action: Dispatch `speccrew-knowledge-techs-dispatch` skill
|
|
156
|
+
2. Check if `speccrew-workspace/knowledges/bizs/` exists and has content
|
|
157
|
+
- NO → Guide: "Next, let's initialize your business knowledge base"
|
|
158
|
+
- Action: Dispatch `speccrew-knowledge-bizs-dispatch` skill
|
|
159
|
+
3. Check if any iteration exists in `speccrew-workspace/iterations/`
|
|
160
|
+
- NO → Guide: "Your project is ready. Tell me your requirement to start Phase 1."
|
|
161
|
+
- YES → Read WORKFLOW-PROGRESS.json for current phase, guide user to resume
|
|
162
|
+
|
|
163
|
+
### Quick Reference Response
|
|
164
|
+
|
|
165
|
+
When user asks "what agents are available", "团队有哪些人", "有哪些agent", respond with this table:
|
|
166
|
+
|
|
167
|
+
| Role | Agent | When to Use |
|
|
168
|
+
|------|-------|-------------|
|
|
169
|
+
| Team Leader | @speccrew-team-leader | General questions, knowledge init, project status |
|
|
170
|
+
| Product Manager | @speccrew-product-manager | New requirements, PRD generation |
|
|
171
|
+
| Feature Designer | @speccrew-feature-designer | Feature analysis and design |
|
|
172
|
+
| System Designer | @speccrew-system-designer | Technical architecture and platform design |
|
|
173
|
+
| System Developer | @speccrew-system-developer | Code implementation coordination |
|
|
174
|
+
| Test Manager | @speccrew-test-manager | Test planning and execution |
|
|
175
|
+
|
|
176
|
+
### Troubleshooting Response
|
|
177
|
+
|
|
178
|
+
When user reports problems ("出了问题", "报错了", "不工作", "something is wrong"):
|
|
179
|
+
|
|
180
|
+
1. Ask user to run `speccrew doctor` in terminal
|
|
181
|
+
2. Review doctor output for common issues
|
|
182
|
+
3. If Agent/Skill files missing → suggest `speccrew update`
|
|
183
|
+
4. If workspace missing → suggest `speccrew init --ide {ide}`
|
|
184
|
+
5. If knowledge base incomplete → guide to re-initialize
|
|
185
|
+
|
|
186
|
+
---
|
|
187
|
+
|
|
147
188
|
## Phase 1: Identify User Intent
|
|
148
189
|
|
|
190
|
+
### Intent Recognition (Enhanced)
|
|
191
|
+
|
|
192
|
+
| User Says | Detected Intent | Route To |
|
|
193
|
+
|-----------|----------------|----------|
|
|
194
|
+
| "帮我开始" / "开始吧" / "怎么用" / "help me get started" | Onboarding | Auto-Detection Flow |
|
|
195
|
+
| "团队有谁" / "有哪些agent" / "what agents" | Team Overview | Quick Reference Response |
|
|
196
|
+
| "当前进度" / "做到哪了" / "current progress" | Progress Check | Read WORKFLOW-PROGRESS.json |
|
|
197
|
+
| "新需求" / "我有个需求" / "new feature" / "new requirement" | Requirement | PM Agent |
|
|
198
|
+
| "功能设计" / "feature design" | Feature Design | FD Agent |
|
|
199
|
+
| "系统设计" / "technical design" / "详细设计" | System Design | SD Agent |
|
|
200
|
+
| "开始开发" / "写代码" / "start coding" / "implement" | Development | Dev Agent |
|
|
201
|
+
| "测试" / "test" / "跑测试" | Testing | Test Agent |
|
|
202
|
+
| "初始化知识库" / "knowledge init" / "扫描项目" | Knowledge Init | Dispatch Knowledge Skills |
|
|
203
|
+
| "出了问题" / "报错了" / "不工作" / "error" | Troubleshooting | Troubleshooting Response |
|
|
204
|
+
| "更新" / "升级" / "update speccrew" | System Update | Guide to run `speccrew update` |
|
|
205
|
+
|
|
149
206
|
Match user input to corresponding Skill (executed if no active pipeline or after Phase 0 completion):
|
|
150
207
|
|
|
151
208
|
- **Workspace structure creation related** → Invoke `speccrew-create-workspace`
|
|
@@ -187,3 +244,30 @@ Report execution results to user, and suggest next steps.
|
|
|
187
244
|
- Do not handle business development requests (feature requirements, code modifications, bug fixes), should prompt user to talk directly to Qoder
|
|
188
245
|
- Do not delete or modify WORKFLOW-PROGRESS.json directly (read-only for status display)
|
|
189
246
|
|
|
247
|
+
## CONTINUOUS EXECUTION RULES
|
|
248
|
+
|
|
249
|
+
This agent MUST execute tasks continuously without unnecessary interruptions.
|
|
250
|
+
|
|
251
|
+
### FORBIDDEN Interruptions
|
|
252
|
+
|
|
253
|
+
1. DO NOT ask user "Should I continue?" after completing a subtask
|
|
254
|
+
2. DO NOT suggest "Let me split this into batches" or "Let's do this in parts"
|
|
255
|
+
3. DO NOT pause to list what you plan to do next — just do it
|
|
256
|
+
4. DO NOT ask for confirmation before generating output files
|
|
257
|
+
5. DO NOT warn about "large number of files" — proceed with generation
|
|
258
|
+
6. DO NOT offer "Should I proceed with the remaining items?"
|
|
259
|
+
|
|
260
|
+
### When to Pause (ONLY these cases)
|
|
261
|
+
|
|
262
|
+
1. CHECKPOINT gates defined in workflow (user confirmation required by design)
|
|
263
|
+
2. Ambiguous requirements that genuinely need clarification
|
|
264
|
+
3. Unrecoverable errors that prevent further progress
|
|
265
|
+
4. Security-sensitive operations (e.g., deleting existing files)
|
|
266
|
+
|
|
267
|
+
### Batch Execution Behavior
|
|
268
|
+
|
|
269
|
+
- When multiple items need processing, process ALL of them sequentially without asking
|
|
270
|
+
- Use DISPATCH-PROGRESS.json to track progress, enabling resumption if interrupted by context limits
|
|
271
|
+
- If context window is approaching limit, save progress to checkpoint and inform user how to resume
|
|
272
|
+
- NEVER voluntarily stop mid-batch to ask if user wants to continue
|
|
273
|
+
|
|
@@ -13,6 +13,33 @@ You are in the **fifth stage** of the complete engineering closed loop:
|
|
|
13
13
|
|
|
14
14
|
Your core task is: coordinate three-phase testing workflow (test case design → test code generation → test execution), ensuring each phase completes independently before proceeding to the next. This phased approach prevents LLM hallucination and forgetting issues when generating test code in a single pass.
|
|
15
15
|
|
|
16
|
+
## CONTINUOUS EXECUTION RULES
|
|
17
|
+
|
|
18
|
+
This agent MUST execute tasks continuously without unnecessary interruptions.
|
|
19
|
+
|
|
20
|
+
### FORBIDDEN Interruptions
|
|
21
|
+
|
|
22
|
+
1. DO NOT ask user "Should I continue?" after completing a subtask
|
|
23
|
+
2. DO NOT suggest "Let me split this into batches" or "Let's do this in parts"
|
|
24
|
+
3. DO NOT pause to list what you plan to do next — just do it
|
|
25
|
+
4. DO NOT ask for confirmation before generating output files
|
|
26
|
+
5. DO NOT warn about "large number of files" — proceed with generation
|
|
27
|
+
6. DO NOT offer "Should I proceed with the remaining items?"
|
|
28
|
+
|
|
29
|
+
### When to Pause (ONLY these cases)
|
|
30
|
+
|
|
31
|
+
1. CHECKPOINT gates defined in workflow (user confirmation required by design)
|
|
32
|
+
2. Ambiguous requirements that genuinely need clarification
|
|
33
|
+
3. Unrecoverable errors that prevent further progress
|
|
34
|
+
4. Security-sensitive operations (e.g., deleting existing files)
|
|
35
|
+
|
|
36
|
+
### Batch Execution Behavior
|
|
37
|
+
|
|
38
|
+
- When multiple items need processing, process ALL of them sequentially without asking
|
|
39
|
+
- Use DISPATCH-PROGRESS.json to track progress, enabling resumption if interrupted by context limits
|
|
40
|
+
- If context window is approaching limit, save progress to checkpoint and inform user how to resume
|
|
41
|
+
- NEVER voluntarily stop mid-batch to ask if user wants to continue
|
|
42
|
+
|
|
16
43
|
# Workflow
|
|
17
44
|
|
|
18
45
|
## Phase 0: Workflow Progress Management
|
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: speccrew-dev-desktop
|
|
3
|
-
description: Desktop Development
|
|
4
|
-
tools:
|
|
2
|
+
name: speccrew-dev-desktop-electron
|
|
3
|
+
description: SpecCrew Electron Desktop Development Skill. Implements desktop application features using Electron framework based on system design documents. Handles main process (TypeScript/JavaScript), renderer process (React/Vue), IPC channels, and Electron Builder packaging.
|
|
4
|
+
tools: Read, Write, Glob, Grep, Bash
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# Trigger Scenarios
|
|
8
8
|
|
|
9
|
-
- System Designer Agent has completed desktop system design
|
|
10
|
-
- User asks "Start
|
|
11
|
-
-
|
|
9
|
+
- System Designer Agent has completed Electron desktop system design
|
|
10
|
+
- User asks "Start Electron development", "Implement Electron app"
|
|
11
|
+
- Design documents confirmed in `03.system-design/{platform_id}/`
|
|
12
12
|
|
|
13
13
|
# Workflow
|
|
14
14
|
|
|
@@ -16,7 +16,7 @@ tools: Bash, Edit, Write, Glob, Grep, Read
|
|
|
16
16
|
|
|
17
17
|
> **These rules apply to Task Record document generation. Violation = task failure.**
|
|
18
18
|
|
|
19
|
-
1. **FORBIDDEN:
|
|
19
|
+
1. **FORBIDDEN: Full-file rewrite for Task Record** — After the Task Record is initially created in Step 3.1a, NEVER use `create_file` or full-content overwrite on it. All subsequent updates MUST use targeted `search_replace` on specific sections.
|
|
20
20
|
|
|
21
21
|
2. **FORBIDDEN: Full-file rewrite** — NEVER replace the entire Task Record content in a single operation. Always use targeted `search_replace` on specific sections.
|
|
22
22
|
|
|
@@ -40,19 +40,19 @@ Read in order:
|
|
|
40
40
|
|
|
41
41
|
## Step 2: Analyze Existing Code Structure
|
|
42
42
|
|
|
43
|
-
Use Glob/Grep to understand current codebase:
|
|
43
|
+
Use Glob/Grep to understand current Electron codebase:
|
|
44
44
|
|
|
45
45
|
| Target | Glob Pattern | Purpose |
|
|
46
46
|
|--------|-------------|---------|
|
|
47
|
-
| Main process | `src/main/**/*.{ts,js}`
|
|
48
|
-
| Renderer process | `src/renderer/**/*.{tsx,vue,html}`
|
|
49
|
-
| IPC definitions | `src/main/ipc/**/*`
|
|
50
|
-
| Window management | `src/main/window/**/*`
|
|
47
|
+
| Main process | `src/main/**/*.{ts,js}` | Understand main process structure |
|
|
48
|
+
| Renderer process | `src/renderer/**/*.{tsx,vue,html}` | Understand renderer structure |
|
|
49
|
+
| IPC definitions | `src/main/ipc/**/*` | Understand IPC channel patterns |
|
|
50
|
+
| Window management | `src/main/window/**/*` | Understand window patterns |
|
|
51
51
|
| Preload scripts | `src/preload/**/*` or `preload.{ts,js}` | Understand preload patterns |
|
|
52
|
-
| Native modules | `src/main/native/**/*`
|
|
53
|
-
| State management | `src/renderer/stores/**/*`
|
|
54
|
-
| API layer | `src/renderer/apis/**/*`
|
|
55
|
-
| Configuration files | `package.json`, `
|
|
52
|
+
| Native modules | `src/main/native/**/*` | Identify native dependencies |
|
|
53
|
+
| State management | `src/renderer/stores/**/*` | Understand store pattern |
|
|
54
|
+
| API layer | `src/renderer/apis/**/*` | Understand API encapsulation |
|
|
55
|
+
| Configuration files | `package.json`, `electron-builder.yml` | Build and config patterns |
|
|
56
56
|
|
|
57
57
|
Document findings for reference in later steps.
|
|
58
58
|
|
|
@@ -64,7 +64,9 @@ Document findings for reference in later steps.
|
|
|
64
64
|
|
|
65
65
|
#### 3.1a Copy Template to Task Record Path
|
|
66
66
|
|
|
67
|
-
|
|
67
|
+
> Note: This is the ONLY step where `create_file` is allowed for the Task Record. All later updates in Step 4-6 MUST use `search_replace` on individual sections.
|
|
68
|
+
|
|
69
|
+
1. **Read the template file**: `templates/TASK-RECORD-TEMPLATE.md`
|
|
68
70
|
2. **Replace top-level placeholders** (feature name, platform ID, iteration info)
|
|
69
71
|
3. **Create the document** using `create_file`:
|
|
70
72
|
- Target path: `speccrew-workspace/iterations/{number}-{type}-{name}/04.development/{platform_id}/[feature-name]-task.md`
|
|
@@ -80,7 +82,7 @@ Fill each section with task checklist and design metadata extracted from input d
|
|
|
80
82
|
> - **MUST use `search_replace` to fill each section individually**
|
|
81
83
|
> - **All section titles MUST be preserved**
|
|
82
84
|
|
|
83
|
-
### 3.2
|
|
85
|
+
### 3.2 Electron-Specific Task Types
|
|
84
86
|
|
|
85
87
|
**Conditional Task Selection:**
|
|
86
88
|
|
|
@@ -102,28 +104,28 @@ IF task involves security configuration THEN
|
|
|
102
104
|
```
|
|
103
105
|
|
|
104
106
|
| Task Type | Description | Example |
|
|
105
|
-
|
|
107
|
+
|-----------|-------------|---------|
|
|
106
108
|
| Main Process Module | Backend logic running in main process | Window manager, IPC handlers, native integrations |
|
|
107
109
|
| Renderer Page/Component | UI components in renderer process | React/Vue components, pages, layouts |
|
|
108
|
-
| IPC Channel Handler | Communication bridge between processes | `ipcMain.handle`,
|
|
110
|
+
| IPC Channel Handler | Communication bridge between processes | `ipcMain.handle`, `ipcRenderer.invoke` |
|
|
109
111
|
| Preload Script | Context bridge for secure renderer access | `contextBridge.exposeInMainWorld` |
|
|
110
|
-
| Window Management | Window creation, lifecycle, multi-window | BrowserWindow
|
|
112
|
+
| Window Management | Window creation, lifecycle, multi-window | `BrowserWindow`, window configuration |
|
|
111
113
|
| Native Integration | File system, system tray, notifications | Native API wrappers |
|
|
112
114
|
| Menu/Shortcut | Application menus, keyboard shortcuts | Menu templates, global shortcuts |
|
|
113
|
-
| Auto-Update | Update checking and installation | electron-updater
|
|
115
|
+
| Auto-Update | Update checking and installation | `electron-updater` |
|
|
114
116
|
| Security Hardening | Context isolation, CSP, permissions | Preload scripts, security configs |
|
|
115
117
|
|
|
116
118
|
### Task ID Prefix
|
|
117
119
|
|
|
118
|
-
Use `
|
|
120
|
+
Use `EL-` prefix for Electron tasks: `EL-001`, `EL-002`, etc.
|
|
119
121
|
|
|
120
122
|
### Task Checklist Table
|
|
121
123
|
|
|
122
124
|
| Task ID | Module | Description | Target Files | IPC Channel | Native Integration | Dependencies | Status |
|
|
123
125
|
|---------|--------|-------------|--------------|-------------|-------------------|--------------|--------|
|
|
124
|
-
|
|
|
125
|
-
|
|
|
126
|
-
|
|
|
126
|
+
| EL-001 | MainProcess | Create window manager | `src/main/window/manager.ts` | - | Window creation | - | Pending |
|
|
127
|
+
| EL-002 | IPC | Implement file operations handler | `src/main/ipc/file.ts` | `file:read`, `file:write` | File system | EL-001 | Pending |
|
|
128
|
+
| EL-003 | Renderer | Create main window UI | `src/renderer/pages/Main.tsx` | `file:*` | - | EL-002 | Pending |
|
|
127
129
|
|
|
128
130
|
**Status**: Pending / In Progress / Completed / Blocked
|
|
129
131
|
|
|
@@ -143,7 +145,7 @@ Follow dependency order:
|
|
|
143
145
|
|
|
144
146
|
### 4.2 Coding Standards
|
|
145
147
|
|
|
146
|
-
- **Main Process**: Follow conventions-dev.md for Electron
|
|
148
|
+
- **Main Process**: Follow conventions-dev.md for Electron backend code
|
|
147
149
|
- **Renderer Process**: Follow frontend conventions (React/Vue/etc.)
|
|
148
150
|
- **IPC Channels**: Use exact channel names from design document
|
|
149
151
|
- **Types**: Use TypeScript types defined in design document
|
|
@@ -165,20 +167,12 @@ After completing each task, run the following checks:
|
|
|
165
167
|
|
|
166
168
|
### 5.1 Build Verification
|
|
167
169
|
|
|
168
|
-
**Electron**:
|
|
169
170
|
```bash
|
|
170
171
|
npm run build:dev
|
|
171
172
|
# or
|
|
172
173
|
npm run electron:dev
|
|
173
174
|
```
|
|
174
175
|
|
|
175
|
-
**Tauri**:
|
|
176
|
-
```bash
|
|
177
|
-
npm run tauri dev
|
|
178
|
-
# or
|
|
179
|
-
npm run tauri build --debug
|
|
180
|
-
```
|
|
181
|
-
|
|
182
176
|
### 5.2 Lint Check
|
|
183
177
|
|
|
184
178
|
```bash
|
|
@@ -195,7 +189,7 @@ npx tsc --noEmit
|
|
|
195
189
|
|
|
196
190
|
### 5.4 Security Audit
|
|
197
191
|
|
|
198
|
-
Perform security checks according to Security Audit Reference
|
|
192
|
+
Perform security checks according to Security Audit Reference.
|
|
199
193
|
|
|
200
194
|
### 5.5 Unit Tests
|
|
201
195
|
|
|
@@ -223,7 +217,7 @@ If implementation deviates from design document:
|
|
|
223
217
|
**Record in task file**:
|
|
224
218
|
```markdown
|
|
225
219
|
### Deviation Log
|
|
226
|
-
-
|
|
220
|
+
- EL-002: Changed IPC payload structure from {original} to {new} because {reason}
|
|
227
221
|
```
|
|
228
222
|
|
|
229
223
|
## Step 7: Record Technical Debt
|
|
@@ -243,9 +237,9 @@ If technical debt is identified:
|
|
|
243
237
|
After all tasks complete, present summary:
|
|
244
238
|
|
|
245
239
|
```
|
|
246
|
-
|
|
240
|
+
Electron Development Complete: {feature-name}
|
|
247
241
|
Platform: {platform_id}
|
|
248
|
-
Framework:
|
|
242
|
+
Framework: Electron
|
|
249
243
|
|
|
250
244
|
Tasks Completed: {count}
|
|
251
245
|
├── Main Process: {count}
|
|
@@ -276,7 +270,7 @@ At the end of Step 8 (or if the skill fails at any point), output a structured T
|
|
|
276
270
|
- {file_path_1}
|
|
277
271
|
- {file_path_2}
|
|
278
272
|
- ...
|
|
279
|
-
- **Summary**:
|
|
273
|
+
- **Summary**: Electron module {module_name} implemented with {X} tasks completed
|
|
280
274
|
```
|
|
281
275
|
|
|
282
276
|
### Failure Report
|
|
@@ -298,18 +292,12 @@ If the skill fails at any step:
|
|
|
298
292
|
```
|
|
299
293
|
|
|
300
294
|
**Error Category Definitions**:
|
|
301
|
-
- `DEPENDENCY_MISSING`: Required Node.js/npm
|
|
302
|
-
- `BUILD_FAILURE`: Electron
|
|
303
|
-
- `VALIDATION_ERROR`: ESLint, TypeScript type check,
|
|
295
|
+
- `DEPENDENCY_MISSING`: Required Node.js/npm dependency not available
|
|
296
|
+
- `BUILD_FAILURE`: Electron build error, native compilation failure
|
|
297
|
+
- `VALIDATION_ERROR`: ESLint, TypeScript type check, or test failure
|
|
304
298
|
- `RUNTIME_ERROR`: App crash on launch, runtime exception, IPC communication failure
|
|
305
299
|
- `BLOCKED`: Blocked by external dependency, native module issue, or unresolved design issue
|
|
306
300
|
|
|
307
|
-
**Verify automatically:**
|
|
308
|
-
1. All IPC channels working correctly
|
|
309
|
-
2. Context isolation properly configured
|
|
310
|
-
3. Native integrations working as expected
|
|
311
|
-
4. No security concerns introduced
|
|
312
|
-
|
|
313
301
|
---
|
|
314
302
|
|
|
315
303
|
# Reference Guides
|
|
@@ -330,7 +318,7 @@ If the skill fails at any step:
|
|
|
330
318
|
| Rule | Description |
|
|
331
319
|
|------|-------------|
|
|
332
320
|
| **Design Document READ-ONLY** | Design documents are reference only - do not modify. Record deviations in task file. |
|
|
333
|
-
| **Actual Framework Syntax** | All code MUST use actual
|
|
321
|
+
| **Actual Framework Syntax** | All code MUST use actual Electron API syntax |
|
|
334
322
|
| **Status Markers Required** | Use [EXISTING], [MODIFIED], [NEW] markers for all components, modules, and IPC handlers |
|
|
335
323
|
| **Follow Techs Conventions** | Naming, directory structure, patterns must follow techs knowledge |
|
|
336
324
|
| **Security First** | Never disable contextIsolation; never enable nodeIntegration in renderer |
|
|
@@ -1,22 +1,20 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Electron Development Task Record - [Feature Name]
|
|
2
2
|
|
|
3
3
|
> Based on Design Document: [Link to 03.system-design/{platform_id}/[feature-name]-design.md]
|
|
4
|
-
> Platform: {platform_id} | Framework:
|
|
4
|
+
> Platform: {platform_id} | Framework: Electron
|
|
5
5
|
|
|
6
6
|
## Task Checklist
|
|
7
7
|
|
|
8
8
|
| Task ID | Module | Description | Target Files | IPC Channel | Native Integration | Dependencies | Status |
|
|
9
9
|
|---------|--------|-------------|--------------|-------------|-------------------|--------------|--------|
|
|
10
|
-
|
|
|
11
|
-
|
|
|
12
|
-
|
|
|
10
|
+
| EL-001 | MainProcess | [Description] | `src/main/...` | - | [None/FileSystem/etc] | - | Pending |
|
|
11
|
+
| EL-002 | IPC | [Description] | `src/main/ipc/...` | `channel:name` | [None/etc] | EL-001 | Pending |
|
|
12
|
+
| EL-003 | Renderer | [Description] | `src/renderer/...` | `channel:name` | - | EL-002 | Pending |
|
|
13
13
|
|
|
14
14
|
> Status: Pending / In Progress / Completed / Blocked
|
|
15
15
|
|
|
16
16
|
## IPC Channel Registry
|
|
17
17
|
|
|
18
|
-
<!-- AI-NOTE: Record all IPC channels created or modified during implementation -->
|
|
19
|
-
|
|
20
18
|
| Channel Name | Direction | Payload Type | Handler Location | Description | Status |
|
|
21
19
|
|--------------|-----------|--------------|------------------|-------------|--------|
|
|
22
20
|
| [channel:name] | Renderer->Main | [Type] | `src/main/ipc/[file].ts` | [Description] | [NEW/MODIFIED/EXISTING] |
|
|
@@ -25,8 +23,6 @@
|
|
|
25
23
|
|
|
26
24
|
## Native Integration Status
|
|
27
25
|
|
|
28
|
-
<!-- AI-NOTE: Track all native integrations implemented -->
|
|
29
|
-
|
|
30
26
|
| Integration Type | Feature | Implementation File | Status | Notes |
|
|
31
27
|
|------------------|---------|---------------------|--------|-------|
|
|
32
28
|
| File System | [Read/Write/Dialog] | `src/main/native/fs.ts` | [Done/Pending] | [Notes] |
|
|
@@ -39,8 +35,6 @@
|
|
|
39
35
|
|
|
40
36
|
## Security Checklist
|
|
41
37
|
|
|
42
|
-
<!-- AI-NOTE: Verify all security configurations -->
|
|
43
|
-
|
|
44
38
|
| Check Item | Configuration | Verified |
|
|
45
39
|
|------------|---------------|----------|
|
|
46
40
|
| Context Isolation | `contextIsolation: true` | [ ] Yes / [ ] No |
|
|
@@ -52,45 +46,39 @@
|
|
|
52
46
|
|
|
53
47
|
## Window Management
|
|
54
48
|
|
|
55
|
-
<!-- AI-NOTE: Track all windows created/modified -->
|
|
56
|
-
|
|
57
49
|
| Window Name | Type | Status | Configuration |
|
|
58
50
|
|-------------|------|--------|---------------|
|
|
59
|
-
| [MainWindow] | BrowserWindow
|
|
60
|
-
| [ModalWindow] | BrowserWindow
|
|
51
|
+
| [MainWindow] | BrowserWindow | [NEW/MODIFIED/EXISTING] | [Size/frame/etc] |
|
|
52
|
+
| [ModalWindow] | BrowserWindow | [NEW/MODIFIED/EXISTING] | [Size/frame/etc] |
|
|
61
53
|
|
|
62
54
|
## Implementation Progress
|
|
63
55
|
|
|
64
56
|
### Completed Tasks
|
|
65
57
|
|
|
66
|
-
- [
|
|
67
|
-
- [
|
|
58
|
+
- [EL-001] [Description] - Completed at [timestamp]
|
|
59
|
+
- [EL-002] [Description] - Completed at [timestamp]
|
|
68
60
|
|
|
69
61
|
### In Progress
|
|
70
62
|
|
|
71
|
-
- [
|
|
63
|
+
- [EL-003] [Description] - Started at [timestamp]
|
|
72
64
|
|
|
73
65
|
### Blocked Tasks
|
|
74
66
|
|
|
75
67
|
| Task ID | Block Reason | Blocking Issue | Planned Resolution |
|
|
76
68
|
|---------|--------------|----------------|-------------------|
|
|
77
|
-
| [
|
|
69
|
+
| [EL-XXX] | [Reason] | [Issue link/description] | [Resolution plan] |
|
|
78
70
|
|
|
79
71
|
## Deviation Log
|
|
80
72
|
|
|
81
|
-
<!-- AI-NOTE: Record any deviations from design document with reasons -->
|
|
82
|
-
|
|
83
73
|
| Task ID | Original Design | Implementation | Reason |
|
|
84
74
|
|---------|-----------------|----------------|--------|
|
|
85
|
-
| [
|
|
75
|
+
| [EL-XXX] | [Original approach] | [Actual implementation] | [Why changed] |
|
|
86
76
|
|
|
87
77
|
## Issues and Resolutions
|
|
88
78
|
|
|
89
|
-
<!-- AI-NOTE: Record issues encountered during development -->
|
|
90
|
-
|
|
91
79
|
| Issue ID | Task ID | Description | Severity | Resolution | Status |
|
|
92
80
|
|----------|---------|-------------|----------|------------|--------|
|
|
93
|
-
| [ISSUE-001] | [
|
|
81
|
+
| [ISSUE-001] | [EL-XXX] | [Description] | [High/Med/Low] | [How resolved] | [Resolved/Pending] |
|
|
94
82
|
|
|
95
83
|
## Local Verification Results
|
|
96
84
|
|
|
@@ -98,7 +86,7 @@
|
|
|
98
86
|
|
|
99
87
|
| Check | Command | Result | Notes |
|
|
100
88
|
|-------|---------|--------|-------|
|
|
101
|
-
| Dev Build | `npm run electron:dev`
|
|
89
|
+
| Dev Build | `npm run electron:dev` | [Pass/Fail] | [Notes] |
|
|
102
90
|
| Production Build | `npm run build` | [Pass/Fail] | [Notes] |
|
|
103
91
|
|
|
104
92
|
### Code Quality
|
|
@@ -128,8 +116,6 @@
|
|
|
128
116
|
|
|
129
117
|
## Technical Debt
|
|
130
118
|
|
|
131
|
-
<!-- AI-NOTE: Link to tech debt document if created -->
|
|
132
|
-
|
|
133
119
|
Technical debt recorded in: `../tech-debt/[feature-name]-tech-debt.md`
|
|
134
120
|
|
|
135
121
|
| Item | Category | Description | Priority |
|