القائمة
系统化调试工具，分类处理编译/运行时/网络/数据库错误，提供信息收集清单、前后端调试方法、常见问题速查表、二分法定位和回归测试。触发词：调试、排查错误、debug、报错了、出错了、error debug、troubleshoot
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف 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问题"