agentCLAWHUBUnverified
qa-bug-root-cause-analysis
当某个 Bug 频繁复现、线上有缺陷需要做事后分析、或者发现同一类问题反复出现需要根治时使用此技能。从症状出发用 5Why、因果图和鱼骨图等方法系统化定位缺陷根源，区分直接原因、间接原因和系统原因。不要只修症状——根因分析的价值在于找到让同类 Bug 不再发生的系统性改进措施，同时分析漏测原因来优化测试设计。 ⚠️ 本技能示例可能调用外部日志/监控工具，请在受控环境执行。 触发场景：Bug根因、根因分析、为什么出Bug、深层原因、定位问题、排查方向、反复出现同类问题需要根因改进时。 Use when the user asks about: root cause analysis for recurring or escaped defects using 5 Whys, fishbone diagrams, and causal diagrams, plus escaped-defect analysis. Skill: qa-bug-root-cause-analysis Owner: kokxi Summary: 当某个 Bug 频繁复现、线上有缺陷需要做事后分析、或者发现同一类问题反复出现需要根治时使用此技能。从症状出发用 5Why、因果图和鱼骨图等方法系统化定位缺陷根源，区分直接原因、间接原因和系统原因。不要只修症状——根因分析的价值在于找到让同类 Bug 不再发生的系统性改进措施，同时分析漏测原因来优化测试设计。 ⚠️ 本技能示例可能调用外部日志/监控工具，请在受控环境执行。 触发场景：Bug根因、根因分析、为什么出Bug、深层原因、定位问题、排查方向、反复出现同类问题需要根因改进时。 Use when the user asks about: root cause analysis for recurring or escaped defects using 5 Whys, fishbone diagrams, and
OpenClaw
Rank
62
Safety
84
Downloads
1.1k
Updated
Oct 11, 2026
Version
1.8.0
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 1.1K downloadsadoption · observed Oct 11, 2026
- Latest release
- 1.8.0release · observed Sep 29, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s170jw3s1atcj5jwhqb4r7v7eh8912kp:qa-bug-root-cause-analysis- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-kokxi-qa-bug-root-cause-analysis/snapshot"
Documentation
CLAWHUB
80,361 characters of source documentation, loaded on request.
Extracted files
4 files captured from the source.
SKILL.md
---
name: qa-bug-root-cause-analysis
description: >-
当某个 Bug 频繁复现、线上有缺陷需要做事后分析、或者发现同一类问题反复出现需要根治时使用此技能。从症状出发用 5Why、因果图和鱼骨图等方法系统化定位缺陷根源，区分直接原因、间接原因和系统原因。不要只修症状——根因分析的价值在于找到让同类 Bug 不再发生的系统性改进措施，同时分析漏测原因来优化测试设计。 ⚠️ 本技能示例可能调用外部日志/监控工具，请在受控环境执行。 触发场景：Bug根因、根因分析、为什么出Bug、深层原因、定位问题、排查方向、反复出现同类问题需要根因改进时。 Use when the user asks about: root cause analysis for recurring or escaped defects using 5 Whys, fishbone diagrams, and causal diagrams, plus escaped-defect analysis.
license: MIT
allowed-tools: Read Grep Glob Bash
metadata:
display-name: "Bug Root Cause Analysis"
version: "1.8.0"
when-to-use: "用户说\"Bug根因\"、\"根因分析\"、\"为什么出Bug\"、\"深层原因\"、\"定位问题\"、\"排查方向\"、需要分析Bug根因、反复出现同类问题需要根因改进时"
related-skills: "{\"upstream\":[\"qa-execution-observation\"],\"downstream\":[\"qa-bug-reporting\",\"qa-retrospective\"]}"
references: "[\"references/symptom-rca-map.md\"]"
input-format: "{\"required\":[{\"name\":\"Bug描述\",\"type\":\"string\",\"description\":\"缺陷的详细描述\"},{\"name\":\"执行日志\",\"type\":\"string\",\"description\":\"执行过程中的日志信息\"},{\"name\":\"环境信息\",\"type\":\"string\",\"description\":\"缺陷发现时的环境配置\"}],\"optional\":[{\"name\":\"复现步骤\",\"type\":\"array\",\"description\":\"缺陷复现的具体步骤\"}]}"
output-format: "{\"traceability\":[\"每个根因分析带唯一ID（ROOT-XXXX）\",\"关联Bug ID（TC_{缺陷模块缩写}_{功能缩写}_{序号}，如 TC_BUG_LOGIN_001；缺陷追溯保留 BUG 前缀）\"],\"structure\":[\"覆盖率：标注口径（基于现有需求/输入文档），禁止\\\"全覆盖/100%\\\"绝对化表述；缺失模块标注\\\"未覆盖+原因\\\"\",{\"root_cause\":\"根因分析结论\"},{\"contributing_factors\":\"促成因素清单\"},{\"impact_assessment\":\"影响范围评估\"},{\"fix_suggestions\":\"修复建议\"},{\"prevention_measures\":\"预防措施\"}]}"
error-recovery-guidance: "{\"on_failure\":\"根因定位不充分时回退到执行观察收集更多信号\",\"retry_behavior\":\"补充日志或环境信息后重新分析根因\"}"
categories: "[\"Development\",\"Testing\",\"Quality\"]"
depth-requirement: "{\"reference_value\":\"根据缺陷复杂度调整根因分析深度：简单×1/中等×2/复杂×3\",\"minimum\":\"至少区分直接原因、间接原因、系统原因3个层级\"}"
---
> ⚠️ 本技能单独使用效果有限，建议配合完整技能集（12 步工作流）使用。安装：npx skills add Kokxi/qa-test-skills
> **⚠️ 安全警告**：本技能的示例可能涉及订单号、支付金额、截图、身份证、手机号等敏感数据。
> 实际使用时请勿粘贴真实生产数据、客户信息或财务凭证；测试前应脱敏/掩码处理。
> 本技能仅在 workspace/ 输出评估文件，不持久化、不外传、不跨会话复用。
# Bug根因分析
## 核心原则
看到错误，能快速缩小根因范围——这不是魔法，是可学习的映射模式。
## 加载时机
| 什么时候读 | 读哪个 |
|-----------|--------|
| 定位到具体症状后，查对应的根因与验证手段 | [`references/symptom-rca-map.md`](references/symptom-rca-map.md) |
> `症状分类与根因映射`的完整内容已下沉至 `references/symptom-rca-map.md`，避免每次触发都占用上下文。
## 分析流程
### 步骤1：收集信息
```text
信息收集清单：
├─ 症状描述：具体表现是什么？
├─ 复现步骤：怎么复现？
├─ 环境信息：什么环境下出现？
├─ 时间信息：什么时候出现？
├─ 影响范围：影响多大？
└─ 相关日志：日志有什么？
```
### 步骤2：分类症状
```text
根据症状表现分类：
- 返回错误 → 代码/数据/配置/依赖层
- 数据不对 → 写入/读取/同步/转换问题
- 性能退化 → 数据库/代码/缓存/资源问题
- 没反应 → 前端/网络/后端/中间件问题
- 偶发问题 → 并发/环境/数据/时序问题
```
### 步骤3：缩小范围
```text
根据症状分类，逐层排查：
1. 先排除外部因素（依赖/环境）
2. 再排除配置因素
3. 再排查数据因素
4. 最后排查代码因素
```
### 步骤4：验证假设
```text
验证方法：
1. 复现问题
2. 修改假设条件
3. 验证问题是否消失
4. 确认根因
```
## 根因分析表
| Bug ID | 症状分类 | 根因方向 | 根本原因 | 验证方法 |
|--------|---------|---------|---------|---------|
| BUG-001 | 返回错误 | 数据层 | 数据格式错误 | 修改数据后验证 |
| BUG-002 | 性能退化 | 数据库 | 慢查询 | 添加索引后验证 |
## 症状分类_meta.json
{
"ownerId": "kn71y9b23csfx0ykgm55d5m9x5891zt8",
"slug": "qa-bug-root-cause-analysis",
"version": "1.8.0",
"publishedAt": 1790655949101
}references/symptom-rca-map.md
# 症状分类与根因映射
> 本文是 `qa-bug-root-cause-analysis` 的**症状→根因对照表**。拿到线上/测试发现的具体症状后查对应根因时读本文；
只想了解 5Why/鱼骨图等方法怎么用时不必读。
---
### 症状1：返回错误
```text
症状表现：
- HTTP状态码错误（4xx/5xx）
- 业务错误码
- 错误信息
根因方向：
├─ 代码层
│ ├─ 逻辑错误：条件判断错误
│ ├─ 空指针：对象未初始化
│ ├─ 数组越界：索引超出范围
│ └─ 类型转换：类型不匹配
│
├─ 数据层
│ ├─ 数据缺失：必要数据不存在
│ ├─ 数据错误：数据格式/值错误
│ ├─ 数据冲突：唯一性约束
│ └─ 数据过期：数据已失效
│
├─ 配置层
│ ├─ 配置缺失：配置项未配置
│ ├─ 配置错误：配置值错误
│ ├─ 环境差异：不同环境配置不同
│ └─ 配置变更：配置被意外修改
│
└─ 依赖层
├─ 依赖不可用：第三方服务故障
├─ 依赖超时：响应超时
├─ 依赖返回错误：第三方返回异常
└─ 依赖版本不兼容：接口变更
```
### 症状2：数据不对
```text
症状表现：
- 数据缺失
- 数据错误
- 数据不一致
- 数据格式异常
根因方向：
├─ 写入问题
│ ├─ 写入失败：数据库操作失败
│ ├─ 写入丢失：事务未提交
│ ├─ 写入延迟：异步写入未完成
│ └─ 写入重复：重复提交
│
├─ 读取问题
│ ├─ 缓存不一致：缓存与DB不同步
│ ├─ 读取过滤：查询条件过滤
│ ├─ 读取延迟：读从库延迟
│ └─ 读取缓存：读到旧缓存
│
├─ 同步问题
│ ├─ 同步延迟：主从同步延迟
│ ├─ 同步失败：同步任务失败
│ ├─ 同步冲突：并发同步冲突
│ └─ 同步丢失：同步任务遗漏
│
└─ 转换问题
├─ 格式转换：数据格式转换错误
├─ 编码问题：字符编码不一致
├─ 精度丢失：浮点数精度问题
└─ 时区问题：时区转换错误
```
### 症状3：性能退化
```text
症状表现：
- 响应时间变长
- 吞吐量下降
- 资源占用高
根因方向：
├─ 数据库问题
│ ├─ 慢查询：SQL执行慢
│ ├─ 索引缺失：缺少必要索引
│ ├─ 锁等待：锁竞争
│ ├─ 连接池耗尽：连接数不够
│ └─ 数据量增长：数据量变大
│
├─ 代码问题
│ ├─ 算法复杂度：算法效率低
│ ├─ 循环嵌套：循环次数多
│ ├─ 内存泄漏：内存未释放
│ ├─ 线程阻塞：线程等待
│ └─ 频繁GC：垃圾回收频繁
│
├─ 缓存问题
│ ├─ 缓存穿透：缓存未命中
│ ├─ 缓存雪崩：缓存集中失效
│ ├─ 缓存击穿：热点key失效
│ └─ 缓存容量：缓存容量不足
│
└─ 资源问题
├─ CPU瓶颈：CPU占用高
├─ 内存瓶颈：内存不足
├─ IO瓶颈：磁盘IO慢
└─ 网络瓶颈：网络延迟高
```
### 症状4：没反应
```text
症状表现：
- 点击无反应
- 操作无效果
- 界面卡住
根因方向：
├─ 前端问题
│ ├─ JS报错：JavaScript错误
│ ├─ 事件绑定：事件未绑定
│ ├─ 状态异常：前端状态错误
│ ├─ 网络请求：请求未发出
│ └─ 渲染异常：DOM渲染错误
│
├─ 网络问题
│ ├─ 请求丢失：网络丢包
│ ├─ 请求超时：网络超时
│ ├─ 连接断开：网络断开
│ └─ DNS解析：DNS解析失败
│
├─ 后端问题
│ ├─ 请求未接收：请求未到达
│ ├─ 处理阻塞：处理线程阻塞
│ ├─ 响应丢失：响应未返回
│ └─ 服务不可用：服务宕机
│
└─ 中间件问题
├─ Nginx问题：Nginx配置错误
├─ 网关问题：网关路由错误
├─ MQ问题：消息队列阻塞
└─ 限流问题：触发限流
```
### 症状5：偶发问题
```text
症状表现：
- 时有时无
- 特定条件出现
- 难以复现
根因方向：
├─ 并发问题
│ ├─ 竞态条件：并发操作冲突
│ ├─ 死锁：线程互相等待
│ ├─ 线程安全：共享资源竞争
│ └─ 资源泄露：资源未释放
│
├─ 环境问题
│ ├─ 环境差异：不同环境表现不同
│ ├─ 配置差异：配置不一致
│ ├─ 依赖状态：依赖服务状态
│ └─ 硬件差异：硬件性能差异
│
├─ 数据问题
│ ├─ 数据状态：特定数据状态触发
│ ├─ 数据量：数据量达到阈值触发
│ ├─ 数据顺序：数据顺序影响
│ └─ 数据时效：数据过期触发
│
└─ 时序问题
├─ 时序依赖：操作顺序影响
├─ 定时任务：定时任务触发
├─ 缓存过期：缓存过期触发
└─ 会话超时：会话过期触发
```skill-card.md
## Description: Helps QA engineers trace recurring or escaped bugs from symptoms to verified root causes and preventive actions. This skill is ready for commercial/non-commercial use. ## Publisher: [kokxi](https://clawhub.ai/user/kokxi) ### License/Terms of Use: MIT-0 ## Use Case: QA engineers and developers use this Chinese-language skill to investigate recurring or escaped defects, validate root-cause hypotheses, assess impact, and propose fixes and prevention measures. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: Bug reports and logs may contain customer, payment, or identity information. Mitigation: Mask sensitive data before sharing logs, screenshots, or production examples. Risk: The optional companion-skill installation introduces a separate trust decision. Mitigation: Verify the source before running the suggested installation command. Risk: Example troubleshooting may involve external log or monitoring tools. Mitigation: Use those tools only in an authorized, controlled environment. ## Reference(s): - [Symptom-to-root-cause reference](references/symptom-rca-map.md) - [ClawHub skill release](https://clawhub.ai/kokxi/skills/qa-bug-root-cause-analysis) ## Skill Output: **Output Type(s):** [Text, Markdown, Guidance] **Output Format:** [Markdown root-cause analysis and recommendations] **Output Parameters:** [1D] **Other Properties Related to Output:** [Root-cause IDs, linked bug IDs, contributing factors, impact, fixes, and prevention measures.] ## Skill Version(s): 1.8.0 (source: skill frontmatter and ClawHub release) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
Github ReposUpdated 2d agoRank 70
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
OPENCLAW
Github ReposUpdated 6mo agoRank 70
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
OPENCLAW
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/kokxi/skills/qa-bug-root-cause-analysis",
"sourceUrl": "https://clawhub.ai/kokxi/skills/qa-bug-root-cause-analysis",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T10:29:17.569Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-kokxi-qa-bug-root-cause-analysis/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-kokxi-qa-bug-root-cause-analysis/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T10:29:17.569Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.1K downloads",
"href": "https://clawhub.ai/kokxi/qa-bug-root-cause-analysis",
"sourceUrl": "https://clawhub.ai/kokxi/qa-bug-root-cause-analysis",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T10:29:17.569Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.8.0",
"href": "https://clawhub.ai/kokxi/qa-bug-root-cause-analysis",
"sourceUrl": "https://clawhub.ai/kokxi/qa-bug-root-cause-analysis",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-29T04:25:49.101Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-kokxi-qa-bug-root-cause-analysis/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-kokxi-qa-bug-root-cause-analysis/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.8.0",
"description": "**Changelog for qa-bug-root-cause-analysis v1.8.0:** - Migrated all detailed \"症状分类与根因映射\" content into a new external reference file (`references/symptom-rca-map.md`) to keep the main documentation concise. - Updated `SKILL.md` to reference the new location for symptom-to-root-cause mapping. - Removed outdated `skill-card.md` file. - Streamlined metadata and descriptions for easier integration and clearer usage scenarios. - Added tips recommending use with the full workflow skill set for best results.",
"href": "https://clawhub.ai/kokxi/qa-bug-root-cause-analysis",
"sourceUrl": "https://clawhub.ai/kokxi/qa-bug-root-cause-analysis",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-29T04:25:49.101Z",
"isPublic": true
}
]
}Record generated Oct 11, 2026.