Debug Skill

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

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

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

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

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

强制性指令集

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

• 强制性证据收集：在提供修复之前，代理必须获取运行时事实以了解故障上下文。
• 循证修复：在分析问题时，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": "" }
    }
  }
}

注： 环境变量是可选的。如果没有提供，服务器将以匿名模式运行。

VS Code (GitHub Copilot Chat)

第一步：技能安装

⚠️ 重要 确保： 1. GitHub Copilot聊天扩展已安装。 1. chat.useAgentSkills 在设置中启用。

快速引导安装

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": "" }
    }
  }
}

注： 环境变量是可选的。如果没有提供，服务器将以匿名模式运行。

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": "" }
    }
  }
}

注： 环境变量是可选的。如果没有提供，服务器将以匿名模式运行。

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 = ""

注： 环境变量是可选的。如果没有提供，服务器将以匿名模式运行。

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

{ "mcpServers": { "debug-mcp-server": { "command": "npx", "args": ["-y", "@syncause/debug-mcp@latest"], "env": { "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安装

**手动编辑配置**

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

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

> **注：** 环境变量是可选的。如果没有提供，服务器将以匿名模式运行。

5. 保存文件并单击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": "" } } } }

> **注：** 环境变量是可选的。如果没有提供，服务器将以匿名模式运行。

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

> **提示**
> OpenCode也与Claude的技能目录兼容： `.claude/skills/` 和 `~/.claude/skills/`

#### 步骤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": "" }, "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/` |