debugging
调试SideDish中的常见问题。在修复错误、调查bug、排查API故障或解决构建问题时使用。包括常见错误模式、日志记录策略和调试工具。
📖 中文导读:调试SideDish中的常见问题。在修复错误、调查bug、排查API故障或解决构建问题时使用。包括常见错误模式、日志记录策略和调试工具。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: debugging description: Debugs common issues in SideDish. Use when fixing errors, investigating bugs, troubleshooting API failures, or resolving build issues. Includes common error patterns, logging strategies, and debugging tools.
Debugging Skill
Instructions
- Check browser console & Network tab
- Review server logs in terminal
- Verify environment variables
- Check Firebase console for auth/db issues
- Clear cache if needed:
rm -rf .next && pnpm dev
Common Error Patterns
401 "인증이 필요합니다"
const { user, isAuthenticated } = useAuth()
console.log('Auth state:', { user, isAuthenticated })
Fix: Wrap with useRequireAuth(), check Firebase config
403 "권한이 없습니다"
console.log('authorId:', doc.data()?.authorId)
console.log('user:', authUser.uid)
Fix: Verify ownership check logic
404 "찾을 수 없습니다"
const doc = await db.collection('projects').doc(id).get()
console.log('exists:', doc.exists, 'id:', id)
Hydration Errors
const [mounted, setMounted] = useState(false)
useEffect(() => setMounted(true), [])
if (!mounted) return null
Quick Checklist
- Browser console errors
- Network tab failed requests
- Environment variables set
- Firebase console status
- TypeScript errors (
pnpm build) - Server logs in terminal
For complete debugging templates and TypeScript error fixes, see reference.md.