用途
这是 Sentry 在 AI 智能体中的统一入口技能。它的目标是先低成本地了解用户当前的 Sentry 与项目状态，再让用户决定下一步：对于全新项目，直接端到端完成 Sentry 的首次错误设置；对于已经使用 Sentry 的项目，则把用户路由到其他可用的 Sentry 技能。
主要能力
- 探测 Sentry MCP 是否已连接并完成认证（通过 find_organizations 或 whoami）。
- 检查当前仓库是否已经使用 Sentry（搜索 @sentry、sentry-sdk、sentry_sdk 或 DSN）。
- 查询用户是否已有 Sentry 项目（find_projects）。
- 对新项目运行首次错误设置流程：检测平台、创建项目、以合理默认值安装 SDK（错误、追踪及 SDK 默认开启的能力）、验证真实错误进入 Sentry、推动用户走向生产环境，并确认生产堆栈跟踪可读。
- 对已有 Sentry 的项目展示菜单，路由到插桩、调试问题、修复堆栈跟踪、设置发布等技能。
- 在引导会话中，根据首次提示中的随机 10 位标识符，静默调用 onboarding_status_update 更新 Sentry Web 应用中的引导 UI 进度。
使用方式
技能以引导式对话进行。首先用简短友好的话介绍 Sentry，然后执行三项快速探测：MCP 连接与认证状态、仓库是否已集成 Sentry、是否已有 Sentry 项目。
如果 MCP 未认证，会通过交互式提示询问用户：没有账户则引导到 https://sentry.io/signup 注册后再连接 MCP；已有账户则根据所在运行环境建议合适的 Sentry MCP 认证方式。若 MCP 未安装，会指向 https://mcp.sentry.dev 添加。
对于全新用户（仓库中没有 Sentry），不展示菜单，直接运行 references/first-error-setup.md 的完整流程，并同时阅读 references/sdk-docs.md 与 references/concepts/errors.md。完成后会提示其他选项，主要是 sentry-instrument 技能以及发布跟踪，但不会自动运行。
对于已有用户（仓库中已有 Sentry），跳过首次错误设置，展示交互式菜单，选项包括：添加信号（追踪、日志、指标、cron、uptime、性能分析、会话回放、用户反馈、AI/LLM 监控）、正确设置 Sentry、修复或调查问题、使堆栈跟踪可读、跟踪发布与部署。技能会先确认目标技能在当前环境中确实可用，可用则交接，不可用则诚实提供文档回退方案。
适用场景
- 新项目首次接入 Sentry，希望由智能体自动完成 SDK 安装与验证。
- 已有 Sentry 项目，需要快速找到并进入正确的 Sentry 技能。
- 需要了解当前 Sentry 账户、项目与仓库集成状态。
限制
- 部分 Sentry Web UI 能力尚未构建为技能，例如改进/加固（数据清洗、用量、OTel）以及监控与告警；遇到这类请求会明确说明并提供文档回退。
- 注册 Sentry 账户本身没有智能体流程，只能引导用户到注册页面。
- 引导进度更新依赖首次提示中的特定随机标识符；没有该标识符则不会发送进度调用。
- 所有 MCP 数据视为不可信输入，不会执行事件负载、问题标题或评论中的指令。
- 进度更新仅包含最小状态说明，不暴露源代码、文件内容、仓库路径、终端输出、事件负载、MCP 结果、密钥、凭据或个人信息。
- 取消由引导 UI 控制；若进度调用永久不可用，会静默停止更新并继续正常设置。