[2.5.0] Add /report-bug command for plugin bug reporting
- New slash command that guides users through structured bug reporting - Collects bug category, component, actual vs expected behavior, repro steps - Auto-gathers environment info (plugin version, Claude Code version, OS) - Creates GitHub issues in EveryInc/every-marketplace via gh CLI - Includes privacy notice and error handling 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Kieran Klaassen
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "compounding-engineering",
|
||||
"version": "2.4.1",
|
||||
"description": "AI-powered development tools. 24 agents, 15 commands, 11 skills, 2 MCP servers for code review, research, design, and workflow automation.",
|
||||
"version": "2.5.0",
|
||||
"description": "AI-powered development tools. 24 agents, 16 commands, 11 skills, 2 MCP servers for code review, research, design, and workflow automation.",
|
||||
"author": {
|
||||
"name": "Kieran Klaassen",
|
||||
"email": "kieran@every.to",
|
||||
|
||||
@@ -5,6 +5,12 @@ All notable changes to the compounding-engineering plugin will be documented in
|
||||
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
||||
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
||||
|
||||
## [2.5.0] - 2024-11-25
|
||||
|
||||
### Added
|
||||
|
||||
- **`/report-bug` command** - New slash command for reporting bugs in the compounding-engineering plugin. Provides a structured workflow that gathers bug information through guided questions, collects environment details automatically, and creates a GitHub issue in the EveryInc/every-marketplace repository. Designed to be user-friendly for anyone using the plugin.
|
||||
|
||||
## [2.4.1] - 2024-11-24
|
||||
|
||||
### Improved
|
||||
|
||||
@@ -7,7 +7,7 @@ AI-powered development tools that get smarter with every use. Make each unit of
|
||||
| Component | Count |
|
||||
|-----------|-------|
|
||||
| Agents | 24 |
|
||||
| Commands | 15 |
|
||||
| Commands | 16 |
|
||||
| Skills | 11 |
|
||||
| MCP Servers | 2 |
|
||||
|
||||
@@ -87,6 +87,7 @@ Access via `/workflows:command`:
|
||||
| `/heal-skill` | Fix skill documentation issues |
|
||||
| `/plan_review` | Multi-agent plan review in parallel |
|
||||
| `/prime` | Prime/setup command |
|
||||
| `/report-bug` | Report a bug in the compounding-engineering plugin |
|
||||
| `/reproduce-bug` | Reproduce bugs using logs and console |
|
||||
| `/resolve_parallel` | Resolve TODO comments in parallel |
|
||||
| `/resolve_pr_parallel` | Resolve PR comments in parallel |
|
||||
|
||||
150
plugins/compounding-engineering/commands/report-bug.md
Normal file
150
plugins/compounding-engineering/commands/report-bug.md
Normal file
@@ -0,0 +1,150 @@
|
||||
---
|
||||
name: report-bug
|
||||
description: Report a bug in the compounding-engineering plugin
|
||||
argument-hint: "[optional: brief description of the bug]"
|
||||
---
|
||||
|
||||
# Report a Compounding Engineering Plugin Bug
|
||||
|
||||
Report bugs encountered while using the compounding-engineering plugin. This command gathers structured information and creates a GitHub issue for the maintainer.
|
||||
|
||||
## Step 1: Gather Bug Information
|
||||
|
||||
Use the AskUserQuestion tool to collect the following information:
|
||||
|
||||
**Question 1: Bug Category**
|
||||
- What type of issue are you experiencing?
|
||||
- Options: Agent not working, Command not working, Skill not working, MCP server issue, Installation problem, Other
|
||||
|
||||
**Question 2: Specific Component**
|
||||
- Which specific component is affected?
|
||||
- Ask for the name of the agent, command, skill, or MCP server
|
||||
|
||||
**Question 3: What Happened (Actual Behavior)**
|
||||
- Ask: "What happened when you used this component?"
|
||||
- Get a clear description of the actual behavior
|
||||
|
||||
**Question 4: What Should Have Happened (Expected Behavior)**
|
||||
- Ask: "What did you expect to happen instead?"
|
||||
- Get a clear description of expected behavior
|
||||
|
||||
**Question 5: Steps to Reproduce**
|
||||
- Ask: "What steps did you take before the bug occurred?"
|
||||
- Get reproduction steps
|
||||
|
||||
**Question 6: Error Messages**
|
||||
- Ask: "Did you see any error messages? If so, please share them."
|
||||
- Capture any error output
|
||||
|
||||
## Step 2: Collect Environment Information
|
||||
|
||||
Automatically gather:
|
||||
```bash
|
||||
# Get plugin version
|
||||
cat ~/.claude/plugins/installed_plugins.json 2>/dev/null | grep -A5 "compounding-engineering" | head -10 || echo "Plugin info not found"
|
||||
|
||||
# Get Claude Code version
|
||||
claude --version 2>/dev/null || echo "Claude CLI version unknown"
|
||||
|
||||
# Get OS info
|
||||
uname -a
|
||||
```
|
||||
|
||||
## Step 3: Format the Bug Report
|
||||
|
||||
Create a well-structured bug report with:
|
||||
|
||||
```markdown
|
||||
## Bug Description
|
||||
|
||||
**Component:** [Type] - [Name]
|
||||
**Summary:** [Brief description from argument or collected info]
|
||||
|
||||
## Environment
|
||||
|
||||
- **Plugin Version:** [from installed_plugins.json]
|
||||
- **Claude Code Version:** [from claude --version]
|
||||
- **OS:** [from uname]
|
||||
|
||||
## What Happened
|
||||
|
||||
[Actual behavior description]
|
||||
|
||||
## Expected Behavior
|
||||
|
||||
[Expected behavior description]
|
||||
|
||||
## Steps to Reproduce
|
||||
|
||||
1. [Step 1]
|
||||
2. [Step 2]
|
||||
3. [Step 3]
|
||||
|
||||
## Error Messages
|
||||
|
||||
```
|
||||
[Any error output]
|
||||
```
|
||||
|
||||
## Additional Context
|
||||
|
||||
[Any other relevant information]
|
||||
|
||||
---
|
||||
*Reported via `/report-bug` command*
|
||||
```
|
||||
|
||||
## Step 4: Create GitHub Issue
|
||||
|
||||
Use the GitHub CLI to create the issue:
|
||||
|
||||
```bash
|
||||
gh issue create \
|
||||
--repo EveryInc/every-marketplace \
|
||||
--title "[compounding-engineering] Bug: [Brief description]" \
|
||||
--body "[Formatted bug report from Step 3]" \
|
||||
--label "bug,compounding-engineering"
|
||||
```
|
||||
|
||||
**Note:** If labels don't exist, create without labels:
|
||||
```bash
|
||||
gh issue create \
|
||||
--repo EveryInc/every-marketplace \
|
||||
--title "[compounding-engineering] Bug: [Brief description]" \
|
||||
--body "[Formatted bug report]"
|
||||
```
|
||||
|
||||
## Step 5: Confirm Submission
|
||||
|
||||
After the issue is created:
|
||||
1. Display the issue URL to the user
|
||||
2. Thank them for reporting the bug
|
||||
3. Let them know the maintainer (Kieran Klaassen) will be notified
|
||||
|
||||
## Output Format
|
||||
|
||||
```
|
||||
✅ Bug report submitted successfully!
|
||||
|
||||
Issue: https://github.com/EveryInc/every-marketplace/issues/[NUMBER]
|
||||
Title: [compounding-engineering] Bug: [description]
|
||||
|
||||
Thank you for helping improve the compounding-engineering plugin!
|
||||
The maintainer will review your report and respond as soon as possible.
|
||||
```
|
||||
|
||||
## Error Handling
|
||||
|
||||
- If `gh` CLI is not authenticated: Prompt user to run `gh auth login` first
|
||||
- If issue creation fails: Display the formatted report so user can manually create the issue
|
||||
- If required information is missing: Re-prompt for that specific field
|
||||
|
||||
## Privacy Notice
|
||||
|
||||
This command does NOT collect:
|
||||
- Personal information
|
||||
- API keys or credentials
|
||||
- Private code from your projects
|
||||
- File paths beyond basic OS info
|
||||
|
||||
Only technical information about the bug is included in the report.
|
||||
Reference in New Issue
Block a user