Agent Code Debugger

面向多语言的 AI 生成代码调试辅助工具。

适用场景

• 调试 AI 生成的代码
• 分析代码中常见的 AI 生成问题
• 获取 Visual Studio 调试指导
• 检测生成代码中的安全漏洞
• 快速修复常见代码问题

使用方法

const debugger = require('./skills/agent-code-debugger');

// 分析代码中的问题
const analysis = debugger.analyze(code, { language: 'csharp' });
console.log(analysis.summary);

// 获取修复建议
const fixes = debugger.suggestFixes(analysis.issues);

// 获取 Visual Studio 调试指导
const guidance = debugger.getVisualStudioGuidance('csharp');

// 生成调试配置
const config = debugger.generateDebugConfig('csharp');

// 快速修复常见问题
const fixed = debugger.quickFix(code, 'console_writeline_leftover');

API

analyze(code, options?)

分析代码中的问题。

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?)

为问题生成修复建议。

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

getVisualStudioGuidance(language?)

获取 Visual Studio 调试指导。

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

generateDebugConfig(language, options?)

为 VS Code / Visual Studio 生成调试配置。

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

detectAIPatterns(code)

识别 AI 生成代码的常见特征。

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

quickFix(code, issueType)

对常见问题应用快速修复。

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

generateReport(analysis)

生成 Markdown 格式的调试报告。

const report = generateReport(analysis);
// '# Code Analysis Reportn...'

支持的语言

• C# / .NET Core —— 完整支持，含 Visual Studio 指导
• TypeScript —— 类型安全性与异步模式检查
• JavaScript —— Promise 与 async/await 模式检查
• Python —— 异常处理与最佳实践检查
• Java —— 异常处理与线程安全检查

检测的常见问题

C# / .NET Core

JavaScript / TypeScript

Python

Visual Studio 调试技巧

断点操作

• F9 —— 切换断点
• F5 —— 启动调试
• F10 —— 单步跳过
• F11 —— 单步进入
• Shift+F11 —— 单步跳出

调试窗口

• 监视 —— 监控变量值
• 即时 —— 执行表达式求值
• 调用堆栈 —— 追踪执行路径
• 局部变量 —— 查看当前作用域变量
• 自动变量 —— 查看相关上下文变量

高级功能

• 条件断点 —— 右键断点 → “条件”
• 命中次数 —— 在第 N 次命中时中断
• 异常设置 —— 对特定异常触发中断
• 编辑并继续 —— 调试过程中修改代码

示例：调试 AI 生成的 C# 代码

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
    }
}
`;

// 分析
const analysis = debugger.analyze(aiGeneratedCode, { language: 'csharp' });
console.log(analysis.summary);
// Found 4 issue(s): 3 high, 1 low

// 获取修复建议
const fixes = debugger.suggestFixes(analysis.issues);
for (const fix of fixes) {
  console.log(`Line ${fix.line}: ${fix.type}`);
  console.log(`Fix: ${fix.fixSuggestion}`);
}

// 快速修复
const cleaned = debugger.quickFix(aiGeneratedCode, 'console_writeline_leftover');

// 获取 Visual Studio 指导
const guidance = debugger.getVisualStudioGuidance('csharp');
console.log('Tips:', guidance.tips);

示例：生成调试配置

const debugger = require('./skills/agent-code-debugger');

// 针对 C# / .NET Core
const csharpConfig = debugger.generateDebugConfig('csharp');
console.log(JSON.stringify(csharpConfig.vscode, null, 2));

// 针对 TypeScript
const tsConfig = debugger.generateDebugConfig('typescript');
console.log(JSON.stringify(tsConfig.vscode, null, 2));

注意事项

• 模式检测基于 AI 生成代码的常见问题
• 内置安全漏洞扫描能力
• 支持多语言，且针对各语言提供专属检测模式
• 提供 Visual Studio 与 VS Code 的集成指导
• 支持常见清理任务的快速修复
• 报告以 Markdown 格式生成