用途
TAPD Bug Analyzer 用于自动化分析和定位 TAPD Bug 单中的问题。它旨在减少人工排查 Bug 的重复工作,将 Bug 单信息、日志检索和代码分析串联为一条自动化流程。
主要能力
该技能以命令 /tapd-bug <bug_url> [--env <environment>] [--region <region>] 的形式使用,能够:
- 解析 TAPD Bug 链接,从中提取 workspace_id 和 bug_id。
- 通过 TAPD MCP 工具
mcp__mcp-server-tapd__get_bug获取 Bug 单详情,包括标题、描述、状态、严重程度、优先级、报告人、处理人等信息。 - 根据 Bug 描述内容自动选择分析策略。
- 输出结构化的分析报告,包含错误摘要、调用链路、问题定位与修复建议。
使用方式
命令参数
bug_url:必填,TAPD Bug 单链接,格式为https://www.tapd.cn/{workspace_id}/bugtrace/bugs/view/{bug_id}。--env:可选,环境名称,支持 dev、test、prod,默认根据 URL 自动判断。--region:可选,地域,支持 shanghai、hangzhou,默认 shanghai。
分析策略
Step 1:解析 TAPD Bug 链接,提取 workspace_id 和 bug_id。
Step 2:调用 mcp__mcp-server-tapd__get_bug 获取 Bug 详情,字段包括 id、title、description、status、severity、priority、reporter、current_owner、created、modified。
Step 3:阅读 Bug 描述,按优先级选择策略:
- 策略 A:包含 traceId。若描述中含 16 位十六进制字符串(正则
[a-f0-9]{16},常见格式如 traceId: xxx、trace_id=xxx、X-B3-TraceId: xxx),则调用 sls-trace-analyzer,脚本路径为~/.claude/skills/sls-trace-analyzer/sls-query.py,参数含 trace-id、region、env。脚本默认同时查询普通存储和长期存储两个 logstore 以获取完整日志。 - 策略 B:包含带时间戳的请求 URL。若描述中含 API 请求 URL(模式
http(s)://xxx.abczs.cn/api/...,末尾带 13 位毫秒时间戳),则调用 sls-trace-analyzer 的 URL 模式。该工具会自动解析 URL 中的域名、路径、时间戳,根据域名判断环境和地域,查询网关日志获取 traceId,再用 traceId 查询完整调用链日志并输出分析结果。 - 策略 C:无 traceId 也无时间戳。基于 Bug 描述进行代码分析:提取关键信息(错误消息、功能模块、操作步骤),使用 codebase-retrieval 搜索相关代码,分析业务逻辑并推断问题原因。
Step 4:日志分析与问题定位。获取 traceId 后调用 sls-trace-analyzer 深度分析,包括识别 ERROR/WARN 级别日志、Java 异常堆栈(Exception、Caused by)、提取错误消息与错误码、按时间排序日志条目、识别请求入口(Controller)与出口、标记 RPC/Feign 调用与响应、从异常堆栈提取类名和行号(优先关注 cn.abcyun 包下的代码),并使用 codebase-retrieval 查找对应代码。
Step 5:输出结构化报告,包含 Bug 基本信息、分析策略(策略 A/B/C、TraceId、请求时间)、错误摘要(错误类型、错误消息、发生位置)、调用链路、问题定位(根因分析、相关代码)和修复建议。
适用场景
- Bug 描述中包含 traceId 时,可直接定位日志。
- Bug 描述中包含带时间戳的请求 URL 时,可通过网关日志反查调用链。
- Bug 描述为纯文字(如复现步骤、业务现象)时,通过代码检索与逻辑分析推断原因。
限制
资料中未提供该技能的收费、价格、平台约束、性能指标或兼容性信息。分析效果取决于 Bug 描述质量、日志可用性以及依赖的 TAPD MCP 工具和 sls-trace-analyzer 是否可用,这些依赖的具体配置资料暂未提供。