Agent Code Debugger#

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

When to Use#

• Debugging AI-generated code
• Analyzing code for common AI generation issues
• Getting Visual Studio debugging guidance
• Detecting security vulnerabilities in generated code
• Quick fixes for common code issues

Usage#

javascript

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.

javascript

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.

javascript

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

getVisualStudioGuidance(language?)#

Get Visual Studio debugging guidance.

javascript

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

generateDebugConfig(language, options?)#

Generate debug configuration for VS Code / Visual Studio.

javascript

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

detectAIPatterns(code)#

Detect common AI-generated code characteristics.

javascript

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

quickFix(code, issueType)#

Apply quick fix for common issues.

javascript

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

generateReport(analysis)#

Generate a markdown debugging report.

javascript

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

Supported Languages#

• C# / .NET Core - Full support with Visual Studio guidance
• TypeScript - Type safety and async patterns
• JavaScript - Promise and async/await patterns
• Python - Exception handling and best practices
• Java - Exception handling and threading

Common Issues Detected#

C# / .NET Core#

IssueSeverityDescriptionasync_voidHighasync void should only be used for event handlerstask_result_blockingHigh.Result blocks thread, potential deadlocktask_wait_blockingHigh.Wait() blocks threadempty_catchHighEmpty catch swallows exceptionsconsole_writeline_leftoverLowDebug Console.WriteLine left in codethread_sleep_blockingMediumThread.Sleep blocks thread

JavaScript / TypeScript#

IssueSeverityDescriptionpromise_without_catchHighPromise chain without .catch()async_without_try_catchMediumAsync function without error handlingconsole_log_leftoverLowDebug console.log left in codeexplicit_any_typeMediumExplicit use of any type (TS)ts_ignore_commentHigh@ts-ignore suppresses errors (TS)

Python#

IssueSeverityDescriptionbare_exceptHighBare except catches all exceptionswildcard_importMediumWildcard import pollutes namespaceprint_statement_leftoverLowDebug print left in code

Visual Studio Debugging Tips#

Breakpoints#

• F9 - Toggle breakpoint
• F5 - Start debugging
• F10 - Step over
• F11 - Step into
• Shift+F11 - Step out

Debug Windows#

• Watch - Monitor variables
• Immediate - Evaluate expressions
• Call Stack - Trace execution
• Locals - View local variables
• Autos - View relevant variables

Advanced Features#

• Conditional breakpoints - Right-click breakpoint > Conditions
• Hit count - Break after N hits
• Exception settings - Break on specific exceptions
• Edit and Continue - Modify code while debugging

Example: Debugging AI-Generated C# Code#

javascript

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#

javascript

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#

• Pattern detection based on common AI-generated code issues
• Security vulnerability scanning included
• Multi-language support with language-specific patterns
• Visual Studio and VS Code integration guidance
• Quick fixes available for common cleanup tasks
• Reports generated in markdown format