# Easyuseaide Complex Debugging

> Use this skill for intermittent, repeated, concurrent, performance, resource-leak, flaky-test, integration, or production-only failures that need investigation beyond an ordinary bug fix. If another general debugging workflow is active, keep it as the primary root-cause process and use this skill only for additional failure-mode checks; do not run two complete debugging workflows.

- **Type:** Skill
- **Install:** `agentstack add skill-john-ops-lab-easyuseaide-easyuseaide-complex-debugging`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [john-ops-lab](https://agentstack.voostack.com/s/john-ops-lab)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [john-ops-lab](https://github.com/john-ops-lab)
- **Source:** https://github.com/john-ops-lab/EasyUseAIDE/tree/main/assets/skills/easyuseaide-complex-debugging

## Install

```sh
agentstack add skill-john-ops-lab-easyuseaide-easyuseaide-complex-debugging
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 复杂故障排查

目标不是快速制造看似有效的补丁，而是形成可重复证据、定位根因并验证修复。

## 与已有调试框架配合

如果其他插件、Skill 或项目规则已经指定通用调试流程，以该流程作为根因调查主流程。本 Skill 只补充间歇性、并发、性能、资源泄漏、失败恢复和反复复发场景的专项检查。

复用已有故障描述、复现步骤、假设记录、测试和日志证据，不重新创建第二套调查流程。两个流程要求真正冲突时，遵循用户当前指令和项目规则；仍无法解决时先报告差异，不默默选择。

## 1. 定义故障

开始复杂故障调查时，读取 `assets/incident-investigation.md`，根据当前项目情况创建调查记录，并在排查过程中持续更新。

记录：

- 预期行为；
- 实际行为；
- 首次出现时间和变化；
- 稳定复现还是间歇出现；
- 影响范围；
- 当前已有证据；
- 已尝试方案及结果。

区分事实、推断和未知。

## 2. 建立最小复现

优先获得：

- 最小输入；
- 最小环境；
- 稳定命令；
- 失败日志、错误码或指标；
- 修改前必然失败的测试。

不能稳定复现时，先增加必要的可观测性，不盲目修改核心逻辑。

## 3. 缩小范围

按证据逐层排除：

- 输入与配置；
- 调用链与数据流；
- 边界条件；
- 外部依赖；
- 并发与事务；
- 超时、重试和部分失败；
- 缓存和状态；
- 资源释放；
- 环境和版本差异。

每次只验证一个主要假设，并记录结果。

## 4. 选择验证工具

按问题使用：

- 单元或集成测试；
- 日志和结构化事件；
- Trace；
- 指标和性能剖析；
- 数据库执行计划、锁和事务视图；
- 网络抓包或请求录制；
- 线程、进程、内存和文件句柄分析；
- 二分定位；
- 故障注入；
- 并发或压力测试。

没有基准时不声称性能提升。

## 5. 修复原则

- 修复根因，不只屏蔽症状；
- 保持改动最小；
- 不删除测试或放宽断言；
- 证据不足时不进行大规模重构；
- 多次修补仍反复出现时，重新检查领域模型、数据流和设计边界。

## 6. 验证修复

确认：

- 原始复现不再失败；
- 修改前失败、修改后通过；
- 相邻正常场景未受影响；
- 必要回归测试已增加；
- 并发、重复、失败恢复或资源释放得到与风险匹配的验证；
- 未验证内容和剩余风险明确记录。

## 7. 沉淀

记录根因、关键证据、修复、回归测试和长期改进。临时调试流水不全部写入长期项目文档。

长期项目中，将依据 `assets/incident-investigation.md` 完成的调查记录保存到项目 `docs/` 下，并在 `project-status.md` 中引用，不在状态文件中复制完整调查内容。

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [john-ops-lab](https://github.com/john-ops-lab)
- **Source:** [john-ops-lab/EasyUseAIDE](https://github.com/john-ops-lab/EasyUseAIDE)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-john-ops-lab-easyuseaide-easyuseaide-complex-debugging
- Seller: https://agentstack.voostack.com/s/john-ops-lab
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.