Menu
系统化调试工具，分类处理编译/运行时/网络/数据库错误，提供信息收集清单、前后端调试方法、常见问题速查表、二分法定位和回归测试。触发词：调试、排查错误、debug、报错了、出错了、error debug、troubleshoot
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
快速测试 API 接口，支持自动认证和批量测试。Use when the user asks to "测试API", "api test", "接口测试", "curl测试", "测试接口".
项目入口角色 — 软件架构师。倾听用户叙述项目思路，整理成结构化的需求文档和架构蓝图。 识别核心功能模块、技术栈选型、数据流设计、关键决策点。 Use when: 用户说"启动架构师"、"我要讲一个项目思路"、"帮我整理思路"、"梳理需求"、"软件架构"、"项目规划"。 Voice triggers: "架构师", "整理思路", "梳理项目", "项目思路"。
代码质量检查，包括 ESLint、TypeScript 类型检查和编译测试。Use when the user asks to "检查代码", "code check", "lint", "typecheck", "代码质量".
数据库备份与恢复，支持自动清理旧备份。Use when the user asks to "备份数据库", "恢复数据库", "db backup", "db restore", "数据库快照".
数据库架构师 — 设计数据库表结构、ER关系图、SQL迁移文件。 输出：数据库设计方案、表结构SQL、索引优化建议。 Use when: 用户说"设计数据库"、"优化查询"、"迁移脚本"、"数据库设计"。 Voice triggers: "数据库设计", "设计数据库", "表结构", "SQL"。
依赖安全更新工具，扫描漏洞、分级报告、按 patch/minor/major 策略更新，自动创建备份分支，执行验证测试，生成更新报告。触发词：更新依赖、依赖升级、npm audit、安全漏洞、dep update、dependency update
| name | error-debug |
| description | 系统化调试工具，分类处理编译/运行时/网络/数据库错误，提供信息收集清单、前后端调试方法、常见问题速查表、二分法定位和回归测试。触发词：调试、排查错误、debug、报错了、出错了、error debug、troubleshoot |
| 类型 | 特征 | 排查重点 |
|---|---|---|
| 编译错误 | 构建失败、类型错误 | 语法、类型定义、依赖 |
| 运行时错误 | 程序崩溃、异常抛出 | 逻辑、空值、边界条件 |
| 网络错误 | 请求失败、超时 | 接口、CORS、连接状态 |
| 数据库错误 | 查询失败、连接错误 | SQL、连接池、权限 |
排查前收集：
# 1. 检查日志
tail -f logs/app.log
journalctl -u <service> -f
# 2. 检查数据库状态
psql -c "\dt" # 查看表
psql -c "SELECT * FROM pg_stat_activity;" # 连接状态
# 3. 测试API响应
curl -v http://localhost:3000/api/health
# 4. 检查环境变量
env | grep APP_
# 1. 浏览器控制台
# - 查看 Console 错误
# - 查看 Network 请求状态
# - 查看 Application Storage
# 2. 检查构建输出
npm run build 2>&1 | tee build.log
# 3. 检查路由配置
cat src/router/index.ts
| 问题 | 可能原因 | 解决方案 |
|---|---|---|
| 端口占用 | 进程未关闭 | lsof -ti:3000 | xargs kill -9 |
| 模块未找到 | 依赖未安装 | rm -rf node_modules && npm install |
| 类型错误 | TS定义不匹配 | 检查 interface/type 定义 |
| CORS错误 | 跨域配置 | 检查后端 CORS 中间件 |
| 认证失败 | Token过期 | 检查 Authorization 头 |
# 1. 开始二分查找
git bisect start
# 2. 标记当前版本有问题
git bisect bad
# 3. 标记已知正常版本
git bisect good <commit-hash>
# 4. 自动测试（如项目有测试脚本）
git bisect run npm test
# 5. 结束查找
git bisect reset
# 1. 确认修复
git diff HEAD
# 2. 本地验证
npm run build
npm test
# 3. 回归测试（检查是否引入新问题）
npm run test:e2e
# 4. 提交修复
git add .
git commit -m "fix: 修复XXX问题"