打造“源码感知型” Sentry 智能分析官

# 创建目录
mkdir -p ~/.openclaw/skills/sentry_local_analyzer

# 进入目录
cd ~/.openclaw/skills/sentry_local_analyzer

# ~/.openclaw/skills/sentry_local_analyzer/__init__.py
from openclaw import Skill, tools
import requests
import os

class SentryLocalAnalyzer(Skill):
    name = "sentry_local_analyzer"
    description = "Analyze Sentry errors with direct access to local source code."

    def run(self, event_id: str, sentry_org: str, sentry_project: str, project_root: str = "."):
        # 1. 安全获取 Sentry Token
        auth_token = tools.get_env("SENTRY_AUTH_TOKEN")
        if not auth_token:
            return {"error": "Missing SENTRY_AUTH_TOKEN in environment"}

        # 2. 调用 Sentry API 获取事件详情
        url = f"https://sentry.io/api/0/projects/{sentry_org}/{sentry_project}/events/{event_id}/"
        headers = {"Authorization": f"Bearer {auth_token}"}
        response = requests.get(url, headers=headers)
        event_data = response.json()

        # 3. 提取最相关的应用代码帧（优先 in_app=True）
        frame = self._extract_app_frame(event_data)
        if not frame:
            return {"error": "No relevant application frame found"}

        file_path = frame["filename"]
        line_num = frame["lineno"]

        # 4. 【核心】映射到本地源码并读取上下文
        local_path = os.path.join(project_root, file_path.lstrip("/"))
        try:
            with open(local_path, 'r') as f:
                all_lines = f.readlines()
            # 提取错误行前后各5行（共11行）
            start = max(0, line_num - 6)
            end = min(len(all_lines), line_num + 5)
            code_snippet = ''.join(all_lines[start:end])
            error_line = all_lines[line_num - 1].strip()
        except FileNotFoundError:
            return {"error": f"Source file not found: {local_path}"}

        # 5. 构建精准诊断 Prompt
        prompt = f"""
        Analyze this production error using the LOCAL source code below.

        Sentry Event: {event_id}
        File: {file_path} | Line: {line_num}
        Error Line: `{error_line}`

        Code Context:
        ```python
        {code_snippet}
        ```

        Tasks:
        1. Root cause of the error on line {line_num}?
        2. Missing checks or invalid assumptions?
        3. Provide a minimal fix as a unified diff.
        4. Critical for production? (Yes/No)

        Respond in JSON.
        """

        # 6. 调用 LLM 并返回结构化结果
        analysis = self.llm.ask(prompt, json=True)
        return {
            "event_id": event_id,
            "file": local_path,
            "line": line_num,
            "analysis": analysis,
            "sentry_url": f"https://sentry.io/.../{event_id}"
        }

    def _extract_app_frame(self, event_data):
        """从 Sentry 堆栈中提取最深的应用代码帧"""
        try:
            frames = event_data["entries"][0]["data"]["exception"]["values"][0]["stacktrace"]["frames"]
            # 优先返回标记为 in_app 的最深帧
            for frame in reversed(frames):
                if frame.get("in_app", False):
                    return frame
            return frames[-1]  # 退化到最后一帧
        except (KeyError, IndexError):
            return None

SENTRY_AUTH_TOKEN=your-sentry-auth-token

openclaw run sentry_local_analyzer --project-root /path/to/your/project ...

openclaw run sentry_local_analyzer \
  --event-id "SENTRY_EVENT_ID" \
  --sentry-org "your-org" \
  --sentry-project "your-project"