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 头

二分法定位（git bisect）

# 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问题"

Más de este repositorio

mismo repositorio

api-test

zhu637882-stack/jiaoyi

快速测试 API 接口，支持自动认证和批量测试。Use when the user asks to "测试API", "api test", "接口测试", "curl测试", "测试接口".

2026-05-110

architect-entry

zhu637882-stack/jiaoyi

项目入口角色 — 软件架构师。倾听用户叙述项目思路，整理成结构化的需求文档和架构蓝图。识别核心功能模块、技术栈选型、数据流设计、关键决策点。 Use when: 用户说"启动架构师"、"我要讲一个项目思路"、"帮我整理思路"、"梳理需求"、"软件架构"、"项目规划"。 Voice triggers: "架构师", "整理思路", "梳理项目", "项目思路"。

2026-05-110

code-check

zhu637882-stack/jiaoyi

代码质量检查，包括 ESLint、TypeScript 类型检查和编译测试。Use when the user asks to "检查代码", "code check", "lint", "typecheck", "代码质量".

2026-05-110

db-backup

zhu637882-stack/jiaoyi

数据库备份与恢复，支持自动清理旧备份。Use when the user asks to "备份数据库", "恢复数据库", "db backup", "db restore", "数据库快照".

2026-05-110

db-designer

zhu637882-stack/jiaoyi

数据库架构师 — 设计数据库表结构、ER关系图、SQL迁移文件。输出：数据库设计方案、表结构SQL、索引优化建议。 Use when: 用户说"设计数据库"、"优化查询"、"迁移脚本"、"数据库设计"。 Voice triggers: "数据库设计", "设计数据库", "表结构", "SQL"。

2026-05-110

dep-update

zhu637882-stack/jiaoyi

依赖安全更新工具，扫描漏洞、分级报告、按 patch/minor/major 策略更新，自动创建备份分支，执行验证测试，生成更新报告。触发词：更新依赖、依赖升级、npm audit、安全漏洞、dep update、dependency update

2026-05-110

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 头

二分法定位（git bisect）

# 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问题"