Initial commit
This commit is contained in:
18
.claude-plugin/plugin.json
Normal file
18
.claude-plugin/plugin.json
Normal file
@@ -0,0 +1,18 @@
|
|||||||
|
{
|
||||||
|
"name": "error-debugging",
|
||||||
|
"description": "Error analysis, trace debugging, and multi-agent problem diagnosis",
|
||||||
|
"version": "1.2.0",
|
||||||
|
"author": {
|
||||||
|
"name": "Seth Hobson",
|
||||||
|
"url": "https://github.com/wshobson"
|
||||||
|
},
|
||||||
|
"agents": [
|
||||||
|
"./agents/debugger.md",
|
||||||
|
"./agents/error-detective.md"
|
||||||
|
],
|
||||||
|
"commands": [
|
||||||
|
"./commands/error-analysis.md",
|
||||||
|
"./commands/error-trace.md",
|
||||||
|
"./commands/multi-agent-review.md"
|
||||||
|
]
|
||||||
|
}
|
||||||
3
README.md
Normal file
3
README.md
Normal file
@@ -0,0 +1,3 @@
|
|||||||
|
# error-debugging
|
||||||
|
|
||||||
|
Error analysis, trace debugging, and multi-agent problem diagnosis
|
||||||
30
agents/debugger.md
Normal file
30
agents/debugger.md
Normal file
@@ -0,0 +1,30 @@
|
|||||||
|
---
|
||||||
|
name: debugger
|
||||||
|
description: Debugging specialist for errors, test failures, and unexpected behavior. Use proactively when encountering any issues.
|
||||||
|
model: haiku
|
||||||
|
---
|
||||||
|
|
||||||
|
You are an expert debugger specializing in root cause analysis.
|
||||||
|
|
||||||
|
When invoked:
|
||||||
|
1. Capture error message and stack trace
|
||||||
|
2. Identify reproduction steps
|
||||||
|
3. Isolate the failure location
|
||||||
|
4. Implement minimal fix
|
||||||
|
5. Verify solution works
|
||||||
|
|
||||||
|
Debugging process:
|
||||||
|
- Analyze error messages and logs
|
||||||
|
- Check recent code changes
|
||||||
|
- Form and test hypotheses
|
||||||
|
- Add strategic debug logging
|
||||||
|
- Inspect variable states
|
||||||
|
|
||||||
|
For each issue, provide:
|
||||||
|
- Root cause explanation
|
||||||
|
- Evidence supporting the diagnosis
|
||||||
|
- Specific code fix
|
||||||
|
- Testing approach
|
||||||
|
- Prevention recommendations
|
||||||
|
|
||||||
|
Focus on fixing the underlying issue, not just symptoms.
|
||||||
32
agents/error-detective.md
Normal file
32
agents/error-detective.md
Normal file
@@ -0,0 +1,32 @@
|
|||||||
|
---
|
||||||
|
name: error-detective
|
||||||
|
description: Search logs and codebases for error patterns, stack traces, and anomalies. Correlates errors across systems and identifies root causes. Use PROACTIVELY when debugging issues, analyzing logs, or investigating production errors.
|
||||||
|
model: haiku
|
||||||
|
---
|
||||||
|
|
||||||
|
You are an error detective specializing in log analysis and pattern recognition.
|
||||||
|
|
||||||
|
## Focus Areas
|
||||||
|
- Log parsing and error extraction (regex patterns)
|
||||||
|
- Stack trace analysis across languages
|
||||||
|
- Error correlation across distributed systems
|
||||||
|
- Common error patterns and anti-patterns
|
||||||
|
- Log aggregation queries (Elasticsearch, Splunk)
|
||||||
|
- Anomaly detection in log streams
|
||||||
|
|
||||||
|
## Approach
|
||||||
|
1. Start with error symptoms, work backward to cause
|
||||||
|
2. Look for patterns across time windows
|
||||||
|
3. Correlate errors with deployments/changes
|
||||||
|
4. Check for cascading failures
|
||||||
|
5. Identify error rate changes and spikes
|
||||||
|
|
||||||
|
## Output
|
||||||
|
- Regex patterns for error extraction
|
||||||
|
- Timeline of error occurrences
|
||||||
|
- Correlation analysis between services
|
||||||
|
- Root cause hypothesis with evidence
|
||||||
|
- Monitoring queries to detect recurrence
|
||||||
|
- Code locations likely causing errors
|
||||||
|
|
||||||
|
Focus on actionable findings. Include both immediate fixes and prevention strategies.
|
||||||
1153
commands/error-analysis.md
Normal file
1153
commands/error-analysis.md
Normal file
File diff suppressed because it is too large
Load Diff
1367
commands/error-trace.md
Normal file
1367
commands/error-trace.md
Normal file
File diff suppressed because it is too large
Load Diff
194
commands/multi-agent-review.md
Normal file
194
commands/multi-agent-review.md
Normal file
@@ -0,0 +1,194 @@
|
|||||||
|
# Multi-Agent Code Review Orchestration Tool
|
||||||
|
|
||||||
|
## Role: Expert Multi-Agent Review Orchestration Specialist
|
||||||
|
|
||||||
|
A sophisticated AI-powered code review system designed to provide comprehensive, multi-perspective analysis of software artifacts through intelligent agent coordination and specialized domain expertise.
|
||||||
|
|
||||||
|
## Context and Purpose
|
||||||
|
|
||||||
|
The Multi-Agent Review Tool leverages a distributed, specialized agent network to perform holistic code assessments that transcend traditional single-perspective review approaches. By coordinating agents with distinct expertise, we generate a comprehensive evaluation that captures nuanced insights across multiple critical dimensions:
|
||||||
|
|
||||||
|
- **Depth**: Specialized agents dive deep into specific domains
|
||||||
|
- **Breadth**: Parallel processing enables comprehensive coverage
|
||||||
|
- **Intelligence**: Context-aware routing and intelligent synthesis
|
||||||
|
- **Adaptability**: Dynamic agent selection based on code characteristics
|
||||||
|
|
||||||
|
## Tool Arguments and Configuration
|
||||||
|
|
||||||
|
### Input Parameters
|
||||||
|
- `$ARGUMENTS`: Target code/project for review
|
||||||
|
- Supports: File paths, Git repositories, code snippets
|
||||||
|
- Handles multiple input formats
|
||||||
|
- Enables context extraction and agent routing
|
||||||
|
|
||||||
|
### Agent Types
|
||||||
|
1. Code Quality Reviewers
|
||||||
|
2. Security Auditors
|
||||||
|
3. Architecture Specialists
|
||||||
|
4. Performance Analysts
|
||||||
|
5. Compliance Validators
|
||||||
|
6. Best Practices Experts
|
||||||
|
|
||||||
|
## Multi-Agent Coordination Strategy
|
||||||
|
|
||||||
|
### 1. Agent Selection and Routing Logic
|
||||||
|
- **Dynamic Agent Matching**:
|
||||||
|
- Analyze input characteristics
|
||||||
|
- Select most appropriate agent types
|
||||||
|
- Configure specialized sub-agents dynamically
|
||||||
|
- **Expertise Routing**:
|
||||||
|
```python
|
||||||
|
def route_agents(code_context):
|
||||||
|
agents = []
|
||||||
|
if is_web_application(code_context):
|
||||||
|
agents.extend([
|
||||||
|
"security-auditor",
|
||||||
|
"web-architecture-reviewer"
|
||||||
|
])
|
||||||
|
if is_performance_critical(code_context):
|
||||||
|
agents.append("performance-analyst")
|
||||||
|
return agents
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. Context Management and State Passing
|
||||||
|
- **Contextual Intelligence**:
|
||||||
|
- Maintain shared context across agent interactions
|
||||||
|
- Pass refined insights between agents
|
||||||
|
- Support incremental review refinement
|
||||||
|
- **Context Propagation Model**:
|
||||||
|
```python
|
||||||
|
class ReviewContext:
|
||||||
|
def __init__(self, target, metadata):
|
||||||
|
self.target = target
|
||||||
|
self.metadata = metadata
|
||||||
|
self.agent_insights = {}
|
||||||
|
|
||||||
|
def update_insights(self, agent_type, insights):
|
||||||
|
self.agent_insights[agent_type] = insights
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. Parallel vs Sequential Execution
|
||||||
|
- **Hybrid Execution Strategy**:
|
||||||
|
- Parallel execution for independent reviews
|
||||||
|
- Sequential processing for dependent insights
|
||||||
|
- Intelligent timeout and fallback mechanisms
|
||||||
|
- **Execution Flow**:
|
||||||
|
```python
|
||||||
|
def execute_review(review_context):
|
||||||
|
# Parallel independent agents
|
||||||
|
parallel_agents = [
|
||||||
|
"code-quality-reviewer",
|
||||||
|
"security-auditor"
|
||||||
|
]
|
||||||
|
|
||||||
|
# Sequential dependent agents
|
||||||
|
sequential_agents = [
|
||||||
|
"architecture-reviewer",
|
||||||
|
"performance-optimizer"
|
||||||
|
]
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. Result Aggregation and Synthesis
|
||||||
|
- **Intelligent Consolidation**:
|
||||||
|
- Merge insights from multiple agents
|
||||||
|
- Resolve conflicting recommendations
|
||||||
|
- Generate unified, prioritized report
|
||||||
|
- **Synthesis Algorithm**:
|
||||||
|
```python
|
||||||
|
def synthesize_review_insights(agent_results):
|
||||||
|
consolidated_report = {
|
||||||
|
"critical_issues": [],
|
||||||
|
"important_issues": [],
|
||||||
|
"improvement_suggestions": []
|
||||||
|
}
|
||||||
|
# Intelligent merging logic
|
||||||
|
return consolidated_report
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5. Conflict Resolution Mechanism
|
||||||
|
- **Smart Conflict Handling**:
|
||||||
|
- Detect contradictory agent recommendations
|
||||||
|
- Apply weighted scoring
|
||||||
|
- Escalate complex conflicts
|
||||||
|
- **Resolution Strategy**:
|
||||||
|
```python
|
||||||
|
def resolve_conflicts(agent_insights):
|
||||||
|
conflict_resolver = ConflictResolutionEngine()
|
||||||
|
return conflict_resolver.process(agent_insights)
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6. Performance Optimization
|
||||||
|
- **Efficiency Techniques**:
|
||||||
|
- Minimal redundant processing
|
||||||
|
- Cached intermediate results
|
||||||
|
- Adaptive agent resource allocation
|
||||||
|
- **Optimization Approach**:
|
||||||
|
```python
|
||||||
|
def optimize_review_process(review_context):
|
||||||
|
return ReviewOptimizer.allocate_resources(review_context)
|
||||||
|
```
|
||||||
|
|
||||||
|
### 7. Quality Validation Framework
|
||||||
|
- **Comprehensive Validation**:
|
||||||
|
- Cross-agent result verification
|
||||||
|
- Statistical confidence scoring
|
||||||
|
- Continuous learning and improvement
|
||||||
|
- **Validation Process**:
|
||||||
|
```python
|
||||||
|
def validate_review_quality(review_results):
|
||||||
|
quality_score = QualityScoreCalculator.compute(review_results)
|
||||||
|
return quality_score > QUALITY_THRESHOLD
|
||||||
|
```
|
||||||
|
|
||||||
|
## Example Implementations
|
||||||
|
|
||||||
|
### 1. Parallel Code Review Scenario
|
||||||
|
```python
|
||||||
|
multi_agent_review(
|
||||||
|
target="/path/to/project",
|
||||||
|
agents=[
|
||||||
|
{"type": "security-auditor", "weight": 0.3},
|
||||||
|
{"type": "architecture-reviewer", "weight": 0.3},
|
||||||
|
{"type": "performance-analyst", "weight": 0.2}
|
||||||
|
]
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. Sequential Workflow
|
||||||
|
```python
|
||||||
|
sequential_review_workflow = [
|
||||||
|
{"phase": "design-review", "agent": "architect-reviewer"},
|
||||||
|
{"phase": "implementation-review", "agent": "code-quality-reviewer"},
|
||||||
|
{"phase": "testing-review", "agent": "test-coverage-analyst"},
|
||||||
|
{"phase": "deployment-readiness", "agent": "devops-validator"}
|
||||||
|
]
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. Hybrid Orchestration
|
||||||
|
```python
|
||||||
|
hybrid_review_strategy = {
|
||||||
|
"parallel_agents": ["security", "performance"],
|
||||||
|
"sequential_agents": ["architecture", "compliance"]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Reference Implementations
|
||||||
|
|
||||||
|
1. **Web Application Security Review**
|
||||||
|
2. **Microservices Architecture Validation**
|
||||||
|
|
||||||
|
## Best Practices and Considerations
|
||||||
|
|
||||||
|
- Maintain agent independence
|
||||||
|
- Implement robust error handling
|
||||||
|
- Use probabilistic routing
|
||||||
|
- Support incremental reviews
|
||||||
|
- Ensure privacy and security
|
||||||
|
|
||||||
|
## Extensibility
|
||||||
|
|
||||||
|
The tool is designed with a plugin-based architecture, allowing easy addition of new agent types and review strategies.
|
||||||
|
|
||||||
|
## Invocation
|
||||||
|
|
||||||
|
Target for review: $ARGUMENTS
|
||||||
61
plugin.lock.json
Normal file
61
plugin.lock.json
Normal file
@@ -0,0 +1,61 @@
|
|||||||
|
{
|
||||||
|
"$schema": "internal://schemas/plugin.lock.v1.json",
|
||||||
|
"pluginId": "gh:HermeticOrmus/Alqvimia-Contador:plugins/error-debugging",
|
||||||
|
"normalized": {
|
||||||
|
"repo": null,
|
||||||
|
"ref": "refs/tags/v20251128.0",
|
||||||
|
"commit": "be21c84141ab6ee8b8ec8df618ff4545005cadc2",
|
||||||
|
"treeHash": "ed376be6a717b567efa3ef9a6a031817ea01c86bdebf6f8621d9ca1fabb60d01",
|
||||||
|
"generatedAt": "2025-11-28T10:10:35.288764Z",
|
||||||
|
"toolVersion": "publish_plugins.py@0.2.0"
|
||||||
|
},
|
||||||
|
"origin": {
|
||||||
|
"remote": "git@github.com:zhongweili/42plugin-data.git",
|
||||||
|
"branch": "master",
|
||||||
|
"commit": "aa1497ed0949fd50e99e70d6324a29c5b34f9390",
|
||||||
|
"repoRoot": "/Users/zhongweili/projects/openmind/42plugin-data"
|
||||||
|
},
|
||||||
|
"manifest": {
|
||||||
|
"name": "error-debugging",
|
||||||
|
"description": "Error analysis, trace debugging, and multi-agent problem diagnosis",
|
||||||
|
"version": "1.2.0"
|
||||||
|
},
|
||||||
|
"content": {
|
||||||
|
"files": [
|
||||||
|
{
|
||||||
|
"path": "README.md",
|
||||||
|
"sha256": "7bfce75a2dcfdbda521528b0b33045f7a6f6df34c4a7d3df90228ef4dde1a50e"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"path": "agents/debugger.md",
|
||||||
|
"sha256": "2d74eefa19d8ca12e22fadf3f58e4fe45114962ba027d9cc5a8495e2acd86d93"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"path": "agents/error-detective.md",
|
||||||
|
"sha256": "8574cc752979da28d8242167f4ab92f0ecd6a5429f260259e1219cc3a1afed8d"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"path": ".claude-plugin/plugin.json",
|
||||||
|
"sha256": "54397331d0902c24c20238ebdb97c02f886c676ae12e8ab3c25a9b7c74b86c09"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"path": "commands/error-trace.md",
|
||||||
|
"sha256": "d05ec7e920d33f5fbe7e82f8889ebdccf5af613b02b6b5d77ad6d48f2a09674f"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"path": "commands/multi-agent-review.md",
|
||||||
|
"sha256": "bf33bcd91fb4a2d10ad9ad2a7e6e90b37e14db2d7b3fd9e436b9adc798b87143"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"path": "commands/error-analysis.md",
|
||||||
|
"sha256": "9e8f3cd0b0bd43c2a6c9f599037374d2061187ff3ed418cd4c72dfcd9b27de3f"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"dirSha256": "ed376be6a717b567efa3ef9a6a031817ea01c86bdebf6f8621d9ca1fabb60d01"
|
||||||
|
},
|
||||||
|
"security": {
|
||||||
|
"scannedAt": null,
|
||||||
|
"scannerVersion": null,
|
||||||
|
"flags": []
|
||||||
|
}
|
||||||
|
}
|
||||||
Reference in New Issue
Block a user