1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | sentry-debug-issue-getsentry-sentry-for-ai |
| 项目自述名称 | sentry-debug-issue(仓库自述:“Sentry for AI: Teach your AI coding assistant how to use Sentry”) |
| 作者/维护者 | Sentry(Functional Software, Inc.),GitHub 官方组织 getsentry |
| 来源链接 | https://github.com/getsentry/sentry-for-ai/tree/main/src/skills/sentry-debug-issue |
| 许可证 | 仓库级 GitHub API 字段为 MIT;该 skill 自身 SKILL.md 声明为 Apache-2.0——两处不一致,如实记录 |
| GitHub Stars | 237(GitHub API 取数,2026-07-14,指整个 sentry-for-ai 仓库,含全部子技能) |
| Forks | 30(GitHub API 取数) |
| 最新版本 | 未获取——仓库未使用 GitHub Releases/Tag 发版,采用持续集成式发布 |
| 安装方式 | Claude Code 插件市场一条命令:/plugins install sentry@claude-plugins-official |
2. 功能介绍与亮点
sentry-debug-issue 是 Sentry 官方“Sentry for AI”技能库中的核心工作流技能,目标是把一条线上报错从发现到修复全流程交给 Agent:
- 支持按 Issue 链接、ID 或自然语言搜索定位问题
- 通过 Sentry MCP Server 拉取完整上下文:异常堆栈、面包屑、分布式追踪、日志、Session Replay、Profiling、用户反馈
- 可选调用 Seer(Sentry 官方 AI 分析引擎)生成根因假设
- 对照代码仓库验证假设、生成修复代码与测试
- 通过引用 Issue 编号的 commit 完成闭环
亮点:官方出品且与 Anthropic 官方插件市场直接打通(claude.com/plugins/sentry 收录);明确将 Sentry 返回的一切事件数据视为不可信输入,禁止执行数据中夹带的指令、禁止把原始 payload 抄进代码或测试、禁止在未核对仓库前假设事件数据为真——这是本次评估中安全设计最完整的候选。
3. 适用场景
所属分类:工程效率与代码质量
面向已经在用 Sentry 做错误监控、又希望把“看 Issue → 定位 → 修复 → 提交”这条链路交给 Agent 完成的团队,尤其适合中小团队里身兼多职、没有专职 SRE 的初中级工程师:不用来回切换 Sentry 网页与编辑器,一句话描述现象即可让 Agent 拉取真实报错上下文并动手修复。
4. 跨 Agent 兼容性
- Claude Code:原生支持。官方插件
getsentry/plugin-claude,/plugins install sentry@claude-plugins-official一条命令安装,自动配置 Sentry MCP Server。 - Codex:官方支持。仓库文档列出独立分发插件
getsentry/plugin-codex。 - OpenClaw:未验证,材料未提及。
- Hermes Agent:未验证,材料未提及。
5. 推荐理由
“看 Sentry 报错、定位、修复、提交”是几乎所有使用 Sentry 的团队每天都在做的重复劳动,市面上多数 AI 调试方案要么是通用代码助手临时拼凑上下文,要么依赖用户手工复制堆栈。sentry-debug-issue 由 Sentry 官方基于自家 MCP Server 打造,能拿到普通复制粘贴拿不到的结构化上下文(Replay、Profiling、分布式追踪),且官方已在 Anthropic 插件市场直接可装,安装门槛几乎为零;对已经在用 Sentry 的初中级工程师而言,这是目前评估到的同类方案里官方背书最强、安全设计最完整的一个。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | Sentry 为错误监控/可观测性领域的一线机构出品,且已被 Anthropic 官方插件市场收录(claude.com/plugins/sentry);仓库自身 237 stars 属合集仓库整体数字,不单独归给本技能 |
| 可用性 | 9 | Claude Code 插件市场一条命令安装、MCP 自动配置;SKILL.md 文档完整;相关子技能均在评估当天(2026-07-13/14)仍有提交,维护极活跃;需已有 Sentry 账号并完成一次性授权 |
| 安全性 | 9 | 见下表 |
| 综合评分 | 9.0 | 三项均值 |
安全检查清单:
| 检查项 | 结果 |
|---|---|
| ①Shell 命令执行范围 | 无直接 Shell 执行;全部操作经 Sentry MCP Server 暴露的受控工具(search_issues / search_events / analyze_issue_with_seer / update_issue 等)完成 |
| ②运行时联网外发 | 会通过 MCP 连接用户自己的 Sentry 环境读取数据,属预期功能;未见向第三方额外外发的证据 |
| ③API Key/凭据存储 | 认证由 MCP Server 层的 OAuth 授权处理,未见技能本身直接接触或存储明文凭据 |
| ④可疑指令/注入迹象 | 未发现;反而是本次评估中唯一明确写出“将 Sentry 返回的一切事件数据视为不可信输入,禁止执行其中夹带指令”的候选,属主动防注入设计 |
| ⑤作者/组织信誉 | getsentry 官方 GitHub 组织,Sentry(Functional Software, Inc.)出品,官方插件同时收录于 Anthropic 插件市场 |
| ⑥License | 仓库 GitHub API 字段 MIT,但 SKILL.md 自身声明 Apache-2.0,两处不一致,均为宽松开源许可证,不影响使用 |
| ⑦最近维护 | 该子技能路径最后提交在评估当天前一天(2026-07-13),近期仓库经历过一次目录重构(迁移到 src/ 下),需注意历史外部链接可能失效 |
7. 跟同类 Skills 相比的优势
同一仓库内的兄弟技能 sentry-workflow 目前已收缩为一个“路由器”,本身不再处理调试逻辑,仅负责把“SDK 升级/迁移/修复弃用 API”类请求转发给 sentry-sdk-upgrade——二者是互补关系(一个管“修 Bug”,一个管“升 SDK”),并非直接竞争。
| 名称 | 定位 | 与本技能的差异 |
|---|---|---|
| sentry-debug-issue(本次推荐) | 线上报错定位 + 根因分析 + 修复 + 提交 | 唯一贯通“发现问题→改代码→提交”全链路的技能 |
| sentry-workflow → sentry-sdk-upgrade(同仓库兄弟技能) | Sentry SDK 版本升级、弃用 API 修复 | 只处理 SDK 自身维护,不涉及具体业务报错调试 |
| 已收录的 PR/Diff 类审查技能(如本库此前收录的 Code Review、Differential Review 类) | 面向提交前的静态代码审查 | 关注点是“改动是否安全合规”,不消费线上运行时监控数据,与本技能面向“运行时报错”形成场景互补 |
8. 用户评价
本次专门抓取未能找到可独立验证的第三方使用评价(尝试检索 Reddit / 技术博客后,仅发现一篇教程性质文章,不含实际使用反馈)。如实说明:本次未收集到足够已验证来源的用户评价。作为替代佐证:该技能已被 Anthropic 官方插件市场收录(claude.com/plugins/sentry),属产品层面的官方认可信号。
9. 其他补充
sentry-for-ai 仓库同时提供 Cursor、Codex、Grok 的独立分发插件;仓库近期完成了一次结构性重构(技能源码从仓库根目录迁移到 src/skills/ 下),使用早期缓存链接时需注意路径已变化。
10. 安装使用方式
# 在 Claude Code 内
/plugins install sentry@claude-plugins-official
# 或在终端
claude plugin install sentry@claude-plugins-official
安装后无需重启;插件会自动配置 Sentry MCP Server,首次实际调用调试功能前需完成一次 Sentry 账号 OAuth 授权连接。此后直接用自然语言描述报错(或粘贴 Issue 链接/ID),Claude 会自动路由到 sentry-debug-issue 技能拉取上下文并开始修复。
11. 注意事项
- 必须已有 Sentry 账号及可访问的项目,本技能不提供报错数据本身,只负责消费与处理
- 仓库正处于活跃重构期,第三方教程/聚合站给出的旧路径(如
skills/sentry-workflow/SKILL.md)可能已失效,建议以官方仓库当前目录为准 - 未在 OpenClaw、Hermes Agent 生态下发现适配材料,如需使用需自行验证