AgentSkillsCN

sentry

借助 Sentry 自动交叉链接功能，高效完成问题分流与调查。支持问题调查、通过 Seer 进行 AI 分析，并与 Linear 系统无缝对接，实现修复进度的全程追踪。当您需要对 Sentry 错误进行分流、调查 sentry.io 的相关 URL，或从 Sentry 中创建 Linear 问题时，可调用此技能。

SKILL.md
--- frontmatter
name: sentry
description: Sentry issue triage and investigation with automatic cross-linking. Handles issue investigation, AI analysis via Seer, and integration with Linear for tracking fixes. Use when triaging Sentry errors, investigating sentry.io URLs, or creating Linear issues from Sentry.
argument-hint: '[sentry-url | analyze <url> | linear <url> | triage --limit N]'

Sentry Issue Management

Triage, investigate, and resolve Sentry issues with enforced cross-linking to Linear and GitHub.

Organization: intexuraos-dev-pbuchman

Usage

code
/sentry                           # NON-INTERACTIVE: Triage unresolved issues
/sentry <sentry-url>              # Investigate specific issue
/sentry INT-123                   # Find Sentry issues linked to Linear issue
/sentry triage --limit 5          # Batch triage with limit
/sentry analyze <sentry-url>      # AI-powered root cause analysis via Seer

Core Mandates

  1. •Fail Fast: If Sentry, Linear, GitHub CLI, or GCloud are unavailable, STOP immediately
  2. •No Guessing: Surface-level fixes without identifying the source of corruption are FORBIDDEN
  3. •Cross-Linking: Every Sentry issue MUST be linked to a Linear issue and GitHub PR
  4. •Documentation in PR: Reasoning belongs in PR descriptions, not code comments
  5. •CI Gate: pnpm run ci:tracked MUST pass before PR creation

Invocation Detection

The skill automatically detects intent from input:

Input PatternTypeWorkflow
/sentry (no args)Batch Triagetriage-batch.md
/sentry <sentry-url>Single Issuetriage-issue.md
/sentry analyze <url>Seer Analysisanalyze-with-seer.md
/sentry linear <sentry-url>Create Linearcreate-linear-issue.md
/sentry triage --limit NLimited Batchtriage-batch.md

Tool Verification (Fail Fast)

Before ANY operation, verify all required tools:

ToolVerification CommandPurpose
Sentry MCPmcp__sentry__whoamiIssue management
Linear MCPmcp__linear__list_teamsIssue tracking
GitHub CLIgh auth statusPR creation
GCloudService account verificationFirestore access

GCloud Verification

Service account key location: ~/personal/gcloud-claude-code-dev.json

  1. •Check if credentials file exists
  2. •If gcloud auth list shows no active account, activate service account
  3. •Verify authentication

You are NEVER "unauthenticated" if the service account key file exists.

Failure Handling

If ANY required tool is unavailable, ABORT immediately:

code
ERROR: /sentry cannot proceed - <tool-name> unavailable

Required for: <purpose>
Fix: <fix-command>

Aborting.

Configured Projects

Issues are fetched from these Sentry projects:

  1. •intexuraos-development (backend services)
  2. •intexuraos-web-development (web app)

Cross-Linking Protocol (Critical)

Every Sentry issue must be traceable across all systems:

DirectionMethod
Sentry → LinearComment on Sentry with Linear issue link
Linear → Sentry[sentry] <title> naming + link in description
Linear → GitHubPR title contains INT-XXX
GitHub → LinearFixes INT-XXX in PR body
GitHub → SentrySentry link in PR description

References