スキル flow-debugging
🔍

flow-debugging

安全

تصحيح الأخطاء بالطريقة المنهجية

يخمن المطورون غالباً حلولاً للأخطاء، مما يؤدي إلى انتكاسات وإهدار للوقت. تفرض هذه المهارة عملية تصحيح صارمة في 4 مراحل تتطلب التحقيق في السبب الجذري قبل أي تغييرات في الكود.

対応: Claude Codex Code(CC)
📊 70 十分
1

スキルZIPをダウンロード

2

Claudeでアップロード

設定 → 機能 → スキル → スキルをアップロードへ移動

3

オンにして利用開始

テストする

「flow-debugging」を使用しています。 Help me debug: My API returns 500 errors intermittently for user login requests.

期待される結果:

Let's start Phase 1: Root Cause Investigation.

## Step 1: Record Error Details
- Error type: HTTP 500 Internal Server Error
- Frequency: Intermittent (not every request)
- Impact: Users cannot log in during failures

## Step 2: Stable Reproduction
What conditions precede this error?
- Time of day? Load level? Specific user types?

## Step 3: Check Recent Changes
Run: git log --oneline -20
Run: git diff HEAD~5

What changed around when this started?

## Step 4: Trace Data Flow
Where does the login request flow break?
- Check logs for stack traces
- Identify the exact line throwing 500

STOP. Do NOT implement fixes yet. First, confirm root cause.

「flow-debugging」を使用しています。 I'm stuck. I've tried 3 fixes but the bug keeps coming back.

期待される結果:

Three failed fix attempts detected. This is a red flag. STOP and apply the methodology.

## Go Back to Phase 1
You likely fixed symptoms, not root cause.

## Questions to Answer
1. Did you reproduce before each fix?
2. Did you write failing tests first?
3. Did you verify root cause with evidence?

## Recommendation
- Roll back all recent changes
- Re-run Phase 1 systematically
- Only then proceed to Phase 2-4

The Iron Law applies: NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST.

セキュリティ監査

安全
v6 • 1/21/2026

Documentation-only skill describing a 4-phase debugging methodology. All static findings are false positives: markdown code blocks flagged as shell execution, SHA256 hash strings flagged as crypto vulnerabilities, and relative documentation paths flagged as path traversal. No executable code exists.

2
スキャンされたファイル
632
解析された行数
0
検出結果
6
総監査数
セキュリティ問題は見つかりませんでした
監査者: claude 監査履歴を表示 →

品質スコア

38
アーキテクチャ
100
保守性
87
コンテンツ
21
コミュニティ
100
セキュリティ
91
仕様準拠

作れるもの

إصلاح الأخطاء المعقدة بشكل منهجي

عند مواجهة أخطاء صعبة قاومت محاولات إصلاح متعددة، استخدم هذه المهارة للتراجع وتطبيق تحليل السبب الجذري الصارم قبل إجراء المزيد من التغييرات.

تعلم التصحيح المنهجي

يمكن للمطورين المبتدئين استخدام هذه المهارة لتعلم تقنيات التصحيح الاحترافية التي تؤكد على التحقيق القائم على الأدلة بدلاً من التخمين.

منع أنماط التصحيح المضادة

عندما تكتشف نفسك تقول 'دعني أجرب هذا'، استخدم هذه المهارة لإعادة التهيأة وتطبيق منهجية التصحيح المنظمة بدلاً من المحاولات العشوائية.

これらのプロンプトを試す

بدء جلسة التصحيح
أواجه خطأ: [describe the error]. ساعدني في تصحيح هذا بشكل منهجي باستخدام عملية الـ 4 مراحل. ابدأ بالمرحلة 1: التحقيق في السبب الجذري. ماذا يجب أن أبحث عنه وأسجله؟
إعادة الإنتاج قبل الإصلاح
أعتقد أنني فهمت الخطأ. قبل تنفيذ الإصلاح، أرشدني خلال إنشاء حالة إعادة إنتاج مستقرة والتحقق من التغييرات الأخيرة باستخدام أوامر git.
تحليل الأنماط
لقد أعدت إنتاج الخطأ. الآن ساعدني في المرحلة 2: تحليل الأنماط. كيف أجد أمثلة مماثلة تعمل وأقارنها مع الكود المكسور؟
اختبار الفرضية بتطوير الاختبارات
فرضيتي هي: [state hypothesis]. أرشدني خلال المرحلة 3: اختبار الفرضيات والمرحلة 4: تطبيق تطوير الاختبارات. ساعدني في كتابة اختبار فاشل أولاً.

ベストプラクティス

  • أكمل دائماً المرحلة 1 (التحقيق في السبب الجذري) قبل كتابة أي كود إصلاح. المقاومة لهذه الخطوة علامة تحذيرية.
  • اكتب اختباراً فاشلاً يُعيد إنتاج الخطأ قبل تنفيذ أي إصلاح. هذه 'الضوء الأحمر' في المرحلة 4.
  • عندما تفشل 3+ محاولات إصلاح، توقف فوراً وابدأ من المرحلة 1. المشكلة أعمق مما تعتقد.
  • وثق تحقيقك باستخدام القالب المنظم. التوثيق الواضح يمنع إعادة زيارة المشاكل التي تم حلها.

回避

  • تصحيح القصف: تجربة تغييرات عشوائية حتى يعمل شيء ما. هذا ليس تصحيحاً، إنه تخمين.
  • منهجية الإصلاح أولاً: تنفيذ الإصلاحات قبل فهم السبب الجذري. هذا يؤدي إلى الانتكاسات.
  • تجاوز إعادة الإنتاج: محاولة الإصلاحات دون إنشاء خطوات إعادة إنتاج موثوقة أولاً.
  • تجاوز التوثيق: قول 'أعرف ما الخطأ' بدون تحقيق قائم على الأدلة.

よくある質問

ما هو القانون الحديدي في هذه المهارة؟
القانون الحديدي هو المبدأ الأساسي: لا إصلاحات بدون تحقيق السبب الجذري أولاً. يجب أن يسبق كل إصلاح خطأ تحقيق منهجي لفهم السبب الجذري.
كم من الوقت يجب أن تأخذ المرحلة 1؟
يجب أن تأخذ المرحلة 1 الوقت اللازم لإنشاء فرضية واضحة للسبب الجذري مع الأدلة. قاوم الرغبة في تجاوز هذه المرحلة. التحقيق الشامل يوفر الوقت بشكل عام عن طريق منع محاولات الإصلاح الخاطئة.
ماذا لو لم أستطع إعادة إنتاج الخطأ؟
إذا لم تتمكن من إعادة إنتاج الخطأ، لا تحاول الإصلاحات. بدلاً من ذلك، اجمع المزيد من المعلومات: تحقق من السجلات، راقب الإنتاج، أضف أدوات القياس، وراجع عمليات النشر الأخيرة. إعادة الإنتاج شرط مسبق للإصلاحات الواثقة.
كيف أعرف متى أنتهي من المرحلة 3؟
تكون المرحلة 3 (اختبار الفرضيات) مكتملة عندما يكون لديك فرضية واحدة قابلة للتحقق، وعند إصلاحها تحل المشكلة باستمرار. إذا اجتازت الاختبارات وتم تأكيد الفرضية، انتقل إلى المرحلة 4.
هل يمكنني تجاوز خطوات الاختبار؟
لا. كتابة الاختبارات الفاشلة قبل الإصلاحات إلزامية في المرحلة 4. الاختبارات توفر الثقة بأن إصلاحك يعمل وتمنع الانتكاسات. تجاوز الاختبارات يعني أنك لا تعرف إذا كانت المشكلة قد حلت حقاً.
كيف تتكامل هذه المهارة مع flow-fix؟
هذه المهارة هي المنهجية الأساسية لأمر /flow-fix. توفر المهارة عملية الـ 4 مراحل التفصيلية التي يفرضها flow-fix. استخدم هذه المهارة للحصول على إرشادات تصحيح عميقة، أو /flow-fix للحصول على سير عمل إصلاح أوتوماتيكي أكثر.

開発者の詳細

作成者

Dimon94

ライセンス

MIT

参照

main

ファイル構成

📄 SKILL.md