أمر Claude Code /insights: فحص شامل لعاداتك البرمجية
أمر سلاش واحد يقرأ جلساتك الأخيرة وينتج تقرير HTML: على ماذا تعمل، وأين تحدث الاحتكاكات، وأي الإصلاحات تأتي أولًا. اثنتا عشرة خطوة مصورة من طرفيتين حقيقيتين.
الخلاصة
- اكتب /insights في أي جلسة Claude Code — يحلل حتى 200 جلسة على هذه الآلة ويتخطى الجلسات القصيرة جدًا.
- بعد نحو دقيقة يظهر تقرير HTML في ~/.claude/usage-data/report.html؛ وكل تشغيل يحفظ نسخة بطابع زمني أيضًا.
- يغطي التقرير مشاريعك، وكيفية استخدامك Claude Code، ونقاط الاحتكاك، والميزات الجديرة بالتجربة — مع روابط أو أوامر جاهزة للصق.
- اطلب من الجلسة نفسها تلخيص التقرير في «أهم 3 نصائح قابلة للتنفيذ»، ثم دع Claude يكتب الإصلاحات في CLAUDE.md وhooks.
Claude Code Course 15 - The /insights Report
القناة: Code Playbook5:09
Claude Code: 5 New "Minor" Features You May Have Missed
القناة: AI Coding Daily6:31
Analyze your usage patterns (official docs)
الوثائق: code.claude.com
تم التحقق من وقائع هذه الصفحة مقابل سجل التغييرات والوثائق الرسمية لـ Claude Code: يحلل /insights حتى 200 جلسة غير محللة سابقًا على جهازك ويتخطى القصير جدًا، ويكتب report.html مع نسخة بطابع زمني في ~/.claude/usage-data/ (تُحذف بعد cleanupPeriodDays — 30 يومًا افتراضيًا).
اللقطات مأخوذة من تسجيلَي المبدعين أعلاه مع قصّ طبقة الكاميرا؛ كل خطوة ترتبط بالثانية الدقيقة في الفيديو الأصلي.
شغّل /insights، واقرأ التقرير، ونفّذ الإصلاحات
تشغيل الأمر (الخطوات 1–3)
- 1
اعرف ما يفعله /insights قبل تشغيله
أعلنت Anthropic عن /insights كأمر يقرأ سجل رسائل الشهر الماضي، ويلخص مشاريعك وطريقة استخدامك لـ Claude Code، ويقترح تحسينات على سير العمل. إنه يُبلّغ عن أسلوب عملك لا عن عدد التوكنات.
منشور الإعلان الرسمي، من فيديو AI Coding Daily.شاهد عند 0:35 - 2
اكتب /insights في أي مشروع
افتح Claude Code في أي مجلد وشغّل /insights. يغطي التحليل كل جلساتك الأخيرة على هذه الآلة، لا المشروع الحالي فحسب. تدور مؤشرات انتظار بينما يقرأ Claude سجلك — وسيستغرق ذلك نحو دقيقة.
/insights قيد التشغيل في تسجيل Code Playbook؛ العداد يُظهر سير التحليل.شاهد عند 0:50 - 3
انتظر رسالة «report is ready»
عند الانتهاء يطبع Claude Code مسار التقرير: ~/.claude/usage-data/report.html، ويسأل إن أردت التعمق في قسم أو تجربة أحد الاقتراحات — أجب داخل الجلسة مباشرة.
رسالة الإتمام مع مسار report.html، من التسجيل الثاني.شاهد عند 0:45
قراءة التقرير (الخطوات 4–8)
- 4
افتح report.html وابدأ من الترويسة
التقرير ملف HTML محلي واحد. تعرض الترويسة إجمالياتك — الرسائل، الأسطر المضافة والمحذوفة، الملفات التي لمستها، الأيام النشطة، الرسائل يوميًا — وثماني تبويبات للأقسام من What You Work On إلى Team Feedback.
إحصاءات ترويسة تحليل 176 جلسة: 936 رسالة عبر 14 يومًا نشطًا.شاهد عند 2:10 - 5
اقرأ بطاقة At a Glance أولًا
تلخص البطاقة الافتتاحية التقرير كله في أربع فقرات: ما الذي يعمل، وما يعيقك، ومكاسب سريعة للتجربة، وسير عمل أكثر طموحًا. هنا ينبّه Claude إلى احتكاك نحوي متكرر ويقترح اتفاقيات CLAUDE.md مع hook لفحص البناء.
ملخص At a Glance — أسرع وسيلة لتقرير ما تبدأ به.شاهد عند 1:48 - 6
انظر كيف تستخدم Claude Code فعلًا
يرسم قسم How You Use CC ما طلبته، والأدوات التي استخدمها Claude (Read وEdit وBash…)، ولغاتك، وأنواع الجلسات كالمهمة المفردة والصقل التكراري. اكتشف المبدع أعلاه أن سير عمله «خطّط ثم نفّذ» كان أكبر نقاط قوته.
رسوم الاستخدام من التقرير: أكثر الأدوات، اللغات، وأنواع الجلسات.شاهد عند 2:18 - 7
تفقد التفصيل حسب المشروع
يسرد What You Work On مشاريعك الأخيرة مع وصف لما بنيته في كل منها وعدد الجلسات التي استغرقها — طريقة سريعة لمعرفة أي مشروع استهلك أكثر المداخلات.
بطاقات المشاريع مع عدّاد الجلسات، من التسجيل الثاني.شاهد عند 1:25 - 8
واجه قسم الاحتكاك
يكمّم التقرير ما ساء: أنواع الاحتكاك الرئيسية كالشيفرة المعطوبة أو النهج الخاطئ، ودرجة رضا يقدّرها النموذج. تحته يقترح Existing CC Features to Try إضافات ملموسة — قواعد CLAUDE.md، وhooks، بل skill مخصص باسم /plan.
أنواع الاحتكاك وتقدير الرضا واقتراحات الميزات.شاهد عند 1:40
تحويل الملاحظات إلى إصلاحات (الخطوات 9–11)
- 9
استخدم كتل PASTE INTO CLAUDE CODE
كثير من الاقتراحات تأتي كأوامر جاهزة. هذا المثال يعرّف دورة بناء-تحقق-إصلاح: بعد كل تعديل شغّل فحص الأنواع، وحلل الأخطاء، وأصلحها كلها، وأعد البناء، وابحث (grep) عن كل استخدام للنوع المتغير. اضغط Copy والصقه في جلسة.
أمر جاهز للصق يولّده التقرير — لا حاجة لهندسة أوامر.شاهد عند 2:35 - 10
اطلب من الجلسة نفسها تلخيصه
التقرير طويل. اسأل Claude في الجلسة نفسها: «give me the top 3 actionable pieces of advice, summarized in less than 200 words» فتحصل على قائمة قصيرة مستخلصة من التقرير — ويمكنك مواصلة السؤال.
طلب أهم ثلاث خلاصات مباشرة بعد اكتمال التقرير.شاهد عند 2:55 - 11
دع Claude ينفّذ الإصلاحات
المخرجات النموذجية: إضافة ملفات اتفاقيات CLAUDE.md لكل مستودع، وإعداد hook بناء بعد كل تعديل في .claude/settings.json، وإضافة قاعدة «تتبّع كل الاستخدامات قبل الالتزام». قل نعم وسيكتب Claude مدخلات CLAUDE.md وإعداد الـhook عنك.
الإصلاحات الثلاثة المقترحة — كل منها يمكن لـ Claude تطبيقه مباشرة.شاهد عند 3:45
حفظ التقرير ومشاركته (الخطوة 12)
- 12
احتفظ بملف HTML أو شاركه
report.html ملف محلي مكتفٍ بذاته — أعد فتحه في متصفحك متى شئت أو أرسله لزميل. كل تشغيل يحفظ نسخة جديدة بطابع زمني، ويحذف التنظيف ما تجاوز cleanupPeriodDays (30 يومًا افتراضيًا).
التقرير يعيش على عنوان file:/// محلي — يعمل دون اتصال.شاهد عند 2:06
جديد في v2.1.281: توصية الوضع التلقائي
أضاف سجل تغييرات Claude Code v2.1.281 توصية وضع تلقائي إلى /insights: يقدّر التقرير الآن كم طلب إذن كان يمكن للوضع التلقائي معالجته في جلساتك الأخيرة. إن كانت أيامك تُقضى في الموافقات، فحدّث ثم أعد تشغيل /insights وانظر كم طلبًا كان سيمتصه الوضع التلقائي بحسب التقرير.
اقرأ إدخال سجل التغييرات v2.1.281