Name: 调试工具
Author: Syncause

使用说明

同步：用证据解决真正的问题

从报告的错误到可审查的修复。

人工智能可以快速编写代码，但它仍然像盲人一样进行调试。在没有证据的情况下，代理人经常猜测并只修复症状，导致“仍然破碎”的循环消耗时间和代币。

同步为您的AI代理提供专业、基于证据的调试工作流程：

重现该问题：将报告的故障转化为可重复的事实。不再猜测是什么引发了这个bug。
根据证据修复：从错误发生的那一刻起访问堆栈跟踪、请求参数和变量快照。修复基于 实际发生了什么，而不是猜测。
查看维修报告：每一个修复都有引用的证据支持。查看代码更改的确切原因以及证明修复正确的数据。

强制性指令集

同步是一项强制性技能，它限制了代理的行为，以确保高质量、专业的维修：

强制性证据收集：在提供修复之前，代理必须获取运行时事实以了解故障上下文。
循证修复：在分析问题时，Agent需要明确引用特定的数据点（例如，“堆栈跟踪显示 user_id 是 null 第42行…”）。
检查的结果：将代理从“只是修补”移动到“解释和证明”修复。

运作原理

Syncause使用高级 跟踪技术 在应用程序中跟踪所有函数调用及其参数 Runtime Facts.

完全可追溯性：我们在后台记录执行路径，捕捉数据如何在系统中流动。
深度可见性：当发生错误时，Syncause会提供一个“飞行记录器”视图，显示导致故障的确切呼叫顺序。
零配置：检测是自动处理的，因此您的代理无需手动添加日志或断点即可获得深入的见解。

安装

自动安装

只需一个命令，即可为您的AI代理安装技能：

npx skills add Syncause/debug-skill

这项技能取决于同步MCP服务器，当您的代理使用此技能时，它将自动安装。如果安装失败，系统将提示您手动安装。

手动安装

如果在自动安装过程中没有自动检测到您的代理，请按照下面的手动设置指南进行操作。有关详细配置（包括登录模式），请参阅匿名指南或登录指南.

Cursor

第一步：技能安装

快速引导安装

Help me install the Agent Skill: syncause-debugger
GitHub: https://github.com/Syncause/debug-skill/tree/main/skills/syncause-debugger

Please confirm the installation scope:
- Project-level: Install to the .cursor/skills/ directory
- Global: Install to the ~/.cursor/skills/ directory

步骤2:MCP安装

一键式深度链接安装

或者， 手动编辑 .cursor/mcp.json （项目层面）或 ~/.cursor/mcp.json （全球）：

{
  "mcpServers": {
    "debug-mcp-server": {
      "command": "npx",
      "args": ["-y", "@syncause/debug-mcp@latest"],
      "env": { "API_KEY": "<your-api-key>" }
    }
  }
}

VS Code (GitHub Copilot Chat)

第一步：技能安装

快速引导安装

Help me install the Agent Skill: syncause-debugger
GitHub: https://github.com/Syncause/debug-skill/tree/main/skills/syncause-debugger

Please confirm the installation scope:
- Project-level: Install to the .github/skills/ directory
- Global: Install to the ~/.copilot/skills/ directory

步骤2:MCP安装

一键式深度链接安装

或者， 手动编辑 .vscode/settings.json:

{
  "servers": {
    "debug-mcp-server": {
      "command": "npx",
      "args": ["-y", "@syncause/debug-mcp@latest"],
      "env": { "API_KEY": "<your-api-key>" }
    }
  }
}

Claude Code

第一步：技能安装

快速引导安装

Help me install the Agent Skill: syncause-debugger
GitHub: https://github.com/Syncause/debug-skill/tree/main/skills/syncause-debugger

Please confirm the installation scope:
- Project-level: Install to the .claude/skills/ directory
- Global: Install to the ~/.claude/skills/ directory

步骤2:MCP安装

CLI命令（推荐）

# Project-level
claude mcp add --scope project debug-mcp-server -- npx -y @syncause/debug-mcp@latest

# User-level
claude mcp add --scope user debug-mcp-server -- npx -y @syncause/debug-mcp@latest

或者， 手动编辑 .mcp.json （项目层面）或 ~/.claude/settings.json （用户级别）：

{
  "mcpServers": {
    "debug-mcp-server": {
      "command": "npx",
      "args": ["-y", "@syncause/debug-mcp@latest"],
      "env": { "API_KEY": "<your-api-key>" }
    }
  }
}

Codex

第一步：技能安装

快速引导安装

Help me install the Agent Skill: syncause-debugger
GitHub: https://github.com/Syncause/debug-skill/tree/main/skills/syncause-debugger

Please confirm the installation scope:
- Project-level: Install to the .codex/skills/ directory
- Global: Install to the ~/.codex/skills/ directory

步骤2:MCP安装

CLI命令（推荐）

codex mcp add debug-mcp-server --command "npx -y @syncause/debug-mcp@latest"

或者， 手动编辑 ~/.codex/config.toml:

[mcp_servers.debug-mcp-server]
command = "npx"
args = ["-y", "@syncause/debug-mcp@latest"]

[mcp_servers.debug-mcp-server.env]
API_KEY = "<your-api-key>"

Gemini CLI

第一步：技能安装

CLI命令（推荐）

# Project-level
gemini skills install https://github.com/Syncause/debug-skill.git --path skills/syncause-debugger --scope workspace

# Global
gemini skills install https://github.com/Syncause/debug-skill.git --path skills/syncause-debugger

或者， 在终端的Agent聊天窗口中运行以下命令：

Help me install the Agent Skill: syncause-debugger
GitHub: https://github.com/Syncause/debug-skill/tree/main/skills/syncause-debugger

Please confirm the installation scope:
- Project-level: Install to the .gemini/skills/ directory
- Global: Install to the ~/.gemini/skills/ directory

步骤2:MCP安装

CLI命令（推荐）

gemini mcp add debug-mcp-server npx -y @syncause/debug-mcp@latest

**Or,** manually edit `.gemini/settings.json` (project-level) or `~/.gemini/settings.json` (global):
```json
{
  "mcpServers": {
    "debug-mcp-server": {
      "command": "npx",
      "args": ["-y", "@syncause/debug-mcp@latest"],
      "env": { "API_KEY": "<your-api-key>" }
    }
  }
}

Antigravity

第一步：技能安装

快速引导安装

Help me install the Agent Skill: syncause-debugger
GitHub: https://github.com/Syncause/debug-skill/tree/main/skills/syncause-debugger

Please confirm the installation scope:
- Project-level: Install to the .agent/skills/ directory
- Global: Install to the ~/.gemini/antigravity/skills/ directory

步骤2:MCP安装

手动编辑配置

在编辑器或代理管理器视图中打开代理侧栏
单击“…”（更多操作）菜单，然后选择MCP服务器
选择查看原始配置以打开 mcp_config.json 文件
添加以下配置：

{
  "mcpServers": {
    "debug-mcp-server": {
      "command": "npx",
      "args": ["-y", "@syncause/debug-mcp@latest"],
      "env": { "API_KEY": "<your-api-key>" }
    }
  }
}

保存文件并单击MCP面板中的“刷新”以查看新工具

Windsurf

第一步：技能安装

快速引导安装

Help me install the Agent Skill: syncause-debugger
GitHub: https://github.com/Syncause/debug-skill/tree/main/skills/syncause-debugger

Please confirm the installation scope:
- Project-level: Install to the .windsurf/skills/ directory
- Global: Install to the ~/.codeium/windsurf/skills/ directory

步骤2:MCP安装

手动编辑配置 编辑 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "debug-mcp-server": {
      "command": "npx",
      "args": ["-y", "@syncause/debug-mcp@latest"],
      "env": { "API_KEY": "<your-api-key>" }
    }
  }
}

OpenCode

第一步：技能安装

快速引导安装

Help me install the Agent Skill: syncause-debugger
GitHub: https://github.com/Syncause/debug-skill/tree/main/skills/syncause-debugger

Please confirm the installation scope:
- Project-level: Install to the .opencode/skills/ directory
- Global: Install to the ~/.config/opencode/skills/ directory

步骤2:MCP安装

手动编辑配置 编辑 ~/.config/opencode/opencode.json:

{
  "$schema": "http://opencode.ai/config.json",
  "mcp": {
    "debug-mcp-server": {
      "type": "local",
      "command": "npx",
      "args": ["-y", "@syncause/debug-mcp@latest"],
      "environment": { "API_KEY": "<your-api-key>" },
      "enabled": true
    }
  }
}

附录

技能目录摘要

IDE	项目级路径	全局路径
光标	`.cursor/skills/`	`~/.cursor/skills/`
VSCode	`.github/skills/`	`~/.copilot/skills/`
克劳德代码	`.claude/skills/`	`~/.claude/skills/`
食品法典委员会	`.codex/skills/`	`~/.codex/skills/`
Gemini CLI	`.gemini/skills/`	`~/.gemini/skills/`
反重力	`.agent/skills/`	`~/.gemini/antigravity/skills/`
风帆冲浪	`.windsurf/skills/`	`~/.codeium/windsurf/skills/`
OpenCode	`.opencode/skills/`	`~/.config/opencode/skills/`

使用说明

同步：用证据解决真正的问题

强制性指令集

运作原理

安装

自动安装

手动安装

第一步：技能安装

步骤2:MCP安装

一键式深度链接安装

第一步：技能安装

步骤2:MCP安装

一键式深度链接安装

第一步：技能安装

步骤2:MCP安装

第一步：技能安装

步骤2:MCP安装

第一步：技能安装

步骤2:MCP安装

第一步：技能安装

步骤2:MCP安装

第一步：技能安装

步骤2:MCP安装

第一步：技能安装

步骤2:MCP安装

附录

技能目录摘要

相关 MCP

React Native代码修复工具

AI可观测性平台

AI代码工具集成服务器

多模型查询服务器

测试平台 MCP 服务器

漏洞赏金平台