smart-spec-kit-mcp 2.2.6 → 2.2.8
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/README.md +75 -1
- package/TROUBLESHOOTING.md +121 -0
- package/dist/tools/agentTools.d.ts +2 -1
- package/dist/tools/agentTools.d.ts.map +1 -1
- package/dist/tools/agentTools.js +21 -22
- package/dist/tools/agentTools.js.map +1 -1
- package/dist/tools/promptTools.d.ts.map +1 -1
- package/dist/tools/promptTools.js +154 -0
- package/dist/tools/promptTools.js.map +1 -1
- package/dist/utils/agentLoader.d.ts +53 -0
- package/dist/utils/agentLoader.d.ts.map +1 -0
- package/dist/utils/agentLoader.js +225 -0
- package/dist/utils/agentLoader.js.map +1 -0
- package/dist/utils/starterKitInstaller.d.ts.map +1 -1
- package/dist/utils/starterKitInstaller.js +27 -1
- package/dist/utils/starterKitInstaller.js.map +1 -1
- package/docs/DOCUMENTATION.md +318 -6
- package/package.json +3 -5
- package/starter-kit/agents/GovAgent.md +53 -0
- package/starter-kit/agents/PlanAgent.md +51 -0
- package/starter-kit/agents/SpecAgent.md +51 -0
- package/starter-kit/agents/TestAgent.md +52 -0
- package/starter-kit/agents/_CustomAgent.template.md +69 -0
- package/starter-kit/github-prompts/speckit.workflow.prompt.md +90 -0
- package/starter-kit/templates/bugfix-report.md +22 -2
- package/starter-kit/templates/functional-spec.md +12 -1
- package/starter-kit/templates/plan-template.md +6 -1
- package/starter-kit/templates/tasks-template.md +4 -3
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
````prompt
|
|
2
|
+
---
|
|
3
|
+
description: "Gérer les workflows Spec-Kit (lister, démarrer, statut)"
|
|
4
|
+
mode: "agent"
|
|
5
|
+
tools: ["mcp_spec-kit_speckit_workflow", "mcp_spec-kit_start_workflow", "mcp_spec-kit_workflow_status"]
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Spec-Kit: Gestion des Workflows
|
|
9
|
+
|
|
10
|
+
Vous utilisez **Spec-Kit** pour gérer les workflows multi-étapes.
|
|
11
|
+
|
|
12
|
+
## Instructions
|
|
13
|
+
|
|
14
|
+
1. **Appeler l'outil MCP** `speckit_workflow` pour gérer les workflows
|
|
15
|
+
2. **Interpréter les arguments** fournis par l'utilisateur
|
|
16
|
+
|
|
17
|
+
```
|
|
18
|
+
$ARGUMENTS
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
## Actions disponibles
|
|
22
|
+
|
|
23
|
+
### Lister les workflows
|
|
24
|
+
```
|
|
25
|
+
action: "list"
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
Affiche tous les workflows disponibles (locaux et intégrés).
|
|
29
|
+
|
|
30
|
+
### Démarrer un workflow
|
|
31
|
+
```
|
|
32
|
+
action: "start"
|
|
33
|
+
workflow_name: "feature-standard"
|
|
34
|
+
context_id: "MonFeature" # Optionnel
|
|
35
|
+
auto: false # Optionnel (true = automatique)
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
Démarre un workflow multi-étapes. Le workflow guide automatiquement à travers les étapes.
|
|
39
|
+
|
|
40
|
+
### Vérifier le statut
|
|
41
|
+
```
|
|
42
|
+
action: "status"
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
Affiche l'état du workflow actif (étape en cours, actions complétées).
|
|
46
|
+
|
|
47
|
+
## Workflows intégrés
|
|
48
|
+
|
|
49
|
+
| Workflow | Description |
|
|
50
|
+
|----------|-------------|
|
|
51
|
+
| `feature-quick` | Feature rapide (léger, sans breakdown de tâches) |
|
|
52
|
+
| `feature-standard` | Feature standard (spec → plan → tasks → implement) |
|
|
53
|
+
| `feature-full` | Feature complète avec validation et tests |
|
|
54
|
+
| `bugfix` | Correction de bug avec reproduction |
|
|
55
|
+
|
|
56
|
+
## Exemples d'utilisation
|
|
57
|
+
|
|
58
|
+
### Utilisateur : "speckit: workflow list"
|
|
59
|
+
→ Appeler `speckit_workflow` avec `action: "list"`
|
|
60
|
+
|
|
61
|
+
### Utilisateur : "speckit: workflow start feature-standard"
|
|
62
|
+
→ Appeler `speckit_workflow` avec `action: "start"`, `workflow_name: "feature-standard"`
|
|
63
|
+
|
|
64
|
+
### Utilisateur : "speckit: workflow start feature-full MyFeature auto"
|
|
65
|
+
→ Appeler `speckit_workflow` avec:
|
|
66
|
+
- `action: "start"`
|
|
67
|
+
- `workflow_name: "feature-full"`
|
|
68
|
+
- `context_id: "MyFeature"`
|
|
69
|
+
- `auto: true`
|
|
70
|
+
|
|
71
|
+
### Utilisateur : "speckit: workflow status"
|
|
72
|
+
→ Appeler `speckit_workflow` avec `action: "status"`
|
|
73
|
+
|
|
74
|
+
## Mode automatique
|
|
75
|
+
|
|
76
|
+
Par défaut, les workflows demandent une approbation à chaque étape.
|
|
77
|
+
|
|
78
|
+
En mode automatique (`auto: true`), le workflow s'exécute sans interruption.
|
|
79
|
+
|
|
80
|
+
## Workflow typique
|
|
81
|
+
|
|
82
|
+
```
|
|
83
|
+
specify → plan → tasks → implement
|
|
84
|
+
↑
|
|
85
|
+
clarify (si nécessaire)
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
Les workflows orchestrent ces commandes automatiquement.
|
|
89
|
+
|
|
90
|
+
````
|
|
@@ -14,9 +14,11 @@ severity: "[Critical/High/Medium/Low]"
|
|
|
14
14
|
## 1. Bug Summary
|
|
15
15
|
|
|
16
16
|
### 1.1 Description
|
|
17
|
+
|
|
17
18
|
[TO FILL: Clear, concise description of the bug]
|
|
18
19
|
|
|
19
20
|
### 1.2 Impact
|
|
21
|
+
|
|
20
22
|
- **Severity**: [Critical/High/Medium/Low]
|
|
21
23
|
- **Affected Users**: [TO FILL: Who is affected]
|
|
22
24
|
- **Business Impact**: [TO FILL: How this affects the business]
|
|
@@ -26,6 +28,7 @@ severity: "[Critical/High/Medium/Low]"
|
|
|
26
28
|
## 2. Reproduction
|
|
27
29
|
|
|
28
30
|
### 2.1 Environment
|
|
31
|
+
|
|
29
32
|
| Component | Value |
|
|
30
33
|
|-----------|-------|
|
|
31
34
|
| OS | [TO FILL] |
|
|
@@ -33,18 +36,22 @@ severity: "[Critical/High/Medium/Low]"
|
|
|
33
36
|
| Version | [TO FILL] |
|
|
34
37
|
|
|
35
38
|
### 2.2 Steps to Reproduce
|
|
39
|
+
|
|
36
40
|
1. [TO FILL: Step 1]
|
|
37
41
|
2. [TO FILL: Step 2]
|
|
38
42
|
3. [TO FILL: Step 3]
|
|
39
43
|
|
|
40
44
|
### 2.3 Expected Behavior
|
|
45
|
+
|
|
41
46
|
[TO FILL: What should happen]
|
|
42
47
|
|
|
43
48
|
### 2.4 Actual Behavior
|
|
49
|
+
|
|
44
50
|
[TO FILL: What actually happens]
|
|
45
51
|
|
|
46
52
|
### 2.5 Evidence
|
|
47
|
-
|
|
53
|
+
|
|
54
|
+
```text
|
|
48
55
|
[TO FILL: Error messages, logs, screenshots]
|
|
49
56
|
```
|
|
50
57
|
|
|
@@ -53,13 +60,16 @@ severity: "[Critical/High/Medium/Low]"
|
|
|
53
60
|
## 3. Root Cause Analysis
|
|
54
61
|
|
|
55
62
|
### 3.1 Investigation
|
|
63
|
+
|
|
56
64
|
[TO FILL: What was investigated and findings]
|
|
57
65
|
|
|
58
66
|
### 3.2 Root Cause
|
|
67
|
+
|
|
59
68
|
[TO FILL: The underlying cause of the bug]
|
|
60
69
|
|
|
61
70
|
### 3.3 Related Code
|
|
62
|
-
|
|
71
|
+
|
|
72
|
+
```text
|
|
63
73
|
File: [path/to/file]
|
|
64
74
|
Line: [line numbers]
|
|
65
75
|
```
|
|
@@ -69,14 +79,17 @@ Line: [line numbers]
|
|
|
69
79
|
## 4. Fix Proposal
|
|
70
80
|
|
|
71
81
|
### 4.1 Solution
|
|
82
|
+
|
|
72
83
|
[TO FILL: Proposed fix approach]
|
|
73
84
|
|
|
74
85
|
### 4.2 Changes Required
|
|
86
|
+
|
|
75
87
|
| File | Change |
|
|
76
88
|
|------|--------|
|
|
77
89
|
| [TO FILL] | [TO FILL] |
|
|
78
90
|
|
|
79
91
|
### 4.3 Risks
|
|
92
|
+
|
|
80
93
|
- [TO FILL: Any risks with the proposed fix]
|
|
81
94
|
|
|
82
95
|
---
|
|
@@ -84,12 +97,14 @@ Line: [line numbers]
|
|
|
84
97
|
## 5. Testing
|
|
85
98
|
|
|
86
99
|
### 5.1 Test Cases
|
|
100
|
+
|
|
87
101
|
| ID | Scenario | Expected Result |
|
|
88
102
|
|----|----------|-----------------|
|
|
89
103
|
| TC-001 | [TO FILL: Original bug scenario] | Bug no longer occurs |
|
|
90
104
|
| TC-002 | [TO FILL: Regression test] | Existing functionality intact |
|
|
91
105
|
|
|
92
106
|
### 5.2 Verification Steps
|
|
107
|
+
|
|
93
108
|
1. [TO FILL: How to verify the fix]
|
|
94
109
|
2. [TO FILL: Regression testing steps]
|
|
95
110
|
|
|
@@ -98,12 +113,14 @@ Line: [line numbers]
|
|
|
98
113
|
## 6. Deployment
|
|
99
114
|
|
|
100
115
|
### 6.1 Deployment Plan
|
|
116
|
+
|
|
101
117
|
- [ ] Code review completed
|
|
102
118
|
- [ ] Tests passing
|
|
103
119
|
- [ ] Staging verification
|
|
104
120
|
- [ ] Production deployment
|
|
105
121
|
|
|
106
122
|
### 6.2 Rollback Plan
|
|
123
|
+
|
|
107
124
|
[TO FILL: How to rollback if issues occur]
|
|
108
125
|
|
|
109
126
|
---
|
|
@@ -111,6 +128,7 @@ Line: [line numbers]
|
|
|
111
128
|
## 7. Post-Mortem (Optional)
|
|
112
129
|
|
|
113
130
|
### 7.1 Timeline
|
|
131
|
+
|
|
114
132
|
| Time | Event |
|
|
115
133
|
|------|-------|
|
|
116
134
|
| [TO FILL] | Bug reported |
|
|
@@ -119,9 +137,11 @@ Line: [line numbers]
|
|
|
119
137
|
| [TO FILL] | Fix deployed |
|
|
120
138
|
|
|
121
139
|
### 7.2 Lessons Learned
|
|
140
|
+
|
|
122
141
|
- [TO FILL: What can we improve to prevent similar issues]
|
|
123
142
|
|
|
124
143
|
### 7.3 Action Items
|
|
144
|
+
|
|
125
145
|
| Item | Owner | Due Date |
|
|
126
146
|
|------|-------|----------|
|
|
127
147
|
| [TO FILL] | [TO FILL] | [TO FILL] |
|
|
@@ -14,16 +14,21 @@ last_updated: "[TO FILL: Date]"
|
|
|
14
14
|
## 1. Overview
|
|
15
15
|
|
|
16
16
|
### 1.1 Purpose
|
|
17
|
+
|
|
17
18
|
[TO FILL: Brief description of the feature's purpose and the problem it solves]
|
|
18
19
|
|
|
19
20
|
### 1.2 Scope
|
|
21
|
+
|
|
20
22
|
**In Scope:**
|
|
23
|
+
|
|
21
24
|
- [TO FILL: What is included]
|
|
22
25
|
|
|
23
26
|
**Out of Scope:**
|
|
27
|
+
|
|
24
28
|
- [TO FILL: What is explicitly excluded]
|
|
25
29
|
|
|
26
30
|
### 1.3 Background
|
|
31
|
+
|
|
27
32
|
[TO FILL: Context and history leading to this feature request]
|
|
28
33
|
|
|
29
34
|
---
|
|
@@ -79,6 +84,7 @@ Feature: [TO FILL: Feature Name]
|
|
|
79
84
|
### 4.1 User Personas
|
|
80
85
|
|
|
81
86
|
**Persona 1: [TO FILL: Name]**
|
|
87
|
+
|
|
82
88
|
- Role: [TO FILL]
|
|
83
89
|
- Goals: [TO FILL]
|
|
84
90
|
- Pain Points: [TO FILL]
|
|
@@ -92,7 +98,7 @@ Feature: [TO FILL: Feature Name]
|
|
|
92
98
|
|
|
93
99
|
### 4.3 User Flow
|
|
94
100
|
|
|
95
|
-
```
|
|
101
|
+
```text
|
|
96
102
|
[TO FILL: Describe or link to user flow diagram]
|
|
97
103
|
┌─────────┐ ┌─────────┐ ┌─────────┐
|
|
98
104
|
│ Step 1 │───▶│ Step 2 │───▶│ Step 3 │
|
|
@@ -104,12 +110,15 @@ Feature: [TO FILL: Feature Name]
|
|
|
104
110
|
## 5. Technical Considerations
|
|
105
111
|
|
|
106
112
|
### 5.1 Dependencies
|
|
113
|
+
|
|
107
114
|
- [TO FILL: External systems, services, or components this feature depends on]
|
|
108
115
|
|
|
109
116
|
### 5.2 Constraints
|
|
117
|
+
|
|
110
118
|
- [TO FILL: Technical or business constraints]
|
|
111
119
|
|
|
112
120
|
### 5.3 Data Requirements
|
|
121
|
+
|
|
113
122
|
- [TO FILL: Data entities, storage, and access patterns]
|
|
114
123
|
|
|
115
124
|
---
|
|
@@ -117,11 +126,13 @@ Feature: [TO FILL: Feature Name]
|
|
|
117
126
|
## 6. Assumptions & Risks
|
|
118
127
|
|
|
119
128
|
### 6.1 Assumptions
|
|
129
|
+
|
|
120
130
|
| ID | Assumption | Impact if Wrong |
|
|
121
131
|
|----|------------|-----------------|
|
|
122
132
|
| A-001 | [TO FILL] | [TO FILL] |
|
|
123
133
|
|
|
124
134
|
### 6.2 Risks
|
|
135
|
+
|
|
125
136
|
| ID | Risk | Probability | Impact | Mitigation |
|
|
126
137
|
|----|------|-------------|--------|------------|
|
|
127
138
|
| R-001 | [TO FILL] | Medium | High | [TO FILL] |
|
|
@@ -9,6 +9,7 @@
|
|
|
9
9
|
## Technical Context
|
|
10
10
|
|
|
11
11
|
### Tech Stack
|
|
12
|
+
|
|
12
13
|
| Component | Technology | Version |
|
|
13
14
|
|-----------|------------|---------|
|
|
14
15
|
| Language | [TO FILL] | |
|
|
@@ -18,7 +19,7 @@
|
|
|
18
19
|
|
|
19
20
|
### Architecture Overview
|
|
20
21
|
|
|
21
|
-
```
|
|
22
|
+
```text
|
|
22
23
|
[TO FILL: ASCII diagram or description of architecture]
|
|
23
24
|
|
|
24
25
|
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
|
|
@@ -50,6 +51,7 @@ tests/
|
|
|
50
51
|
## Implementation Phases
|
|
51
52
|
|
|
52
53
|
### Phase 0: Research & Design
|
|
54
|
+
|
|
53
55
|
**Duration**: [X days]
|
|
54
56
|
**Output**: research.md, data-model.md
|
|
55
57
|
|
|
@@ -59,6 +61,7 @@ tests/
|
|
|
59
61
|
- [ ] Define API contracts
|
|
60
62
|
|
|
61
63
|
### Phase 1: Foundation
|
|
64
|
+
|
|
62
65
|
**Duration**: [X days]
|
|
63
66
|
**Dependencies**: Phase 0
|
|
64
67
|
|
|
@@ -68,6 +71,7 @@ tests/
|
|
|
68
71
|
- [ ] Set up database schema
|
|
69
72
|
|
|
70
73
|
### Phase 2: Core Implementation
|
|
74
|
+
|
|
71
75
|
**Duration**: [X days]
|
|
72
76
|
**Dependencies**: Phase 1
|
|
73
77
|
|
|
@@ -76,6 +80,7 @@ tests/
|
|
|
76
80
|
- [ ] Add unit tests
|
|
77
81
|
|
|
78
82
|
### Phase 3: Integration & Polish
|
|
83
|
+
|
|
79
84
|
**Duration**: [X days]
|
|
80
85
|
**Dependencies**: Phase 2
|
|
81
86
|
|
|
@@ -8,11 +8,12 @@
|
|
|
8
8
|
|
|
9
9
|
## Task Format
|
|
10
10
|
|
|
11
|
-
```
|
|
11
|
+
```text
|
|
12
12
|
- [ ] T### [P?] [Story?] Description - `path/to/file.ext`
|
|
13
13
|
```
|
|
14
14
|
|
|
15
15
|
**Legend**:
|
|
16
|
+
|
|
16
17
|
- `T###`: Task ID (sequential)
|
|
17
18
|
- `[P]`: Can be executed in parallel with other `[P]` tasks in same phase
|
|
18
19
|
- `[Story?]`: Associated user story ID (optional)
|
|
@@ -107,7 +108,7 @@
|
|
|
107
108
|
|
|
108
109
|
## Dependencies & Execution Order
|
|
109
110
|
|
|
110
|
-
```
|
|
111
|
+
```text
|
|
111
112
|
Phase 1 (Setup)
|
|
112
113
|
│
|
|
113
114
|
▼
|
|
@@ -129,7 +130,7 @@ Phase 3 (US-1) Phase 4 (US-2) Phase 5 (US-3) ← Can run in parallel
|
|
|
129
130
|
|
|
130
131
|
Tasks marked `[P]` within the same phase can run simultaneously:
|
|
131
132
|
|
|
132
|
-
```
|
|
133
|
+
```text
|
|
133
134
|
Phase 3, Story 1:
|
|
134
135
|
├── T010 Create model (sequential - others depend on this)
|
|
135
136
|
│
|