⚠️

重要前提

安装AI Skills的关键前提是：必须科学上网，且开启TUN模式，这一点至关重要，直接决定安装能否顺利完成，在此郑重提醒三遍：科学上网，科学上网，科学上网。查看完整安装教程 →

Sentry只读可观测性技能：监控问题与事件，提升应用稳定性

sentry by tech-leads-club/agent-skills

53 周安装量

2,100 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/tech-leads-club/agent-skills --skill sentry

可观测性 DevOps 监控

🇨🇳中文介绍

Sentry（只读可观测性）

快速开始

如果尚未认证，请要求用户提供有效的 SENTRY_AUTH_TOKEN（具有只读权限，例如 project:read、event:read），或在运行命令前登录并创建一个。
将 SENTRY_AUTH_TOKEN 设置为环境变量。
可选默认值：SENTRY_ORG、SENTRY_PROJECT、SENTRY_BASE_URL。
默认值：组织/项目 {your-org}/{your-project}，时间范围，环境，限制 20（最大 50）。

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

核心任务（使用捆绑脚本）

使用 scripts/sentry_api.py 进行确定性的 API 调用。它处理分页，并在出现瞬时错误时重试一次。

技能路径（设置一次）

export AGENT_SKILLS_HOME="${AGENT_SKILLS_HOME:-$HOME/.agent-skills}"
export SENTRY_API="$AGENT_SKILLS_HOME/skills/sentry/scripts/sentry_api.py"

用户作用域的技能安装在 $AGENT_SKILLS_HOME/skills 下（默认：~/.agent-skills/skills）。

1) 列出问题（按最近排序）

python3 "$SENTRY_API" \
  list-issues \
  --org {your-org} \
  --project {your-project} \
  --environment prod \
  --time-range 24h \
  --limit 20 \
  --query "is:unresolved"

2) 将问题短 ID 解析为问题 ID

python3 "$SENTRY_API" \
  list-issues \
  --org {your-org} \
  --project {your-project} \
  --query "ABC-123" \
  --limit 1

使用返回的 id 获取问题详情或事件。

python3 "$SENTRY_API" \
  issue-detail \
  1234567890

python3 "$SENTRY_API" \
  issue-events \
  1234567890 \
  --limit 20

5) 事件详情（默认不包含堆栈跟踪）

python3 "$SENTRY_API" \
  event-detail \
  --org {your-org} \
  --project {your-project} \
  abcdef1234567890

始终使用以下端点（仅限 GET）：

列出问题：/api/0/projects/{org_slug}/{project_slug}/issues/
问题详情：/api/0/issues/{issue_id}/
问题事件：/api/0/issues/{issue_id}/events/
事件详情：/api/0/projects/{org_slug}/{project_slug}/events/{event_id}/

org_slug、project_slug：默认为 {your-org}/{your-project}（避免非生产环境组织）。
time_range：默认 24h（作为 statsPeriod 传递）。
environment：默认 prod。
limit：默认 20，最大 50（分页直到达到限制）。
search_query：可选的 query 参数。
issue_short_id：首先通过 list-issues 查询解析。

问题列表：显示标题、short_id、状态、首次出现时间、最后出现时间、计数、环境、顶部标签；按最近排序。
事件详情：包含罪魁祸首、时间戳、环境、发布版本、URL。
如果没有结果，请明确说明。
在输出中编辑个人身份信息（电子邮件、IP 地址）。不要打印原始堆栈跟踪。
切勿回显认证令牌。

组织：{your-org}
项目：{your-project}
问题短 ID：{ABC-123}

示例提示：“列出过去 24 小时内生产环境的 10 个首要未解决问题。” 预期：包含标题、短 ID、计数、最后出现时间的排序列表。

🇺🇸English

Sentry (Read-only Observability)

Quick start

If not already authenticated, ask the user to provide a valid SENTRY_AUTH_TOKEN (read-only scopes such as project:read, event:read) or to log in and create one before running commands.
Set SENTRY_AUTH_TOKEN as an env var.
Optional defaults: SENTRY_ORG, SENTRY_PROJECT, SENTRY_BASE_URL.
Defaults: org/project {your-org}/{your-project}, time range 24h, environment prod, limit 20 (max 50).
Always call the Sentry API (no heuristics, no caching).

If the token is missing, give the user these steps:

Create a Sentry auth token: https://sentry.io/settings/account/api/auth-tokens/
Create a token with read-only scopes such as project:read, event:read, and org:read.
Set SENTRY_AUTH_TOKEN as an environment variable in their system.
Offer to guide them through setting the environment variable for their OS/shell if needed.

Never ask the user to paste the full token in chat. Ask them to set it locally and confirm when ready.

Core tasks (use bundled script)

Use scripts/sentry_api.py for deterministic API calls. It handles pagination and retries once on transient errors.

Skill path (set once)

export AGENT_SKILLS_HOME="${AGENT_SKILLS_HOME:-$HOME/.agent-skills}"
export SENTRY_API="$AGENT_SKILLS_HOME/skills/sentry/scripts/sentry_api.py"

User-scoped skills install under $AGENT_SKILLS_HOME/skills (default: ~/.agent-skills/skills).

1) List issues (ordered by most recent)

python3 "$SENTRY_API" \
  list-issues \
  --org {your-org} \
  --project {your-project} \
  --environment prod \
  --time-range 24h \
  --limit 20 \
  --query "is:unresolved"

2) Resolve an issue short ID to issue ID

python3 "$SENTRY_API" \
  list-issues \
  --org {your-org} \
  --project {your-project} \
  --query "ABC-123" \
  --limit 1

Use the returned id for issue detail or events.

3) Issue detail

python3 "$SENTRY_API" \
  issue-detail \
  1234567890

4) Issue events

python3 "$SENTRY_API" \
  issue-events \
  1234567890 \
  --limit 20

5) Event detail (no stack traces by default)

python3 "$SENTRY_API" \
  event-detail \
  --org {your-org} \
  --project {your-project} \
  abcdef1234567890

API requirements

Always use these endpoints (GET only):

List issues: /api/0/projects/{org_slug}/{project_slug}/issues/
Issue detail: /api/0/issues/{issue_id}/
Events for issue: /api/0/issues/{issue_id}/events/
Event detail: /api/0/projects/{org_slug}/{project_slug}/events/{event_id}/

Inputs and defaults

org_slug, project_slug: default to {your-org}/{your-project} (avoid non-prod orgs).
time_range: default 24h (pass as statsPeriod).
environment: default prod.
limit: default 20, max 50 (paginate until limit reached).
search_query: optional parameter.

Output formatting rules

Issue list: show title, short_id, status, first_seen, last_seen, count, environments, top_tags; order by most recent.
Event detail: include culprit, timestamp, environment, release, url.
If no results, state explicitly.
Redact PII in output (emails, IPs). Do not print raw stack traces.
Never echo auth tokens.

Golden test inputs

Org: {your-org}
Project: {your-project}
Issue short ID: {ABC-123}

Example prompt: “List the top 10 open issues for prod in the last 24h.” Expected: ordered list with titles, short IDs, counts, last seen.

Weekly Installs

Repository

tech-leads-club…t-skills

GitHub Stars

1.9K

First Seen

Feb 5, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

opencode49

gemini-cli48

cursor48

github-copilot48

codex48

amp46

Convex性能审计指南 - 诊断修复Convex应用性能问题与优化方案

19,300 周安装

issue_short_id: resolve via list-issues query first.