Agent Code Debugger

Agent Code Debugger

Debugging assistance for AI-generated code with multi-language support.

When to Use

Usage

const debugger = require('./skills/agent-code-debugger');
// Analyze code for issues
const analysis = debugger.analyze(code, { language: 'csharp' });
console.log(analysis.summary);
// Get fix suggestions
const fixes = debugger.suggestFixes(analysis.issues);
// Get Visual Studio guidance
const guidance = debugger.getVisualStudioGuidance('csharp');
// Generate debug configuration
const config = debugger.generateDebugConfig('csharp');
// Quick fix common issues
const fixed = debugger.quickFix(code, 'console_writeline_leftover');

API

analyze(code, options?)

Analyze code for issues.

const analysis = analyze(csharpCode, { language: 'csharp' });
// {
//   language: 'csharp',
//   totalIssues: 5,
//   criticalCount: 0,
//   highCount: 2,
//   mediumCount: 2,
//   lowCount: 1,
//   issues: [...],
//   summary: 'Found 5 issue(s): 2 high, 2 medium, 1 low'
// }

suggestFixes(issues, options?)

Generate fix suggestions for issues.

const fixes = suggestFixes(analysis.issues, { language: 'csharp' });
// [{ type: 'async_void', fixSuggestion: '...', ... }]

getVisualStudioGuidance(language?)

Get Visual Studio debugging guidance.

const guidance = getVisualStudioGuidance('csharp');
// {
//   breakpoints: '...',
//   watchWindow: '...',
//   tips: [...]
// }

generateDebugConfig(language, options?)

Generate debug configuration for VS Code / Visual Studio.

const config = generateDebugConfig('csharp');
// { visualStudio: {...}, vscode: {...} }

detectAIPatterns(code)

Detect common AI-generated code characteristics.

const patterns = detectAIPatterns(code);
// [{ type: 'todo_comments', description: '...', suggestion: '...' }]

quickFix(code, issueType)

Apply quick fix for common issues.

const fixed = quickFix(code, 'console_writeline_leftover');
// { original: '...', fixed: '...', applied: true }

generateReport(analysis)

Generate a markdown debugging report.

const report = generateReport(analysis);
// '# Code Analysis Report\n...'

Supported Languages

Common Issues Detected

C# / .NET Core

| Issue | Severity | Description | |-------|----------|-------------| | async_void | High | async void should only be used for event handlers | | task_result_blocking | High | .Result blocks thread, potential deadlock | | task_wait_blocking | High | .Wait() blocks thread | | empty_catch | High | Empty catch swallows exceptions | | console_writeline_leftover | Low | Debug Console.WriteLine left in code | | thread_sleep_blocking | Medium | Thread.Sleep blocks thread |

JavaScript / TypeScript

| Issue | Severity | Description | |-------|----------|-------------| | promise_without_catch | High | Promise chain without .catch() | | async_without_try_catch | Medium | Async function without error handling | | console_log_leftover | Low | Debug console.log left in code | | explicit_any_type | Medium | Explicit use of any type (TS) | | ts_ignore_comment | High | @ts-ignore suppresses errors (TS) |

Python

| Issue | Severity | Description | |-------|----------|-------------| | bare_except | High | Bare except catches all exceptions | | wildcard_import | Medium | Wildcard import pollutes namespace | | print_statement_leftover | Low | Debug print left in code |

Visual Studio Debugging Tips

Breakpoints

Debug Windows

Advanced Features

Example: Debugging AI-Generated C# Code

const debugger = require('./skills/agent-code-debugger');
const aiGeneratedCode = 
public async void ProcessData() {
    var result = GetDataAsync().Result;
    Console.WriteLine($"Debug: {result}");
    try {
        // Process result
    } catch {
        // Handle error
    }
}
;
// Analyze
const analysis = debugger.analyze(aiGeneratedCode, { language: 'csharp' });
console.log(analysis.summary);
// Found 4 issue(s): 3 high, 1 low
// Get fixes
const fixes = debugger.suggestFixes(analysis.issues);
for (const fix of fixes) {
  console.log(Line ${fix.line}: ${fix.type});
  console.log(Fix: ${fix.fixSuggestion});
}
// Quick fix
const cleaned = debugger.quickFix(aiGeneratedCode, 'console_writeline_leftover');
// Get VS guidance
const guidance = debugger.getVisualStudioGuidance('csharp');
console.log('Tips:', guidance.tips);

Example: Generating Debug Configuration

const debugger = require('./skills/agent-code-debugger');
// For C# / .NET Core
const csharpConfig = debugger.generateDebugConfig('csharp');
console.log(JSON.stringify(csharpConfig.vscode, null, 2));
// For TypeScript
const tsConfig = debugger.generateDebugConfig('typescript');
console.log(JSON.stringify(tsConfig.vscode, null, 2));

Notes

const debugger = require('./skills/agent-code-debugger');
// Analyze code for issues
const analysis = debugger.analyze(code, { language: 'csharp' });
console.log(analysis.summary);
// Get fix suggestions
const fixes = debugger.suggestFixes(analysis.issues);
// Get Visual Studio guidance
const guidance = debugger.getVisualStudioGuidance('csharp');
// Generate debug configuration
const config = debugger.generateDebugConfig('csharp');
// Quick fix common issues
const fixed = debugger.quickFix(code, 'console_writeline_leftover');