{"id":"645a15cb-1d4f-4bec-966d-bab271965be8","entityType":"agent","slug":"clawhub-kokxi-qa-bug-root-cause-analysis","name":"qa-bug-root-cause-analysis","canonicalUrl":"https://www.xpersona.co/agent/clawhub-kokxi-qa-bug-root-cause-analysis","canonicalPath":"/agent/clawhub-kokxi-qa-bug-root-cause-analysis","generatedAt":"2026-10-11T14:13:19.811Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T10:29:17.569Z","emptyReason":null},"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. 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","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s170jw3s1atcj5jwhqb4r7v7eh8912kp:qa-bug-root-cause-analysis","sourceUrl":"https://clawhub.ai/kokxi/qa-bug-root-cause-analysis","homepage":"https://clawhub.ai/kokxi/skills/qa-bug-root-cause-analysis","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/kokxi/qa-bug-root-cause-analysis","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/kokxi/skills/qa-bug-root-cause-analysis","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":61,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"当某个 Bug 频繁复现、线上有缺陷需要做事后分析、或者发现同一类问题反复出现需要根治时使用此技能。从症状出发用 5Why、因果图和鱼骨图等方法系统化定位缺陷根源，区分直接原因、间接原因和系统原因。不要只修症状——根因分析的价值在于找到让同类 Bug 不再发生的系统性改进措施，同时分析漏测原因来优化测试设计。 ⚠️ 本"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T10:29:17.569Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T10:29:17.569Z","emptyReason":null},"stars":null,"forks":null,"downloads":1087,"packageName":null,"latestVersion":"1.8.0","tractionLabel":"1.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T10:29:17.562Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T10:29:17.569Z","lastCrawledAt":"2026-10-11T10:29:17.562Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T10:29:17.562Z","lastVerifiedAt":null,"highlights":[{"version":"1.8.0","createdAt":"2026-09-29T04:25:49.101Z","changelog":"**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.","fileCount":4,"zipByteSize":7261},{"version":"1.7.7","createdAt":"2026-09-27T14:33:25.079Z","changelog":"1.7.7","fileCount":3,"zipByteSize":6403},{"version":"1.7.6","createdAt":"2026-09-01T12:37:22.124Z","changelog":"显示名改中文","fileCount":3,"zipByteSize":6843},{"version":"1.7.5","createdAt":"2026-08-30T15:11:59.740Z","changelog":"1.7.5: 版本号升级","fileCount":3,"zipByteSize":6600},{"version":"1.6.3","createdAt":"2026-08-12T15:21:51.721Z","changelog":"- Added `slug` and `displayName` fields to SKILL.md for improved metadata and compatibility. - Updated version to 1.6.3. - Removed the file `skill-card.md`. - No user-facing logic or instruction changes; content and analysis workflow remain unchanged.","fileCount":3,"zipByteSize":6196},{"version":"1.6.0","createdAt":"2026-07-06T17:14:35.927Z","changelog":"Version 1.6.0 introduces enhanced traceability, safety guidance, and analysis requirements. - Added root cause traceability with unique analysis IDs and explicit Bug ID linkage. - Introduced safety warnings about using/desensitizing sensitive data in examples. - Expanded output format to require deeper cause categorization and quantification by defect complexity. - Added recovery guidance for failed analyses (e.g., retry on insufficient input). - Updated trigger phrases to support broader root cause inquiry expressions. - Removed the skill-card.md file.","fileCount":3,"zipByteSize":6309},{"version":"1.5.0","createdAt":"2026-06-29T12:31:49.719Z","changelog":"- Enhanced the skill description to emphasize system-level root cause analysis, distinguishing direct, indirect, and systemic causes. - Updated input and output formats for greater structural clarity and detail. - Added explicit fields such as contributing factors, impact assessment, fix suggestions, and prevention measures to outputs. - Removed the legacy \"skill-card.md\" file for simplification. - Clarified use cases to prioritize system-wide prevention and continuous test optimization.","fileCount":3,"zipByteSize":5813},{"version":"1.4.1","createdAt":"2026-06-25T16:53:43.901Z","changelog":"- 简化了技能描述，明确强调针对Bug根因分析和漏测分析的使用场景 - 精简并更新了激活时机的描述，突出“5 Why”、根治等关键词场景 - 移除了skill-card.md文件 - 技能核心分析流程和速查表保持不变，功能逻辑未做调整 - 文档结构更精炼，更易于理解和使用","fileCount":3,"zipByteSize":5257}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s170jw3s1atcj5jwhqb4r7v7eh8912kp:qa-bug-root-cause-analysis","setupComplexity":"low","setupSteps":["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":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-kokxi-qa-bug-root-cause-analysis/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-kokxi-qa-bug-root-cause-analysis/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-kokxi-qa-bug-root-cause-analysis/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-kokxi-qa-bug-root-cause-analysis/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-kokxi-qa-bug-root-cause-analysis/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-kokxi-qa-bug-root-cause-analysis/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T14:13:19.809Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-kokxi-qa-bug-root-cause-analysis/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-kokxi-qa-bug-root-cause-analysis/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-kokxi-qa-bug-root-cause-analysis/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-kokxi-qa-bug-root-cause-analysis/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T10:29:17.569Z","emptyReason":null},"readme":"Skill: qa-bug-root-cause-analysis\n\nOwner: kokxi\n\nSummary: 当某个 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.\n\nTags: latest:1.8.0\n\nVersion history:\n\nv1.8.0 | 2026-09-29T04:25:49.101Z | auto\n\n**Changelog for qa-bug-root-cause-analysis v1.8.0:**\n\n- Migrated all detailed \"症状分类与根因映射\" content into a new external reference file (`references/symptom-rca-map.md`) to keep the main documentation concise.\n- Updated `SKILL.md` to reference the new location for symptom-to-root-cause mapping.\n- Removed outdated `skill-card.md` file.\n- Streamlined metadata and descriptions for easier integration and clearer usage scenarios.\n- Added tips recommending use with the full workflow skill set for best results.\n\nv1.7.7 | 2026-09-27T14:33:25.079Z | user\n\n1.7.7\n\nv1.7.6 | 2026-09-01T12:37:22.124Z | user\n\n显示名改中文\n\nv1.7.5 | 2026-08-30T15:11:59.740Z | user\n\n1.7.5: 版本号升级\n\nv1.6.3 | 2026-08-12T15:21:51.721Z | auto\n\n- Added `slug` and `displayName` fields to SKILL.md for improved metadata and compatibility.\n- Updated version to 1.6.3.\n- Removed the file `skill-card.md`.\n- No user-facing logic or instruction changes; content and analysis workflow remain unchanged.\n\nv1.6.0 | 2026-07-06T17:14:35.927Z | auto\n\nVersion 1.6.0 introduces enhanced traceability, safety guidance, and analysis requirements.\n\n- Added root cause traceability with unique analysis IDs and explicit Bug ID linkage.\n- Introduced safety warnings about using/desensitizing sensitive data in examples.\n- Expanded output format to require deeper cause categorization and quantification by defect complexity.\n- Added recovery guidance for failed analyses (e.g., retry on insufficient input).\n- Updated trigger phrases to support broader root cause inquiry expressions.\n- Removed the skill-card.md file.\n\nv1.5.0 | 2026-06-29T12:31:49.719Z | auto\n\n- Enhanced the skill description to emphasize system-level root cause analysis, distinguishing direct, indirect, and systemic causes.\n- Updated input and output formats for greater structural clarity and detail.\n- Added explicit fields such as contributing factors, impact assessment, fix suggestions, and prevention measures to outputs.\n- Removed the legacy \"skill-card.md\" file for simplification.\n- Clarified use cases to prioritize system-wide prevention and continuous test optimization.\n\nv1.4.1 | 2026-06-25T16:53:43.901Z | auto\n\n- 简化了技能描述，明确强调针对Bug根因分析和漏测分析的使用场景\n- 精简并更新了激活时机的描述，突出“5 Why”、根治等关键词场景\n- 移除了skill-card.md文件\n- 技能核心分析流程和速查表保持不变，功能逻辑未做调整\n- 文档结构更精炼，更易于理解和使用\n\nv1.4.0 | 2026-06-24T05:05:54.339Z | auto\n\n- Expanded and clarified skill description, use cases, and trigger keywords.\n- Reorganized documentation with clearer Overview and analysis methodology.\n- Added “症状分类速查”表，便于根据现象快速定位根因方向和优先排查点。\n- Supplemented with practical examples to illustrate分析流程.\n- Improved symptom mapping, process guidance, and user checklists for more systematic根因分析.\n- Removed the redundant skill-card.md file for a cleaner project structure.\n\nv1.3.0 | 2026-06-21T04:50:29.647Z | auto\n\n- Major update: Added detailed symptom categories, root cause mapping, and standard analysis flows for bug root cause analysis.\n- Skill now includes structured guidance for symptoms such as errors, data issues, performance, \"no response,\" and intermittent bugs.\n- New process steps: information collection, symptom classification, narrowing down, hypothesis validation, and post-analysis checklist.\n- Outlines input/output formats and skill context within QA workflows.\n- Provides example analysis table and practical checklists to streamline and standardize bug root cause investigations.\n\nArchive index:\n\nArchive v1.8.0: 4 files, 7261 bytes\n\nFiles: references/symptom-rca-map.md (5123b), skill-card.md (1877b), SKILL.md (7318b), _meta.json (145b)\n\nFile v1.8.0:SKILL.md\n\n---\nname: qa-bug-root-cause-analysis\ndescription: >-\n 当某个 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.\nlicense: MIT\nallowed-tools: Read Grep Glob Bash\nmetadata:\n display-name: \"Bug Root Cause Analysis\"\n version: \"1.8.0\"\n when-to-use: \"用户说\\\"Bug根因\\\"、\\\"根因分析\\\"、\\\"为什么出Bug\\\"、\\\"深层原因\\\"、\\\"定位问题\\\"、\\\"排查方向\\\"、需要分析Bug根因、反复出现同类问题需要根因改进时\"\n related-skills: \"{\\\"upstream\\\":[\\\"qa-execution-observation\\\"],\\\"downstream\\\":[\\\"qa-bug-reporting\\\",\\\"qa-retrospective\\\"]}\"\n references: \"[\\\"references/symptom-rca-map.md\\\"]\"\n input-format: \"{\\\"required\\\":[{\\\"name\\\":\\\"Bug描述\\\",\\\"type\\\":\\\"string\\\",\\\"description\\\":\\\"缺陷的详细描述\\\"},{\\\"name\\\":\\\"执行日志\\\",\\\"type\\\":\\\"string\\\",\\\"description\\\":\\\"执行过程中的日志信息\\\"},{\\\"name\\\":\\\"环境信息\\\",\\\"type\\\":\\\"string\\\",\\\"description\\\":\\\"缺陷发现时的环境配置\\\"}],\\\"optional\\\":[{\\\"name\\\":\\\"复现步骤\\\",\\\"type\\\":\\\"array\\\",\\\"description\\\":\\\"缺陷复现的具体步骤\\\"}]}\"\n 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\\\":\\\"预防措施\\\"}]}\"\n error-recovery-guidance: \"{\\\"on_failure\\\":\\\"根因定位不充分时回退到执行观察收集更多信号\\\",\\\"retry_behavior\\\":\\\"补充日志或环境信息后重新分析根因\\\"}\"\n categories: \"[\\\"Development\\\",\\\"Testing\\\",\\\"Quality\\\"]\"\n depth-requirement: \"{\\\"reference_value\\\":\\\"根据缺陷复杂度调整根因分析深度：简单×1/中等×2/复杂×3\\\",\\\"minimum\\\":\\\"至少区分直接原因、间接原因、系统原因3个层级\\\"}\"\n---\n> ⚠️ 本技能单独使用效果有限，建议配合完整技能集（12 步工作流）使用。安装：npx skills add Kokxi/qa-test-skills\n\n> **⚠️ 安全警告**：本技能的示例可能涉及订单号、支付金额、截图、身份证、手机号等敏感数据。\n> 实际使用时请勿粘贴真实生产数据、客户信息或财务凭证；测试前应脱敏/掩码处理。\n> 本技能仅在 workspace/ 输出评估文件，不持久化、不外传、不跨会话复用。\n\n# Bug根因分析\n\n## 核心原则\n\n看到错误，能快速缩小根因范围——这不是魔法，是可学习的映射模式。\n\n## 加载时机\n\n| 什么时候读 | 读哪个 |\n|-----------|--------|\n| 定位到具体症状后，查对应的根因与验证手段 | [`references/symptom-rca-map.md`](references/symptom-rca-map.md) |\n\n> `症状分类与根因映射`的完整内容已下沉至 `references/symptom-rca-map.md`，避免每次触发都占用上下文。\n\n## 分析流程\n\n### 步骤1：收集信息\n```text\n信息收集清单：\n├─ 症状描述：具体表现是什么？\n├─ 复现步骤：怎么复现？\n├─ 环境信息：什么环境下出现？\n├─ 时间信息：什么时候出现？\n├─ 影响范围：影响多大？\n└─ 相关日志：日志有什么？\n```\n\n### 步骤2：分类症状\n```text\n根据症状表现分类：\n- 返回错误 → 代码/数据/配置/依赖层\n- 数据不对 → 写入/读取/同步/转换问题\n- 性能退化 → 数据库/代码/缓存/资源问题\n- 没反应 → 前端/网络/后端/中间件问题\n- 偶发问题 → 并发/环境/数据/时序问题\n```\n\n### 步骤3：缩小范围\n```text\n根据症状分类，逐层排查：\n1. 先排除外部因素（依赖/环境）\n2. 再排除配置因素\n3. 再排查数据因素\n4. 最后排查代码因素\n```\n\n### 步骤4：验证假设\n```text\n验证方法：\n1. 复现问题\n2. 修改假设条件\n3. 验证问题是否消失\n4. 确认根因\n```\n\n## 根因分析表\n\n| Bug ID | 症状分类 | 根因方向 | 根本原因 | 验证方法 |\n|--------|---------|---------|---------|---------|\n| BUG-001 | 返回错误 | 数据层 | 数据格式错误 | 修改数据后验证 |\n| BUG-002 | 性能退化 | 数据库 | 慢查询 | 添加索引后验证 |\n\n## 症状分类速查\n\n### 从现象到根因方向\n\n| 现象 | 症状分类 | 大概率方向 | 优先排查 |\n|------|---------|-----------|---------|\n| 报500错误 | 返回错误 | 后端异常/数据异常 | 日志ERROR + 入参数据 |\n| 返回空数据 | 返回错误 | 查询条件/权限过滤 | SQL日志 + 权限配置 |\n| 页面白屏 | 返回错误 | 前端解析/接口数据格式 | F12看接口响应 |\n| 金额不对 | 数据不对 | 计算逻辑/精度问题 | 核对计算公式 |\n| 状态不更新 | 数据不对 | 状态机/回调处理 | 检查状态流转日志 |\n| 账单对不上 | 数据不对 | 数据一致性/事务问题 | 核对多个数据源 |\n| 页面越来越慢 | 性能退化 | 慢查询/数据累积 | 慢SQL日志 |\n| 高峰期就挂 | 性能退化 | 并发/资源不足 | 压测复现+监控 |\n| 点按钮没反应 | 没反应 | 前端事件绑定/接口不通 | F12看请求是否发出 |\n| 加载中不动 | 没反应 | 后端处理卡住/死锁 | 线程堆栈+DB锁查询 |\n| 偶尔支付失败 | 偶发问题 | 并发冲突/超时 | 并行多次复现 |\n| 特定时间出问题 | 偶发问题 | 定时任务/缓存过期 | 核对定时任务时间+缓存策略 |\n| 只有某用户出问题 | 偶发问题 | 数据隔离/权限 | 对比正常/异常用户数据 |\n\n## 输出示例\n\n**Bug描述：\"用户支付成功但订单状态仍为待支付\"**\n→ 症状分类：数据不一致（症状2）\n→ 根因映射：数据层问题→检查支付回调处理逻辑\n→ 分析流程：\n 1. 收集信息：支付网关回执、订单日志、数据库记录\n 2. 分类症状：数据不一致\n 3. 缩小范围：支付回调→订单状态更新→数据库写入\n 4. 验证假设：手动触发回调验证状态变更\n\n**Bug描述：\"页面加载越来越慢\"**\n→ 症状分类：性能退化（症状3）→ 数据库/缓存层排查\n\n## 检查清单\n\n根因分析完成后检查：\n- [ ] 是否收集了完整信息？\n- [ ] 是否正确分类症状？\n- [ ] 是否逐层排查根因？\n- [ ] 是否验证了根因假设？\n- [ ] 根因描述是否清晰？\n- [ ] 验证方法是否可行？\n\nFile v1.8.0:_meta.json\n\n{\n \"ownerId\": \"kn71y9b23csfx0ykgm55d5m9x5891zt8\",\n \"slug\": \"qa-bug-root-cause-analysis\",\n \"version\": \"1.8.0\",\n \"publishedAt\": 1790655949101\n}\n\nFile v1.8.0:references/symptom-rca-map.md\n\n# 症状分类与根因映射\n\n> 本文是 `qa-bug-root-cause-analysis` 的**症状→根因对照表**。拿到线上/测试发现的具体症状后查对应根因时读本文；\n只想了解 5Why/鱼骨图等方法怎么用时不必读。\n\n---\n\n\n### 症状1：返回错误\n\n```text\n症状表现：\n- HTTP状态码错误（4xx/5xx）\n- 业务错误码\n- 错误信息\n\n根因方向：\n├─ 代码层\n│ ├─ 逻辑错误：条件判断错误\n│ ├─ 空指针：对象未初始化\n│ ├─ 数组越界：索引超出范围\n│ └─ 类型转换：类型不匹配\n│\n├─ 数据层\n│ ├─ 数据缺失：必要数据不存在\n│ ├─ 数据错误：数据格式/值错误\n│ ├─ 数据冲突：唯一性约束\n│ └─ 数据过期：数据已失效\n│\n├─ 配置层\n│ ├─ 配置缺失：配置项未配置\n│ ├─ 配置错误：配置值错误\n│ ├─ 环境差异：不同环境配置不同\n│ └─ 配置变更：配置被意外修改\n│\n└─ 依赖层\n ├─ 依赖不可用：第三方服务故障\n ├─ 依赖超时：响应超时\n ├─ 依赖返回错误：第三方返回异常\n └─ 依赖版本不兼容：接口变更\n```\n\n### 症状2：数据不对\n\n```text\n症状表现：\n- 数据缺失\n- 数据错误\n- 数据不一致\n- 数据格式异常\n\n根因方向：\n├─ 写入问题\n│ ├─ 写入失败：数据库操作失败\n│ ├─ 写入丢失：事务未提交\n│ ├─ 写入延迟：异步写入未完成\n│ └─ 写入重复：重复提交\n│\n├─ 读取问题\n│ ├─ 缓存不一致：缓存与DB不同步\n│ ├─ 读取过滤：查询条件过滤\n│ ├─ 读取延迟：读从库延迟\n│ └─ 读取缓存：读到旧缓存\n│\n├─ 同步问题\n│ ├─ 同步延迟：主从同步延迟\n│ ├─ 同步失败：同步任务失败\n│ ├─ 同步冲突：并发同步冲突\n│ └─ 同步丢失：同步任务遗漏\n│\n└─ 转换问题\n ├─ 格式转换：数据格式转换错误\n ├─ 编码问题：字符编码不一致\n ├─ 精度丢失：浮点数精度问题\n └─ 时区问题：时区转换错误\n```\n\n### 症状3：性能退化\n\n```text\n症状表现：\n- 响应时间变长\n- 吞吐量下降\n- 资源占用高\n\n根因方向：\n├─ 数据库问题\n│ ├─ 慢查询：SQL执行慢\n│ ├─ 索引缺失：缺少必要索引\n│ ├─ 锁等待：锁竞争\n│ ├─ 连接池耗尽：连接数不够\n│ └─ 数据量增长：数据量变大\n│\n├─ 代码问题\n│ ├─ 算法复杂度：算法效率低\n│ ├─ 循环嵌套：循环次数多\n│ ├─ 内存泄漏：内存未释放\n│ ├─ 线程阻塞：线程等待\n│ └─ 频繁GC：垃圾回收频繁\n│\n├─ 缓存问题\n│ ├─ 缓存穿透：缓存未命中\n│ ├─ 缓存雪崩：缓存集中失效\n│ ├─ 缓存击穿：热点key失效\n│ └─ 缓存容量：缓存容量不足\n│\n└─ 资源问题\n ├─ CPU瓶颈：CPU占用高\n ├─ 内存瓶颈：内存不足\n ├─ IO瓶颈：磁盘IO慢\n └─ 网络瓶颈：网络延迟高\n```\n\n### 症状4：没反应\n\n```text\n症状表现：\n- 点击无反应\n- 操作无效果\n- 界面卡住\n\n根因方向：\n├─ 前端问题\n│ ├─ JS报错：JavaScript错误\n│ ├─ 事件绑定：事件未绑定\n│ ├─ 状态异常：前端状态错误\n│ ├─ 网络请求：请求未发出\n│ └─ 渲染异常：DOM渲染错误\n│\n├─ 网络问题\n│ ├─ 请求丢失：网络丢包\n│ ├─ 请求超时：网络超时\n│ ├─ 连接断开：网络断开\n│ └─ DNS解析：DNS解析失败\n│\n├─ 后端问题\n│ ├─ 请求未接收：请求未到达\n│ ├─ 处理阻塞：处理线程阻塞\n│ ├─ 响应丢失：响应未返回\n│ └─ 服务不可用：服务宕机\n│\n└─ 中间件问题\n ├─ Nginx问题：Nginx配置错误\n ├─ 网关问题：网关路由错误\n ├─ MQ问题：消息队列阻塞\n └─ 限流问题：触发限流\n```\n\n### 症状5：偶发问题\n\n```text\n症状表现：\n- 时有时无\n- 特定条件出现\n- 难以复现\n\n根因方向：\n├─ 并发问题\n│ ├─ 竞态条件：并发操作冲突\n│ ├─ 死锁：线程互相等待\n│ ├─ 线程安全：共享资源竞争\n│ └─ 资源泄露：资源未释放\n│\n├─ 环境问题\n│ ├─ 环境差异：不同环境表现不同\n│ ├─ 配置差异：配置不一致\n│ ├─ 依赖状态：依赖服务状态\n│ └─ 硬件差异：硬件性能差异\n│\n├─ 数据问题\n│ ├─ 数据状态：特定数据状态触发\n│ ├─ 数据量：数据量达到阈值触发\n│ ├─ 数据顺序：数据顺序影响\n│ └─ 数据时效：数据过期触发\n│\n└─ 时序问题\n ├─ 时序依赖：操作顺序影响\n ├─ 定时任务：定时任务触发\n ├─ 缓存过期：缓存过期触发\n └─ 会话超时：会话过期触发\n```\n\nFile v1.8.0:skill-card.md\n\n## Description:\n\nHelps QA engineers trace recurring or escaped bugs from symptoms to verified root causes and preventive actions.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[kokxi](https://clawhub.ai/user/kokxi)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nQA 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.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Bug reports and logs may contain customer, payment, or identity information.\n\nMitigation: Mask sensitive data before sharing logs, screenshots, or production examples.\n\nRisk: The optional companion-skill installation introduces a separate trust decision.\n\nMitigation: Verify the source before running the suggested installation command.\n\nRisk: Example troubleshooting may involve external log or monitoring tools.\n\nMitigation: Use those tools only in an authorized, controlled environment.\n\n## Reference(s):\n\n- [Symptom-to-root-cause reference](references/symptom-rca-map.md)\n- [ClawHub skill release](https://clawhub.ai/kokxi/skills/qa-bug-root-cause-analysis)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Guidance]\n\n**Output Format:** [Markdown root-cause analysis and recommendations]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Root-cause IDs, linked bug IDs, contributing factors, impact, fixes, and prevention measures.]\n\n## Skill Version(s):\n\n1.8.0 (source: skill frontmatter and ClawHub release)\n\n## Ethical Considerations:\n\nUsers 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.\n\nArchive v1.7.7: 3 files, 6403 bytes\n\nFiles: skill-card.md (1738b), SKILL.md (11697b), _meta.json (145b)\n\nFile v1.7.7:SKILL.md\n\n---\nname: qa-bug-root-cause-analysis\nslug: qa-bug-root-cause-analysis\ndisplayName: Bug Root Cause Analysis\nversion: 1.7.7\ndescription: >-\n 当某个 Bug 频繁复现、线上有缺陷需要做事后分析、或者发现同一类问题反复出现需要根治时使用此技能。从症状出发用 5Why、因果图和鱼骨图等方法系统化定位缺陷根源，区分直接原因、间接原因和系统原因。不要只修症状——根因分析的价值在于找到让同类 Bug 不再发生的系统性改进措施，同时分析漏测原因来优化测试设计。 ⚠️ 本技能示例可能调用外部日志/监控工具，请在受控环境执行。\nwhen_to_use: 用户说\"Bug根因\"、\"根因分析\"、\"为什么出Bug\"、\"深层原因\"、\"定位问题\"、\"排查方向\"、需要分析Bug根因、反复出现同类问题需要根因改进时\nallowed-tools: Read Grep Glob Bash\nrelated_skills:\n upstream:\n - qa-execution-observation # 输入：执行观察发现的异常信号\n downstream:\n - qa-bug-reporting # 输出：根因分析用于Bug报告\n - qa-retrospective # 输出：根因分类用于复盘\ninput_format:\n required:\n - name: Bug描述\n type: string\n description: 缺陷的详细描述\n - name: 执行日志\n type: string\n description: 执行过程中的日志信息\n - name: 环境信息\n type: string\n description: 缺陷发现时的环境配置\n optional:\n - name: 复现步骤\n type: array\n description: 缺陷复现的具体步骤\noutput_format:\n traceability:\n - 每个根因分析带唯一ID（ROOT-XXXX）\n - 关联Bug ID（TC_{缺陷模块缩写}_{功能缩写}_{序号}，如 TC_BUG_LOGIN_001；缺陷追溯保留 BUG 前缀）\n structure:\n - 测试用例表格：固定 9 列（用例编号|测试类型|功能模块|测试标题|用例级别|预置条件|测试步骤|预期结果|风险等级）\n - 用例级别：P0≤20%（核心流程）/ P1≤40%（主要功能）/ P2≤30%（次要功能）/ P3≤10%（边缘场景）\n - 覆盖率：标注口径（基于现有需求/输入文档），禁止\"全覆盖/100%\"绝对化表述；缺失模块标注\"未覆盖+原因\"\n - root_cause: 根因分析结论\n - contributing_factors: 促成因素清单\n - impact_assessment: 影响范围评估\n - fix_suggestions: 修复建议\n - prevention_measures: 预防措施\ncategories: ['Development','Testing','Quality']\ndepth_requirement_quantification:\n reference_value: \"根据缺陷复杂度调整根因分析深度：简单×1/中等×2/复杂×3\"\n minimum: \"至少区分直接原因、间接原因、系统原因3个层级\"\nerror_recovery_guidance:\n on_failure: \"根因定位不充分时回退到执行观察收集更多信号\"\n retry_behavior: \"补充日志或环境信息后重新分析根因\"\n---\n> **⚠️ 安全警告**：本技能的示例可能涉及订单号、支付金额、截图、身份证、手机号等敏感数据。\n> 实际使用时请勿粘贴真实生产数据、客户信息或财务凭证；测试前应脱敏/掩码处理。\n> 本技能仅在 workspace/ 输出评估文件，不持久化、不外传、不跨会话复用。\n\n# Bug根因分析\n\n## 核心原则\n\n看到错误，能快速缩小根因范围——这不是魔法，是可学习的映射模式。\n\n## 症状分类与根因映射\n\n### 症状1：返回错误\n\n```text\n症状表现：\n- HTTP状态码错误（4xx/5xx）\n- 业务错误码\n- 错误信息\n\n根因方向：\n├─ 代码层\n│ ├─ 逻辑错误：条件判断错误\n│ ├─ 空指针：对象未初始化\n│ ├─ 数组越界：索引超出范围\n│ └─ 类型转换：类型不匹配\n│\n├─ 数据层\n│ ├─ 数据缺失：必要数据不存在\n│ ├─ 数据错误：数据格式/值错误\n│ ├─ 数据冲突：唯一性约束\n│ └─ 数据过期：数据已失效\n│\n├─ 配置层\n│ ├─ 配置缺失：配置项未配置\n│ ├─ 配置错误：配置值错误\n│ ├─ 环境差异：不同环境配置不同\n│ └─ 配置变更：配置被意外修改\n│\n└─ 依赖层\n ├─ 依赖不可用：第三方服务故障\n ├─ 依赖超时：响应超时\n ├─ 依赖返回错误：第三方返回异常\n └─ 依赖版本不兼容：接口变更\n```\n\n### 症状2：数据不对\n\n```text\n症状表现：\n- 数据缺失\n- 数据错误\n- 数据不一致\n- 数据格式异常\n\n根因方向：\n├─ 写入问题\n│ ├─ 写入失败：数据库操作失败\n│ ├─ 写入丢失：事务未提交\n│ ├─ 写入延迟：异步写入未完成\n│ └─ 写入重复：重复提交\n│\n├─ 读取问题\n│ ├─ 缓存不一致：缓存与DB不同步\n│ ├─ 读取过滤：查询条件过滤\n│ ├─ 读取延迟：读从库延迟\n│ └─ 读取缓存：读到旧缓存\n│\n├─ 同步问题\n│ ├─ 同步延迟：主从同步延迟\n│ ├─ 同步失败：同步任务失败\n│ ├─ 同步冲突：并发同步冲突\n│ └─ 同步丢失：同步任务遗漏\n│\n└─ 转换问题\n ├─ 格式转换：数据格式转换错误\n ├─ 编码问题：字符编码不一致\n ├─ 精度丢失：浮点数精度问题\n └─ 时区问题：时区转换错误\n```\n\n### 症状3：性能退化\n\n```text\n症状表现：\n- 响应时间变长\n- 吞吐量下降\n- 资源占用高\n\n根因方向：\n├─ 数据库问题\n│ ├─ 慢查询：SQL执行慢\n│ ├─ 索引缺失：缺少必要索引\n│ ├─ 锁等待：锁竞争\n│ ├─ 连接池耗尽：连接数不够\n│ └─ 数据量增长：数据量变大\n│\n├─ 代码问题\n│ ├─ 算法复杂度：算法效率低\n│ ├─ 循环嵌套：循环次数多\n│ ├─ 内存泄漏：内存未释放\n│ ├─ 线程阻塞：线程等待\n│ └─ 频繁GC：垃圾回收频繁\n│\n├─ 缓存问题\n│ ├─ 缓存穿透：缓存未命中\n│ ├─ 缓存雪崩：缓存集中失效\n│ ├─ 缓存击穿：热点key失效\n│ └─ 缓存容量：缓存容量不足\n│\n└─ 资源问题\n ├─ CPU瓶颈：CPU占用高\n ├─ 内存瓶颈：内存不足\n ├─ IO瓶颈：磁盘IO慢\n └─ 网络瓶颈：网络延迟高\n```\n\n### 症状4：没反应\n\n```text\n症状表现：\n- 点击无反应\n- 操作无效果\n- 界面卡住\n\n根因方向：\n├─ 前端问题\n│ ├─ JS报错：JavaScript错误\n│ ├─ 事件绑定：事件未绑定\n│ ├─ 状态异常：前端状态错误\n│ ├─ 网络请求：请求未发出\n│ └─ 渲染异常：DOM渲染错误\n│\n├─ 网络问题\n│ ├─ 请求丢失：网络丢包\n│ ├─ 请求超时：网络超时\n│ ├─ 连接断开：网络断开\n│ └─ DNS解析：DNS解析失败\n│\n├─ 后端问题\n│ ├─ 请求未接收：请求未到达\n│ ├─ 处理阻塞：处理线程阻塞\n│ ├─ 响应丢失：响应未返回\n│ └─ 服务不可用：服务宕机\n│\n└─ 中间件问题\n ├─ Nginx问题：Nginx配置错误\n ├─ 网关问题：网关路由错误\n ├─ MQ问题：消息队列阻塞\n └─ 限流问题：触发限流\n```\n\n### 症状5：偶发问题\n\n```text\n症状表现：\n- 时有时无\n- 特定条件出现\n- 难以复现\n\n根因方向：\n├─ 并发问题\n│ ├─ 竞态条件：并发操作冲突\n│ ├─ 死锁：线程互相等待\n│ ├─ 线程安全：共享资源竞争\n│ └─ 资源泄露：资源未释放\n│\n├─ 环境问题\n│ ├─ 环境差异：不同环境表现不同\n│ ├─ 配置差异：配置不一致\n│ ├─ 依赖状态：依赖服务状态\n│ └─ 硬件差异：硬件性能差异\n│\n├─ 数据问题\n│ ├─ 数据状态：特定数据状态触发\n│ ├─ 数据量：数据量达到阈值触发\n│ ├─ 数据顺序：数据顺序影响\n│ └─ 数据时效：数据过期触发\n│\n└─ 时序问题\n ├─ 时序依赖：操作顺序影响\n ├─ 定时任务：定时任务触发\n ├─ 缓存过期：缓存过期触发\n └─ 会话超时：会话过期触发\n```\n\n## 分析流程\n\n### 步骤1：收集信息\n```text\n信息收集清单：\n├─ 症状描述：具体表现是什么？\n├─ 复现步骤：怎么复现？\n├─ 环境信息：什么环境下出现？\n├─ 时间信息：什么时候出现？\n├─ 影响范围：影响多大？\n└─ 相关日志：日志有什么？\n```\n\n### 步骤2：分类症状\n```text\n根据症状表现分类：\n- 返回错误 → 代码/数据/配置/依赖层\n- 数据不对 → 写入/读取/同步/转换问题\n- 性能退化 → 数据库/代码/缓存/资源问题\n- 没反应 → 前端/网络/后端/中间件问题\n- 偶发问题 → 并发/环境/数据/时序问题\n```\n\n### 步骤3：缩小范围\n```text\n根据症状分类，逐层排查：\n1. 先排除外部因素（依赖/环境）\n2. 再排除配置因素\n3. 再排查数据因素\n4. 最后排查代码因素\n```\n\n### 步骤4：验证假设\n```text\n验证方法：\n1. 复现问题\n2. 修改假设条件\n3. 验证问题是否消失\n4. 确认根因\n```\n\n## 根因分析表\n\n| Bug ID | 症状分类 | 根因方向 | 根本原因 | 验证方法 |\n|--------|---------|---------|---------|---------|\n| BUG-001 | 返回错误 | 数据层 | 数据格式错误 | 修改数据后验证 |\n| BUG-002 | 性能退化 | 数据库 | 慢查询 | 添加索引后验证 |\n\n## 症状分类速查\n\n### 从现象到根因方向\n\n| 现象 | 症状分类 | 大概率方向 | 优先排查 |\n|------|---------|-----------|---------|\n| 报500错误 | 返回错误 | 后端异常/数据异常 | 日志ERROR + 入参数据 |\n| 返回空数据 | 返回错误 | 查询条件/权限过滤 | SQL日志 + 权限配置 |\n| 页面白屏 | 返回错误 | 前端解析/接口数据格式 | F12看接口响应 |\n| 金额不对 | 数据不对 | 计算逻辑/精度问题 | 核对计算公式 |\n| 状态不更新 | 数据不对 | 状态机/回调处理 | 检查状态流转日志 |\n| 账单对不上 | 数据不对 | 数据一致性/事务问题 | 核对多个数据源 |\n| 页面越来越慢 | 性能退化 | 慢查询/数据累积 | 慢SQL日志 |\n| 高峰期就挂 | 性能退化 | 并发/资源不足 | 压测复现+监控 |\n| 点按钮没反应 | 没反应 | 前端事件绑定/接口不通 | F12看请求是否发出 |\n| 加载中不动 | 没反应 | 后端处理卡住/死锁 | 线程堆栈+DB锁查询 |\n| 偶尔支付失败 | 偶发问题 | 并发冲突/超时 | 并行多次复现 |\n| 特定时间出问题 | 偶发问题 | 定时任务/缓存过期 | 核对定时任务时间+缓存策略 |\n| 只有某用户出问题 | 偶发问题 | 数据隔离/权限 | 对比正常/异常用户数据 |\n\n## 输出示例\n\n**Bug描述：\"用户支付成功但订单状态仍为待支付\"**\n→ 症状分类：数据不一致（症状2）\n→ 根因映射：数据层问题→检查支付回调处理逻辑\n→ 分析流程：\n 1. 收集信息：支付网关回执、订单日志、数据库记录\n 2. 分类症状：数据不一致\n 3. 缩小范围：支付回调→订单状态更新→数据库写入\n 4. 验证假设：手动触发回调验证状态变更\n\n**Bug描述：\"页面加载越来越慢\"**\n→ 症状分类：性能退化（症状3）→ 数据库/缓存层排查\n\n## 检查清单\n\n根因分析完成后检查：\n- [ ] 是否收集了完整信息？\n- [ ] 是否正确分类症状？\n- [ ] 是否逐层排查根因？\n- [ ] 是否验证了根因假设？\n- [ ] 根因描述是否清晰？\n- [ ] 验证方法是否可行？\n\nFile v1.7.7:_meta.json\n\n{\n \"ownerId\": \"kn71y9b23csfx0ykgm55d5m9x5891zt8\",\n \"slug\": \"qa-bug-root-cause-analysis\",\n \"version\": \"1.7.7\",\n \"publishedAt\": 1790519605079\n}\n\nFile v1.7.7:skill-card.md\n\n## Description:\n\nGuides QA and engineering teams through symptom classification, hypothesis testing, and root-cause analysis of recurring or production bugs.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[kokxi](https://clawhub.ai/user/kokxi)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nQA engineers and developers use this skill to investigate defects using bug descriptions, logs, and environment details, then identify contributing causes and propose fixes and prevention measures.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Bug logs and order or payment examples may contain sensitive customer or financial data.\n\nMitigation: Use masked test data where possible; do not paste real production records, customer information, or financial credentials.\n\nRisk: Suggested shell commands or log and monitoring access may affect production systems.\n\nMitigation: Review commands before running them and investigate in a controlled environment.\n\n## Reference(s):\n\n- [ClawHub skill release](https://clawhub.ai/kokxi/skills/qa-bug-root-cause-analysis)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Guidance]\n\n**Output Format:** [Markdown analysis and tables]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Traceable root-cause IDs and linked bug IDs; findings, impact, fixes, and prevention measures.]\n\n## Skill Version(s):\n\n1.7.7 (source: release metadata and frontmatter)\n\n## Ethical Considerations:\n\nUsers 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.\n\nArchive v1.7.6: 3 files, 6843 bytes\n\nFiles: skill-card.md (2310b), SKILL.md (12315b), _meta.json (145b)\n\nFile v1.7.6:SKILL.md\n\n---\r\nname: qa-bug-root-cause-analysis\r\nslug: qa-bug-root-cause-analysis\r\ndisplayName: 缺陷根因分析\r\nversion: 1.7.5\r\ndescription: >-\r\n 当某个 Bug 频繁复现、线上有缺陷需要做事后分析、或者发现同一类问题反复出现需要根治时使用此技能。从症状出发用 5Why、因果图和鱼骨图等方法系统化定位缺陷根源，区分直接原因、间接原因和系统原因。不要只修症状——根因分析的价值在于找到让同类 Bug 不再发生的系统性改进措施，同时分析漏测原因来优化测试设计。 ⚠️ 本技能示例可能调用外部日志/监控工具，请在受控环境执行。\r\n 本技能属于 QA Test Skills 技能集（49 个技能之一），完整工作流体验需安装全套：npx skills add Kokxi/qa-test-skills\r\nwhen_to_use: 用户说\"Bug根因\"、\"根因分析\"、\"为什么出Bug\"、\"深层原因\"、\"定位问题\"、\"排查方向\"、需要分析Bug根因、反复出现同类问题需要根因改进时\r\nallowed-tools: Read Grep Glob Bash\r\nrelated_skills:\r\n upstream:\r\n - qa-execution-observation # 输入：执行观察发现的异常信号\r\n downstream:\r\n - qa-bug-reporting # 输出：根因分析用于Bug报告\r\n - qa-retrospective # 输出：根因分类用于复盘\r\ninput_format:\r\n required:\r\n - name: Bug描述\r\n type: string\r\n description: 缺陷的详细描述\r\n - name: 执行日志\r\n type: string\r\n description: 执行过程中的日志信息\r\n - name: 环境信息\r\n type: string\r\n description: 缺陷发现时的环境配置\r\n optional:\r\n - name: 复现步骤\r\n type: array\r\n description: 缺陷复现的具体步骤\r\noutput_format:\r\n traceability:\r\n - 每个根因分析带唯一ID（ROOT-XXXX）\r\n - 关联Bug ID（TC_{缺陷模块缩写}_{功能缩写}_{序号}，如 TC_BUG_LOGIN_001；缺陷追溯保留 BUG 前缀）\r\n structure:\r\n - 测试用例表格：固定 9 列（用例编号|测试类型|功能模块|测试标题|用例级别|预置条件|测试步骤|预期结果|风险等级）\r\n - 用例级别：P0≤20%（核心流程）/ P1≤40%（主要功能）/ P2≤30%（次要功能）/ P3≤10%（边缘场景）\r\n - 覆盖率：标注口径（基于现有需求/输入文档），禁止\"全覆盖/100%\"绝对化表述；缺失模块标注\"未覆盖+原因\"\r\n - root_cause: 根因分析结论\r\n - contributing_factors: 促成因素清单\r\n - impact_assessment: 影响范围评估\r\n - fix_suggestions: 修复建议\r\n - prevention_measures: 预防措施\r\ncategories: ['Development','Testing','Quality']\r\ndepth_requirement_quantification:\r\n reference_value: \"根据缺陷复杂度调整根因分析深度：简单×1/中等×2/复杂×3\"\r\n minimum: \"至少区分直接原因、间接原因、系统原因3个层级\"\r\nerror_recovery_guidance:\r\n on_failure: \"根因定位不充分时回退到执行观察收集更多信号\"\r\n retry_behavior: \"补充日志或环境信息后重新分析根因\"\r\n---\r\n> ⚠️ 本技能单独使用效果有限，建议配合完整技能集（12 步工作流）使用。安装：npx skills add Kokxi/qa-test-skills\r\n\r\n> **⚠️ 安全警告**：本技能的示例可能涉及订单号、支付金额、截图、身份证、手机号等敏感数据。\r\n> 实际使用时请勿粘贴真实生产数据、客户信息或财务凭证；测试前应脱敏/掩码处理。\r\n> 本技能仅在 workspace/ 输出评估文件，不持久化、不外传、不跨会话复用。\r\n\r\n# Bug根因分析\r\n\r\n## 核心原则\r\n\r\n看到错误，能快速缩小根因范围——这不是魔法，是可学习的映射模式。\r\n\r\n## 症状分类与根因映射\r\n\r\n### 症状1：返回错误\r\n\r\n```text\r\n症状表现：\r\n- HTTP状态码错误（4xx/5xx）\r\n- 业务错误码\r\n- 错误信息\r\n\r\n根因方向：\r\n├─ 代码层\r\n│ ├─ 逻辑错误：条件判断错误\r\n│ ├─ 空指针：对象未初始化\r\n│ ├─ 数组越界：索引超出范围\r\n│ └─ 类型转换：类型不匹配\r\n│\r\n├─ 数据层\r\n│ ├─ 数据缺失：必要数据不存在\r\n│ ├─ 数据错误：数据格式/值错误\r\n│ ├─ 数据冲突：唯一性约束\r\n│ └─ 数据过期：数据已失效\r\n│\r\n├─ 配置层\r\n│ ├─ 配置缺失：配置项未配置\r\n│ ├─ 配置错误：配置值错误\r\n│ ├─ 环境差异：不同环境配置不同\r\n│ └─ 配置变更：配置被意外修改\r\n│\r\n└─ 依赖层\r\n ├─ 依赖不可用：第三方服务故障\r\n ├─ 依赖超时：响应超时\r\n ├─ 依赖返回错误：第三方返回异常\r\n └─ 依赖版本不兼容：接口变更\r\n```\r\n\r\n### 症状2：数据不对\r\n\r\n```text\r\n症状表现：\r\n- 数据缺失\r\n- 数据错误\r\n- 数据不一致\r\n- 数据格式异常\r\n\r\n根因方向：\r\n├─ 写入问题\r\n│ ├─ 写入失败：数据库操作失败\r\n│ ├─ 写入丢失：事务未提交\r\n│ ├─ 写入延迟：异步写入未完成\r\n│ └─ 写入重复：重复提交\r\n│\r\n├─ 读取问题\r\n│ ├─ 缓存不一致：缓存与DB不同步\r\n│ ├─ 读取过滤：查询条件过滤\r\n│ ├─ 读取延迟：读从库延迟\r\n│ └─ 读取缓存：读到旧缓存\r\n│\r\n├─ 同步问题\r\n│ ├─ 同步延迟：主从同步延迟\r\n│ ├─ 同步失败：同步任务失败\r\n│ ├─ 同步冲突：并发同步冲突\r\n│ └─ 同步丢失：同步任务遗漏\r\n│\r\n└─ 转换问题\r\n ├─ 格式转换：数据格式转换错误\r\n ├─ 编码问题：字符编码不一致\r\n ├─ 精度丢失：浮点数精度问题\r\n └─ 时区问题：时区转换错误\r\n```\r\n\r\n### 症状3：性能退化\r\n\r\n```text\r\n症状表现：\r\n- 响应时间变长\r\n- 吞吐量下降\r\n- 资源占用高\r\n\r\n根因方向：\r\n├─ 数据库问题\r\n│ ├─ 慢查询：SQL执行慢\r\n│ ├─ 索引缺失：缺少必要索引\r\n│ ├─ 锁等待：锁竞争\r\n│ ├─ 连接池耗尽：连接数不够\r\n│ └─ 数据量增长：数据量变大\r\n│\r\n├─ 代码问题\r\n│ ├─ 算法复杂度：算法效率低\r\n│ ├─ 循环嵌套：循环次数多\r\n│ ├─ 内存泄漏：内存未释放\r\n│ ├─ 线程阻塞：线程等待\r\n│ └─ 频繁GC：垃圾回收频繁\r\n│\r\n├─ 缓存问题\r\n│ ├─ 缓存穿透：缓存未命中\r\n│ ├─ 缓存雪崩：缓存集中失效\r\n│ ├─ 缓存击穿：热点key失效\r\n│ └─ 缓存容量：缓存容量不足\r\n│\r\n└─ 资源问题\r\n ├─ CPU瓶颈：CPU占用高\r\n ├─ 内存瓶颈：内存不足\r\n ├─ IO瓶颈：磁盘IO慢\r\n └─ 网络瓶颈：网络延迟高\r\n```\r\n\r\n### 症状4：没反应\r\n\r\n```text\r\n症状表现：\r\n- 点击无反应\r\n- 操作无效果\r\n- 界面卡住\r\n\r\n根因方向：\r\n├─ 前端问题\r\n│ ├─ JS报错：JavaScript错误\r\n│ ├─ 事件绑定：事件未绑定\r\n│ ├─ 状态异常：前端状态错误\r\n│ ├─ 网络请求：请求未发出\r\n│ └─ 渲染异常：DOM渲染错误\r\n│\r\n├─ 网络问题\r\n│ ├─ 请求丢失：网络丢包\r\n│ ├─ 请求超时：网络超时\r\n│ ├─ 连接断开：网络断开\r\n│ └─ DNS解析：DNS解析失败\r\n│\r\n├─ 后端问题\r\n│ ├─ 请求未接收：请求未到达\r\n│ ├─ 处理阻塞：处理线程阻塞\r\n│ ├─ 响应丢失：响应未返回\r\n│ └─ 服务不可用：服务宕机\r\n│\r\n└─ 中间件问题\r\n ├─ Nginx问题：Nginx配置错误\r\n ├─ 网关问题：网关路由错误\r\n ├─ MQ问题：消息队列阻塞\r\n └─ 限流问题：触发限流\r\n```\r\n\r\n### 症状5：偶发问题\r\n\r\n```text\r\n症状表现：\r\n- 时有时无\r\n- 特定条件出现\r\n- 难以复现\r\n\r\n根因方向：\r\n├─ 并发问题\r\n│ ├─ 竞态条件：并发操作冲突\r\n│ ├─ 死锁：线程互相等待\r\n│ ├─ 线程安全：共享资源竞争\r\n│ └─ 资源泄露：资源未释放\r\n│\r\n├─ 环境问题\r\n│ ├─ 环境差异：不同环境表现不同\r\n│ ├─ 配置差异：配置不一致\r\n│ ├─ 依赖状态：依赖服务状态\r\n│ └─ 硬件差异：硬件性能差异\r\n│\r\n├─ 数据问题\r\n│ ├─ 数据状态：特定数据状态触发\r\n│ ├─ 数据量：数据量达到阈值触发\r\n│ ├─ 数据顺序：数据顺序影响\r\n│ └─ 数据时效：数据过期触发\r\n│\r\n└─ 时序问题\r\n ├─ 时序依赖：操作顺序影响\r\n ├─ 定时任务：定时任务触发\r\n ├─ 缓存过期：缓存过期触发\r\n └─ 会话超时：会话过期触发\r\n```\r\n\r\n## 分析流程\r\n\r\n### 步骤1：收集信息\r\n```text\r\n信息收集清单：\r\n├─ 症状描述：具体表现是什么？\r\n├─ 复现步骤：怎么复现？\r\n├─ 环境信息：什么环境下出现？\r\n├─ 时间信息：什么时候出现？\r\n├─ 影响范围：影响多大？\r\n└─ 相关日志：日志有什么？\r\n```\r\n\r\n### 步骤2：分类症状\r\n```text\r\n根据症状表现分类：\r\n- 返回错误 → 代码/数据/配置/依赖层\r\n- 数据不对 → 写入/读取/同步/转换问题\r\n- 性能退化 → 数据库/代码/缓存/资源问题\r\n- 没反应 → 前端/网络/后端/中间件问题\r\n- 偶发问题 → 并发/环境/数据/时序问题\r\n```\r\n\r\n### 步骤3：缩小范围\r\n```text\r\n根据症状分类，逐层排查：\r\n1. 先排除外部因素（依赖/环境）\r\n2. 再排除配置因素\r\n3. 再排查数据因素\r\n4. 最后排查代码因素\r\n```\r\n\r\n### 步骤4：验证假设\r\n```text\r\n验证方法：\r\n1. 复现问题\r\n2. 修改假设条件\r\n3. 验证问题是否消失\r\n4. 确认根因\r\n```\r\n\r\n## 根因分析表\r\n\r\n| Bug ID | 症状分类 | 根因方向 | 根本原因 | 验证方法 |\r\n|--------|---------|---------|---------|---------|\r\n| BUG-001 | 返回错误 | 数据层 | 数据格式错误 | 修改数据后验证 |\r\n| BUG-002 | 性能退化 | 数据库 | 慢查询 | 添加索引后验证 |\r\n\r\n## 症状分类速查\r\n\r\n### 从现象到根因方向\r\n\r\n| 现象 | 症状分类 | 大概率方向 | 优先排查 |\r\n|------|---------|-----------|---------|\r\n| 报500错误 | 返回错误 | 后端异常/数据异常 | 日志ERROR + 入参数据 |\r\n| 返回空数据 | 返回错误 | 查询条件/权限过滤 | SQL日志 + 权限配置 |\r\n| 页面白屏 | 返回错误 | 前端解析/接口数据格式 | F12看接口响应 |\r\n| 金额不对 | 数据不对 | 计算逻辑/精度问题 | 核对计算公式 |\r\n| 状态不更新 | 数据不对 | 状态机/回调处理 | 检查状态流转日志 |\r\n| 账单对不上 | 数据不对 | 数据一致性/事务问题 | 核对多个数据源 |\r\n| 页面越来越慢 | 性能退化 | 慢查询/数据累积 | 慢SQL日志 |\r\n| 高峰期就挂 | 性能退化 | 并发/资源不足 | 压测复现+监控 |\r\n| 点按钮没反应 | 没反应 | 前端事件绑定/接口不通 | F12看请求是否发出 |\r\n| 加载中不动 | 没反应 | 后端处理卡住/死锁 | 线程堆栈+DB锁查询 |\r\n| 偶尔支付失败 | 偶发问题 | 并发冲突/超时 | 并行多次复现 |\r\n| 特定时间出问题 | 偶发问题 | 定时任务/缓存过期 | 核对定时任务时间+缓存策略 |\r\n| 只有某用户出问题 | 偶发问题 | 数据隔离/权限 | 对比正常/异常用户数据 |\r\n\r\n## 输出示例\r\n\r\n**Bug描述：\"用户支付成功但订单状态仍为待支付\"**\r\n→ 症状分类：数据不一致（症状2）\r\n→ 根因映射：数据层问题→检查支付回调处理逻辑\r\n→ 分析流程：\r\n 1. 收集信息：支付网关回执、订单日志、数据库记录\r\n 2. 分类症状：数据不一致\r\n 3. 缩小范围：支付回调→订单状态更新→数据库写入\r\n 4. 验证假设：手动触发回调验证状态变更\r\n\r\n**Bug描述：\"页面加载越来越慢\"**\r\n→ 症状分类：性能退化（症状3）→ 数据库/缓存层排查\r\n\r\n## 检查清单\r\n\r\n根因分析完成后检查：\r\n- [ ] 是否收集了完整信息？\r\n- [ ] 是否正确分类症状？\r\n- [ ] 是否逐层排查根因？\r\n- [ ] 是否验证了根因假设？\r\n- [ ] 根因描述是否清晰？\r\n- [ ] 验证方法是否可行？\n\nFile v1.7.6:_meta.json\n\n{\n \"ownerId\": \"kn71y9b23csfx0ykgm55d5m9x5891zt8\",\n \"slug\": \"qa-bug-root-cause-analysis\",\n \"version\": \"1.7.6\",\n \"publishedAt\": 1788266242124\n}\n\nFile v1.7.6:skill-card.md\n\n## Description:\n\nThis skill guides QA teams through bug root-cause analysis using symptom classification, 5 Whys, causal diagrams, and prevention-focused remediation.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[kokxi](https://clawhub.ai/user/kokxi)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nQA testers, developers, and engineering teams use this skill to analyze recurring or production bugs, separate direct, contributing, and systemic causes, validate hypotheses, and define prevention measures that improve test design.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The release guidance flags an unpinned command that can install a larger mutable QA skill set.\n\nMitigation: Review the bundle before installation and prefer an immutable, pinned version or commit for any npx or repository install.\n\nRisk: Bug reports, logs, screenshots, payment details, IDs, and customer information may contain sensitive production data.\n\nMitigation: Sanitize or mask sensitive data before using the skill, and run it without unnecessary credentials or broad access to external monitoring tools.\n\nRisk: Security evidence rates the release as suspicious due to ambiguous data-handling scope and mutable install guidance.\n\nMitigation: Run the skill in a restricted environment and review its behavior before using it with confidential QA or incident materials.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/kokxi/skills/qa-bug-root-cause-analysis)\n- [Publisher profile](https://clawhub.ai/user/kokxi)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, guidance]\n\n**Output Format:** [Markdown root-cause analysis with tables and structured remediation sections]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Includes root-cause IDs, bug traceability, contributing factors, impact assessment, fix suggestions, and prevention measures.]\n\n## Skill Version(s):\n\n1.7.6 (source: server-resolved release metadata; artifact frontmatter lists 1.7.5)\n\n## Ethical Considerations:\n\nUsers 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.\n\nArchive v1.7.5: 3 files, 6600 bytes\n\nFiles: skill-card.md (2115b), SKILL.md (11697b), _meta.json (145b)\n\nFile v1.7.5:SKILL.md\n\n---\nname: qa-bug-root-cause-analysis\nslug: qa-bug-root-cause-analysis\ndisplayName: Bug Root Cause Analysis\nversion: 1.7.5\ndescription: >-\n 当某个 Bug 频繁复现、线上有缺陷需要做事后分析、或者发现同一类问题反复出现需要根治时使用此技能。从症状出发用 5Why、因果图和鱼骨图等方法系统化定位缺陷根源，区分直接原因、间接原因和系统原因。不要只修症状——根因分析的价值在于找到让同类 Bug 不再发生的系统性改进措施，同时分析漏测原因来优化测试设计。 ⚠️ 本技能示例可能调用外部日志/监控工具，请在受控环境执行。\nwhen_to_use: 用户说\"Bug根因\"、\"根因分析\"、\"为什么出Bug\"、\"深层原因\"、\"定位问题\"、\"排查方向\"、需要分析Bug根因、反复出现同类问题需要根因改进时\nallowed-tools: Read Grep Glob Bash\nrelated_skills:\n upstream:\n - qa-execution-observation # 输入：执行观察发现的异常信号\n downstream:\n - qa-bug-reporting # 输出：根因分析用于Bug报告\n - qa-retrospective # 输出：根因分类用于复盘\ninput_format:\n required:\n - name: Bug描述\n type: string\n description: 缺陷的详细描述\n - name: 执行日志\n type: string\n description: 执行过程中的日志信息\n - name: 环境信息\n type: string\n description: 缺陷发现时的环境配置\n optional:\n - name: 复现步骤\n type: array\n description: 缺陷复现的具体步骤\noutput_format:\n traceability:\n - 每个根因分析带唯一ID（ROOT-XXXX）\n - 关联Bug ID（TC_{缺陷模块缩写}_{功能缩写}_{序号}，如 TC_BUG_LOGIN_001；缺陷追溯保留 BUG 前缀）\n structure:\n - 测试用例表格：固定 9 列（用例编号|测试类型|功能模块|测试标题|用例级别|预置条件|测试步骤|预期结果|风险等级）\n - 用例级别：P0≤20%（核心流程）/ P1≤40%（主要功能）/ P2≤30%（次要功能）/ P3≤10%（边缘场景）\n - 覆盖率：标注口径（基于现有需求/输入文档），禁止\"全覆盖/100%\"绝对化表述；缺失模块标注\"未覆盖+原因\"\n - root_cause: 根因分析结论\n - contributing_factors: 促成因素清单\n - impact_assessment: 影响范围评估\n - fix_suggestions: 修复建议\n - prevention_measures: 预防措施\ncategories: ['Development','Testing','Quality']\ndepth_requirement_quantification:\n reference_value: \"根据缺陷复杂度调整根因分析深度：简单×1/中等×2/复杂×3\"\n minimum: \"至少区分直接原因、间接原因、系统原因3个层级\"\nerror_recovery_guidance:\n on_failure: \"根因定位不充分时回退到执行观察收集更多信号\"\n retry_behavior: \"补充日志或环境信息后重新分析根因\"\n---\n> **⚠️ 安全警告**：本技能的示例可能涉及订单号、支付金额、截图、身份证、手机号等敏感数据。\n> 实际使用时请勿粘贴真实生产数据、客户信息或财务凭证；测试前应脱敏/掩码处理。\n> 本技能仅在 workspace/ 输出评估文件，不持久化、不外传、不跨会话复用。\n\n# Bug根因分析\n\n## 核心原则\n\n看到错误，能快速缩小根因范围——这不是魔法，是可学习的映射模式。\n\n## 症状分类与根因映射\n\n### 症状1：返回错误\n\n```text\n症状表现：\n- HTTP状态码错误（4xx/5xx）\n- 业务错误码\n- 错误信息\n\n根因方向：\n├─ 代码层\n│ ├─ 逻辑错误：条件判断错误\n│ ├─ 空指针：对象未初始化\n│ ├─ 数组越界：索引超出范围\n│ └─ 类型转换：类型不匹配\n│\n├─ 数据层\n│ ├─ 数据缺失：必要数据不存在\n│ ├─ 数据错误：数据格式/值错误\n│ ├─ 数据冲突：唯一性约束\n│ └─ 数据过期：数据已失效\n│\n├─ 配置层\n│ ├─ 配置缺失：配置项未配置\n│ ├─ 配置错误：配置值错误\n│ ├─ 环境差异：不同环境配置不同\n│ └─ 配置变更：配置被意外修改\n│\n└─ 依赖层\n ├─ 依赖不可用：第三方服务故障\n ├─ 依赖超时：响应超时\n ├─ 依赖返回错误：第三方返回异常\n └─ 依赖版本不兼容：接口变更\n```\n\n### 症状2：数据不对\n\n```text\n症状表现：\n- 数据缺失\n- 数据错误\n- 数据不一致\n- 数据格式异常\n\n根因方向：\n├─ 写入问题\n│ ├─ 写入失败：数据库操作失败\n│ ├─ 写入丢失：事务未提交\n│ ├─ 写入延迟：异步写入未完成\n│ └─ 写入重复：重复提交\n│\n├─ 读取问题\n│ ├─ 缓存不一致：缓存与DB不同步\n│ ├─ 读取过滤：查询条件过滤\n│ ├─ 读取延迟：读从库延迟\n│ └─ 读取缓存：读到旧缓存\n│\n├─ 同步问题\n│ ├─ 同步延迟：主从同步延迟\n│ ├─ 同步失败：同步任务失败\n│ ├─ 同步冲突：并发同步冲突\n│ └─ 同步丢失：同步任务遗漏\n│\n└─ 转换问题\n ├─ 格式转换：数据格式转换错误\n ├─ 编码问题：字符编码不一致\n ├─ 精度丢失：浮点数精度问题\n └─ 时区问题：时区转换错误\n```\n\n### 症状3：性能退化\n\n```text\n症状表现：\n- 响应时间变长\n- 吞吐量下降\n- 资源占用高\n\n根因方向：\n├─ 数据库问题\n│ ├─ 慢查询：SQL执行慢\n│ ├─ 索引缺失：缺少必要索引\n│ ├─ 锁等待：锁竞争\n│ ├─ 连接池耗尽：连接数不够\n│ └─ 数据量增长：数据量变大\n│\n├─ 代码问题\n│ ├─ 算法复杂度：算法效率低\n│ ├─ 循环嵌套：循环次数多\n│ ├─ 内存泄漏：内存未释放\n│ ├─ 线程阻塞：线程等待\n│ └─ 频繁GC：垃圾回收频繁\n│\n├─ 缓存问题\n│ ├─ 缓存穿透：缓存未命中\n│ ├─ 缓存雪崩：缓存集中失效\n│ ├─ 缓存击穿：热点key失效\n│ └─ 缓存容量：缓存容量不足\n│\n└─ 资源问题\n ├─ CPU瓶颈：CPU占用高\n ├─ 内存瓶颈：内存不足\n ├─ IO瓶颈：磁盘IO慢\n └─ 网络瓶颈：网络延迟高\n```\n\n### 症状4：没反应\n\n```text\n症状表现：\n- 点击无反应\n- 操作无效果\n- 界面卡住\n\n根因方向：\n├─ 前端问题\n│ ├─ JS报错：JavaScript错误\n│ ├─ 事件绑定：事件未绑定\n│ ├─ 状态异常：前端状态错误\n│ ├─ 网络请求：请求未发出\n│ └─ 渲染异常：DOM渲染错误\n│\n├─ 网络问题\n│ ├─ 请求丢失：网络丢包\n│ ├─ 请求超时：网络超时\n│ ├─ 连接断开：网络断开\n│ └─ DNS解析：DNS解析失败\n│\n├─ 后端问题\n│ ├─ 请求未接收：请求未到达\n│ ├─ 处理阻塞：处理线程阻塞\n│ ├─ 响应丢失：响应未返回\n│ └─ 服务不可用：服务宕机\n│\n└─ 中间件问题\n ├─ Nginx问题：Nginx配置错误\n ├─ 网关问题：网关路由错误\n ├─ MQ问题：消息队列阻塞\n └─ 限流问题：触发限流\n```\n\n### 症状5：偶发问题\n\n```text\n症状表现：\n- 时有时无\n- 特定条件出现\n- 难以复现\n\n根因方向：\n├─ 并发问题\n│ ├─ 竞态条件：并发操作冲突\n│ ├─ 死锁：线程互相等待\n│ ├─ 线程安全：共享资源竞争\n│ └─ 资源泄露：资源未释放\n│\n├─ 环境问题\n│ ├─ 环境差异：不同环境表现不同\n│ ├─ 配置差异：配置不一致\n│ ├─ 依赖状态：依赖服务状态\n│ └─ 硬件差异：硬件性能差异\n│\n├─ 数据问题\n│ ├─ 数据状态：特定数据状态触发\n│ ├─ 数据量：数据量达到阈值触发\n│ ├─ 数据顺序：数据顺序影响\n│ └─ 数据时效：数据过期触发\n│\n└─ 时序问题\n ├─ 时序依赖：操作顺序影响\n ├─ 定时任务：定时任务触发\n ├─ 缓存过期：缓存过期触发\n └─ 会话超时：会话过期触发\n```\n\n## 分析流程\n\n### 步骤1：收集信息\n```text\n信息收集清单：\n├─ 症状描述：具体表现是什么？\n├─ 复现步骤：怎么复现？\n├─ 环境信息：什么环境下出现？\n├─ 时间信息：什么时候出现？\n├─ 影响范围：影响多大？\n└─ 相关日志：日志有什么？\n```\n\n### 步骤2：分类症状\n```text\n根据症状表现分类：\n- 返回错误 → 代码/数据/配置/依赖层\n- 数据不对 → 写入/读取/同步/转换问题\n- 性能退化 → 数据库/代码/缓存/资源问题\n- 没反应 → 前端/网络/后端/中间件问题\n- 偶发问题 → 并发/环境/数据/时序问题\n```\n\n### 步骤3：缩小范围\n```text\n根据症状分类，逐层排查：\n1. 先排除外部因素（依赖/环境）\n2. 再排除配置因素\n3. 再排查数据因素\n4. 最后排查代码因素\n```\n\n### 步骤4：验证假设\n```text\n验证方法：\n1. 复现问题\n2. 修改假设条件\n3. 验证问题是否消失\n4. 确认根因\n```\n\n## 根因分析表\n\n| Bug ID | 症状分类 | 根因方向 | 根本原因 | 验证方法 |\n|--------|---------|---------|---------|---------|\n| BUG-001 | 返回错误 | 数据层 | 数据格式错误 | 修改数据后验证 |\n| BUG-002 | 性能退化 | 数据库 | 慢查询 | 添加索引后验证 |\n\n## 症状分类速查\n\n### 从现象到根因方向\n\n| 现象 | 症状分类 | 大概率方向 | 优先排查 |\n|------|---------|-----------|---------|\n| 报500错误 | 返回错误 | 后端异常/数据异常 | 日志ERROR + 入参数据 |\n| 返回空数据 | 返回错误 | 查询条件/权限过滤 | SQL日志 + 权限配置 |\n| 页面白屏 | 返回错误 | 前端解析/接口数据格式 | F12看接口响应 |\n| 金额不对 | 数据不对 | 计算逻辑/精度问题 | 核对计算公式 |\n| 状态不更新 | 数据不对 | 状态机/回调处理 | 检查状态流转日志 |\n| 账单对不上 | 数据不对 | 数据一致性/事务问题 | 核对多个数据源 |\n| 页面越来越慢 | 性能退化 | 慢查询/数据累积 | 慢SQL日志 |\n| 高峰期就挂 | 性能退化 | 并发/资源不足 | 压测复现+监控 |\n| 点按钮没反应 | 没反应 | 前端事件绑定/接口不通 | F12看请求是否发出 |\n| 加载中不动 | 没反应 | 后端处理卡住/死锁 | 线程堆栈+DB锁查询 |\n| 偶尔支付失败 | 偶发问题 | 并发冲突/超时 | 并行多次复现 |\n| 特定时间出问题 | 偶发问题 | 定时任务/缓存过期 | 核对定时任务时间+缓存策略 |\n| 只有某用户出问题 | 偶发问题 | 数据隔离/权限 | 对比正常/异常用户数据 |\n\n## 输出示例\n\n**Bug描述：\"用户支付成功但订单状态仍为待支付\"**\n→ 症状分类：数据不一致（症状2）\n→ 根因映射：数据层问题→检查支付回调处理逻辑\n→ 分析流程：\n 1. 收集信息：支付网关回执、订单日志、数据库记录\n 2. 分类症状：数据不一致\n 3. 缩小范围：支付回调→订单状态更新→数据库写入\n 4. 验证假设：手动触发回调验证状态变更\n\n**Bug描述：\"页面加载越来越慢\"**\n→ 症状分类：性能退化（症状3）→ 数据库/缓存层排查\n\n## 检查清单\n\n根因分析完成后检查：\n- [ ] 是否收集了完整信息？\n- [ ] 是否正确分类症状？\n- [ ] 是否逐层排查根因？\n- [ ] 是否验证了根因假设？\n- [ ] 根因描述是否清晰？\n- [ ] 验证方法是否可行？\n\nFile v1.7.5:_meta.json\n\n{\n \"ownerId\": \"kn71y9b23csfx0ykgm55d5m9x5891zt8\",\n \"slug\": \"qa-bug-root-cause-analysis\",\n \"version\": \"1.7.5\",\n \"publishedAt\": 1788102719740\n}\n\nFile v1.7.5:skill-card.md\n\n## Description:\n\nUse this skill when a bug recurs, a production defect needs post-incident analysis, or a recurring issue needs a systemic fix; it guides agents from symptoms through 5 Why, cause-and-effect, and fishbone-style analysis to distinguish direct, indirect, and systemic causes and improve test design.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[kokxi](https://clawhub.ai/user/kokxi)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers, QA engineers, and incident reviewers use this skill to analyze recurring software defects, map symptoms to likely technical causes, validate root-cause hypotheses, and propose fixes and prevention measures.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Bug investigation inputs may contain production logs, customer identifiers, payment details, screenshots, financial records, or other sensitive data.\n\nMitigation: Use the skill in controlled environments and redact or mask sensitive data before sharing inputs.\n\nRisk: The skill may suggest bash commands or local diagnostic steps that touch logs, monitoring tools, or workspace files.\n\nMitigation: Review commands before execution and run them only against approved systems and data.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/kokxi/skills/qa-bug-root-cause-analysis)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, Guidance]\n\n**Output Format:** [Markdown with structured root-cause analysis, tables, checklists, and optional shell commands]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include root-cause IDs, contributing factors, impact assessment, fix suggestions, prevention measures, and test-design improvements.]\n\n## Skill Version(s):\n\n1.7.5 (source: frontmatter and server release metadata)\n\n## Ethical Considerations:\n\nUsers 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.\n\nArchive v1.6.3: 3 files, 6196 bytes\n\nFiles: skill-card.md (2036b), SKILL.md (11162b), _meta.json (145b)\n\nFile v1.6.3:SKILL.md\n\n---\nname: qa-bug-root-cause-analysis\nslug: qa-bug-root-cause-analysis\ndisplayName: Bug Root Cause Analysis\nversion: 1.6.3\ndescription: >-\n 当某个 Bug 频繁复现、线上有缺陷需要做事后分析、或者发现同一类问题反复出现需要根治时使用此技能。从症状出发用 5Why、因果图和鱼骨图等方法系统化定位缺陷根源，区分直接原因、间接原因和系统原因。不要只修症状——根因分析的价值在于找到让同类 Bug 不再发生的系统性改进措施，同时分析漏测原因来优化测试设计。 ⚠️ 本技能示例可能调用外部日志/监控工具，请在受控环境执行。\nwhen_to_use: 用户说\"Bug根因\"、\"根因分析\"、\"为什么出Bug\"、\"深层原因\"、\"定位问题\"、\"排查方向\"、需要分析Bug根因、反复出现同类问题需要根因改进时\nallowed-tools: Read Grep Glob Bash\nrelated_skills:\n upstream:\n - qa-execution-observation # 输入：执行观察发现的异常信号\n downstream:\n - qa-bug-reporting # 输出：根因分析用于Bug报告\n - qa-retrospective # 输出：根因分类用于复盘\ninput_format:\n required:\n - name: Bug描述\n type: string\n description: 缺陷的详细描述\n - name: 执行日志\n type: string\n description: 执行过程中的日志信息\n - name: 环境信息\n type: string\n description: 缺陷发现时的环境配置\n optional:\n - name: 复现步骤\n type: array\n description: 缺陷复现的具体步骤\noutput_format:\n traceability:\n - 每个根因分析带唯一ID（ROOT-XXXX）\n - 关联Bug ID（BUG-XXXX）\n structure:\n - root_cause: 根因分析结论\n - contributing_factors: 促成因素清单\n - impact_assessment: 影响范围评估\n - fix_suggestions: 修复建议\n - prevention_measures: 预防措施\ncategories: ['Development','Testing','Quality']\ndepth_requirement_quantification:\n reference_value: \"根据缺陷复杂度调整根因分析深度：简单×1/中等×2/复杂×3\"\n minimum: \"至少区分直接原因、间接原因、系统原因3个层级\"\nerror_recovery_guidance:\n on_failure: \"根因定位不充分时回退到执行观察收集更多信号\"\n retry_behavior: \"补充日志或环境信息后重新分析根因\"\n---\n> **⚠️ 安全警告**：本技能的示例可能涉及订单号、支付金额、截图、身份证、手机号等敏感数据。\n> 实际使用时请勿粘贴真实生产数据、客户信息或财务凭证；测试前应脱敏/掩码处理。\n> 本技能仅在 workspace/ 输出评估文件，不持久化、不外传、不跨会话复用。\n\n# Bug根因分析\n\n## 核心原则\n\n看到错误，能快速缩小根因范围——这不是魔法，是可学习的映射模式。\n\n## 症状分类与根因映射\n\n### 症状1：返回错误\n\n```text\n症状表现：\n- HTTP状态码错误（4xx/5xx）\n- 业务错误码\n- 错误信息\n\n根因方向：\n├─ 代码层\n│ ├─ 逻辑错误：条件判断错误\n│ ├─ 空指针：对象未初始化\n│ ├─ 数组越界：索引超出范围\n│ └─ 类型转换：类型不匹配\n│\n├─ 数据层\n│ ├─ 数据缺失：必要数据不存在\n│ ├─ 数据错误：数据格式/值错误\n│ ├─ 数据冲突：唯一性约束\n│ └─ 数据过期：数据已失效\n│\n├─ 配置层\n│ ├─ 配置缺失：配置项未配置\n│ ├─ 配置错误：配置值错误\n│ ├─ 环境差异：不同环境配置不同\n│ └─ 配置变更：配置被意外修改\n│\n└─ 依赖层\n ├─ 依赖不可用：第三方服务故障\n ├─ 依赖超时：响应超时\n ├─ 依赖返回错误：第三方返回异常\n └─ 依赖版本不兼容：接口变更\n```\n\n### 症状2：数据不对\n\n```text\n症状表现：\n- 数据缺失\n- 数据错误\n- 数据不一致\n- 数据格式异常\n\n根因方向：\n├─ 写入问题\n│ ├─ 写入失败：数据库操作失败\n│ ├─ 写入丢失：事务未提交\n│ ├─ 写入延迟：异步写入未完成\n│ └─ 写入重复：重复提交\n│\n├─ 读取问题\n│ ├─ 缓存不一致：缓存与DB不同步\n│ ├─ 读取过滤：查询条件过滤\n│ ├─ 读取延迟：读从库延迟\n│ └─ 读取缓存：读到旧缓存\n│\n├─ 同步问题\n│ ├─ 同步延迟：主从同步延迟\n│ ├─ 同步失败：同步任务失败\n│ ├─ 同步冲突：并发同步冲突\n│ └─ 同步丢失：同步任务遗漏\n│\n└─ 转换问题\n ├─ 格式转换：数据格式转换错误\n ├─ 编码问题：字符编码不一致\n ├─ 精度丢失：浮点数精度问题\n └─ 时区问题：时区转换错误\n```\n\n### 症状3：性能退化\n\n```text\n症状表现：\n- 响应时间变长\n- 吞吐量下降\n- 资源占用高\n\n根因方向：\n├─ 数据库问题\n│ ├─ 慢查询：SQL执行慢\n│ ├─ 索引缺失：缺少必要索引\n│ ├─ 锁等待：锁竞争\n│ ├─ 连接池耗尽：连接数不够\n│ └─ 数据量增长：数据量变大\n│\n├─ 代码问题\n│ ├─ 算法复杂度：算法效率低\n│ ├─ 循环嵌套：循环次数多\n│ ├─ 内存泄漏：内存未释放\n│ ├─ 线程阻塞：线程等待\n│ └─ 频繁GC：垃圾回收频繁\n│\n├─ 缓存问题\n│ ├─ 缓存穿透：缓存未命中\n│ ├─ 缓存雪崩：缓存集中失效\n│ ├─ 缓存击穿：热点key失效\n│ └─ 缓存容量：缓存容量不足\n│\n└─ 资源问题\n ├─ CPU瓶颈：CPU占用高\n ├─ 内存瓶颈：内存不足\n ├─ IO瓶颈：磁盘IO慢\n └─ 网络瓶颈：网络延迟高\n```\n\n### 症状4：没反应\n\n```text\n症状表现：\n- 点击无反应\n- 操作无效果\n- 界面卡住\n\n根因方向：\n├─ 前端问题\n│ ├─ JS报错：JavaScript错误\n│ ├─ 事件绑定：事件未绑定\n│ ├─ 状态异常：前端状态错误\n│ ├─ 网络请求：请求未发出\n│ └─ 渲染异常：DOM渲染错误\n│\n├─ 网络问题\n│ ├─ 请求丢失：网络丢包\n│ ├─ 请求超时：网络超时\n│ ├─ 连接断开：网络断开\n│ └─ DNS解析：DNS解析失败\n│\n├─ 后端问题\n│ ├─ 请求未接收：请求未到达\n│ ├─ 处理阻塞：处理线程阻塞\n│ ├─ 响应丢失：响应未返回\n│ └─ 服务不可用：服务宕机\n│\n└─ 中间件问题\n ├─ Nginx问题：Nginx配置错误\n ├─ 网关问题：网关路由错误\n ├─ MQ问题：消息队列阻塞\n └─ 限流问题：触发限流\n```\n\n### 症状5：偶发问题\n\n```text\n症状表现：\n- 时有时无\n- 特定条件出现\n- 难以复现\n\n根因方向：\n├─ 并发问题\n│ ├─ 竞态条件：并发操作冲突\n│ ├─ 死锁：线程互相等待\n│ ├─ 线程安全：共享资源竞争\n│ └─ 资源泄露：资源未释放\n│\n├─ 环境问题\n│ ├─ 环境差异：不同环境表现不同\n│ ├─ 配置差异：配置不一致\n│ ├─ 依赖状态：依赖服务状态\n│ └─ 硬件差异：硬件性能差异\n│\n├─ 数据问题\n│ ├─ 数据状态：特定数据状态触发\n│ ├─ 数据量：数据量达到阈值触发\n│ ├─ 数据顺序：数据顺序影响\n│ └─ 数据时效：数据过期触发\n│\n└─ 时序问题\n ├─ 时序依赖：操作顺序影响\n ├─ 定时任务：定时任务触发\n ├─ 缓存过期：缓存过期触发\n └─ 会话超时：会话过期触发\n```\n\n## 分析流程\n\n### 步骤1：收集信息\n```text\n信息收集清单：\n├─ 症状描述：具体表现是什么？\n├─ 复现步骤：怎么复现？\n├─ 环境信息：什么环境下出现？\n├─ 时间信息：什么时候出现？\n├─ 影响范围：影响多大？\n└─ 相关日志：日志有什么？\n```\n\n### 步骤2：分类症状\n```text\n根据症状表现分类：\n- 返回错误 → 代码/数据/配置/依赖层\n- 数据不对 → 写入/读取/同步/转换问题\n- 性能退化 → 数据库/代码/缓存/资源问题\n- 没反应 → 前端/网络/后端/中间件问题\n- 偶发问题 → 并发/环境/数据/时序问题\n```\n\n### 步骤3：缩小范围\n```text\n根据症状分类，逐层排查：\n1. 先排除外部因素（依赖/环境）\n2. 再排除配置因素\n3. 再排查数据因素\n4. 最后排查代码因素\n```\n\n### 步骤4：验证假设\n```text\n验证方法：\n1. 复现问题\n2. 修改假设条件\n3. 验证问题是否消失\n4. 确认根因\n```\n\n## 根因分析表\n\n| Bug ID | 症状分类 | 根因方向 | 根本原因 | 验证方法 |\n|--------|---------|---------|---------|---------|\n| BUG-001 | 返回错误 | 数据层 | 数据格式错误 | 修改数据后验证 |\n| BUG-002 | 性能退化 | 数据库 | 慢查询 | 添加索引后验证 |\n\n## 症状分类速查\n\n### 从现象到根因方向\n\n| 现象 | 症状分类 | 大概率方向 | 优先排查 |\n|------|---------|-----------|---------|\n| 报500错误 | 返回错误 | 后端异常/数据异常 | 日志ERROR + 入参数据 |\n| 返回空数据 | 返回错误 | 查询条件/权限过滤 | SQL日志 + 权限配置 |\n| 页面白屏 | 返回错误 | 前端解析/接口数据格式 | F12看接口响应 |\n| 金额不对 | 数据不对 | 计算逻辑/精度问题 | 核对计算公式 |\n| 状态不更新 | 数据不对 | 状态机/回调处理 | 检查状态流转日志 |\n| 账单对不上 | 数据不对 | 数据一致性/事务问题 | 核对多个数据源 |\n| 页面越来越慢 | 性能退化 | 慢查询/数据累积 | 慢SQL日志 |\n| 高峰期就挂 | 性能退化 | 并发/资源不足 | 压测复现+监控 |\n| 点按钮没反应 | 没反应 | 前端事件绑定/接口不通 | F12看请求是否发出 |\n| 加载中不动 | 没反应 | 后端处理卡住/死锁 | 线程堆栈+DB锁查询 |\n| 偶尔支付失败 | 偶发问题 | 并发冲突/超时 | 并行多次复现 |\n| 特定时间出问题 | 偶发问题 | 定时任务/缓存过期 | 核对定时任务时间+缓存策略 |\n| 只有某用户出问题 | 偶发问题 | 数据隔离/权限 | 对比正常/异常用户数据 |\n\n## 输出示例\n\n**Bug描述：\"用户支付成功但订单状态仍为待支付\"**\n→ 症状分类：数据不一致（症状2）\n→ 根因映射：数据层问题→检查支付回调处理逻辑\n→ 分析流程：\n 1. 收集信息：支付网关回执、订单日志、数据库记录\n 2. 分类症状：数据不一致\n 3. 缩小范围：支付回调→订单状态更新→数据库写入\n 4. 验证假设：手动触发回调验证状态变更\n\n**Bug描述：\"页面加载越来越慢\"**\n→ 症状分类：性能退化（症状3）→ 数据库/缓存层排查\n\n## 检查清单\n\n根因分析完成后检查：\n- [ ] 是否收集了完整信息？\n- [ ] 是否正确分类症状？\n- [ ] 是否逐层排查根因？\n- [ ] 是否验证了根因假设？\n- [ ] 根因描述是否清晰？\n- [ ] 验证方法是否可行？\n\nFile v1.6.3:_meta.json\n\n{\n \"ownerId\": \"kn71y9b23csfx0ykgm55d5m9x5891zt8\",\n \"slug\": \"qa-bug-root-cause-analysis\",\n \"version\": \"1.6.3\",\n \"publishedAt\": 1786548111721\n}\n\nFile v1.6.3:skill-card.md\n\n## Description:\n\nHelps QA and engineering teams investigate recurring or production bugs by mapping symptoms to likely root-cause areas, validating hypotheses, and identifying fixes and prevention measures.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[kokxi](https://clawhub.ai/user/kokxi)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers, QA engineers, and engineering leads use this skill to structure bug root-cause analysis from bug descriptions, execution logs, environment details, and optional reproduction steps. It supports post-incident analysis, recurring defect prevention, and test-design improvement.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Bug reports, execution logs, screenshots, payment details, customer identifiers, or credentials may contain sensitive production data.\n\nMitigation: Provide only the debugging context needed for the specific issue and mask production data, customer identifiers, payment details, screenshots, and credentials before use.\n\nRisk: External monitoring or log systems may be involved during debugging.\n\nMitigation: Use controlled environments and approved access paths, and avoid sharing unnecessary data from external systems.\n\n## Reference(s):\n\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, guidance]\n\n**Output Format:** [Markdown or structured text root-cause analysis with traceability identifiers, contributing factors, impact assessment, fix suggestions, and prevention measures.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include ROOT and BUG identifiers and concise checklists for validation and prevention.]\n\n## Skill Version(s):\n\n1.6.3 (source: frontmatter and server release evidence)\n\n## Ethical Considerations:\n\nUsers 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.\n\nArchive v1.6.0: 3 files, 6309 bytes\n\nFiles: skill-card.md (2303b), SKILL.md (11415b), _meta.json (145b)\n\nFile v1.6.0:SKILL.md\n\n---\r\nname: qa-bug-root-cause-analysis\r\nversion: 1.6.0\r\ndescription: >-\r\n 当某个 Bug 频繁复现、线上有缺陷需要做事后分析、或者发现同一类问题反复出现需要根治时使用此技能。从症状出发用 5Why、因果图和鱼骨图等方法系统化定位缺陷根源，区分直接原因、间接原因和系统原因。不要只修症状——根因分析的价值在于找到让同类 Bug 不再发生的系统性改进措施，同时分析漏测原因来优化测试设计。 ⚠️ 本技能示例可能调用外部日志/监控工具，请在受控环境执行。\r\nwhen_to_use: 用户说\"Bug根因\"、\"根因分析\"、\"为什么出Bug\"、\"深层原因\"、\"定位问题\"、\"排查方向\"、需要分析Bug根因、反复出现同类问题需要根因改进时\r\nallowed-tools: Read Grep Glob Bash\r\nrelated_skills:\r\n upstream:\r\n - qa-execution-observation # 输入：执行观察发现的异常信号\r\n downstream:\r\n - qa-bug-reporting # 输出：根因分析用于Bug报告\r\n - qa-retrospective # 输出：根因分类用于复盘\r\ninput_format:\r\n required:\r\n - name: Bug描述\r\n type: string\r\n description: 缺陷的详细描述\r\n - name: 执行日志\r\n type: string\r\n description: 执行过程中的日志信息\r\n - name: 环境信息\r\n type: string\r\n description: 缺陷发现时的环境配置\r\n optional:\r\n - name: 复现步骤\r\n type: array\r\n description: 缺陷复现的具体步骤\r\noutput_format:\r\n traceability:\r\n - 每个根因分析带唯一ID（ROOT-XXXX）\r\n - 关联Bug ID（BUG-XXXX）\r\n structure:\r\n - root_cause: 根因分析结论\r\n - contributing_factors: 促成因素清单\r\n - impact_assessment: 影响范围评估\r\n - fix_suggestions: 修复建议\r\n - prevention_measures: 预防措施\r\ncategories: ['Development','Testing','Quality']\r\ndepth_requirement_quantification:\r\n reference_value: \"根据缺陷复杂度调整根因分析深度：简单×1/中等×2/复杂×3\"\r\n minimum: \"至少区分直接原因、间接原因、系统原因3个层级\"\r\nerror_recovery_guidance:\r\n on_failure: \"根因定位不充分时回退到执行观察收集更多信号\"\r\n retry_behavior: \"补充日志或环境信息后重新分析根因\"\r\n---\r\n> **⚠️ 安全警告**：本技能的示例可能涉及订单号、支付金额、截图、身份证、手机号等敏感数据。\r\n> 实际使用时请勿粘贴真实生产数据、客户信息或财务凭证；测试前应脱敏/掩码处理。\r\n> 本技能仅在 workspace/ 输出评估文件，不持久化、不外传、不跨会话复用。\r\n\r\n# Bug根因分析\r\n\r\n## 核心原则\r\n\r\n看到错误，能快速缩小根因范围——这不是魔法，是可学习的映射模式。\r\n\r\n## 症状分类与根因映射\r\n\r\n### 症状1：返回错误\r\n\r\n```text\r\n症状表现：\r\n- HTTP状态码错误（4xx/5xx）\r\n- 业务错误码\r\n- 错误信息\r\n\r\n根因方向：\r\n├─ 代码层\r\n│ ├─ 逻辑错误：条件判断错误\r\n│ ├─ 空指针：对象未初始化\r\n│ ├─ 数组越界：索引超出范围\r\n│ └─ 类型转换：类型不匹配\r\n│\r\n├─ 数据层\r\n│ ├─ 数据缺失：必要数据不存在\r\n│ ├─ 数据错误：数据格式/值错误\r\n│ ├─ 数据冲突：唯一性约束\r\n│ └─ 数据过期：数据已失效\r\n│\r\n├─ 配置层\r\n│ ├─ 配置缺失：配置项未配置\r\n│ ├─ 配置错误：配置值错误\r\n│ ├─ 环境差异：不同环境配置不同\r\n│ └─ 配置变更：配置被意外修改\r\n│\r\n└─ 依赖层\r\n ├─ 依赖不可用：第三方服务故障\r\n ├─ 依赖超时：响应超时\r\n ├─ 依赖返回错误：第三方返回异常\r\n └─ 依赖版本不兼容：接口变更\r\n```\r\n\r\n### 症状2：数据不对\r\n\r\n```text\r\n症状表现：\r\n- 数据缺失\r\n- 数据错误\r\n- 数据不一致\r\n- 数据格式异常\r\n\r\n根因方向：\r\n├─ 写入问题\r\n│ ├─ 写入失败：数据库操作失败\r\n│ ├─ 写入丢失：事务未提交\r\n│ ├─ 写入延迟：异步写入未完成\r\n│ └─ 写入重复：重复提交\r\n│\r\n├─ 读取问题\r\n│ ├─ 缓存不一致：缓存与DB不同步\r\n│ ├─ 读取过滤：查询条件过滤\r\n│ ├─ 读取延迟：读从库延迟\r\n│ └─ 读取缓存：读到旧缓存\r\n│\r\n├─ 同步问题\r\n│ ├─ 同步延迟：主从同步延迟\r\n│ ├─ 同步失败：同步任务失败\r\n│ ├─ 同步冲突：并发同步冲突\r\n│ └─ 同步丢失：同步任务遗漏\r\n│\r\n└─ 转换问题\r\n ├─ 格式转换：数据格式转换错误\r\n ├─ 编码问题：字符编码不一致\r\n ├─ 精度丢失：浮点数精度问题\r\n └─ 时区问题：时区转换错误\r\n```\r\n\r\n### 症状3：性能退化\r\n\r\n```text\r\n症状表现：\r\n- 响应时间变长\r\n- 吞吐量下降\r\n- 资源占用高\r\n\r\n根因方向：\r\n├─ 数据库问题\r\n│ ├─ 慢查询：SQL执行慢\r\n│ ├─ 索引缺失：缺少必要索引\r\n│ ├─ 锁等待：锁竞争\r\n│ ├─ 连接池耗尽：连接数不够\r\n│ └─ 数据量增长：数据量变大\r\n│\r\n├─ 代码问题\r\n│ ├─ 算法复杂度：算法效率低\r\n│ ├─ 循环嵌套：循环次数多\r\n│ ├─ 内存泄漏：内存未释放\r\n│ ├─ 线程阻塞：线程等待\r\n│ └─ 频繁GC：垃圾回收频繁\r\n│\r\n├─ 缓存问题\r\n│ ├─ 缓存穿透：缓存未命中\r\n│ ├─ 缓存雪崩：缓存集中失效\r\n│ ├─ 缓存击穿：热点key失效\r\n│ └─ 缓存容量：缓存容量不足\r\n│\r\n└─ 资源问题\r\n ├─ CPU瓶颈：CPU占用高\r\n ├─ 内存瓶颈：内存不足\r\n ├─ IO瓶颈：磁盘IO慢\r\n └─ 网络瓶颈：网络延迟高\r\n```\r\n\r\n### 症状4：没反应\r\n\r\n```text\r\n症状表现：\r\n- 点击无反应\r\n- 操作无效果\r\n- 界面卡住\r\n\r\n根因方向：\r\n├─ 前端问题\r\n│ ├─ JS报错：JavaScript错误\r\n│ ├─ 事件绑定：事件未绑定\r\n│ ├─ 状态异常：前端状态错误\r\n│ ├─ 网络请求：请求未发出\r\n│ └─ 渲染异常：DOM渲染错误\r\n│\r\n├─ 网络问题\r\n│ ├─ 请求丢失：网络丢包\r\n│ ├─ 请求超时：网络超时\r\n│ ├─ 连接断开：网络断开\r\n│ └─ DNS解析：DNS解析失败\r\n│\r\n├─ 后端问题\r\n│ ├─ 请求未接收：请求未到达\r\n│ ├─ 处理阻塞：处理线程阻塞\r\n│ ├─ 响应丢失：响应未返回\r\n│ └─ 服务不可用：服务宕机\r\n│\r\n└─ 中间件问题\r\n ├─ Nginx问题：Nginx配置错误\r\n ├─ 网关问题：网关路由错误\r\n ├─ MQ问题：消息队列阻塞\r\n └─ 限流问题：触发限流\r\n```\r\n\r\n### 症状5：偶发问题\r\n\r\n```text\r\n症状表现：\r\n- 时有时无\r\n- 特定条件出现\r\n- 难以复现\r\n\r\n根因方向：\r\n├─ 并发问题\r\n│ ├─ 竞态条件：并发操作冲突\r\n│ ├─ 死锁：线程互相等待\r\n│ ├─ 线程安全：共享资源竞争\r\n│ └─ 资源泄露：资源未释放\r\n│\r\n├─ 环境问题\r\n│ ├─ 环境差异：不同环境表现不同\r\n│ ├─ 配置差异：配置不一致\r\n│ ├─ 依赖状态：依赖服务状态\r\n│ └─ 硬件差异：硬件性能差异\r\n│\r\n├─ 数据问题\r\n│ ├─ 数据状态：特定数据状态触发\r\n│ ├─ 数据量：数据量达到阈值触发\r\n│ ├─ 数据顺序：数据顺序影响\r\n│ └─ 数据时效：数据过期触发\r\n│\r\n└─ 时序问题\r\n ├─ 时序依赖：操作顺序影响\r\n ├─ 定时任务：定时任务触发\r\n ├─ 缓存过期：缓存过期触发\r\n └─ 会话超时：会话过期触发\r\n```\r\n\r\n## 分析流程\r\n\r\n### 步骤1：收集信息\r\n```text\r\n信息收集清单：\r\n├─ 症状描述：具体表现是什么？\r\n├─ 复现步骤：怎么复现？\r\n├─ 环境信息：什么环境下出现？\r\n├─ 时间信息：什么时候出现？\r\n├─ 影响范围：影响多大？\r\n└─ 相关日志：日志有什么？\r\n```\r\n\r\n### 步骤2：分类症状\r\n```text\r\n根据症状表现分类：\r\n- 返回错误 → 代码/数据/配置/依赖层\r\n- 数据不对 → 写入/读取/同步/转换问题\r\n- 性能退化 → 数据库/代码/缓存/资源问题\r\n- 没反应 → 前端/网络/后端/中间件问题\r\n- 偶发问题 → 并发/环境/数据/时序问题\r\n```\r\n\r\n### 步骤3：缩小范围\r\n```text\r\n根据症状分类，逐层排查：\r\n1. 先排除外部因素（依赖/环境）\r\n2. 再排除配置因素\r\n3. 再排查数据因素\r\n4. 最后排查代码因素\r\n```\r\n\r\n### 步骤4：验证假设\r\n```text\r\n验证方法：\r\n1. 复现问题\r\n2. 修改假设条件\r\n3. 验证问题是否消失\r\n4. 确认根因\r\n```\r\n\r\n## 根因分析表\r\n\r\n| Bug ID | 症状分类 | 根因方向 | 根本原因 | 验证方法 |\r\n|--------|---------|---------|---------|---------|\r\n| BUG-001 | 返回错误 | 数据层 | 数据格式错误 | 修改数据后验证 |\r\n| BUG-002 | 性能退化 | 数据库 | 慢查询 | 添加索引后验证 |\r\n\r\n## 症状分类速查\r\n\r\n### 从现象到根因方向\r\n\r\n| 现象 | 症状分类 | 大概率方向 | 优先排查 |\r\n|------|---------|-----------|---------|\r\n| 报500错误 | 返回错误 | 后端异常/数据异常 | 日志ERROR + 入参数据 |\r\n| 返回空数据 | 返回错误 | 查询条件/权限过滤 | SQL日志 + 权限配置 |\r\n| 页面白屏 | 返回错误 | 前端解析/接口数据格式 | F12看接口响应 |\r\n| 金额不对 | 数据不对 | 计算逻辑/精度问题 | 核对计算公式 |\r\n| 状态不更新 | 数据不对 | 状态机/回调处理 | 检查状态流转日志 |\r\n| 账单对不上 | 数据不对 | 数据一致性/事务问题 | 核对多个数据源 |\r\n| 页面越来越慢 | 性能退化 | 慢查询/数据累积 | 慢SQL日志 |\r\n| 高峰期就挂 | 性能退化 | 并发/资源不足 | 压测复现+监控 |\r\n| 点按钮没反应 | 没反应 | 前端事件绑定/接口不通 | F12看请求是否发出 |\r\n| 加载中不动 | 没反应 | 后端处理卡住/死锁 | 线程堆栈+DB锁查询 |\r\n| 偶尔支付失败 | 偶发问题 | 并发冲突/超时 | 并行多次复现 |\r\n| 特定时间出问题 | 偶发问题 | 定时任务/缓存过期 | 核对定时任务时间+缓存策略 |\r\n| 只有某用户出问题 | 偶发问题 | 数据隔离/权限 | 对比正常/异常用户数据 |\r\n\r\n## 输出示例\r\n\r\n**Bug描述：\"用户支付成功但订单状态仍为待支付\"**\r\n→ 症状分类：数据不一致（症状2）\r\n→ 根因映射：数据层问题→检查支付回调处理逻辑\r\n→ 分析流程：\r\n 1. 收集信息：支付网关回执、订单日志、数据库记录\r\n 2. 分类症状：数据不一致\r\n 3. 缩小范围：支付回调→订单状态更新→数据库写入\r\n 4. 验证假设：手动触发回调验证状态变更\r\n\r\n**Bug描述：\"页面加载越来越慢\"**\r\n→ 症状分类：性能退化（症状3）→ 数据库/缓存层排查\r\n\r\n## 检查清单\r\n\r\n根因分析完成后检查：\r\n- [ ] 是否收集了完整信息？\r\n- [ ] 是否正确分类症状？\r\n- [ ] 是否逐层排查根因？\r\n- [ ] 是否验证了根因假设？\r\n- [ ] 根因描述是否清晰？\r\n- [ ] 验证方法是否可行？\n\nFile v1.6.0:_meta.json\n\n{\n \"ownerId\": \"kn71y9b23csfx0ykgm55d5m9x5891zt8\",\n \"slug\": \"qa-bug-root-cause-analysis\",\n \"version\": \"1.6.0\",\n \"publishedAt\": 1783358075927\n}\n\nFile v1.6.0:skill-card.md\n\n## Description:
\nGuides agents through structured QA bug root-cause analysis by classifying symptoms, tracing direct, indirect, and systemic causes, and producing fix and prevention recommendations.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[kokxi](https://clawhub.ai/user/kokxi)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nDevelopers, QA engineers, and incident reviewers use this skill to analyze recurring or production bugs, identify root causes, assess impact, and define fixes and prevention measures. It is suited for post-defect analysis when logs, environment details, reproduction steps, and bug descriptions are available.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: Broad trigger phrases may activate the skill during general troubleshooting.
\nMitigation: Confirm the user wants a formal QA root-cause analysis before applying the workflow to generic debugging requests.
\nRisk: Bug reports, logs, screenshots, and payment or customer examples can contain sensitive production data.
\nMitigation: Mask production logs, customer identifiers, payment details, screenshots, credentials, and environment secrets before using the skill.
\n\n\n## Reference(s):
\n- [ClawHub skill release page](https://clawhub.ai/kokxi/skills/qa-bug-root-cause-analysis)
\n- [ClawHub publisher profile](https://clawhub.ai/user/kokxi)
\n\n\n## Skill Output:
\n**Output Type(s):** [Analysis, Markdown, Guidance]
\n**Output Format:** [Markdown with structured root-cause analysis fields, traceability IDs, tables, and checklists]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Outputs include ROOT-XXXX traceability, BUG-XXXX linkage, root cause, contributing factors, impact assessment, fix suggestions, prevention measures, and verification guidance.]
\n\n## Skill Version(s):
\n1.6.0 (source: server release evidence and SKILL.md frontmatter)
\n\n## Ethical Considerations:
\nUsers 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.
\n\nArchive v1.5.0: 3 files, 5813 bytes\n\nFiles: skill-card.md (2260b), SKILL.md (10614b), _meta.json (145b)\n\nFile v1.5.0:SKILL.md\n\n---\r\nname: qa-bug-root-cause-analysis\r\nversion: 1.5.0\r\ndescription: >-\r\n 当某个 Bug 频繁复现、线上有缺陷需要做事后分析、或者发现同一类问题反复出现需要根治时使用此技能。从症状出发用 5Why、因果图和鱼骨图等方法系统化定位缺陷根源，区分直接原因、间接原因和系统原因。不要只修症状——根因分析的价值在于找到让同类 Bug 不再发生的系统性改进措施，同时分析漏测原因来优化测试设计。\r\n\r\nwhen_to_use: 用户说\"分析Bug\"、\"根因分析\"、\"为什么出错\"、\"Bug原因\"、\"怎么发生的\"、\"5 Why\"、\"根治\"、需要定位Bug原因、缺陷频发需要系统性根治时\r\nallowed-tools: Read Grep Glob Bash\r\nrelated_skills:\r\n upstream:\r\n - qa-execution-observation # 输入：执行观察发现的异常信号\r\n downstream:\r\n - qa-bug-reporting # 输出：根因分析用于Bug报告\r\n - qa-retrospective # 输出：根因分类用于复盘\r\ninput_format:\r\n required:\r\n - name: Bug描述\r\n type: string\r\n description: 缺陷的详细描述\r\n - name: 执行日志\r\n type: string\r\n description: 执行过程中的日志信息\r\n - name: 环境信息\r\n type: string\r\n description: 缺陷发现时的环境配置\r\n optional:\r\n - name: 复现步骤\r\n type: array\r\n description: 缺陷复现的具体步骤\r\noutput_format:\r\n structure:\r\n - root_cause: 根因分析结论\r\n - contributing_factors: 促成因素清单\r\n - impact_assessment: 影响范围评估\r\n - fix_suggestions: 修复建议\r\n - prevention_measures: 预防措施\r\n---\r\n\r\n# Bug根因分析\r\n\r\n## 核心原则\r\n\r\n你是一位根因分析专家，擅长从症状倒推根因方向。\r\n**核心原则**：看到错误，能快速缩小根因范围——这不是魔法，是可学习的映射模式。\r\n本技能提供症状分类→根因映射→分析流程→验证假设的完整方法。\r\n\r\n## 症状分类与根因映射\r\n\r\n### 症状1：返回错误\r\n\r\n```text\r\n症状表现：\r\n- HTTP状态码错误（4xx/5xx）\r\n- 业务错误码\r\n- 错误信息\r\n\r\n根因方向：\r\n├─ 代码层\r\n│ ├─ 逻辑错误：条件判断错误\r\n│ ├─ 空指针：对象未初始化\r\n│ ├─ 数组越界：索引超出范围\r\n│ └─ 类型转换：类型不匹配\r\n│\r\n├─ 数据层\r\n│ ├─ 数据缺失：必要数据不存在\r\n│ ├─ 数据错误：数据格式/值错误\r\n│ ├─ 数据冲突：唯一性约束\r\n│ └─ 数据过期：数据已失效\r\n│\r\n├─ 配置层\r\n│ ├─ 配置缺失：配置项未配置\r\n│ ├─ 配置错误：配置值错误\r\n│ ├─ 环境差异：不同环境配置不同\r\n│ └─ 配置变更：配置被意外修改\r\n│\r\n└─ 依赖层\r\n ├─ 依赖不可用：第三方服务故障\r\n ├─ 依赖超时：响应超时\r\n ├─ 依赖返回错误：第三方返回异常\r\n └─ 依赖版本不兼容：接口变更\r\n```\r\n\r\n### 症状2：数据不对\r\n\r\n```text\r\n症状表现：\r\n- 数据缺失\r\n- 数据错误\r\n- 数据不一致\r\n- 数据格式异常\r\n\r\n根因方向：\r\n├─ 写入问题\r\n│ ├─ 写入失败：数据库操作失败\r\n│ ├─ 写入丢失：事务未提交\r\n│ ├─ 写入延迟：异步写入未完成\r\n│ └─ 写入重复：重复提交\r\n│\r\n├─ 读取问题\r\n│ ├─ 缓存不一致：缓存与DB不同步\r\n│ ├─ 读取过滤：查询条件过滤\r\n│ ├─ 读取延迟：读从库延迟\r\n│ └─ 读取缓存：读到旧缓存\r\n│\r\n├─ 同步问题\r\n│ ├─ 同步延迟：主从同步延迟\r\n│ ├─ 同步失败：同步任务失败\r\n│ ├─ 同步冲突：并发同步冲突\r\n│ └─ 同步丢失：同步任务遗漏\r\n│\r\n└─ 转换问题\r\n ├─ 格式转换：数据格式转换错误\r\n ├─ 编码问题：字符编码不一致\r\n ├─ 精度丢失：浮点数精度问题\r\n └─ 时区问题：时区转换错误\r\n```\r\n\r\n### 症状3：性能退化\r\n\r\n```text\r\n症状表现：\r\n- 响应时间变长\r\n- 吞吐量下降\r\n- 资源占用高\r\n\r\n根因方向：\r\n├─ 数据库问题\r\n│ ├─ 慢查询：SQL执行慢\r\n│ ├─ 索引缺失：缺少必要索引\r\n│ ├─ 锁等待：锁竞争\r\n│ ├─ 连接池耗尽：连接数不够\r\n│ └─ 数据量增长：数据量变大\r\n│\r\n├─ 代码问题\r\n│ ├─ 算法复杂度：算法效率低\r\n│ ├─ 循环嵌套：循环次数多\r\n│ ├─ 内存泄漏：内存未释放\r\n│ ├─ 线程阻塞：线程等待\r\n│ └─ 频繁GC：垃圾回收频繁\r\n│\r\n├─ 缓存问题\r\n│ ├─ 缓存穿透：缓存未命中\r\n│ ├─ 缓存雪崩：缓存集中失效\r\n│ ├─ 缓存击穿：热点key失效\r\n│ └─ 缓存容量：缓存容量不足\r\n│\r\n└─ 资源问题\r\n ├─ CPU瓶颈：CPU占用高\r\n ├─ 内存瓶颈：内存不足\r\n ├─ IO瓶颈：磁盘IO慢\r\n └─ 网络瓶颈：网络延迟高\r\n```\r\n\r\n### 症状4：没反应\r\n\r\n```text\r\n症状表现：\r\n- 点击无反应\r\n- 操作无效果\r\n- 界面卡住\r\n\r\n根因方向：\r\n├─ 前端问题\r\n│ ├─ JS报错：JavaScript错误\r\n│ ├─ 事件绑定：事件未绑定\r\n│ ├─ 状态异常：前端状态错误\r\n│ ├─ 网络请求：请求未发出\r\n│ └─ 渲染异常：DOM渲染错误\r\n│\r\n├─ 网络问题\r\n│ ├─ 请求丢失：网络丢包\r\n│ ├─ 请求超时：网络超时\r\n│ ├─ 连接断开：网络断开\r\n│ └─ DNS解析：DNS解析失败\r\n│\r\n├─ 后端问题\r\n│ ├─ 请求未接收：请求未到达\r\n│ ├─ 处理阻塞：处理线程阻塞\r\n│ ├─ 响应丢失：响应未返回\r\n│ └─ 服务不可用：服务宕机\r\n│\r\n└─ 中间件问题\r\n ├─ Nginx问题：Nginx配置错误\r\n ├─ 网关问题：网关路由错误\r\n ├─ MQ问题：消息队列阻塞\r\n └─ 限流问题：触发限流\r\n```\r\n\r\n### 症状5：偶发问题\r\n\r\n```text\r\n症状表现：\r\n- 时有时无\r\n- 特定条件出现\r\n- 难以复现\r\n\r\n根因方向：\r\n├─ 并发问题\r\n│ ├─ 竞态条件：并发操作冲突\r\n│ ├─ 死锁：线程互相等待\r\n│ ├─ 线程安全：共享资源竞争\r\n│ └─ 资源泄露：资源未释放\r\n│\r\n├─ 环境问题\r\n│ ├─ 环境差异：不同环境表现不同\r\n│ ├─ 配置差异：配置不一致\r\n│ ├─ 依赖状态：依赖服务状态\r\n│ └─ 硬件差异：硬件性能差异\r\n│\r\n├─ 数据问题\r\n│ ├─ 数据状态：特定数据状态触发\r\n│ ├─ 数据量：数据量达到阈值触发\r\n│ ├─ 数据顺序：数据顺序影响\r\n│ └─ 数据时效：数据过期触发\r\n│\r\n└─ 时序问题\r\n ├─ 时序依赖：操作顺序影响\r\n ├─ 定时任务：定时任务触发\r\n ├─ 缓存过期：缓存过期触发\r\n └─ 会话超时：会话过期触发\r\n```\r\n\r\n## 分析流程\r\n\r\n### 步骤1：收集信息\r\n```text\r\n信息收集清单：\r\n├─ 症状描述：具体表现是什么？\r\n├─ 复现步骤：怎么复现？\r\n├─ 环境信息：什么环境下出现？\r\n├─ 时间信息：什么时候出现？\r\n├─ 影响范围：影响多大？\r\n└─ 相关日志：日志有什么？\r\n```\r\n\r\n### 步骤2：分类症状\r\n```text\r\n根据症状表现分类：\r\n- 返回错误 → 代码/数据/配置/依赖层\r\n- 数据不对 → 写入/读取/同步/转换问题\r\n- 性能退化 → 数据库/代码/缓存/资源问题\r\n- 没反应 → 前端/网络/后端/中间件问题\r\n- 偶发问题 → 并发/环境/数据/时序问题\r\n```\r\n\r\n### 步骤3：缩小范围\r\n```text\r\n根据症状分类，逐层排查：\r\n1. 先排除外部因素（依赖/环境）\r\n2. 再排除配置因素\r\n3. 再排查数据因素\r\n4. 最后排查代码因素\r\n```\r\n\r\n### 步骤4：验证假设\r\n```text\r\n验证方法：\r\n1. 复现问题\r\n2. 修改假设条件\r\n3. 验证问题是否消失\r\n4. 确认根因\r\n```\r\n\r\n## 根因分析表\r\n\r\n| Bug ID | 症状分类 | 根因方向 | 根本原因 | 验证方法 |\r\n|--------|---------|---------|---------|---------|\r\n| BUG-001 | 返回错误 | 数据层 | 数据格式错误 | 修改数据后验证 |\r\n| BUG-002 | 性能退化 | 数据库 | 慢查询 | 添加索引后验证 |\r\n\r\n## 症状分类速查\r\n\r\n### 从现象到根因方向\r\n\r\n| 现象 | 症状分类 | 大概率方向 | 优先排查 |\r\n|------|---------|-----------|---------|\r\n| 报500错误 | 返回错误 | 后端异常/数据异常 | 日志ERROR + 入参数据 |\r\n| 返回空数据 | 返回错误 | 查询条件/权限过滤 | SQL日志 + 权限配置 |\r\n| 页面白屏 | 返回错误 | 前端解析/接口数据格式 | F12看接口响应 |\r\n| 金额不对 | 数据不对 | 计算逻辑/精度问题 | 核对计算公式 |\r\n| 状态不更新 | 数据不对 | 状态机/回调处理 | 检查状态流转日志 |\r\n| 账单对不上 | 数据不对 | 数据一致性/事务问题 | 核对多个数据源 |\r\n| 页面越来越慢 | 性能退化 | 慢查询/数据累积 | 慢SQL日志 |\r\n| 高峰期就挂 | 性能退化 | 并发/资源不足 | 压测复现+监控 |\r\n| 点按钮没反应 | 没反应 | 前端事件绑定/接口不通 | F12看请求是否发出 |\r\n| 加载中不动 | 没反应 | 后端处理卡住/死锁 | 线程堆栈+DB锁查询 |\r\n| 偶尔支付失败 | 偶发问题 | 并发冲突/超时 | 并行多次复现 |\r\n| 特定时间出问题 | 偶发问题 | 定时任务/缓存过期 | 核对定时任务时间+缓存策略 |\r\n| 只有某用户出问题 | 偶发问题 | 数据隔离/权限 | 对比正常/异常用户数据 |\r\n\r\n## 输出示例\r\n\r\n**Bug描述：\"用户支付成功但订单状态仍为待支付\"**\r\n→ 症状分类：数据不一致（症状2）\r\n→ 根因映射：数据层问题→检查支付回调处理逻辑\r\n→ 分析流程：\r\n 1. 收集信息：支付网关回执、订单日志、数据库记录\r\n 2. 分类症状：数据不一致\r\n 3. 缩小范围：支付回调→订单状态更新→数据库写入\r\n 4. 验证假设：手动触发回调验证状态变更\r\n\r\n**Bug描述：\"页面加载越来越慢\"**\r\n→ 症状分类：性能退化（症状3）→ 数据库/缓存层排查\r\n\r\n## 检查清单\r\n\r\n根因分析完成后检查：\r\n- [ ] 是否收集了完整信息？\r\n- [ ] 是否正确分类症状？\r\n- [ ] 是否逐层排查根因？\r\n- [ ] 是否验证了根因假设？\r\n- [ ] 根因描述是否清晰？\r\n- [ ] 验证方法是否可行？\n\nFile v1.5.0:_meta.json\n\n{\n \"ownerId\": \"kn71y9b23csfx0ykgm55d5m9x5891zt8\",\n \"slug\": \"qa-bug-root-cause-analysis\",\n \"version\": \"1.5.0\",\n \"publishedAt\": 1782736309719\n}\n\nFile v1.5.0:skill-card.md\n\n## Description:
\nGuides agents through structured QA bug root cause analysis using symptom classification, 5 Whys, causal diagrams, and fishbone analysis to identify direct, indirect, and systemic causes.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[kokxi](https://clawhub.ai/user/kokxi)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nQA engineers, developers, and incident reviewers use this skill to turn recurring or production bugs into structured root cause analyses, impact assessments, fix suggestions, and prevention measures. It is especially suited to cases where teams need to distinguish direct defects from process or system causes and improve test design.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: Bug descriptions, logs, environment details, or project files may contain sensitive production data.
\nMitigation: Redact secrets and unnecessary personal or production data before sharing evidence with an agent, and scope file inspection to the materials needed for the analysis.
\nRisk: A root cause conclusion may be misleading if based only on symptoms or incomplete reproduction evidence.
\nMitigation: Validate hypotheses against logs, reproduction steps, and controlled changes before treating the conclusion as final.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/kokxi/skills/qa-bug-root-cause-analysis)
\n\n\n## Skill Output:
\n**Output Type(s):** [Text, Markdown, Guidance]
\n**Output Format:** [Structured Markdown analysis with root cause, contributing factors, impact assessment, fix suggestions, and prevention measures]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [May include diagnostic checklists and hypothesis verification steps; no executable output is required.]
\n\n## Skill Version(s):
\n1.5.0 (source: frontmatter and release evidence)
\n\n## Ethical Considerations:
\nUsers 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.
\n\nArchive v1.4.1: 3 files, 5257 bytes\n\nFiles: skill-card.md (1932b), SKILL.md (9760b), _meta.json (145b)\n\nFile v1.4.1:SKILL.md\n\n---\r\nname: qa-bug-root-cause-analysis\r\ndescription: >-\r\n Bug根因分析，从症状出发通过5Why等方法系统化定位缺陷根源，支持漏测根因分析。当需要分析Bug原因或根治缺陷时激活。\r\n\r\nwhen_to_use: 用户说\"分析Bug\"、\"根因分析\"、\"为什么出错\"、\"Bug原因\"、\"怎么发生的\"、\"5 Why\"、\"根治\"、需要定位Bug原因、缺陷频发需要系统性根治时\r\nallowed-tools: Read Grep Glob Bash\r\nrelated_skills:\r\n upstream:\r\n - qa-execution-observation # 输入：执行观察发现的异常信号\r\n downstream:\r\n - qa-bug-reporting # 输出：根因分析用于Bug报告\r\n - qa-retrospective # 输出：根因分类用于复盘\r\ninput_format: 执行观察报告 + 异常信号\r\noutput_format: 根因分析报告（症状分类 + 根因方向 + 验证方法）\r\n---\r\n\r\n# Bug根因分析\r\n\r\n## Overview\r\n\r\n你是一位根因分析专家，擅长从症状倒推根因方向。\r\n**核心原则**：看到错误，能快速缩小根因范围——这不是魔法，是可学习的映射模式。\r\n本技能提供症状分类→根因映射→分析流程→验证假设的完整方法。\r\n\r\n## 症状分类与根因映射\r\n\r\n### 症状1：返回错误\r\n\r\n```\r\n症状表现：\r\n- HTTP状态码错误（4xx/5xx）\r\n- 业务错误码\r\n- 错误信息\r\n\r\n根因方向：\r\n├─ 代码层\r\n│ ├─ 逻辑错误：条件判断错误\r\n│ ├─ 空指针：对象未初始化\r\n│ ├─ 数组越界：索引超出范围\r\n│ └─ 类型转换：类型不匹配\r\n│\r\n├─ 数据层\r\n│ ├─ 数据缺失：必要数据不存在\r\n│ ├─ 数据错误：数据格式/值错误\r\n│ ├─ 数据冲突：唯一性约束\r\n│ └─ 数据过期：数据已失效\r\n│\r\n├─ 配置层\r\n│ ├─ 配置缺失：配置项未配置\r\n│ ├─ 配置错误：配置值错误\r\n│ ├─ 环境差异：不同环境配置不同\r\n│ └─ 配置变更：配置被意外修改\r\n│\r\n└─ 依赖层\r\n ├─ 依赖不可用：第三方服务故障\r\n ├─ 依赖超时：响应超时\r\n ├─ 依赖返回错误：第三方返回异常\r\n └─ 依赖版本不兼容：接口变更\r\n```\r\n\r\n### 症状2：数据不对\r\n\r\n```\r\n症状表现：\r\n- 数据缺失\r\n- 数据错误\r\n- 数据不一致\r\n- 数据格式异常\r\n\r\n根因方向：\r\n├─ 写入问题\r\n│ ├─ 写入失败：数据库操作失败\r\n│ ├─ 写入丢失：事务未提交\r\n│ ├─ 写入延迟：异步写入未完成\r\n│ └─ 写入重复：重复提交\r\n│\r\n├─ 读取问题\r\n│ ├─ 缓存不一致：缓存与DB不同步\r\n│ ├─ 读取过滤：查询条件过滤\r\n│ ├─ 读取延迟：读从库延迟\r\n│ └─ 读取缓存：读到旧缓存\r\n│\r\n├─ 同步问题\r\n│ ├─ 同步延迟：主从同步延迟\r\n│ ├─ 同步失败：同步任务失败\r\n│ ├─ 同步冲突：并发同步冲突\r\n│ └─ 同步丢失：同步任务遗漏\r\n│\r\n└─ 转换问题\r\n ├─ 格式转换：数据格式转换错误\r\n ├─ 编码问题：字符编码不一致\r\n ├─ 精度丢失：浮点数精度问题\r\n └─ 时区问题：时区转换错误\r\n```\r\n\r\n### 症状3：性能退化\r\n\r\n```\r\n症状表现：\r\n- 响应时间变长\r\n- 吞吐量下降\r\n- 资源占用高\r\n\r\n根因方向：\r\n├─ 数据库问题\r\n│ ├─ 慢查询：SQL执行慢\r\n│ ├─ 索引缺失：缺少必要索引\r\n│ ├─ 锁等待：锁竞争\r\n│ ├─ 连接池耗尽：连接数不够\r\n│ └─ 数据量增长：数据量变大\r\n│\r\n├─ 代码问题\r\n│ ├─ 算法复杂度：算法效率低\r\n│ ├─ 循环嵌套：循环次数多\r\n│ ├─ 内存泄漏：内存未释放\r\n│ ├─ 线程阻塞：线程等待\r\n│ └─ 频繁GC：垃圾回收频繁\r\n│\r\n├─ 缓存问题\r\n│ ├─ 缓存穿透：缓存未命中\r\n│ ├─ 缓存雪崩：缓存集中失效\r\n│ ├─ 缓存击穿：热点key失效\r\n│ └─ 缓存容量：缓存容量不足\r\n│\r\n└─ 资源问题\r\n ├─ CPU瓶颈：CPU占用高\r\n ├─ 内存瓶颈：内存不足\r\n ├─ IO瓶颈：磁盘IO慢\r\n └─ 网络瓶颈：网络延迟高\r\n```\r\n\r\n### 症状4：没反应\r\n\r\n```\r\n症状表现：\r\n- 点击无反应\r\n- 操作无效果\r\n- 界面卡住\r\n\r\n根因方向：\r\n├─ 前端问题\r\n│ ├─ JS报错：JavaScript错误\r\n│ ├─ 事件绑定：事件未绑定\r\n│ ├─ 状态异常：前端状态错误\r\n│ ├─ 网络请求：请求未发出\r\n│ └─ 渲染异常：DOM渲染错误\r\n│\r\n├─ 网络问题\r\n│ ├─ 请求丢失：网络丢包\r\n│ ├─ 请求超时：网络超时\r\n│ ├─ 连接断开：网络断开\r\n│ └─ DNS解析：DNS解析失败\r\n│\r\n├─ 后端问题\r\n│ ├─ 请求未接收：请求未到达\r\n│ ├─ 处理阻塞：处理线程阻塞\r\n│ ├─ 响应丢失：响应未返回\r\n│ └─ 服务不可用：服务宕机\r\n│\r\n└─ 中间件问题\r\n ├─ Nginx问题：Nginx配置错误\r\n ├─ 网关问题：网关路由错误\r\n ├─ MQ问题：消息队列阻塞\r\n └─ 限流问题：触发限流\r\n```\r\n\r\n### 症状5：偶发问题\r\n\r\n```\r\n症状表现：\r\n- 时有时无\r\n- 特定条件出现\r\n- 难以复现\r\n\r\n根因方向：\r\n├─ 并发问题\r\n│ ├─ 竞态条件：并发操作冲突\r\n│ ├─ 死锁：线程互相等待\r\n│ ├─ 线程安全：共享资源竞争\r\n│ └─ 资源泄露：资源未释放\r\n│\r\n├─ 环境问题\r\n│ ├─ 环境差异：不同环境表现不同\r\n│ ├─ 配置差异：配置不一致\r\n│ ├─ 依赖状态：依赖服务状态\r\n│ └─ 硬件差异：硬件性能差异\r\n│\r\n├─ 数据问题\r\n│ ├─ 数据状态：特定数据状态触发\r\n│ ├─ 数据量：数据量达到阈值触发\r\n│ ├─ 数据顺序：数据顺序影响\r\n│ └─ 数据时效：数据过期触发\r\n│\r\n└─ 时序问题\r\n ├─ 时序依赖：操作顺序影响\r\n ├─ 定时任务：定时任务触发\r\n ├─ 缓存过期：缓存过期触发\r\n └─ 会话超时：会话过期触发\r\n```\r\n\r\n## 分析流程\r\n\r\n### 步骤1：收集信息\r\n```\r\n信息收集清单：\r\n├─ 症状描述：具体表现是什么？\r\n├─ 复现步骤：怎么复现？\r\n├─ 环境信息：什么环境下出现？\r\n├─ 时间信息：什么时候出现？\r\n├─ 影响范围：影响多大？\r\n└─ 相关日志：日志有什么？\r\n```\r\n\r\n### 步骤2：分类症状\r\n```\r\n根据症状表现分类：\r\n- 返回错误 → 代码/数据/配置/依赖层\r\n- 数据不对 → 写入/读取/同步/转换问题\r\n- 性能退化 → 数据库/代码/缓存/资源问题\r\n- 没反应 → 前端/网络/后端/中间件问题\r\n- 偶发问题 → 并发/环境/数据/时序问题\r\n```\r\n\r\n### 步骤3：缩小范围\r\n```\r\n根据症状分类，逐层排查：\r\n1. 先排除外部因素（依赖/环境）\r\n2. 再排除配置因素\r\n3. 再排查数据因素\r\n4. 最后排查代码因素\r\n```\r\n\r\n### 步骤4：验证假设\r\n```\r\n验证方法：\r\n1. 复现问题\r\n2. 修改假设条件\r\n3. 验证问题是否消失\r\n4. 确认根因\r\n```\r\n\r\n## 根因分析表\r\n\r\n| Bug ID | 症状分类 | 根因方向 | 根本原因 | 验证方法 |\r\n|--------|---------|---------|---------|---------|\r\n| BUG-001 | 返回错误 | 数据层 | 数据格式错误 | 修改数据后验证 |\r\n| BUG-002 | 性能退化 | 数据库 | 慢查询 | 添加索引后验证 |\r\n\r\n## 症状分类速查\r\n\r\n### 从现象到根因方向\r\n\r\n| 现象 | 症状分类 | 大概率方向 | 优先排查 |\r\n|------|---------|-----------|---------|\r\n| 报500错误 | 返回错误 | 后端异常/数据异常 | 日志ERROR + 入参数据 |\r\n| 返回空数据 | 返回错误 | 查询条件/权限过滤 | SQL日志 + 权限配置 |\r\n| 页面白屏 | 返回错误 | 前端解析/接口数据格式 | F12看接口响应 |\r\n| 金额不对 | 数据不对 | 计算逻辑/精度问题 | 核对计算公式 |\r\n| 状态不更新 | 数据不对 | 状态机/回调处理 | 检查状态流转日志 |\r\n| 账单对不上 | 数据不对 | 数据一致性/事务问题 | 核对多个数据源 |\r\n| 页面越来越慢 | 性能退化 | 慢查询/数据累积 | 慢SQL日志 |\r\n| 高峰期就挂 | 性能退化 | 并发/资源不足 | 压测复现+监控 |\r\n| 点按钮没反应 | 没反应 | 前端事件绑定/接口不通 | F12看请求是否发出 |\r\n| 加载中不动 | 没反应 | 后端处理卡住/死锁 | 线程堆栈+DB锁查询 |\r\n| 偶尔支付失败 | 偶发问题 | 并发冲突/超时 | 并行多次复现 |\r\n| 特定时间出问题 | 偶发问题 | 定时任务/缓存过期 | 核对定时任务时间+缓存策略 |\r\n| 只有某用户出问题 | 偶发问题 | 数据隔离/权限 | 对比正常/异常用户数据 |\r\n\r\n## Examples\r\n\r\n**Bug描述：\"用户支付成功但订单状态仍为待支付\"**\r\n→ 症状分类：数据不一致（症状2）\r\n→ 根因映射：数据层问题→检查支付回调处理逻辑\r\n→ 分析流程：\r\n 1. 收集信息：支付网关回执、订单日志、数据库记录\r\n 2. 分类症状：数据不一致\r\n 3. 缩小范围：支付回调→订单状态更新→数据库写入\r\n 4. 验证假设：手动触发回调验证状态变更\r\n\r\n**Bug描述：\"页面加载越来越慢\"**\r\n→ 症状分类：性能退化（症状3）→ 数据库/缓存层排查\r\n\r\n## Guidelines\r\n\r\n根因分析完成后检查：\r\n- [ ] 是否收集了完整信息？\r\n- [ ] 是否正确分类症状？\r\n- [ ] 是否逐层排查根因？\r\n- [ ] 是否验证了根因假设？\r\n- [ ] 根因描述是否清晰？\r\n- [ ] 验证方法是否可行？\n\nFile v1.4.1:_meta.json\n\n{\n \"ownerId\": \"kn71y9b23csfx0ykgm55d5m9x5891zt8\",\n \"slug\": \"qa-bug-root-cause-analysis\",\n \"version\": \"1.4.1\",\n \"publishedAt\": 1782406423901\n}\n\nFile v1.4.1:skill-card.md\n\n## Description:
\nGuides agents through systematic bug root-cause analysis and missed-test analysis using symptom classification, 5 Why reasoning, cause mapping, and validation steps.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[kokxi](https://clawhub.ai/user/kokxi)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nQA engineers, developers, and support engineers use this skill to classify bug symptoms, narrow likely root-cause areas, plan verification steps, and document actionable root-cause analysis for bug reports or retrospectives.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The artifact may contain invisible Unicode or control characters that make review harder.
\nMitigation: Review and normalize SKILL.md before broad publication or reuse.
\nRisk: Broad trigger phrases could activate the skill for general debugging conversations where formal root-cause analysis is not intended.
\nMitigation: Narrow activation wording to clear requests for bug root-cause analysis, missed-test analysis, 5 Why analysis, or defect remediation.
\n\n\n## Reference(s):
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, guidance]
\n**Output Format:** [Markdown root-cause analysis report with symptom classification, likely cause directions, and validation steps]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [May include structured checklists and analysis tables based on the supplied bug context.]
\n\n## Skill Version(s):
\n1.4.1 (source: server release metadata)
\n\n## Ethical Considerations:
\nUsers 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.
\n\nArchive v1.4.0: 3 files, 5237 bytes\n\nFiles: skill-card.md (1775b), SKILL.md (10058b), _meta.json (145b)\n\nFile v1.4.0:SKILL.md\n\n---\r\nname: qa-bug-root-cause-analysis\r\ndescription: >-\r\n Bug根因分析，从症状倒推根因方向，系统化定位缺陷根源。当用户需要分析Bug、进行根因分析、追问为什么出现或定位Bug原因时自动触发。\r\n 也适用于：缺陷频发需要系统性根治，或复盘时需要对漏测做根因分析时。\r\n 关键词：根因分析、Bug定位、根本原因、缺陷溯源、症状分类、根因映射、分析流程、假设验证、偶发问题、性能退化、根因分析表。\nwhen_to_use: 用户说\"分析Bug\"、\"根因分析\"、\"为什么出错\"、\"Bug原因\"、\"怎么发生的\"、\"5 Why\"、\"根治\"、需要定位Bug原因、缺陷频发需要系统性根治时\r\nallowed-tools: Read Grep Glob Bash\r\nrelated_skills:\r\n upstream:\r\n - qa-execution-observation # 输入：执行观察发现的异常信号\r\n downstream:\r\n - qa-bug-reporting # 输出：根因分析用于Bug报告\r\n - qa-retrospective # 输出：根因分类用于复盘\r\ninput_format: 执行观察报告 + 异常信号\r\noutput_format: 根因分析报告（症状分类 + 根因方向 + 验证方法）\r\n---\r\n\r\n# Bug根因分析\r\n\r\n## Overview\r\n\r\n你是一位根因分析专家，擅长从症状倒推根因方向。\r\n**核心原则**：看到错误，能快速缩小根因范围——这不是魔法，是可学习的映射模式。\r\n本技能提供症状分类→根因映射→分析流程→验证假设的完整方法。\r\n\r\n## 症状分类与根因映射\r\n\r\n### 症状1：返回错误\r\n\r\n```\r\n症状表现：\r\n- HTTP状态码错误（4xx/5xx）\r\n- 业务错误码\r\n- 错误信息\r\n\r\n根因方向：\r\n├─ 代码层\r\n│ ├─ 逻辑错误：条件判断错误\r\n│ ├─ 空指针：对象未初始化\r\n│ ├─ 数组越界：索引超出范围\r\n│ └─ 类型转换：类型不匹配\r\n│\r\n├─ 数据层\r\n│ ├─ 数据缺失：必要数据不存在\r\n│ ├─ 数据错误：数据格式/值错误\r\n│ ├─ 数据冲突：唯一性约束\r\n│ └─ 数据过期：数据已失效\r\n│\r\n├─ 配置层\r\n│ ├─ 配置缺失：配置项未配置\r\n│ ├─ 配置错误：配置值错误\r\n│ ├─ 环境差异：不同环境配置不同\r\n│ └─ 配置变更：配置被意外修改\r\n│\r\n└─ 依赖层\r\n ├─ 依赖不可用：第三方服务故障\r\n ├─ 依赖超时：响应超时\r\n ├─ 依赖返回错误：第三方返回异常\r\n └─ 依赖版本不兼容：接口变更\r\n```\r\n\r\n### 症状2：数据不对\r\n\r\n```\r\n症状表现：\r\n- 数据缺失\r\n- 数据错误\r\n- 数据不一致\r\n- 数据格式异常\r\n\r\n根因方向：\r\n├─ 写入问题\r\n│ ├─ 写入失败：数据库操作失败\r\n│ ├─ 写入丢失：事务未提交\r\n│ ├─ 写入延迟：异步写入未完成\r\n│ └─ 写入重复：重复提交\r\n│\r\n├─ 读取问题\r\n│ ├─ 缓存不一致：缓存与DB不同步\r\n│ ├─ 读取过滤：查询条件过滤\r\n│ ├─ 读取延迟：读从库延迟\r\n│ └─ 读取缓存：读到旧缓存\r\n│\r\n├─ 同步问题\r\n│ ├─ 同步延迟：主从同步延迟\r\n│ ├─ 同步失败：同步任务失败\r\n│ ├─ 同步冲突：并发同步冲突\r\n│ └─ 同步丢失：同步任务遗漏\r\n│\r\n└─ 转换问题\r\n ├─ 格式转换：数据格式转换错误\r\n ├─ 编码问题：字符编码不一致\r\n ├─ 精度丢失：浮点数精度问题\r\n └─ 时区问题：时区转换错误\r\n```\r\n\r\n### 症状3：性能退化\r\n\r\n```\r\n症状表现：\r\n- 响应时间变长\r\n- 吞吐量下降\r\n- 资源占用高\r\n\r\n根因方向：\r\n├─ 数据库问题\r\n│ ├─ 慢查询：SQL执行慢\r\n│ ├─ 索引缺失：缺少必要索引\r\n│ ├─ 锁等待：锁竞争\r\n│ ├─ 连接池耗尽：连接数不够\r\n│ └─ 数据量增长：数据量变大\r\n│\r\n├─ 代码问题\r\n│ ├─ 算法复杂度：算法效率低\r\n│ ├─ 循环嵌套：循环次数多\r\n│ ├─ 内存泄漏：内存未释放\r\n│ ├─ 线程阻塞：线程等待\r\n│ └─ 频繁GC：垃圾回收频繁\r\n│\r\n├─ 缓存问题\r\n│ ├─ 缓存穿透：缓存未命中\r\n│ ├─ 缓存雪崩：缓存集中失效\r\n│ ├─ 缓存击穿：热点key失效\r\n│ └─ 缓存容量：缓存容量不足\r\n│\r\n└─ 资源问题\r\n ├─ CPU瓶颈：CPU占用高\r\n ├─ 内存瓶颈：内存不足\r\n ├─ IO瓶颈：磁盘IO慢\r\n └─ 网络瓶颈：网络延迟高\r\n```\r\n\r\n### 症状4：没反应\r\n\r\n```\r\n症状表现：\r\n- 点击无反应\r\n- 操作无效果\r\n- 界面卡住\r\n\r\n根因方向：\r\n├─ 前端问题\r\n│ ├─ JS报错：JavaScript错误\r\n│ ├─ 事件绑定：事件未绑定\r\n│ ├─ 状态异常：前端状态错误\r\n│ ├─ 网络请求：请求未发出\r\n│ └─ 渲染异常：DOM渲染错误\r\n│\r\n├─ 网络问题\r\n│ ├─ 请求丢失：网络丢包\r\n│ ├─ 请求超时：网络超时\r\n│ ├─ 连接断开：网络断开\r\n│ └─ DNS解析：DNS解析失败\r\n│\r\n├─ 后端问题\r\n│ ├─ 请求未接收：请求未到达\r\n│ ├─ 处理阻塞：处理线程阻塞\r\n│ ├─ 响应丢失：响应未返回\r\n│ └─ 服务不可用：服务宕机\r\n│\r\n└─ 中间件问题\r\n ├─ Nginx问题：Nginx配置错误\r\n ├─ 网关问题：网关路由错误\r\n ├─ MQ问题：消息队列阻塞\r\n └─ 限流问题：触发限流\r\n```\r\n\r\n### 症状5：偶发问题\r\n\r\n```\r\n症状表现：\r\n- 时有时无\r\n- 特定条件出现\r\n- 难以复现\r\n\r\n根因方向：\r\n├─ 并发问题\r\n│ ├─ 竞态条件：并发操作冲突\r\n│ ├─ 死锁：线程互相等待\r\n│ ├─ 线程安全：共享资源竞争\r\n│ └─ 资源泄露：资源未释放\r\n│\r\n├─ 环境问题\r\n│ ├─ 环境差异：不同环境表现不同\r\n│ ├─ 配置差异：配置不一致\r\n│ ├─ 依赖状态：依赖服务状态\r\n│ └─ 硬件差异：硬件性能差异\r\n│\r\n├─ 数据问题\r\n│ ├─ 数据状态：特定数据状态触发\r\n│ ├─ 数据量：数据量达到阈值触发\r\n│ ├─ 数据顺序：数据顺序影响\r\n│ └─ 数据时效：数据过期触发\r\n│\r\n└─ 时序问题\r\n ├─ 时序依赖：操作顺序影响\r\n ├─ 定时任务：定时任务触发\r\n ├─ 缓存过期：缓存过期触发\r\n └─ 会话超时：会话过期触发\r\n```\r\n\r\n## 分析流程\r\n\r\n### 步骤1：收集信息\r\n```\r\n信息收集清单：\r\n├─ 症状描述：具体表现是什么？\r\n├─ 复现步骤：怎么复现？\r\n├─ 环境信息：什么环境下出现？\r\n├─ 时间信息：什么时候出现？\r\n├─ 影响范围：影响多大？\r\n└─ 相关日志：日志有什么？\r\n```\r\n\r\n### 步骤2：分类症状\r\n```\r\n根据症状表现分类：\r\n- 返回错误 → 代码/数据/配置/依赖层\r\n- 数据不对 → 写入/读取/同步/转换问题\r\n- 性能退化 → 数据库/代码/缓存/资源问题\r\n- 没反应 → 前端/网络/后端/中间件问题\r\n- 偶发问题 → 并发/环境/数据/时序问题\r\n```\r\n\r\n### 步骤3：缩小范围\r\n```\r\n根据症状分类，逐层排查：\r\n1. 先排除外部因素（依赖/环境）\r\n2. 再排除配置因素\r\n3. 再排查数据因素\r\n4. 最后排查代码因素\r\n```\r\n\r\n### 步骤4：验证假设\r\n```\r\n验证方法：\r\n1. 复现问题\r\n2. 修改假设条件\r\n3. 验证问题是否消失\r\n4. 确认根因\r\n```\r\n\r\n## 根因分析表\r\n\r\n| Bug ID | 症状分类 | 根因方向 | 根本原因 | 验证方法 |\r\n|--------|---------|---------|---------|---------|\r\n| BUG-001 | 返回错误 | 数据层 | 数据格式错误 | 修改数据后验证 |\r\n| BUG-002 | 性能退化 | 数据库 | 慢查询 | 添加索引后验证 |\r\n\r\n## 症状分类速查\r\n\r\n### 从现象到根因方向\r\n\r\n| 现象 | 症状分类 | 大概率方向 | 优先排查 |\r\n|------|---------|-----------|---------|\r\n| 报500错误 | 返回错误 | 后端异常/数据异常 | 日志ERROR + 入参数据 |\r\n| 返回空数据 | 返回错误 | 查询条件/权限过滤 | SQL日志 + 权限配置 |\r\n| 页面白屏 | 返回错误 | 前端解析/接口数据格式 | F12看接口响应 |\r\n| 金额不对 | 数据不对 | 计算逻辑/精度问题 | 核对计算公式 |\r\n| 状态不更新 | 数据不对 | 状态机/回调处理 | 检查状态流转日志 |\r\n| 账单对不上 | 数据不对 | 数据一致性/事务问题 | 核对多个数据源 |\r\n| 页面越来越慢 | 性能退化 | 慢查询/数据累积 | 慢SQL日志 |\r\n| 高峰期就挂 | 性能退化 | 并发/资源不足 | 压测复现+监控 |\r\n| 点按钮没反应 | 没反应 | 前端事件绑定/接口不通 | F12看请求是否发出 |\r\n| 加载中不动 | 没反应 | 后端处理卡住/死锁 | 线程堆栈+DB锁查询 |\r\n| 偶尔支付失败 | 偶发问题 | 并发冲突/超时 | 并行多次复现 |\r\n| 特定时间出问题 | 偶发问题 | 定时任务/缓存过期 | 核对定时任务时间+缓存策略 |\r\n| 只有某用户出问题 | 偶发问题 | 数据隔离/权限 | 对比正常/异常用户数据 |\r\n\r\n## Examples\r\n\r\n**Bug描述：\"用户支付成功但订单状态仍为待支付\"**\r\n→ 症状分类：数据不一致（症状2）\r\n→ 根因映射：数据层问题→检查支付回调处理逻辑\r\n→ 分析流程：\r\n 1. 收集信息：支付网关回执、订单日志、数据库记录\r\n 2. 分类症状：数据不一致\r\n 3. 缩小范围：支付回调→订单状态更新→数据库写入\r\n 4. 验证假设：手动触发回调验证状态变更\r\n\r\n**Bug描述：\"页面加载越来越慢\"**\r\n→ 症状分类：性能退化（症状3）→ 数据库/缓存层排查\r\n\r\n## Guidelines\r\n\r\n根因分析完成后检查：\r\n- [ ] 是否收集了完整信息？\r\n- [ ] 是否正确分类症状？\r\n- [ ] 是否逐层排查根因？\r\n- [ ] 是否验证了根因假设？\r\n- [ ] 根因描述是否清晰？\r\n- [ ] 验证方法是否可行？\n\nFile v1.4.0:_meta.json\n\n{\n \"ownerId\": \"kn71y9b23csfx0ykgm55d5m9x5891zt8\",\n \"slug\": \"qa-bug-root-cause-analysis\",\n \"version\": \"1.4.0\",\n \"publishedAt\": 1782277554339\n}\n\nFile v1.4.0:skill-card.md\n\n## Description:
\nThis skill guides Chinese-language bug root-cause analysis by mapping observed symptoms to likely causes and verification steps.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[kokxi](https://clawhub.ai/user/kokxi)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nDevelopers, QA engineers, and incident reviewers use this skill to analyze bugs, classify symptoms, narrow likely root-cause areas, and define verification steps for fixes or retrospectives.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: Review before execution as proposals could introduce incorrect or misleading guidance into skills.
\nMitigation: Review and scan skill before deployment.
\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/kokxi/skills/qa-bug-root-cause-analysis)
\n- [ClawHub publisher profile](https://clawhub.ai/user/kokxi)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, shell commands, guidance]
\n**Output Format:** [Markdown root-cause analysis report with symptom classification, likely cause areas, and verification steps]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Security evidence describes a clean debugging guidance skill; review any proposed Bash commands before execution because the artifact allows Bash.]
\n\n## Skill Version(s):
\n1.4.0 (source: server release metadata)
\n\n## Ethical Considerations:
\nUsers 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.
\n\nArchive v1.3.0: 3 files, 4390 bytes\n\nFiles: skill-card.md (1976b), SKILL.md (7577b), _meta.json (145b)\n\nFile v1.3.0:SKILL.md\n\n---\r\nname: qa-bug-root-cause-analysis\r\ndescription: Bug根因分析，从症状倒推根因方向。当需要分析Bug根本原因时激活。\r\nwhen_to_use: 用户说\"分析Bug\"、\"根因分析\"、\"为什么出错\"、需要定位Bug原因时\r\nallowed-tools: Read Grep Glob Bash\r\nrelated_skills:\r\n upstream:\r\n - qa-execution-observation # 输入：执行观察发现的异常信号\r\n downstream:\r\n - qa-bug-reporting # 输出：根因分析用于Bug报告\r\n - qa-retrospective # 输出：根因分类用于复盘\r\ninput_format: 执行观察报告 + 异常信号\r\noutput_format: 根因分析报告（症状分类 + 根因方向 + 验证方法）\r\n---\r\n\r\n# Bug根因分析\r\n\r\n你是一位根因分析专家，擅长从症状倒推根因方向。\r\n\r\n## 核心原则\r\n\r\n**看到某个错误，能快速缩小根因范围——这不是魔法，是可学习的映射模式。**\r\n\r\n## 症状分类与根因映射\r\n\r\n### 症状1：返回错误\r\n\r\n```\r\n症状表现：\r\n- HTTP状态码错误（4xx/5xx）\r\n- 业务错误码\r\n- 错误信息\r\n\r\n根因方向：\r\n├─ 代码层\r\n│ ├─ 逻辑错误：条件判断错误\r\n│ ├─ 空指针：对象未初始化\r\n│ ├─ 数组越界：索引超出范围\r\n│ └─ 类型转换：类型不匹配\r\n│\r\n├─ 数据层\r\n│ ├─ 数据缺失：必要数据不存在\r\n│ ├─ 数据错误：数据格式/值错误\r\n│ ├─ 数据冲突：唯一性约束\r\n│ └─ 数据过期：数据已失效\r\n│\r\n├─ 配置层\r\n│ ├─ 配置缺失：配置项未配置\r\n│ ├─ 配置错误：配置值错误\r\n│ ├─ 环境差异：不同环境配置不同\r\n│ └─ 配置变更：配置被意外修改\r\n│\r\n└─ 依赖层\r\n ├─ 依赖不可用：第三方服务故障\r\n ├─ 依赖超时：响应超时\r\n ├─ 依赖返回错误：第三方返回异常\r\n └─ 依赖版本不兼容：接口变更\r\n```\r\n\r\n### 症状2：数据不对\r\n\r\n```\r\n症状表现：\r\n- 数据缺失\r\n- 数据错误\r\n- 数据不一致\r\n- 数据格式异常\r\n\r\n根因方向：\r\n├─ 写入问题\r\n│ ├─ 写入失败：数据库操作失败\r\n│ ├─ 写入丢失：事务未提交\r\n│ ├─ 写入延迟：异步写入未完成\r\n│ └─ 写入重复：重复提交\r\n│\r\n├─ 读取问题\r\n│ ├─ 缓存不一致：缓存与DB不同步\r\n│ ├─ 读取过滤：查询条件过滤\r\n│ ├─ 读取延迟：读从库延迟\r\n│ └─ 读取缓存：读到旧缓存\r\n│\r\n├─ 同步问题\r\n│ ├─ 同步延迟：主从同步延迟\r\n│ ├─ 同步失败：同步任务失败\r\n│ ├─ 同步冲突：并发同步冲突\r\n│ └─ 同步丢失：同步任务遗漏\r\n│\r\n└─ 转换问题\r\n ├─ 格式转换：数据格式转换错误\r\n ├─ 编码问题：字符编码不一致\r\n ├─ 精度丢失：浮点数精度问题\r\n └─ 时区问题：时区转换错误\r\n```\r\n\r\n### 症状3：性能退化\r\n\r\n```\r\n症状表现：\r\n- 响应时间变长\r\n- 吞吐量下降\r\n- 资源占用高\r\n\r\n根因方向：\r\n├─ 数据库问题\r\n│ ├─ 慢查询：SQL执行慢\r\n│ ├─ 索引缺失：缺少必要索引\r\n│ ├─ 锁等待：锁竞争\r\n│ ├─ 连接池耗尽：连接数不够\r\n│ └─ 数据量增长：数据量变大\r\n│\r\n├─ 代码问题\r\n│ ├─ 算法复杂度：算法效率低\r\n│ ├─ 循环嵌套：循环次数多\r\n│ ├─ 内存泄漏：内存未释放\r\n│ ├─ 线程阻塞：线程等待\r\n│ └─ 频繁GC：垃圾回收频繁\r\n│\r\n├─ 缓存问题\r\n│ ├─ 缓存穿透：缓存未命中\r\n│ ├─ 缓存雪崩：缓存集中失效\r\n│ ├─ 缓存击穿：热点key失效\r\n│ └─ 缓存容量：缓存容量不足\r\n│\r\n└─ 资源问题\r\n ├─ CPU瓶颈：CPU占用高\r\n ├─ 内存瓶颈：内存不足\r\n ├─ IO瓶颈：磁盘IO慢\r\n └─ 网络瓶颈：网络延迟高\r\n```\r\n\r\n### 症状4：没反应\r\n\r\n```\r\n症状表现：\r\n- 点击无反应\r\n- 操作无效果\r\n- 界面卡住\r\n\r\n根因方向：\r\n├─ 前端问题\r\n│ ├─ JS报错：JavaScript错误\r\n│ ├─ 事件绑定：事件未绑定\r\n│ ├─ 状态异常：前端状态错误\r\n│ ├─ 网络请求：请求未发出\r\n│ └─ 渲染异常：DOM渲染错误\r\n│\r\n├─ 网络问题\r\n│ ├─ 请求丢失：网络丢包\r\n│ ├─ 请求超时：网络超时\r\n│ ├─ 连接断开：网络断开\r\n│ └─ DNS解析：DNS解析失败\r\n│\r\n├─ 后端问题\r\n│ ├─ 请求未接收：请求未到达\r\n│ ├─ 处理阻塞：处理线程阻塞\r\n│ ├─ 响应丢失：响应未返回\r\n│ └─ 服务不可用：服务宕机\r\n│\r\n└─ 中间件问题\r\n ├─ Nginx问题：Nginx配置错误\r\n ├─ 网关问题：网关路由错误\r\n ├─ MQ问题：消息队列阻塞\r\n └─ 限流问题：触发限流\r\n```\r\n\r\n### 症状5：偶发问题\r\n\r\n```\r\n症状表现：\r\n- 时有时无\r\n- 特定条件出现\r\n- 难以复现\r\n\r\n根因方向：\r\n├─ 并发问题\r\n│ ├─ 竞态条件：并发操作冲突\r\n│ ├─ 死锁：线程互相等待\r\n│ ├─ 线程安全：共享资源竞争\r\n│ └─ 资源泄露：资源未释放\r\n│\r\n├─ 环境问题\r\n│ ├─ 环境差异：不同环境表现不同\r\n│ ├─ 配置差异：配置不一致\r\n│ ├─ 依赖状态：依赖服务状态\r\n│ └─ 硬件差异：硬件性能差异\r\n│\r\n├─ 数据问题\r\n│ ├─ 数据状态：特定数据状态触发\r\n│ ├─ 数据量：数据量达到阈值触发\r\n│ ├─ 数据顺序：数据顺序影响\r\n│ └─ 数据时效：数据过期触发\r\n│\r\n└─ 时序问题\r\n ├─ 时序依赖：操作顺序影响\r\n ├─ 定时任务：定时任务触发\r\n ├─ 缓存过期：缓存过期触发\r\n └─ 会话超时：会话过期触发\r\n```\r\n\r\n## 分析流程\r\n\r\n### 步骤1：收集信息\r\n```\r\n信息收集清单：\r\n├─ 症状描述：具体表现是什么？\r\n├─ 复现步骤：怎么复现？\r\n├─ 环境信息：什么环境下出现？\r\n├─ 时间信息：什么时候出现？\r\n├─ 影响范围：影响多大？\r\n└─ 相关日志：日志有什么？\r\n```\r\n\r\n### 步骤2：分类症状\r\n```\r\n根据症状表现分类：\r\n- 返回错误 → 代码/数据/配置/依赖层\r\n- 数据不对 → 写入/读取/同步/转换问题\r\n- 性能退化 → 数据库/代码/缓存/资源问题\r\n- 没反应 → 前端/网络/后端/中间件问题\r\n- 偶发问题 → 并发/环境/数据/时序问题\r\n```\r\n\r\n### 步骤3：缩小范围\r\n```\r\n根据症状分类，逐层排查：\r\n1. 先排除外部因素（依赖/环境）\r\n2. 再排除配置因素\r\n3. 再排查数据因素\r\n4. 最后排查代码因素\r\n```\r\n\r\n### 步骤4：验证假设\r\n```\r\n验证方法：\r\n1. 复现问题\r\n2. 修改假设条件\r\n3. 验证问题是否消失\r\n4. 确认根因\r\n```\r\n\r\n## 根因分析表\r\n\r\n| Bug ID | 症状分类 | 根因方向 | 根本原因 | 验证方法 |\r\n|--------|---------|---------|---------|---------|\r\n| BUG-001 | 返回错误 | 数据层 | 数据格式错误 | 修改数据后验证 |\r\n| BUG-002 | 性能退化 | 数据库 | 慢查询 | 添加索引后验证 |\r\n\r\n## 验收清单\r\n\r\n根因分析完成后检查：\r\n- [ ] 是否收集了完整信息？\r\n- [ ] 是否正确分类症状？\r\n- [ ] 是否逐层排查根因？\r\n- [ ] 是否验证了根因假设？\r\n- [ ] 根因描述是否清晰？\r\n- [ ] 验证方法是否可行？\n\nFile v1.3.0:_meta.json\n\n{\n \"ownerId\": \"kn71y9b23csfx0ykgm55d5m9x5891zt8\",\n \"slug\": \"qa-bug-root-cause-analysis\",\n \"version\": \"1.3.0\",\n \"publishedAt\": 1782017429647\n}\n\nFile v1.3.0:skill-card.md\n\n## Description:
\nChinese-language bug root-cause analysis workflow that maps observed QA symptoms to likely cause areas and validation methods.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[kokxi](https://clawhub.ai/user/kokxi)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nQA testers, developers, and support engineers use this Chinese-language workflow to collect bug evidence, classify symptoms, narrow likely root cause layers, and define validation steps.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: Agent-proposed Bash commands during debugging could modify files, services, or data.
\nMitigation: Review commands before execution and prefer read-only diagnostics unless a change is explicitly intended.
\nRisk: Root-cause conclusions may be misleading when the bug report lacks reproduction steps, environment details, timing, impact, or logs.
\nMitigation: Collect the required symptom, reproduction, environment, time, impact, and log evidence before confirming a root cause.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/kokxi/qa-bug-root-cause-analysis)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, guidance, shell commands]
\n**Output Format:** [Markdown root-cause analysis report with symptom classification, root-cause direction, and validation methods]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Chinese-language QA workflow; may include diagnostic commands when debugging requires them.]
\n\n## Skill Version(s):
\n1.3.0 (source: server release metadata)
\n\n## Ethical Considerations:
\nUsers 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.
","readmeExcerpt":"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 ","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"信息收集清单：\n├─ 症状描述：具体表现是什么？\n├─ 复现步骤：怎么复现？\n├─ 环境信息：什么环境下出现？\n├─ 时间信息：什么时候出现？\n├─ 影响范围：影响多大？\n└─ 相关日志：日志有什么？"},{"language":"text","snippet":"根据症状表现分类：\n- 返回错误 → 代码/数据/配置/依赖层\n- 数据不对 → 写入/读取/同步/转换问题\n- 性能退化 → 数据库/代码/缓存/资源问题\n- 没反应 → 前端/网络/后端/中间件问题\n- 偶发问题 → 并发/环境/数据/时序问题"},{"language":"text","snippet":"根据症状分类，逐层排查：\n1. 先排除外部因素（依赖/环境）\n2. 再排除配置因素\n3. 再排查数据因素\n4. 最后排查代码因素"},{"language":"text","snippet":"验证方法：\n1. 复现问题\n2. 修改假设条件\n3. 验证问题是否消失\n4. 确认根因"},{"language":"text","snippet":"症状表现：\n- HTTP状态码错误（4xx/5xx）\n- 业务错误码\n- 错误信息\n\n根因方向：\n├─ 代码层\n│ ├─ 逻辑错误：条件判断错误\n│ ├─ 空指针：对象未初始化\n│ ├─ 数组越界：索引超出范围\n│ └─ 类型转换：类型不匹配\n│\n├─ 数据层\n│ ├─ 数据缺失：必要数据不存在\n│ ├─ 数据错误：数据格式/值错误\n│ ├─ 数据冲突：唯一性约束\n│ └─ 数据过期：数据已失效\n│\n├─ 配置层\n│ ├─ 配置缺失：配置项未配置\n│ ├─ 配置错误：配置值错误\n│ ├─ 环境差异：不同环境配置不同\n│ └─ 配置变更：配置被意外修改\n│\n└─ 依赖层\n ├─ 依赖不可用：第三方服务故障\n ├─ 依赖超时：响应超时\n ├─ 依赖返回错误：第三方返回异常\n └─ 依赖版本不兼容：接口变更"},{"language":"text","snippet":"症状表现：\n- 数据缺失\n- 数据错误\n- 数据不一致\n- 数据格式异常\n\n根因方向：\n├─ 写入问题\n│ ├─ 写入失败：数据库操作失败\n│ ├─ 写入丢失：事务未提交\n│ ├─ 写入延迟：异步写入未完成\n│ └─ 写入重复：重复提交\n│\n├─ 读取问题\n│ ├─ 缓存不一致：缓存与DB不同步\n│ ├─ 读取过滤：查询条件过滤\n│ ├─ 读取延迟：读从库延迟\n│ └─ 读取缓存：读到旧缓存\n│\n├─ 同步问题\n│ ├─ 同步延迟：主从同步延迟\n│ ├─ 同步失败：同步任务失败\n│ ├─ 同步冲突：并发同步冲突\n│ └─ 同步丢失：同步任务遗漏\n│\n└─ 转换问题\n ├─ 格式转换：数据格式转换错误\n ├─ 编码问题：字符编码不一致\n ├─ 精度丢失：浮点数精度问题\n └─ 时区问题：时区转换错误"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: qa-bug-root-cause-analysis\ndescription: >-\n 当某个 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.\nlicense: MIT\nallowed-tools: Read Grep Glob Bash\nmetadata:\n display-name: \"Bug Root Cause Analysis\"\n version: \"1.8.0\"\n when-to-use: \"用户说\\\"Bug根因\\\"、\\\"根因分析\\\"、\\\"为什么出Bug\\\"、\\\"深层原因\\\"、\\\"定位问题\\\"、\\\"排查方向\\\"、需要分析Bug根因、反复出现同类问题需要根因改进时\"\n related-skills: \"{\\\"upstream\\\":[\\\"qa-execution-observation\\\"],\\\"downstream\\\":[\\\"qa-bug-reporting\\\",\\\"qa-retrospective\\\"]}\"\n references: \"[\\\"references/symptom-rca-map.md\\\"]\"\n input-format: \"{\\\"required\\\":[{\\\"name\\\":\\\"Bug描述\\\",\\\"type\\\":\\\"string\\\",\\\"description\\\":\\\"缺陷的详细描述\\\"},{\\\"name\\\":\\\"执行日志\\\",\\\"type\\\":\\\"string\\\",\\\"description\\\":\\\"执行过程中的日志信息\\\"},{\\\"name\\\":\\\"环境信息\\\",\\\"type\\\":\\\"string\\\",\\\"description\\\":\\\"缺陷发现时的环境配置\\\"}],\\\"optional\\\":[{\\\"name\\\":\\\"复现步骤\\\",\\\"type\\\":\\\"array\\\",\\\"description\\\":\\\"缺陷复现的具体步骤\\\"}]}\"\n 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\\\":\\\"预防措施\\\"}]}\"\n error-recovery-guidance: \"{\\\"on_failure\\\":\\\"根因定位不充分时回退到执行观察收集更多信号\\\",\\\"retry_behavior\\\":\\\"补充日志或环境信息后重新分析根因\\\"}\"\n categories: \"[\\\"Development\\\",\\\"Testing\\\",\\\"Quality\\\"]\"\n depth-requirement: \"{\\\"reference_value\\\":\\\"根据缺陷复杂度调整根因分析深度：简单×1/中等×2/复杂×3\\\",\\\"minimum\\\":\\\"至少区分直接原因、间接原因、系统原因3个层级\\\"}\"\n---\n> ⚠️ 本技能单独使用效果有限，建议配合完整技能集（12 步工作流）使用。安装：npx skills add Kokxi/qa-test-skills\n\n> **⚠️ 安全警告**：本技能的示例可能涉及订单号、支付金额、截图、身份证、手机号等敏感数据。\n> 实际使用时请勿粘贴真实生产数据、客户信息或财务凭证；测试前应脱敏/掩码处理。\n> 本技能仅在 workspace/ 输出评估文件，不持久化、不外传、不跨会话复用。\n\n# Bug根因分析\n\n## 核心原则\n\n看到错误，能快速缩小根因范围——这不是魔法，是可学习的映射模式。\n\n## 加载时机\n\n| 什么时候读 | 读哪个 |\n|-----------|--------|\n| 定位到具体症状后，查对应的根因与验证手段 | [`references/symptom-rca-map.md`](references/symptom-rca-map.md) |\n\n> `症状分类与根因映射`的完整内容已下沉至 `references/symptom-rca-map.md`，避免每次触发都占用上下文。\n\n## 分析流程\n\n### 步骤1：收集信息\n```text\n信息收集清单：\n├─ 症状描述：具体表现是什么？\n├─ 复现步骤：怎么复现？\n├─ 环境信息：什么环境下出现？\n├─ 时间信息：什么时候出现？\n├─ 影响范围：影响多大？\n└─ 相关日志：日志有什么？\n```\n\n### 步骤2：分类症状\n```text\n根据症状表现分类：\n- 返回错误 → 代码/数据/配置/依赖层\n- 数据不对 → 写入/读取/同步/转换问题\n- 性能退化 → 数据库/代码/缓存/资源问题\n- 没反应 → 前端/网络/后端/中间件问题\n- 偶发问题 → 并发/环境/数据/时序问题\n```\n\n### 步骤3：缩小范围\n```text\n根据症状分类，逐层排查：\n1. 先排除外部因素（依赖/环境）\n2. 再排除配置因素\n3. 再排查数据因素\n4. 最后排查代码因素\n```\n\n### 步骤4：验证假设\n```text\n验证方法：\n1. 复现问题\n2. 修改假设条件\n3. 验证问题是否消失\n4. 确认根因\n```\n\n## 根因分析表\n\n| Bug ID | 症状分类 | 根因方向 | 根本原因 | 验证方法 |\n|--------|---------|---------|---------|---------|\n| BUG-001 | 返回错误 | 数据层 | 数据格式错误 | 修改数据后验证 |\n| BUG-002 | 性能退化 | 数据库 | 慢查询 | 添加索引后验证 |\n\n## 症状分类"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn71y9b23csfx0ykgm55d5m9x5891zt8\",\n \"slug\": \"qa-bug-root-cause-analysis\",\n \"version\": \"1.8.0\",\n \"publishedAt\": 1790655949101\n}"},{"path":"references/symptom-rca-map.md","content":"# 症状分类与根因映射\n\n> 本文是 `qa-bug-root-cause-analysis` 的**症状→根因对照表**。拿到线上/测试发现的具体症状后查对应根因时读本文；\n只想了解 5Why/鱼骨图等方法怎么用时不必读。\n\n---\n\n\n### 症状1：返回错误\n\n```text\n症状表现：\n- HTTP状态码错误（4xx/5xx）\n- 业务错误码\n- 错误信息\n\n根因方向：\n├─ 代码层\n│ ├─ 逻辑错误：条件判断错误\n│ ├─ 空指针：对象未初始化\n│ ├─ 数组越界：索引超出范围\n│ └─ 类型转换：类型不匹配\n│\n├─ 数据层\n│ ├─ 数据缺失：必要数据不存在\n│ ├─ 数据错误：数据格式/值错误\n│ ├─ 数据冲突：唯一性约束\n│ └─ 数据过期：数据已失效\n│\n├─ 配置层\n│ ├─ 配置缺失：配置项未配置\n│ ├─ 配置错误：配置值错误\n│ ├─ 环境差异：不同环境配置不同\n│ └─ 配置变更：配置被意外修改\n│\n└─ 依赖层\n ├─ 依赖不可用：第三方服务故障\n ├─ 依赖超时：响应超时\n ├─ 依赖返回错误：第三方返回异常\n └─ 依赖版本不兼容：接口变更\n```\n\n### 症状2：数据不对\n\n```text\n症状表现：\n- 数据缺失\n- 数据错误\n- 数据不一致\n- 数据格式异常\n\n根因方向：\n├─ 写入问题\n│ ├─ 写入失败：数据库操作失败\n│ ├─ 写入丢失：事务未提交\n│ ├─ 写入延迟：异步写入未完成\n│ └─ 写入重复：重复提交\n│\n├─ 读取问题\n│ ├─ 缓存不一致：缓存与DB不同步\n│ ├─ 读取过滤：查询条件过滤\n│ ├─ 读取延迟：读从库延迟\n│ └─ 读取缓存：读到旧缓存\n│\n├─ 同步问题\n│ ├─ 同步延迟：主从同步延迟\n│ ├─ 同步失败：同步任务失败\n│ ├─ 同步冲突：并发同步冲突\n│ └─ 同步丢失：同步任务遗漏\n│\n└─ 转换问题\n ├─ 格式转换：数据格式转换错误\n ├─ 编码问题：字符编码不一致\n ├─ 精度丢失：浮点数精度问题\n └─ 时区问题：时区转换错误\n```\n\n### 症状3：性能退化\n\n```text\n症状表现：\n- 响应时间变长\n- 吞吐量下降\n- 资源占用高\n\n根因方向：\n├─ 数据库问题\n│ ├─ 慢查询：SQL执行慢\n│ ├─ 索引缺失：缺少必要索引\n│ ├─ 锁等待：锁竞争\n│ ├─ 连接池耗尽：连接数不够\n│ └─ 数据量增长：数据量变大\n│\n├─ 代码问题\n│ ├─ 算法复杂度：算法效率低\n│ ├─ 循环嵌套：循环次数多\n│ ├─ 内存泄漏：内存未释放\n│ ├─ 线程阻塞：线程等待\n│ └─ 频繁GC：垃圾回收频繁\n│\n├─ 缓存问题\n│ ├─ 缓存穿透：缓存未命中\n│ ├─ 缓存雪崩：缓存集中失效\n│ ├─ 缓存击穿：热点key失效\n│ └─ 缓存容量：缓存容量不足\n│\n└─ 资源问题\n ├─ CPU瓶颈：CPU占用高\n ├─ 内存瓶颈：内存不足\n ├─ IO瓶颈：磁盘IO慢\n └─ 网络瓶颈：网络延迟高\n```\n\n### 症状4：没反应\n\n```text\n症状表现：\n- 点击无反应\n- 操作无效果\n- 界面卡住\n\n根因方向：\n├─ 前端问题\n│ ├─ JS报错：JavaScript错误\n│ ├─ 事件绑定：事件未绑定\n│ ├─ 状态异常：前端状态错误\n│ ├─ 网络请求：请求未发出\n│ └─ 渲染异常：DOM渲染错误\n│\n├─ 网络问题\n│ ├─ 请求丢失：网络丢包\n│ ├─ 请求超时：网络超时\n│ ├─ 连接断开：网络断开\n│ └─ DNS解析：DNS解析失败\n│\n├─ 后端问题\n│ ├─ 请求未接收：请求未到达\n│ ├─ 处理阻塞：处理线程阻塞\n│ ├─ 响应丢失：响应未返回\n│ └─ 服务不可用：服务宕机\n│\n└─ 中间件问题\n ├─ Nginx问题：Nginx配置错误\n ├─ 网关问题：网关路由错误\n ├─ MQ问题：消息队列阻塞\n └─ 限流问题：触发限流\n```\n\n### 症状5：偶发问题\n\n```text\n症状表现：\n- 时有时无\n- 特定条件出现\n- 难以复现\n\n根因方向：\n├─ 并发问题\n│ ├─ 竞态条件：并发操作冲突\n│ ├─ 死锁：线程互相等待\n│ ├─ 线程安全：共享资源竞争\n│ └─ 资源泄露：资源未释放\n│\n├─ 环境问题\n│ ├─ 环境差异：不同环境表现不同\n│ ├─ 配置差异：配置不一致\n│ ├─ 依赖状态：依赖服务状态\n│ └─ 硬件差异：硬件性能差异\n│\n├─ 数据问题\n│ ├─ 数据状态：特定数据状态触发\n│ ├─ 数据量：数据量达到阈值触发\n│ ├─ 数据顺序：数据顺序影响\n│ └─ 数据时效：数据过期触发\n│\n└─ 时序问题\n ├─ 时序依赖：操作顺序影响\n ├─ 定时任务：定时任务触发\n ├─ 缓存过期：缓存过期触发\n └─ 会话超时：会话过期触发\n```"},{"path":"skill-card.md","content":"## Description:\n\nHelps QA engineers trace recurring or escaped bugs from symptoms to verified root causes and preventive actions.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[kokxi](https://clawhub.ai/user/kokxi)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nQA 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.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Bug reports and logs may contain customer, payment, or identity information.\n\nMitigation: Mask sensitive data before sharing logs, screenshots, or production examples.\n\nRisk: The optional companion-skill installation introduces a separate trust decision.\n\nMitigation: Verify the source before running the suggested installation command.\n\nRisk: Example troubleshooting may involve external log or monitoring tools.\n\nMitigation: Use those tools only in an authorized, controlled environment.\n\n## Reference(s):\n\n- [Symptom-to-root-cause reference](references/symptom-rca-map.md)\n- [ClawHub skill release](https://clawhub.ai/kokxi/skills/qa-bug-root-cause-analysis)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Guidance]\n\n**Output Format:** [Markdown root-cause analysis and recommendations]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Root-cause IDs, linked bug IDs, contributing factors, impact, fixes, and prevention measures.]\n\n## Skill Version(s):\n\n1.8.0 (source: skill frontmatter and ClawHub release)\n\n## Ethical Considerations:\n\nUsers 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."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"当某个 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","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1061,"uniquenessScore":50,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T10:29:17.569Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T10:29:17.569Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T14:13:19.811Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"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!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"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","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}