基于 Codex Skills 目录的 Sentry 只读可观测性技能：用 Sentry CLI 排查线上问题

基于 Codex Skills 目录的 Sentry 只读可观测性技能用 Sentry CLI 排查线上问题【免费下载链接】skillsSkills Catalog for Codex项目地址: https://gitcode.com/GitHub_Trending/skills4/skills导读本文讲解 GitHub 推荐项目精选 skills 仓库中sentry技能Skill的完整用法。该技能封装了 Sentry CLI 的只读查询能力让 AI Agent 在收到查看 Sentry issue/event、总结近期线上错误、拉取基础健康数据等请求时能通过sentry命令自动完成认证、组织/项目探测、分页与重试并以 JSON 结构化输出结果。读完本文你将掌握从安装认证、issue/event 查询到 AI 根因分析与修复方案生成的完整实战链路并能理解该技能在 Codex 中的装配方式与输出规范。技能定位Sentry 只读可观测性sentry技能定义于 skills/.curated/sentry/SKILL.md属于本仓库 curated精选技能目录。其设计目标非常明确当用户要求查看 Sentry issues 或 events、总结近期生产错误、拉取基础 Sentry 健康数据时被触发所有操作均为只读查询统一通过sentryCLI 完成底层命令自动处理认证、组织/项目探测、分页和重试Agent 无需自行实现这些繁琐逻辑。该技能的装配元数据在 skills/.curated/sentry/agents/openai.yaml 中声明显示名称为 Sentry (Read-only Observability)默认提示词default_prompt为以只读方式调查该 Sentry issue并报告可能的根因、影响和后续步骤——这决定了 Agent 被触发后的默认行为模式。快速开始认证与安装1. 认证方式二选一使用前必须先完成 Sentry CLI 的认证两种方式任选其一# 方式一交互式登录浏览器授权 sentry auth login # 方式二设置环境变量适合 CI / 非交互场景 export SENTRY_AUTH_TOKENyour-auth-token安全红线绝对不要要求用户把完整 Token 粘贴到聊天中。应让用户在本地自行设置确认完成后即可继续。在输出中也严禁回显认证 Token。2. 确认认证状态sentry auth status3. 安装 Sentry CLI如果 CLI 尚未安装按以下步骤操作# 1. 安装 Sentry CLI curl https://cli.sentry.dev/install -fsS | bash # 2. 登录认证 sentry auth login # 3. 确认认证成功 sentry auth status4. 组织/项目自动探测机制CLI 会从以下来源自动探测组织org与项目project.env文件中的 DSN源码中的 DSN 配置配置默认值目录名。只有在自动探测失败或探测到错误目标时才需要显式指定org/project。这意味着 Agent 在绝大多数场景下可以直接执行查询命令无需关心目标地址。5. 默认参数与 JSON 输出约定技能内置了三组关键默认值参数默认值传参方式时间范围time_range24h--period 24h环境environmentproduction并入--query如environment:production结果条数上限limit20--limit 20输出约定程序化处理输出时始终使用--json使用--json --fields只选择需要的字段减小输出体积快速发现可用 API 端点时使用sentry schema resource。核心任务基于 Sentry CLI 的七类查询所有查询统一走sentryCLI且尽量使用--json以获得机器可读输出。以下命令均可直接复制运行。1. 列出 issues按最近排序查询最近 24 小时内生产环境未解决的 issue取前 20 条并只输出指定字段sentry issue list \ --query is:unresolved environment:production \ --period 24h \ --limit 20 \ --json --fields shortId,title,priority,level,status如果自动探测未能解析出 org/project显式传入sentry issue list {your-org}/{your-project} \ --query is:unresolved environment:production \ --period 24h \ --limit 20 \ --json2. 将 issue 短 ID 解析为详情sentry issue view {ABC-123} --json注意必须使用短 ID 格式如ABC-123而不是数字型 ID。3. 查看 issue 详情sentry issue view {ABC-123}4. 查看 issue 的 events事件流sentry issue events {ABC-123} --limit 20 --json事件流是理解该 issue 究竟被哪些请求/堆栈触发过的关键--limit控制取样数量。5. 查看单个 event 详情sentry event view {your-org}/{your-project}/{event_id} --jsonevent 详情通常包含 culprit罪魁祸首位置、时间戳、环境、release 版本与 URL 等信息见下文输出格式规范。6. AI 驱动的根因分析Root Cause Analysissentry issue explain {ABC-123}该命令借助 AI 能力对 issue 进行根因解释适合在定位问题时快速获得假设方向。7. AI 驱动的修复方案生成sentry issue plan {ABC-123}在根因明确后可用该命令生成修复计划作为后续代码改动的起点。兜底方案任意 API 访问与端点发现对于没有专属 CLI 子命令的端点使用sentry api直接打 REST 接口sentry api /api/0/organizations/{your-org}/ --method GET使用sentry schema快速发现可用端点sentry schema issues这一兜底路径保证了技能的覆盖面即使官方 CLI 命令未覆盖某类数据Agent 仍可通过 OpenAPI schema 发现并调用对应端点属于技能的可扩展性设计。输入与默认值详解技能文档明确定义了可用的输入参数及其处理规则输入参数默认值/取值说明org_slug/project_slug自动探测从 DSN、环境变量、目录名探测失败时用位置参数{your-org}/{your-project}覆盖time_range24h以--period 24h传入environmentproduction作为--query的一部分传入如environment:productionlimit20以--limit传入search_query可选通过--query传入使用 Sentry 搜索语法如is:unresolved、assigned:meissue_short_id—直接用于sentry issue view其中search_query支持完整的 Sentry 搜索语法常用的组合包括is:unresolved未解决、is:regressed回归、assigned:me指派给我、first_seen时间窗口等可与environment:production等环境过滤条件叠加使用。输出格式规范Agent 汇报的硬性要求为了让 Agent 的汇报结果稳定、可读、合规技能对输出格式做了明确约定Issue 列表按最近排序应包含title标题short_id短 IDstatus状态first_seen首次出现时间last_seen最后出现时间count出现次数environments涉及环境top_tags高频标签Event 详情应包含culprit罪魁祸首timestamp时间戳environment环境release发布版本url相关 URL行为与安全约束若查询无结果必须明确说明无结果不能含糊带过输出时必须对 PII个人身份信息脱敏包括邮箱、IP 地址不打印原始堆栈信息绝不回显认证 Token。这些约束与技能只读可观测的定位一脉相承Agent 只负责汇报与辅助分析不做任何写操作也不泄露敏感信息。Golden Test 输入与验收示例技能内置了用于验收的示例输入与预期输出可作为复现与自测的标准Org: {your-org} Project: {your-project} Issue short ID: {ABC-123}典型提示词与预期输出示例提示词List the top 10 open issues for prod in the last 24h.预期输出按最近出现排序的 issue 列表包含标题、短 ID、出现次数、最后出现时间。这条验收标准本质上是一份可执行的测试用例验证 Agent 是否正确执行了issue list 排序 字段裁剪的完整链路。在 Codex 中的装配与安装方式sentry技能位于本仓库 skills/.curated/ 目录属于 curated精选技能。根据仓库 README.md 的说明.system目录下的技能会在最新版 Codex 中自动安装curated / experimental 技能需要通过 Codex 内的$skill-installer安装精选技能可按名称安装例如$skill-installer sentry安装完成后重启 Codex 即可生效。单个技能的许可证位于其目录内的LICENSE.txtsentry 技能的许可证为 skills/.curated/sentry/LICENSE.txtApache License 2.0。技能目录结构一览skills/.curated/sentry/ ├── SKILL.md # 技能主体指令本文讲解的核心 ├── agents/ │ └── openai.yaml # Agent 装配元数据display_name、default_prompt、图标 ├── assets/ │ ├── sentry-small.svg │ └── sentry.png └── LICENSE.txt # Apache License 2.0SKILL.md 是技能的行为指令本体agents/openai.yaml 则定义了它在 Codex 界面中的展示名称、默认提示词与图标两者共同构成了一个完整可装配的 Agent 技能包。总结技能的关键设计要点只读原则所有命令均为查询性质不执行任何写操作适合作为生产环境的安全观测入口自动化优先认证、org/project 探测、分页、重试全部由 CLI 承担Agent 只需关注查询语义结构化输出--json--fields裁剪配合明确的字段级输出规范保证下游解析稳定AI 能力内置issue explain与issue plan让定位问题与规划修复可以一步到位安全合规Token 永不出现在聊天与输出中PII 必须脱敏原始堆栈不直接打印可扩展sentry apisentry schema兜底任意端点Golden Test 提供可复现的验收基准。掌握这套技能Agent 便能在收到最近生产环境出了什么问题这类模糊指令时稳定输出按最近排序的 issue 列表 关键字段 根因分析与修复建议真正把 Sentry 的只读可观测能力变成可复用的 Agent 能力。【免费下载链接】skillsSkills Catalog for Codex项目地址: https://gitcode.com/GitHub_Trending/skills4/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考