Initial commit
This commit is contained in:
Zhongwei Li
292
commands/suggest.md
Normal file
292
commands/suggest.md
Normal file
@@ -0,0 +1,292 @@
|
||||
---
|
||||
description: AI-powered workflow recommendation based on context analysis
|
||||
---
|
||||
|
||||
## User Input
|
||||
|
||||
```text
|
||||
$ARGUMENTS
|
||||
```
|
||||
|
||||
## Goal
|
||||
|
||||
Analyze current context (branch name, commits, file changes, user description) and recommend the most appropriate workflow.
|
||||
|
||||
---
|
||||
|
||||
## Execution Steps
|
||||
|
||||
### 1. Gather Context
|
||||
|
||||
```bash
|
||||
echo "🤖 Workflow Suggestion - Analyzing Context..."
|
||||
|
||||
# Branch name
|
||||
CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null)
|
||||
|
||||
# Recent commits
|
||||
RECENT_COMMITS=$(git log -5 --oneline 2>/dev/null)
|
||||
|
||||
# Changed files
|
||||
CHANGED_FILES=$(git diff --name-only HEAD~5..HEAD 2>/dev/null)
|
||||
|
||||
# Uncommitted changes
|
||||
UNCOMMITTED=$(git status --porcelain 2>/dev/null | head -10)
|
||||
|
||||
# User description (if provided)
|
||||
USER_DESCRIPTION=$ARGUMENTS
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 2. Analyze Patterns
|
||||
|
||||
**Branch Name Analysis:**
|
||||
```bash
|
||||
if [[ "$CURRENT_BRANCH" =~ ^feature/ ]]; then
|
||||
PATTERN_SCORE["feature"]=5
|
||||
elif [[ "$CURRENT_BRANCH" =~ ^bugfix/ ]]; then
|
||||
PATTERN_SCORE["bugfix"]=10
|
||||
elif [[ "$CURRENT_BRANCH" =~ ^modify/ ]]; then
|
||||
PATTERN_SCORE["modify"]=10
|
||||
elif [[ "$CURRENT_BRANCH" =~ ^hotfix/ ]]; then
|
||||
PATTERN_SCORE["hotfix"]=10
|
||||
elif [[ "$CURRENT_BRANCH" =~ ^refactor/ ]]; then
|
||||
PATTERN_SCORE["refactor"]=10
|
||||
elif [[ "$CURRENT_BRANCH" =~ ^deprecate/ ]]; then
|
||||
PATTERN_SCORE["deprecate"]=10
|
||||
fi
|
||||
```
|
||||
|
||||
**Commit Message Analysis:**
|
||||
```bash
|
||||
# Look for keywords in commits
|
||||
if echo "$RECENT_COMMITS" | grep -qi "fix\|bug\|issue"; then
|
||||
PATTERN_SCORE["bugfix"]+=3
|
||||
fi
|
||||
|
||||
if echo "$RECENT_COMMITS" | grep -qi "refactor\|cleanup\|improve"; then
|
||||
PATTERN_SCORE["refactor"]+=3
|
||||
fi
|
||||
|
||||
if echo "$RECENT_COMMITS" | grep -qi "hotfix\|emergency\|critical"; then
|
||||
PATTERN_SCORE["hotfix"]+=5
|
||||
fi
|
||||
|
||||
if echo "$RECENT_COMMITS" | grep -qi "deprecate\|remove\|sunset"; then
|
||||
PATTERN_SCORE["deprecate"]+=3
|
||||
fi
|
||||
|
||||
if echo "$RECENT_COMMITS" | grep -qi "modify\|update\|change"; then
|
||||
PATTERN_SCORE["modify"]+=2
|
||||
fi
|
||||
```
|
||||
|
||||
**File Change Analysis:**
|
||||
```bash
|
||||
# Analyze changed files
|
||||
FILE_COUNT=$(echo "$CHANGED_FILES" | wc -l)
|
||||
|
||||
if [ "$FILE_COUNT" -gt 10 ]; then
|
||||
# Many files changed - likely refactor or major modify
|
||||
PATTERN_SCORE["refactor"]+=2
|
||||
PATTERN_SCORE["modify"]+=2
|
||||
fi
|
||||
|
||||
# Check for test file changes
|
||||
if echo "$CHANGED_FILES" | grep -qi "test\|spec"; then
|
||||
PATTERN_SCORE["bugfix"]+=1 # Tests often accompany bug fixes
|
||||
fi
|
||||
```
|
||||
|
||||
**User Description Analysis:**
|
||||
```bash
|
||||
if [ -n "$USER_DESCRIPTION" ]; then
|
||||
# Analyze user description for keywords
|
||||
if echo "$USER_DESCRIPTION" | grep -qi "bug\|fix\|broken\|not working"; then
|
||||
PATTERN_SCORE["bugfix"]+=5
|
||||
fi
|
||||
|
||||
if echo "$USER_DESCRIPTION" | grep -qi "emergency\|critical\|urgent\|hotfix\|down"; then
|
||||
PATTERN_SCORE["hotfix"]+=7
|
||||
fi
|
||||
|
||||
if echo "$USER_DESCRIPTION" | grep -qi "refactor\|clean\|improve quality"; then
|
||||
PATTERN_SCORE["refactor"]+=5
|
||||
fi
|
||||
|
||||
if echo "$USER_DESCRIPTION" | grep -qi "modify\|change\|update\|add to"; then
|
||||
PATTERN_SCORE["modify"]+=5
|
||||
fi
|
||||
|
||||
if echo "$USER_DESCRIPTION" | grep -qi "deprecate\|remove\|sunset\|phase out"; then
|
||||
PATTERN_SCORE["deprecate"]+=5
|
||||
fi
|
||||
fi
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 3. Generate Recommendations
|
||||
|
||||
```markdown
|
||||
# Workflow Recommendation
|
||||
|
||||
**Analysis Date**: YYYY-MM-DD
|
||||
|
||||
---
|
||||
|
||||
## Context Analysis
|
||||
|
||||
**Branch**: ${CURRENT_BRANCH}
|
||||
|
||||
**Recent Activity**:
|
||||
- Commits analyzed: [N]
|
||||
- Files changed: [N]
|
||||
- Keywords found: [list]
|
||||
|
||||
**User Description**: ${USER_DESCRIPTION}
|
||||
|
||||
---
|
||||
|
||||
## Pattern Scores
|
||||
|
||||
| Workflow | Score | Confidence |
|
||||
|----------|-------|------------|
|
||||
| Bugfix | [N] | [High/Med/Low] |
|
||||
| Modify | [N] | [High/Med/Low] |
|
||||
| Hotfix | [N] | [High/Med/Low] |
|
||||
| Refactor | [N] | [High/Med/Low] |
|
||||
| Deprecate | [N] | [High/Med/Low] |
|
||||
| Feature (SpecSwarm/SpecTest) | [N] | [High/Med/Low] |
|
||||
|
||||
---
|
||||
|
||||
## Recommendation
|
||||
|
||||
### 🎯 Primary Recommendation: `/specswarm:[workflow]`
|
||||
|
||||
**Confidence**: [High/Medium/Low]
|
||||
|
||||
**Reasoning**:
|
||||
1. [Reason 1 - evidence from branch/commits/files]
|
||||
2. [Reason 2]
|
||||
3. [Reason 3]
|
||||
|
||||
**Why This Workflow**:
|
||||
[Description of why this workflow fits]
|
||||
|
||||
**Expected Outcome**:
|
||||
- [Outcome 1]
|
||||
- [Outcome 2]
|
||||
|
||||
---
|
||||
|
||||
## Alternative Workflows
|
||||
|
||||
### Alternative 1: `/specswarm:[workflow2]`
|
||||
**Confidence**: [Medium/Low]
|
||||
**When to Use**: [Scenario where this would be better]
|
||||
|
||||
### Alternative 2: `/specswarm:[workflow3]`
|
||||
**Confidence**: [Medium/Low]
|
||||
**When to Use**: [Scenario where this would be better]
|
||||
|
||||
---
|
||||
|
||||
## Not Recommended
|
||||
|
||||
**Feature Development** → Use `/specswarm:*` workflows
|
||||
**Reason**: [If feature development detected, redirect to appropriate plugin]
|
||||
|
||||
---
|
||||
|
||||
## Next Steps
|
||||
|
||||
1. **Review recommendation** above
|
||||
2. **Run recommended workflow**: `/specswarm:[workflow]`
|
||||
3. **If uncertain**, provide more context: `/specswarm:suggest "more details here"`
|
||||
|
||||
**Command to run**:
|
||||
```
|
||||
/specswarm:[recommended_workflow]
|
||||
```
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 4. Output Recommendation
|
||||
|
||||
```
|
||||
🤖 Workflow Suggestion Complete
|
||||
|
||||
🎯 Recommended Workflow: /specswarm:[workflow]
|
||||
Confidence: [High/Medium/Low]
|
||||
|
||||
📊 Analysis:
|
||||
- Branch pattern: [detected pattern]
|
||||
- Commit keywords: [list]
|
||||
- Files changed: [N]
|
||||
- User signals: [description analysis]
|
||||
|
||||
📋 Full analysis (above)
|
||||
|
||||
⚡ Quick Start:
|
||||
/specswarm:[recommended_workflow]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Example Output
|
||||
|
||||
```
|
||||
🤖 Workflow Suggestion Complete
|
||||
|
||||
🎯 Recommended Workflow: /specswarm:bugfix
|
||||
Confidence: High
|
||||
|
||||
📊 Analysis:
|
||||
- Branch pattern: bugfix/042-login-timeout
|
||||
- Commit keywords: "fix", "bug", "timeout issue"
|
||||
- Files changed: 3 (auth, tests)
|
||||
- User signals: "login not working"
|
||||
|
||||
Reasoning:
|
||||
1. Branch name explicitly indicates bugfix
|
||||
2. Commit messages contain bug-fix keywords
|
||||
3. User description indicates broken functionality
|
||||
4. Test files modified (typical of bugfix workflow)
|
||||
|
||||
⚡ Quick Start:
|
||||
/speclab:bugfix
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Decision Logic
|
||||
|
||||
**High Confidence (score ≥ 10)**:
|
||||
- Clear indicators from multiple sources
|
||||
- Strong pattern match
|
||||
- Recommend with confidence
|
||||
|
||||
**Medium Confidence (score 5-9)**:
|
||||
- Some indicators present
|
||||
- Moderate pattern match
|
||||
- Offer alternatives
|
||||
|
||||
**Low Confidence (score < 5)**:
|
||||
- Weak or conflicting signals
|
||||
- Suggest multiple options
|
||||
- Ask for more context
|
||||
|
||||
---
|
||||
|
||||
## Success Criteria
|
||||
|
||||
✅ Context gathered from git history
|
||||
✅ Patterns analyzed (branch, commits, files, description)
|
||||
✅ Scores calculated for each workflow
|
||||
✅ Primary recommendation provided
|
||||
✅ Alternative workflows suggested
|
||||
✅ Next steps clear
|
||||
Reference in New Issue
Block a user