Sentry 生产错误观察助手
通过 Sentry CLI 检查问题、事件和生产环境健康数据。
技能明确限定为只读查询,要求本地认证、禁止在聊天中粘贴完整令牌,并要求脱敏个人信息和不输出原始堆栈;因此主要安全风险可见。扣分原因是未要求敏感查询或任意 API 访问前确认,且未说明数据传输范围、服务端保留、回滚机制或依赖安装风险。
命令示例、默认参数、JSON 输出和认证流程较一致,静态阅读显示快乐路径可理解。扣分原因是未提供测试或可复现执行证据,自动探测可能误选组织/项目,且异常输入、权限失败、网络失败和无效资源的诊断处理不足;按静态校准不超过10分。
目标用户、Sentry 问题/事件查询和基础健康数据场景较清楚,并声明只读边界、输入字段和若无结果时的输出要求。扣分原因是触发排除条件、支持的 CLI 版本和中文输出支持未明确;对中国大陆网络可达性没有证据,且核心功能依赖外部 Sentry 服务。
文档有快速开始、核心任务、输入默认值、输出规则和示例,结构清晰。扣分原因是仓库已声明废弃,单项技能许可证未知,缺少技能版本、变更日志、明确维护责任和更新路径,也缺少故障排查与已知限制说明。
技能覆盖列出问题、查看详情、事件和基础分析/计划等核心任务,并规定了可直接使用的输出字段。扣分原因是没有静态可验证的真实输出或执行证据,AI 分析命令的可用性和输出质量未被证明,且相对手工 CLI 查询的增量价值有限;按静态校准不超过7分。
源文件提供了可审计的命令、参数和行为声明,且官方组织来源可作为出处证据。扣分原因是没有测试套件、CI 覆盖、第三方执行结果或交叉来源验证;结论主要依赖作者文档,按静态校准不超过5分。
- 安装说明使用远程 curl 管道脚本,未说明校验来源、版本固定或失败后的清理策略;用户应在本地审查后执行。
- 自动从 DSN、环境变量、源码和目录名探测组织/项目,可能导致查询错误目标;执行前应核对目标范围。
- “只读”边界未覆盖所有任意 API 端点和 AI 分析命令,不能据此假设所有操作或数据处理都无外部影响。
- 仓库已标记为废弃,且单项许可证未知;应确认当前维护来源和许可条件。
- 未提供中国大陆网络可达性或中文输出证据,外部 Sentry 服务不可达时核心功能可能无法使用。
它能做什么 & 适用场景
这是一个只读的 Sentry 可观测性技能,供 AI 代理通过 Sentry CLI 查询问题、事件和基础健康数据。它默认查询过去 24 小时的 production 环境,最多返回 20 条结果,并支持 JSON 输出。技能可以查看问题详情、事件、任意 Sentry API 端点,以及生成 AI 根因分析和修复计划。使用前需要安装并认证 Sentry CLI;输出应隐藏个人信息和原始堆栈跟踪。
运行 sentry issue list 按最近时间列出未解决问题;使用短 ID 查看问题详情和问题事件;使用组织、项目和事件 ID查看事件详情;使用 sentry issue explain 生成根因分析,使用 sentry issue plan 生成修复计划;对未覆盖的端点运行 sentry api,并通过 sentry schema 发现端点;以 JSON 或选定字段输出结果,明确说明无结果,并隐藏邮箱、IP 和认证令牌。
- 负责生产环境的工程师想查看过去 24 小时 production 中最常见的未解决问题。
- 值班人员需要根据问题短 ID查看问题详情和近期事件。
- 工程师需要查看某个事件的 culprit、时间戳、环境、release 和 URL。
- 团队希望对某个 Sentry 问题获取 AI 根因分析或修复计划。
- 需要查询专用命令未覆盖的 Sentry API 端点,但仍希望通过 CLI 完成只读访问的用户。
优缺点一览
- 覆盖问题列表、问题详情、事件详情和任意 API 访问。
- 支持 JSON 及字段筛选,适合程序化处理。
- 明确要求只读查询、隐藏 PII、避免输出原始堆栈和令牌。
- CLI 负责认证、组织/项目识别、分页和重试。
- 依赖已安装且已认证的 Sentry CLI。
- 需要访问 Sentry 网络接口,并可能需要读取本地 DSN、环境变量、配置或目录信息。
- 源材料未提供测试套件、平台验证或性能数据。
- 仓库已 deprecated,且本技能的许可证文件未在源材料中提供。
如何安装
该技能位于 skills/.curated/sentry/。README 说明可在 Codex 中运行 $skill-installer sentry 安装 curated 技能,安装后重启 Codex。该仓库已被标记为 deprecated,README 未提供其他针对本技能的安装方式。
如何使用
如果尚未认证,请先运行 sentry auth login,或在本地设置 SENTRY_AUTH_TOKEN,再运行 sentry auth status确认。示例触发请求:"List the top 10 open issues for prod in the last 24h." CLI 会尝试从 DSN、环境变量、配置默认值和目录名自动识别组织与项目;失败时可显式传入 <org>/<project>。默认时间范围为 24h、环境为 production、限制为 20 条。