Agent skill
debug-assistant
调试辅助工具。快速诊断后端、前端和数据库问题。适用于 API 失败、日志分析、服务健康检查等场景。
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/debug-assistant-j4xie-my-prototype-logisti
SKILL.md
调试辅助 Skill
服务架构
| 服务 | 端口 | 日志位置 | 健康检查 |
|---|---|---|---|
| Cretas Backend | 10010 | /www/wwwroot/cretas/cretas-backend.log |
/api/mobile/health |
| AI Service | 8085 | /www/wwwroot/cretas/ai-service/ai-service.log |
/health |
| Mall Backend | 7500 | /www/wwwroot/mall-admin/mall-admin.log |
/actuator/health |
| React Native | 3010 | Metro bundler 控制台 | N/A |
快速诊断命令
服务状态检查
# 检查端口
nc -zv 139.196.165.140 10010
# 健康检查
curl -s http://139.196.165.140:10010/api/mobile/health
curl -s http://139.196.165.140:8085/health
curl -s http://139.196.165.140:7500/actuator/health
查看日志
# Cretas 后端日志
ssh [email protected] "tail -100 /www/wwwroot/cretas/cretas-backend.log"
# 过滤 ERROR
ssh [email protected] "tail -500 /www/wwwroot/cretas/cretas-backend.log | grep -A5 'ERROR'"
# AI 服务日志
ssh [email protected] "tail -100 /www/wwwroot/cretas/ai-service/ai-service.log"
数据库检查
ssh [email protected] "mysql -u root -p cretas_db -e 'SELECT 1'"
常见错误速查
| 错误 | 检查命令 | 常见原因 |
|---|---|---|
| 500 Error | grep ERROR backend.log |
Entity字段缺失、NPE、JSON错误 |
| 401 Unauthorized | echo TOKEN | cut -d'.' -f2 | base64 -d |
Token过期/格式错误/权限不足 |
| 网络失败 | nc -zv 139.196.165.140 10010 |
端口未开放/防火墙 |
| RN 白屏 | npx expo start --clear |
Metro 编译错误 |
JWT Token 调试
# 解码 JWT payload
echo "YOUR_TOKEN" | cut -d'.' -f2 | base64 -d 2>/dev/null | jq
React Native 调试
cd frontend/CretasFoodTrace
npx expo start --clear # 清除缓存启动
npx expo doctor # 检查环境
参考文档
references/common-errors.md- 完整错误速查表
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?