159 lines
6.3 KiB
Markdown
159 lines
6.3 KiB
Markdown
---
|
|
name: analyze:quality
|
|
description: Run comprehensive quality control with autonomous auto-fixing
|
|
delegates-to: autonomous-agent:orchestrator
|
|
---
|
|
|
|
# Quality Check Command
|
|
|
|
## 🚨 CRITICAL: RESPONSE SAFETY REQUIREMENTS
|
|
|
|
**SYSTEM-WIDE FAILURE PREVENTION**: When generating ANY response content for this command, you MUST ensure:
|
|
|
|
1. **NEVER generate empty text blocks** - All content blocks must have non-empty text
|
|
2. **NEVER use Unicode box characters** (=, |, +, +, etc.) - Use safe ASCII alternatives
|
|
3. **ALWAYS provide fallback content** for any section that might be empty
|
|
4. **VALIDATE all content blocks** before finalizing response
|
|
5. **NEVER leave sections empty** - Provide default values for missing data
|
|
|
|
**SAFE RESPONSE PATTERN**:
|
|
- Use ASCII characters instead of Unicode box drawing
|
|
- Ensure every score section has actual numeric values
|
|
- Provide default content when data is missing
|
|
- Never return empty strings or whitespace-only content
|
|
- Always include actionable recommendations
|
|
|
|
**FAILURE TO COMPLY**: Will cause `cache_control cannot be set for empty text blocks` errors and break ALL Claude functionality.
|
|
|
|
Run comprehensive quality control check with autonomous fixing. This will:
|
|
|
|
- Run all tests and analyze coverage
|
|
- Check code standards compliance
|
|
- Verify documentation completeness
|
|
- Validate pattern adherence
|
|
- Auto-fix issues when possible
|
|
- Generate quality report with trends
|
|
|
|
## How It Works
|
|
|
|
1. **Test Execution**: Runs all tests and calculates coverage
|
|
2. **Standards Check**: Validates code against style and standards
|
|
3. **Documentation Review**: Checks for missing or incomplete docs
|
|
4. **Pattern Validation**: Verifies adherence to learned patterns
|
|
5. **Auto-Fix Loop**: Automatically fixes issues (repeats if needed)
|
|
6. **Quality Assessment**: Calculates overall quality score (0-100)
|
|
7. **Trend Analysis**: Compares against historical data
|
|
|
|
**IMPORTANT**: This command delegates to `autonomous-agent:orchestrator` which MUST present a detailed quality report to the user showing scores, test results, auto-fix actions, and specific recommendations. Silent completion is not acceptable.
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
/analyze:quality
|
|
```
|
|
|
|
## Quality Scoring
|
|
|
|
- **Test Coverage**: 30 points (aim for >80%)
|
|
- **Code Standards**: 25 points (style, conventions)
|
|
- **Documentation**: 20 points (completeness)
|
|
- **Pattern Adherence**: 15 points (learned patterns)
|
|
- **Code Metrics**: 10 points (complexity, maintainability)
|
|
|
|
**Pass Threshold**: 70/100
|
|
|
|
If score < 70, auto-fix loop is triggered automatically.
|
|
|
|
## Example Output
|
|
|
|
The orchestrator MUST present results in this format:
|
|
|
|
```
|
|
============================================================
|
|
QUALITY CHECK COMPLETED
|
|
============================================================
|
|
|
|
+-------------------------------------------------------+
|
|
| OVERALL QUALITY SCORE
|
|
+-------------------------------------------------------+
|
|
| Current Score: 88/100 [PASS] |
|
|
| Previous Score: 83/100 |
|
|
| Trend: +5 points (improving) |
|
|
| Status: Above threshold (70+) |
|
|
+-------------------------------------------------------+
|
|
|
|
+-------------------------------------------------------+
|
|
| QUALITY BREAKDOWN
|
|
+-------------------------------------------------------+
|
|
| Tests (30 pts): 26/30 [PASS] |
|
|
| 45 passed, 2 failed | 88% coverage |
|
|
| |
|
|
| Standards (25 pts): 18/25 [WARN] |
|
|
| 18 style violations found |
|
|
| |
|
|
| Documentation (20 pts): 19/20 [PASS] |
|
|
| 97% of public APIs documented |
|
|
| |
|
|
| Patterns (15 pts): 15/15 [PASS] |
|
|
| Adheres to 8/8 learned patterns |
|
|
| |
|
|
| Metrics (10 pts): 10/10 [PASS] |
|
|
| Acceptable complexity levels |
|
|
+-------------------------------------------------------+
|
|
|
|
+-------------------------------------------------------+
|
|
| AUTO-FIX ACTIONS TAKEN
|
|
+-------------------------------------------------------+
|
|
| * Fixed 12 style violations (auto-formatted) |
|
|
| * Added 3 missing docstrings |
|
|
| * Updated 1 outdated dependency |
|
|
| * Quality improved from 83 -> 88 (+5 points) |
|
|
+-------------------------------------------------------+
|
|
|
|
+-------------------------------------------------------+
|
|
| REMAINING ISSUES
|
|
+-------------------------------------------------------+
|
|
| Tests: |
|
|
| * test_user_login() - AssertionError (auth.py:45) |
|
|
| * test_token_refresh() - Timeout (auth.py:89) |
|
|
| |
|
|
| Standards: |
|
|
| * 6 violations require manual review |
|
|
| (complex refactoring needed) |
|
|
+-------------------------------------------------------+
|
|
|
|
+-------------------------------------------------------+
|
|
| RECOMMENDATIONS
|
|
+-------------------------------------------------------+
|
|
| 1. [HIGH] Fix 2 failing tests in auth module |
|
|
| -> Expected +4 quality points |
|
|
| 2. [MED] Refactor complex functions flagged |
|
|
| -> Expected +2 quality points |
|
|
| 3. [LOW] Review 6 manual style violations |
|
|
| -> Expected +1 quality point |
|
|
+-------------------------------------------------------+
|
|
|
|
Skills Loaded: quality-standards, testing-strategies
|
|
Agents Used: autonomous-agent:quality-controller, autonomous-agent:test-engineer
|
|
Auto-Fix Iterations: 2 (converged)
|
|
Patterns Stored: Quality pattern updated in .claude-patterns/
|
|
Check Time: 1.8 minutes
|
|
|
|
============================================================
|
|
```
|
|
|
|
## Auto-Fix Details
|
|
|
|
When quality < 70, the plugin will:
|
|
1. Run failing tests individually
|
|
2. Fix style violations
|
|
3. Generate missing documentation
|
|
4. Suggest pattern improvements
|
|
5. Re-check quality
|
|
6. Iterate up to 3 times
|
|
|
|
## See Also
|
|
|
|
- `/analyze:project` - Autonomous project analysis
|
|
- `/learn:init` - Initialize pattern learning database
|