同步：用证据解决真正的问题
从报告的错误到可审查的修复。
人工智能可以快速编写代码，但它仍然像盲人一样进行调试。在没有证据的情况下，代理人经常猜测并只修复症状，导致“仍然破碎”的循环消耗时间和代币。
同步 为您的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": "" }
}
}
}注： 环境变量是可选的。如果没有提供，服务器将以匿名模式运行。
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/` |