스킬 debug-connection
🔌

debug-connection

안전 🌐 네트워크 접근📁 파일 시스템 액세스⚙️ 외부 명령어

تشخيص مشاكل اتصال WebSocket

또한 다음에서 사용할 수 있습니다: 7nohe

غالبًا ما تفشل اتصالات WebSocket بين واجهة سطر الأوامر وإضافة FigJam بصمت. توفر هذه المهارة إجراءات تشخيصية خطوة بخطوة لتحديد مشاكل الاتصال وحلها بسرعة.

지원: Claude Codex Code(CC)
📊 71 적절함
1

스킬 ZIP 다운로드

2

Claude에서 업로드

설정 → 기능 → 스킬 → 스킬 업로드로 이동

3

토글을 켜고 사용 시작

테스트해 보기

"debug-connection" 사용 중입니다. Debug why my FigJam plugin shows 'Connecting...' indefinitely

예상 결과:

  • رفض الاتصال عادة يعني أن CLI serve غير قيد التشغيل. اتبع هذه الخطوات:
  • 1. تحقق من تشغيل figram serve: ps aux | grep 'figram serve'
  • 2. تحقق من توفر المنفذ 3456: lsof -i :3456
  • 3. ابدأ CLI بـ: bun run packages/cli/src/index.ts serve diagram.yaml
  • 4. اختبر WebSocket يدويًا: wscat -c ws://localhost:3456
  • 5. تحقق من وحدة تحكم واجهة الإضافة لأحداث إغلاق WebSocket

"debug-connection" 사용 중입니다. The WebSocket connects but my diagrams are not syncing

예상 결과:

  • الاتصال دون تحديث عادة يشير إلى أخطاء تحليل YAML أو مشاكل في التصحيحات. خطوات التشخيص:
  • 1. تحقق من مخرجات CLI لحالة إنشاء التصحيح
  • 2. افحص وحدة تحكم واجهة الإضافة لأحداث الرسائل المستلمة
  • 3. ابحث عن أخطاء العرض في وحدة تحكم الإضافة الرئيسية
  • 4. تحقق من صحة بناء جملة YAML بـ: bun run packages/cli/src/index.ts build diagram.yaml
  • 5. تحقق من تطابق أرقام المراجعة بين baseRev و nextRev

보안 감사

안전
v3 • 1/16/2026

This skill contains only documentation - a markdown file providing debugging guidance for WebSocket connection issues between CLI and FigJam plugin. No executable code, no file system access, no network operations, and no code execution capabilities. Pure informational content explaining diagnostic procedures.

2
스캔된 파일
372
분석된 줄 수
3
발견 사항
3
총 감사 수
감사자: claude 감사 이력 보기 →

품질 점수

38
아키텍처
100
유지보수성
87
콘텐츠
31
커뮤니티
100
보안
91
사양 준수

만들 수 있는 것

تشخيص مشاكل المزامنة المباشرة

عندما لا تظهر تغييرات YAML في لوحة FigJam، قم بتشخيص أعطال اتصال WebSocket

التحقيق في انقطاعات الاتصال

تتبع سبب إغلاق اتصالات WebSocket بشكل غير متوقع أثناء جلسات التطوير

التحقق من مشاكل التكوين

فحص توفر المنفذ، وعدم تطابق الأسرار، ومشاكل المصادقة في الإعدادات المنشورة

이 프롬프트를 사용해 보세요

فحص حالة الاتصال
Debug why my FigJam plugin shows 'Connecting...' indefinitely. How do I check if the CLI serve is running and verify port 3456 is available?
تشخيص فشل المزامنة
The WebSocket connects but my diagrams are not syncing. What diagnostic steps should I follow to identify why patches are not being applied?
التحقق من المصادقة
My connection establishes but then closes immediately. How do I check if there's a secret mismatch between CLI and plugin?
فحص إطارات البروتوكول
Show me the WebSocket protocol message formats including HelloMessage, FullMessage, PatchMessage, and how patch operations are structured.

모범 사례

  • ابدأ CLI serve مع DEBUG=* للحصول على مخرجات إطارات WebSocket التفصيلية
  • استخدم أدوات مطور المتصفح لفحص علامة تبويب الشبكة لإطارات WS
  • حافظ على قيم الأسرار متزامنة بين CLI والإضافة عند استخدام المصادقة

피하기

  • تجاهل أخطاء التحقق من YAML التي تمنع التحديثات التدريجية
  • تخطي فحص سجلات وحدة التحكم عند انقطاع الاتصالات
  • افتراض أن فشل الاتصال دائمًا مشاكل على مستوى الشبكة

자주 묻는 질문

هل تعمل هذه المهارة مع Claude Code على جميع أنظمة التشغيل؟
نعم، إجراءات التشخيص تستخدم أوامر قياسية مثل ps و lsof و bun المتوفرة على macOS و Linux. قد يحتاج مستخدمو Windows إلى WSL.
ما هي حدود المهلة الزمنية للاتصال؟
لا توجد حدود زمنية صارمة محددة. يستمر اتصال WebSocket حتى تنتهي عملية CLI أو يحدث انقطاع في الشبكة.
هل يمكنني دمج هذا مع خطوط أنابيب الاختبار الآلي؟
توفر المهارة إرشادات تشخيصية فقط. للاختبار الآلي، ستحتاج إلى تنفيذ فحوصات صحة WebSocket في خط أنابيب CI الخاص بك.
هل يتم إرسال محتوى YAML الخاص بي إلى خوادم خارجية أثناء التشخيص؟
لا. جميع عمليات التشخيص محلية. اتصال WebSocket محلي فقط (ws://localhost:3456) ولا ينقل البيانات خارجيًا.
ماذا لو لم يكن wscat مثبتًا للاختبار اليدوي؟
يمكنك استخدام أي أداة عميل WebSocket. تشمل الخيارات البديلة websocat أو DevTools المتصفح أو نصوص اختبار WebSocket بسيطة في Node.js.
كيف تقارن هذه المهارة بأدوات تشخيص الشبكة العامة؟
هذه المهارة متخصصة في بروتوكول WebSocket لـ Figram بما في ذلك أنواع الرسائل وتتبع المراجعات وعمليات التصحيح التي لا يمكن للأدوات العامة تفسيرها.

개발자 세부 정보

작성자

7nohe

라이선스

MIT

참조

main

파일 구조

📄 SKILL.md