superkit-mcp-server 1.2.3 → 1.2.4
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/ARCHITECTURE.md +102 -102
- package/README.md +71 -71
- package/SUPERKIT.md +168 -168
- package/agents/code-archaeologist.md +106 -106
- package/agents/coder.md +90 -90
- package/agents/data-engineer.md +28 -28
- package/agents/devops-engineer.md +242 -242
- package/agents/git-manager.md +203 -203
- package/agents/orchestrator.md +420 -420
- package/agents/penetration-tester.md +188 -188
- package/agents/performance-optimizer.md +187 -187
- package/agents/planner.md +270 -270
- package/agents/qa-automation-engineer.md +103 -103
- package/agents/quant-developer.md +32 -32
- package/agents/reviewer.md +100 -100
- package/agents/scout.md +222 -222
- package/agents/tester.md +274 -274
- package/agents/ui-designer.md +208 -208
- package/build/tools/sessionManager.js +79 -10
- package/build/tools/todoTools.js +39 -39
- package/build/tools/validators/__tests__/apiSchema.test.js +23 -23
- package/build/tools/validators/__tests__/convertRules.test.js +5 -5
- package/build/tools/validators/__tests__/frontendDesign.test.js +12 -12
- package/build/tools/validators/__tests__/geoChecker.test.js +19 -19
- package/build/tools/validators/__tests__/mobileAudit.test.js +12 -12
- package/build/tools/validators/__tests__/reactPerformanceChecker.test.js +17 -17
- package/build/tools/validators/__tests__/securityScan.test.js +6 -6
- package/build/tools/validators/__tests__/seoChecker.test.js +16 -16
- package/build/tools/validators/__tests__/typeCoverage.test.js +14 -14
- package/commands/README.md +122 -122
- package/commands/ask.toml +72 -72
- package/commands/brainstorm.toml +119 -119
- package/commands/chat.toml +77 -77
- package/commands/code-preview.toml +37 -37
- package/commands/code.toml +28 -28
- package/commands/content.toml +200 -200
- package/commands/cook.toml +77 -77
- package/commands/copywrite.toml +131 -131
- package/commands/db.toml +192 -192
- package/commands/debug.toml +166 -166
- package/commands/design.toml +158 -158
- package/commands/dev-rules.toml +14 -14
- package/commands/do.toml +117 -117
- package/commands/doc-rules.toml +14 -14
- package/commands/docs.toml +148 -148
- package/commands/fix.toml +440 -440
- package/commands/fullstack.toml +175 -175
- package/commands/git.toml +235 -235
- package/commands/help.toml +84 -84
- package/commands/integrate.toml +127 -127
- package/commands/journal.toml +136 -136
- package/commands/kit-setup.toml +40 -40
- package/commands/mcp.toml +183 -183
- package/commands/orchestration.toml +15 -15
- package/commands/plan.toml +171 -171
- package/commands/pm.toml +148 -148
- package/commands/pr.toml +50 -50
- package/commands/project.toml +32 -32
- package/commands/research.toml +117 -117
- package/commands/review-pr.toml +63 -63
- package/commands/review.toml +190 -190
- package/commands/scout-ext.toml +97 -97
- package/commands/scout.toml +79 -79
- package/commands/screenshot.toml +65 -65
- package/commands/session.toml +102 -102
- package/commands/skill.toml +384 -384
- package/commands/status.toml +22 -22
- package/commands/team.toml +56 -56
- package/commands/test.toml +164 -164
- package/commands/ticket.toml +70 -70
- package/commands/use.toml +106 -106
- package/commands/video.toml +83 -83
- package/commands/watzup.toml +71 -71
- package/commands/workflow.toml +14 -14
- package/package.json +35 -35
- package/skills/meta/README.md +30 -30
- package/skills/meta/api-design/SKILL.md +134 -134
- package/skills/meta/code-review/SKILL.md +44 -44
- package/skills/meta/code-review/checklists/pre-merge.md +25 -25
- package/skills/meta/code-review/workflows/architecture-pass.md +26 -26
- package/skills/meta/code-review/workflows/performance-pass.md +27 -27
- package/skills/meta/code-review/workflows/security-pass.md +29 -29
- package/skills/meta/compound-docs/SKILL.md +133 -133
- package/skills/meta/debug/SKILL.md +40 -40
- package/skills/meta/debug/templates/bug-report.template.md +31 -31
- package/skills/meta/debug/workflows/reproduce-issue.md +20 -20
- package/skills/meta/docker/SKILL.md +126 -126
- package/skills/meta/examples/supabase/SKILL.md +46 -46
- package/skills/meta/examples/supabase/references/best-practices.md +319 -319
- package/skills/meta/examples/supabase/references/common-patterns.md +373 -373
- package/skills/meta/examples/supabase/templates/migration-template.sql +49 -49
- package/skills/meta/examples/supabase/templates/rls-policy-template.sql +77 -77
- package/skills/meta/examples/supabase/workflows/debugging.md +260 -260
- package/skills/meta/examples/supabase/workflows/migration-workflow.md +211 -211
- package/skills/meta/examples/supabase/workflows/rls-policies.md +244 -244
- package/skills/meta/examples/supabase/workflows/schema-design.md +321 -321
- package/skills/meta/file-todos/SKILL.md +88 -88
- package/skills/meta/mobile/SKILL.md +140 -140
- package/skills/meta/nextjs/SKILL.md +101 -101
- package/skills/meta/performance/SKILL.md +130 -130
- package/skills/meta/react-patterns/SKILL.md +83 -83
- package/skills/meta/security/SKILL.md +114 -114
- package/skills/meta/session-resume/SKILL.md +96 -96
- package/skills/meta/tailwind/SKILL.md +139 -139
- package/skills/meta/testing/SKILL.md +43 -43
- package/skills/meta/testing/references/vitest-patterns.md +45 -45
- package/skills/meta/testing/templates/component-test.template.tsx +37 -37
- package/skills/tech/alpha-vantage/SKILL.md +142 -142
- package/skills/tech/alpha-vantage/references/commodities.md +153 -153
- package/skills/tech/alpha-vantage/references/economic-indicators.md +158 -158
- package/skills/tech/alpha-vantage/references/forex-crypto.md +154 -154
- package/skills/tech/alpha-vantage/references/fundamentals.md +223 -223
- package/skills/tech/alpha-vantage/references/intelligence.md +138 -138
- package/skills/tech/alpha-vantage/references/options.md +93 -93
- package/skills/tech/alpha-vantage/references/technical-indicators.md +374 -374
- package/skills/tech/alpha-vantage/references/time-series.md +157 -157
- package/skills/tech/financial-modeling/SKILL.md +18 -18
- package/skills/tech/financial-modeling/skills/3-statements/SKILL.md +368 -368
- package/skills/tech/financial-modeling/skills/3-statements/references/formatting.md +118 -118
- package/skills/tech/financial-modeling/skills/3-statements/references/formulas.md +292 -292
- package/skills/tech/financial-modeling/skills/3-statements/references/sec-filings.md +125 -125
- package/skills/tech/financial-modeling/skills/dcf-model/SKILL.md +1210 -1210
- package/skills/tech/financial-modeling/skills/dcf-model/TROUBLESHOOTING.md +40 -40
- package/skills/tech/financial-modeling/skills/dcf-model/requirements.txt +8 -8
- package/skills/tech/financial-modeling/skills/dcf-model/scripts/validate_dcf.py +292 -292
- package/skills/tech/financial-modeling/skills/lbo-model/SKILL.md +236 -236
- package/skills/tech/financial-modeling/skills/merger-model/SKILL.md +108 -108
- package/skills/workflows/README.md +203 -203
- package/skills/workflows/adr.md +174 -174
- package/skills/workflows/changelog.md +74 -74
- package/skills/workflows/compound.md +323 -323
- package/skills/workflows/compound_health.md +74 -74
- package/skills/workflows/create-agent-skill.md +138 -138
- package/skills/workflows/cycle.md +144 -144
- package/skills/workflows/deploy-docs.md +84 -84
- package/skills/workflows/development-rules.md +42 -42
- package/skills/workflows/doc.md +95 -95
- package/skills/workflows/documentation-management.md +34 -34
- package/skills/workflows/explore.md +146 -146
- package/skills/workflows/generate_command.md +106 -106
- package/skills/workflows/heal-skill.md +97 -97
- package/skills/workflows/housekeeping.md +229 -229
- package/skills/workflows/kit-setup.md +102 -102
- package/skills/workflows/map-codebase.md +78 -78
- package/skills/workflows/orchestration-protocol.md +43 -43
- package/skills/workflows/plan-compound.md +439 -439
- package/skills/workflows/plan_review.md +269 -269
- package/skills/workflows/primary-workflow.md +37 -37
- package/skills/workflows/promote_pattern.md +86 -86
- package/skills/workflows/release-docs.md +82 -82
- package/skills/workflows/report-bug.md +135 -135
- package/skills/workflows/reproduce-bug.md +118 -118
- package/skills/workflows/resolve_pr.md +133 -133
- package/skills/workflows/resolve_todo.md +128 -128
- package/skills/workflows/review-compound.md +376 -376
- package/skills/workflows/skill-review.md +127 -127
- package/skills/workflows/specs.md +257 -257
- package/skills/workflows/triage-sprint.md +102 -102
- package/skills/workflows/triage.md +152 -152
- package/skills/workflows/work.md +399 -399
- package/skills/workflows/xcode-test.md +93 -93
package/commands/status.toml
CHANGED
|
@@ -1,23 +1,23 @@
|
|
|
1
|
-
description = "View project progress - specs, plans, todos, and compound health"
|
|
2
|
-
|
|
3
|
-
prompt = """
|
|
4
|
-
# 📊 Project Status
|
|
5
|
-
|
|
6
|
-
Loading status...
|
|
7
|
-
|
|
8
|
-
Call MCP `call_tool_session_manager` { command: "status" }
|
|
9
|
-
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
## Quick Actions
|
|
13
|
-
|
|
14
|
-
| Action | Command |
|
|
15
|
-
|--------|---------|
|
|
16
|
-
| View specs details | `ls docs/specs/` |
|
|
17
|
-
| View plans details | `ls plans/` |
|
|
18
|
-
| View todos details | `ls todos/` |
|
|
19
|
-
| Compound health | `Call MCP call_tool_compound_manager { action: "dashboard" }` |
|
|
20
|
-
| Housekeeping | `/housekeeping` |
|
|
21
|
-
|
|
22
|
-
What do you need to do next?
|
|
1
|
+
description = "View project progress - specs, plans, todos, and compound health"
|
|
2
|
+
|
|
3
|
+
prompt = """
|
|
4
|
+
# 📊 Project Status
|
|
5
|
+
|
|
6
|
+
Loading status...
|
|
7
|
+
|
|
8
|
+
Call MCP `call_tool_session_manager` { command: "status" }
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## Quick Actions
|
|
13
|
+
|
|
14
|
+
| Action | Command |
|
|
15
|
+
|--------|---------|
|
|
16
|
+
| View specs details | `ls docs/specs/` |
|
|
17
|
+
| View plans details | `ls plans/` |
|
|
18
|
+
| View todos details | `ls todos/` |
|
|
19
|
+
| Compound health | `Call MCP call_tool_compound_manager { action: "dashboard" }` |
|
|
20
|
+
| Housekeeping | `/housekeeping` |
|
|
21
|
+
|
|
22
|
+
What do you need to do next?
|
|
23
23
|
"""
|
package/commands/team.toml
CHANGED
|
@@ -1,56 +1,56 @@
|
|
|
1
|
-
# /team - Team Orchestration Command
|
|
2
|
-
# Manages AI team sessions for complex development workflows
|
|
3
|
-
|
|
4
|
-
description = "🤖 AI Team Orchestration - Start team sessions, run workflows, track progress"
|
|
5
|
-
|
|
6
|
-
prompt = """
|
|
7
|
-
# AI Team Orchestration
|
|
8
|
-
|
|
9
|
-
You are the Team Orchestrator for super-kit. Help the user manage AI team sessions.
|
|
10
|
-
|
|
11
|
-
## Command: /team {{args}}
|
|
12
|
-
|
|
13
|
-
### If {{args}} is empty:he arguments and execute the appropriate action:
|
|
14
|
-
|
|
15
|
-
### Actions:
|
|
16
|
-
|
|
17
|
-
**1. /team start <goal>** - Start new team session
|
|
18
|
-
- Call `kit_team_start` with the goal
|
|
19
|
-
- AI will suggest best workflow
|
|
20
|
-
|
|
21
|
-
**2. /team status** - Get current session status
|
|
22
|
-
- Call `kit_team_status`
|
|
23
|
-
|
|
24
|
-
**3. /team end** - End current session
|
|
25
|
-
- Call `kit_team_end`
|
|
26
|
-
|
|
27
|
-
**4. /team run <workflow> <task>** - Execute workflow
|
|
28
|
-
- Workflows: cook, quickfix, feature, refactor, review, tdd, docs
|
|
29
|
-
- Call `kit_run_workflow`
|
|
30
|
-
|
|
31
|
-
**5. /team route <task>** - Smart route to best workflow
|
|
32
|
-
- Call `kit_smart_route`
|
|
33
|
-
|
|
34
|
-
**6. /team list** - List all workflows
|
|
35
|
-
- Call `kit_list_workflows`
|
|
36
|
-
|
|
37
|
-
**7. /team history** - Show past sessions
|
|
38
|
-
- Call `kit_session_history`
|
|
39
|
-
|
|
40
|
-
## Workflow Types:
|
|
41
|
-
|
|
42
|
-
| Workflow | Description |
|
|
43
|
-
|----------|-------------|
|
|
44
|
-
| **cook** | Full cycle: Plan → Scout → Code → Test → Review |
|
|
45
|
-
| **quickfix** | Bug fix: Debug → Code → Test |
|
|
46
|
-
| **feature** | New feature: Design → Plan → Code → Test → Docs |
|
|
47
|
-
| **refactor** | Refactor: Scout → Plan → Code → Test → Review |
|
|
48
|
-
| **review** | Code review: Scout → Review → Security |
|
|
49
|
-
| **tdd** | Test-driven: Write tests → Implement → Verify |
|
|
50
|
-
| **docs** | Documentation: Scout → Analyze → Write → Review |
|
|
51
|
-
|
|
52
|
-
## User Command:
|
|
53
|
-
{{args}}
|
|
54
|
-
|
|
55
|
-
Execute the appropriate MCP tool based on the user's request.
|
|
56
|
-
"""
|
|
1
|
+
# /team - Team Orchestration Command
|
|
2
|
+
# Manages AI team sessions for complex development workflows
|
|
3
|
+
|
|
4
|
+
description = "🤖 AI Team Orchestration - Start team sessions, run workflows, track progress"
|
|
5
|
+
|
|
6
|
+
prompt = """
|
|
7
|
+
# AI Team Orchestration
|
|
8
|
+
|
|
9
|
+
You are the Team Orchestrator for super-kit. Help the user manage AI team sessions.
|
|
10
|
+
|
|
11
|
+
## Command: /team {{args}}
|
|
12
|
+
|
|
13
|
+
### If {{args}} is empty:he arguments and execute the appropriate action:
|
|
14
|
+
|
|
15
|
+
### Actions:
|
|
16
|
+
|
|
17
|
+
**1. /team start <goal>** - Start new team session
|
|
18
|
+
- Call `kit_team_start` with the goal
|
|
19
|
+
- AI will suggest best workflow
|
|
20
|
+
|
|
21
|
+
**2. /team status** - Get current session status
|
|
22
|
+
- Call `kit_team_status`
|
|
23
|
+
|
|
24
|
+
**3. /team end** - End current session
|
|
25
|
+
- Call `kit_team_end`
|
|
26
|
+
|
|
27
|
+
**4. /team run <workflow> <task>** - Execute workflow
|
|
28
|
+
- Workflows: cook, quickfix, feature, refactor, review, tdd, docs
|
|
29
|
+
- Call `kit_run_workflow`
|
|
30
|
+
|
|
31
|
+
**5. /team route <task>** - Smart route to best workflow
|
|
32
|
+
- Call `kit_smart_route`
|
|
33
|
+
|
|
34
|
+
**6. /team list** - List all workflows
|
|
35
|
+
- Call `kit_list_workflows`
|
|
36
|
+
|
|
37
|
+
**7. /team history** - Show past sessions
|
|
38
|
+
- Call `kit_session_history`
|
|
39
|
+
|
|
40
|
+
## Workflow Types:
|
|
41
|
+
|
|
42
|
+
| Workflow | Description |
|
|
43
|
+
|----------|-------------|
|
|
44
|
+
| **cook** | Full cycle: Plan → Scout → Code → Test → Review |
|
|
45
|
+
| **quickfix** | Bug fix: Debug → Code → Test |
|
|
46
|
+
| **feature** | New feature: Design → Plan → Code → Test → Docs |
|
|
47
|
+
| **refactor** | Refactor: Scout → Plan → Code → Test → Review |
|
|
48
|
+
| **review** | Code review: Scout → Review → Security |
|
|
49
|
+
| **tdd** | Test-driven: Write tests → Implement → Verify |
|
|
50
|
+
| **docs** | Documentation: Scout → Analyze → Write → Review |
|
|
51
|
+
|
|
52
|
+
## User Command:
|
|
53
|
+
{{args}}
|
|
54
|
+
|
|
55
|
+
Execute the appropriate MCP tool based on the user's request.
|
|
56
|
+
"""
|
package/commands/test.toml
CHANGED
|
@@ -1,165 +1,165 @@
|
|
|
1
|
-
description = "Create and run tests with coverage analysis (Tester Agent)"
|
|
2
|
-
|
|
3
|
-
prompt = """
|
|
4
|
-
# 🧪 TESTER AGENT
|
|
5
|
-
|
|
6
|
-
Test request:
|
|
7
|
-
|
|
8
|
-
**Task:** {{args}}
|
|
9
|
-
|
|
10
|
-
## MODE DETECTION
|
|
11
|
-
|
|
12
|
-
| Mode | Trigger | Description |
|
|
13
|
-
|------|---------|-------|
|
|
14
|
-
| **RUN** | default | Run full test suite |
|
|
15
|
-
| **FIX** | "fix", "failing", "broken" | Auto-fix failing tests |
|
|
16
|
-
| **COVERAGE** | "coverage", "gaps" | Analyze coverage gaps |
|
|
17
|
-
| **WRITE** | "write", "create", "add" | Generate new tests |
|
|
18
|
-
|
|
19
|
-
---
|
|
20
|
-
|
|
21
|
-
## FRAMEWORK DETECTION
|
|
22
|
-
Automatically detect and run according to the project:
|
|
23
|
-
|
|
24
|
-
| Framework | Detection | Command |
|
|
25
|
-
|-----------|-----------|---------|
|
|
26
|
-
| **Jest** | package.json has jest | `npm test` |
|
|
27
|
-
| **Vitest** | vitest.config.* | `npm run test` |
|
|
28
|
-
| **pytest** | pytest.ini / pyproject.toml | `pytest -v` |
|
|
29
|
-
| **Flutter** | pubspec.yaml | `flutter test` |
|
|
30
|
-
| **Go** | go.mod | `go test ./...` |
|
|
31
|
-
|
|
32
|
-
---
|
|
33
|
-
|
|
34
|
-
## RUN MODE (Default)
|
|
35
|
-
|
|
36
|
-
### 1. Detect Framework
|
|
37
|
-
```bash
|
|
38
|
-
# Auto-detected: [framework]
|
|
39
|
-
[test command]
|
|
40
|
-
```
|
|
41
|
-
|
|
42
|
-
### 2. Coverage Report
|
|
43
|
-
| Metric | Value | Default Target | Critical Code Target |
|
|
44
|
-
|--------|-------|----------------|---------------------|
|
|
45
|
-
| Statements | X% | 80% | 90% |
|
|
46
|
-
| Branches | X% | 75% | 85% |
|
|
47
|
-
| Functions | X% | 80% | 90% |
|
|
48
|
-
| Lines | X% | 80% | 90% |
|
|
49
|
-
|
|
50
|
-
**Target Guidelines:**
|
|
51
|
-
- **Standard code:** 80%
|
|
52
|
-
- **Payment/Finance:** 90%+
|
|
53
|
-
- **Security/Auth:** 90%+
|
|
54
|
-
- **Core business logic:** 85%+
|
|
55
|
-
- **UI components:** 60-70%
|
|
56
|
-
|
|
57
|
-
### 3. Test Results
|
|
58
|
-
```
|
|
59
|
-
✅ Passed: X tests
|
|
60
|
-
❌ Failed: Y tests
|
|
61
|
-
⏭️ Skipped: Z tests
|
|
62
|
-
⏱️ Duration: Xs
|
|
63
|
-
```
|
|
64
|
-
|
|
65
|
-
### 4. Coverage Gaps
|
|
66
|
-
⚠️ **Uncovered areas:**
|
|
67
|
-
- `src/file.ts` lines 45-52
|
|
68
|
-
- `src/other.ts` function `handleError`
|
|
69
|
-
|
|
70
|
-
---
|
|
71
|
-
|
|
72
|
-
## FIX MODE
|
|
73
|
-
When there are failing tests:
|
|
74
|
-
|
|
75
|
-
### Failed Test Analysis
|
|
76
|
-
```
|
|
77
|
-
Test: [test name]
|
|
78
|
-
Error: [error message]
|
|
79
|
-
File: [file:line]
|
|
80
|
-
```
|
|
81
|
-
|
|
82
|
-
### Root Cause
|
|
83
|
-
[Why it fails]
|
|
84
|
-
|
|
85
|
-
### Fix
|
|
86
|
-
```typescript
|
|
87
|
-
// Before
|
|
88
|
-
[old code]
|
|
89
|
-
|
|
90
|
-
// After
|
|
91
|
-
[fixed code]
|
|
92
|
-
```
|
|
93
|
-
|
|
94
|
-
---
|
|
95
|
-
|
|
96
|
-
## COVERAGE MODE
|
|
97
|
-
|
|
98
|
-
### Gap Analysis
|
|
99
|
-
| File | Coverage | Missing |
|
|
100
|
-
|------|----------|---------|
|
|
101
|
-
| `file.ts` | 65% | Lines 10-15, 45-50 |
|
|
102
|
-
| `util.ts` | 45% | Functions: parse, validate |
|
|
103
|
-
|
|
104
|
-
### Recommendations
|
|
105
|
-
1. Add test for `[function]`
|
|
106
|
-
2. Cover edge case: `[scenario]`
|
|
107
|
-
|
|
108
|
-
---
|
|
109
|
-
|
|
110
|
-
## WRITE MODE
|
|
111
|
-
Generate tests for:
|
|
112
|
-
|
|
113
|
-
### Test File Structure
|
|
114
|
-
```typescript
|
|
115
|
-
describe('[Component/Function]', () => {
|
|
116
|
-
describe('[Method]', () => {
|
|
117
|
-
it('should [expected behavior]', () => {
|
|
118
|
-
// Arrange
|
|
119
|
-
// Act
|
|
120
|
-
// Assert
|
|
121
|
-
});
|
|
122
|
-
|
|
123
|
-
it('should handle [edge case]', () => {
|
|
124
|
-
// Test edge case
|
|
125
|
-
});
|
|
126
|
-
|
|
127
|
-
it('should throw on [error condition]', () => {
|
|
128
|
-
// Test error handling
|
|
129
|
-
});
|
|
130
|
-
});
|
|
131
|
-
});
|
|
132
|
-
```
|
|
133
|
-
|
|
134
|
-
---
|
|
135
|
-
|
|
136
|
-
## CI/CD JSON OUTPUT
|
|
137
|
-
```json
|
|
138
|
-
{
|
|
139
|
-
"passed": 42,
|
|
140
|
-
"failed": 0,
|
|
141
|
-
"skipped": 2,
|
|
142
|
-
"coverage": 85.5,
|
|
143
|
-
"duration": "12.3s",
|
|
144
|
-
"timestamp": "2024-12-14T19:00:00Z"
|
|
145
|
-
}
|
|
146
|
-
```
|
|
147
|
-
|
|
148
|
-
---
|
|
149
|
-
|
|
150
|
-
## PRO TIPS
|
|
151
|
-
- **80%+ on critical paths** - no need for 100%
|
|
152
|
-
- **Zero flaky tests** - better to remove than keep flaky
|
|
153
|
-
- **Fail fast** - run `/test` before starting new work
|
|
154
|
-
- **>60s = optimize** - slow tests need attention
|
|
155
|
-
|
|
156
|
-
> **Key Takeaway:** Test execution isn't about 100% coverage - it's about 80%+ on critical paths with zero flaky tests.
|
|
157
|
-
"""
|
|
158
|
-
|
|
159
|
-
# ---
|
|
160
|
-
# USAGE:
|
|
161
|
-
# /test - Run all tests
|
|
162
|
-
# /test fix auth tests - Fix failing auth tests
|
|
163
|
-
# /test coverage gaps - Find untested code
|
|
164
|
-
# /test write UserService - Generate tests for UserService
|
|
1
|
+
description = "Create and run tests with coverage analysis (Tester Agent)"
|
|
2
|
+
|
|
3
|
+
prompt = """
|
|
4
|
+
# 🧪 TESTER AGENT
|
|
5
|
+
|
|
6
|
+
Test request:
|
|
7
|
+
|
|
8
|
+
**Task:** {{args}}
|
|
9
|
+
|
|
10
|
+
## MODE DETECTION
|
|
11
|
+
|
|
12
|
+
| Mode | Trigger | Description |
|
|
13
|
+
|------|---------|-------|
|
|
14
|
+
| **RUN** | default | Run full test suite |
|
|
15
|
+
| **FIX** | "fix", "failing", "broken" | Auto-fix failing tests |
|
|
16
|
+
| **COVERAGE** | "coverage", "gaps" | Analyze coverage gaps |
|
|
17
|
+
| **WRITE** | "write", "create", "add" | Generate new tests |
|
|
18
|
+
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
## FRAMEWORK DETECTION
|
|
22
|
+
Automatically detect and run according to the project:
|
|
23
|
+
|
|
24
|
+
| Framework | Detection | Command |
|
|
25
|
+
|-----------|-----------|---------|
|
|
26
|
+
| **Jest** | package.json has jest | `npm test` |
|
|
27
|
+
| **Vitest** | vitest.config.* | `npm run test` |
|
|
28
|
+
| **pytest** | pytest.ini / pyproject.toml | `pytest -v` |
|
|
29
|
+
| **Flutter** | pubspec.yaml | `flutter test` |
|
|
30
|
+
| **Go** | go.mod | `go test ./...` |
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## RUN MODE (Default)
|
|
35
|
+
|
|
36
|
+
### 1. Detect Framework
|
|
37
|
+
```bash
|
|
38
|
+
# Auto-detected: [framework]
|
|
39
|
+
[test command]
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
### 2. Coverage Report
|
|
43
|
+
| Metric | Value | Default Target | Critical Code Target |
|
|
44
|
+
|--------|-------|----------------|---------------------|
|
|
45
|
+
| Statements | X% | 80% | 90% |
|
|
46
|
+
| Branches | X% | 75% | 85% |
|
|
47
|
+
| Functions | X% | 80% | 90% |
|
|
48
|
+
| Lines | X% | 80% | 90% |
|
|
49
|
+
|
|
50
|
+
**Target Guidelines:**
|
|
51
|
+
- **Standard code:** 80%
|
|
52
|
+
- **Payment/Finance:** 90%+
|
|
53
|
+
- **Security/Auth:** 90%+
|
|
54
|
+
- **Core business logic:** 85%+
|
|
55
|
+
- **UI components:** 60-70%
|
|
56
|
+
|
|
57
|
+
### 3. Test Results
|
|
58
|
+
```
|
|
59
|
+
✅ Passed: X tests
|
|
60
|
+
❌ Failed: Y tests
|
|
61
|
+
⏭️ Skipped: Z tests
|
|
62
|
+
⏱️ Duration: Xs
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
### 4. Coverage Gaps
|
|
66
|
+
⚠️ **Uncovered areas:**
|
|
67
|
+
- `src/file.ts` lines 45-52
|
|
68
|
+
- `src/other.ts` function `handleError`
|
|
69
|
+
|
|
70
|
+
---
|
|
71
|
+
|
|
72
|
+
## FIX MODE
|
|
73
|
+
When there are failing tests:
|
|
74
|
+
|
|
75
|
+
### Failed Test Analysis
|
|
76
|
+
```
|
|
77
|
+
Test: [test name]
|
|
78
|
+
Error: [error message]
|
|
79
|
+
File: [file:line]
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
### Root Cause
|
|
83
|
+
[Why it fails]
|
|
84
|
+
|
|
85
|
+
### Fix
|
|
86
|
+
```typescript
|
|
87
|
+
// Before
|
|
88
|
+
[old code]
|
|
89
|
+
|
|
90
|
+
// After
|
|
91
|
+
[fixed code]
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
## COVERAGE MODE
|
|
97
|
+
|
|
98
|
+
### Gap Analysis
|
|
99
|
+
| File | Coverage | Missing |
|
|
100
|
+
|------|----------|---------|
|
|
101
|
+
| `file.ts` | 65% | Lines 10-15, 45-50 |
|
|
102
|
+
| `util.ts` | 45% | Functions: parse, validate |
|
|
103
|
+
|
|
104
|
+
### Recommendations
|
|
105
|
+
1. Add test for `[function]`
|
|
106
|
+
2. Cover edge case: `[scenario]`
|
|
107
|
+
|
|
108
|
+
---
|
|
109
|
+
|
|
110
|
+
## WRITE MODE
|
|
111
|
+
Generate tests for:
|
|
112
|
+
|
|
113
|
+
### Test File Structure
|
|
114
|
+
```typescript
|
|
115
|
+
describe('[Component/Function]', () => {
|
|
116
|
+
describe('[Method]', () => {
|
|
117
|
+
it('should [expected behavior]', () => {
|
|
118
|
+
// Arrange
|
|
119
|
+
// Act
|
|
120
|
+
// Assert
|
|
121
|
+
});
|
|
122
|
+
|
|
123
|
+
it('should handle [edge case]', () => {
|
|
124
|
+
// Test edge case
|
|
125
|
+
});
|
|
126
|
+
|
|
127
|
+
it('should throw on [error condition]', () => {
|
|
128
|
+
// Test error handling
|
|
129
|
+
});
|
|
130
|
+
});
|
|
131
|
+
});
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
---
|
|
135
|
+
|
|
136
|
+
## CI/CD JSON OUTPUT
|
|
137
|
+
```json
|
|
138
|
+
{
|
|
139
|
+
"passed": 42,
|
|
140
|
+
"failed": 0,
|
|
141
|
+
"skipped": 2,
|
|
142
|
+
"coverage": 85.5,
|
|
143
|
+
"duration": "12.3s",
|
|
144
|
+
"timestamp": "2024-12-14T19:00:00Z"
|
|
145
|
+
}
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
---
|
|
149
|
+
|
|
150
|
+
## PRO TIPS
|
|
151
|
+
- **80%+ on critical paths** - no need for 100%
|
|
152
|
+
- **Zero flaky tests** - better to remove than keep flaky
|
|
153
|
+
- **Fail fast** - run `/test` before starting new work
|
|
154
|
+
- **>60s = optimize** - slow tests need attention
|
|
155
|
+
|
|
156
|
+
> **Key Takeaway:** Test execution isn't about 100% coverage - it's about 80%+ on critical paths with zero flaky tests.
|
|
157
|
+
"""
|
|
158
|
+
|
|
159
|
+
# ---
|
|
160
|
+
# USAGE:
|
|
161
|
+
# /test - Run all tests
|
|
162
|
+
# /test fix auth tests - Fix failing auth tests
|
|
163
|
+
# /test coverage gaps - Find untested code
|
|
164
|
+
# /test write UserService - Generate tests for UserService
|
|
165
165
|
# ---
|
package/commands/ticket.toml
CHANGED
|
@@ -1,71 +1,71 @@
|
|
|
1
|
-
description = "Read ticket from Jira/Linear and start workflow"
|
|
2
|
-
|
|
3
|
-
prompt = """
|
|
4
|
-
# 🎫 Ticket Agent
|
|
5
|
-
|
|
6
|
-
Read and process ticket.
|
|
7
|
-
|
|
8
|
-
**Ticket ID:** {{args}}
|
|
9
|
-
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
## Workflow
|
|
13
|
-
|
|
14
|
-
### Step 1: Get Ticket
|
|
15
|
-
Use the `kit_jira_get_ticket` tool to get information:
|
|
16
|
-
- Title, description
|
|
17
|
-
- Status, priority
|
|
18
|
-
- Assignee, reporter
|
|
19
|
-
- Labels, components
|
|
20
|
-
|
|
21
|
-
### Step 2: Analyze Requirements
|
|
22
|
-
Analyze ticket:
|
|
23
|
-
- Understand primary requirements
|
|
24
|
-
- Determine scope
|
|
25
|
-
- List acceptance criteria
|
|
26
|
-
|
|
27
|
-
### Step 3: Create Branch
|
|
28
|
-
Create branch from ticket ID:
|
|
29
|
-
```bash
|
|
30
|
-
git checkout -b feature/[TICKET-ID]-[short-description]
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
### Step 4: Start Workflow
|
|
34
|
-
Propose next steps:
|
|
35
|
-
- Run `/plan` to create plan
|
|
36
|
-
- Or `/cook` to start immediately
|
|
37
|
-
|
|
38
|
-
---
|
|
39
|
-
|
|
40
|
-
## Output Format
|
|
41
|
-
|
|
42
|
-
```markdown
|
|
43
|
-
## 🎫 Ticket: [TICKET-ID]
|
|
44
|
-
|
|
45
|
-
### Summary
|
|
46
|
-
[Title]
|
|
47
|
-
|
|
48
|
-
### Description
|
|
49
|
-
[Description]
|
|
50
|
-
|
|
51
|
-
### Details
|
|
52
|
-
- **Status:** [status]
|
|
53
|
-
- **Priority:** [priority]
|
|
54
|
-
- **Assignee:** [assignee]
|
|
55
|
-
|
|
56
|
-
### Acceptance Criteria
|
|
57
|
-
- [ ] Criteria 1
|
|
58
|
-
- [ ] Criteria 2
|
|
59
|
-
|
|
60
|
-
### 🚀 Next Steps
|
|
61
|
-
1. Branch created: feature/[TICKET-ID]-...
|
|
62
|
-
2. Run `/plan [ticket summary]` to start
|
|
63
|
-
```
|
|
64
|
-
|
|
65
|
-
---
|
|
66
|
-
|
|
67
|
-
## Supported Platforms
|
|
68
|
-
- Jira (JIRA-123)
|
|
69
|
-
- Linear (LIN-123)
|
|
70
|
-
- GitHub Issues (#123)
|
|
1
|
+
description = "Read ticket from Jira/Linear and start workflow"
|
|
2
|
+
|
|
3
|
+
prompt = """
|
|
4
|
+
# 🎫 Ticket Agent
|
|
5
|
+
|
|
6
|
+
Read and process ticket.
|
|
7
|
+
|
|
8
|
+
**Ticket ID:** {{args}}
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## Workflow
|
|
13
|
+
|
|
14
|
+
### Step 1: Get Ticket
|
|
15
|
+
Use the `kit_jira_get_ticket` tool to get information:
|
|
16
|
+
- Title, description
|
|
17
|
+
- Status, priority
|
|
18
|
+
- Assignee, reporter
|
|
19
|
+
- Labels, components
|
|
20
|
+
|
|
21
|
+
### Step 2: Analyze Requirements
|
|
22
|
+
Analyze ticket:
|
|
23
|
+
- Understand primary requirements
|
|
24
|
+
- Determine scope
|
|
25
|
+
- List acceptance criteria
|
|
26
|
+
|
|
27
|
+
### Step 3: Create Branch
|
|
28
|
+
Create branch from ticket ID:
|
|
29
|
+
```bash
|
|
30
|
+
git checkout -b feature/[TICKET-ID]-[short-description]
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
### Step 4: Start Workflow
|
|
34
|
+
Propose next steps:
|
|
35
|
+
- Run `/plan` to create plan
|
|
36
|
+
- Or `/cook` to start immediately
|
|
37
|
+
|
|
38
|
+
---
|
|
39
|
+
|
|
40
|
+
## Output Format
|
|
41
|
+
|
|
42
|
+
```markdown
|
|
43
|
+
## 🎫 Ticket: [TICKET-ID]
|
|
44
|
+
|
|
45
|
+
### Summary
|
|
46
|
+
[Title]
|
|
47
|
+
|
|
48
|
+
### Description
|
|
49
|
+
[Description]
|
|
50
|
+
|
|
51
|
+
### Details
|
|
52
|
+
- **Status:** [status]
|
|
53
|
+
- **Priority:** [priority]
|
|
54
|
+
- **Assignee:** [assignee]
|
|
55
|
+
|
|
56
|
+
### Acceptance Criteria
|
|
57
|
+
- [ ] Criteria 1
|
|
58
|
+
- [ ] Criteria 2
|
|
59
|
+
|
|
60
|
+
### 🚀 Next Steps
|
|
61
|
+
1. Branch created: feature/[TICKET-ID]-...
|
|
62
|
+
2. Run `/plan [ticket summary]` to start
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
---
|
|
66
|
+
|
|
67
|
+
## Supported Platforms
|
|
68
|
+
- Jira (JIRA-123)
|
|
69
|
+
- Linear (LIN-123)
|
|
70
|
+
- GitHub Issues (#123)
|
|
71
71
|
"""
|