Habilidades codebase-search
🔍

codebase-search

Seguro

البحث في قواعد الكود مثل المحترفين

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

Soporta: Claude Codex Code(CC)
📊 71 Adecuado
1

Descargar el ZIP de la skill

2

Subir en Claude

Ve a Configuración → Capacidades → Skills → Subir skill

3

Activa y empieza a usar

Pruébalo

Usando "codebase-search". Find where user authentication is implemented

Resultado esperado:

I found the authentication flow in this codebase:

1. Entry point: routes/auth.py (POST /login, POST /register)
2. Controller: controllers/auth.py - AuthController handles requests
3. Service: services/auth_service.py - contains verify_credentials() and create_token()
4. Model: models/user.py - User model with password_hash field

The flow is: request → route → controller → service → model

See auth_service.py:45 for the main verification logic.

Usando "codebase-search". Find all usages of process_payment function

Resultado esperado:

Found 8 call sites for process_payment():

1. controllers/checkout.py:89 - checkout_complete()
2. services/subscription.py:156 - renew_subscription()
3. services/order.py:234 - finalize_order()
4. api/webhooks.py:67 - handle_payment_webhook()
5. tests/test_payment.py:12,45,78 - test cases

All calls pass through the payment gateway at services/payment_gateway.py

Auditoría de seguridad

Seguro
v1 • 3/10/2026

All 62 static findings are false positives. The skill contains only documentation with example bash/grep commands in markdown code blocks (mistaken for shell execution), reference URLs (not network calls), and example search terms (not actual secrets). This is a safe documentation skill.

2
Archivos escaneados
556
Líneas analizadas
0
hallazgos
1
Auditorías totales
No se encontraron problemas de seguridad

Patrones detectados

External Commands False PositiveHardcoded URLs False PositiveAPI Key Access False PositiveEnvironment File Access False PositiveCritical Heuristic False Positive
Auditado por: claude

Puntuación de calidad

38
Arquitectura
100
Mantenibilidad
87
Contenido
33
Comunidad
100
Seguridad
87
Cumplimiento de la especificación

Lo que puedes crear

إصلاح خطأ

تتبع رسالة الخطأ إلى مصدرها، والعثور على جميع المواقع التي يتم فيها استدعاء دالة ما، وفهم تدفق البيانات الذي يسبب المشكلة.

تعلم قاعدة كود جديدة

اكتشاف نقطة الإدخال والمسارات الرئيسية ونماذج البيانات وتكوين مشروع غير مألوف لفهة هيكله.

الاستعداد لإعادة الهيكلة

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

Prueba estos prompts

بحث أساسي في الكود 
Find where [function/class name] is defined in this codebase. Use semantic search first, then grep to verify the exact location.
تتبع الأخطاء 
I need to find where this error originates: [error message]. Search for where this error is thrown and trace back to understand what triggers it.
فهم الاستخدام 
Show me all the places where [function_name] is called. Then read each call site to understand how it's used in different contexts.
اكتشاف الهندسة 
Help me understand how [feature] works end-to-end. Find the entry point, trace through controllers/services, and identify the data flow.

Mejores prácticas

  • ابدأ بالبحث الدلالي للأسئلة المفاهيمية، ثم صقل باستخدام grep للتطابقات الدقيقة
  • استخدم استهداف المجلدات لتضييق نطاق البحث وتجنب النتائج المفرطة
  • اجمع بين استراتيجيات البحث المتعددة: ابحث عن التعريف، ثم ابحث عن جميع الاستخدامات، ثم اقرأ السياق

Evitar

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

Preguntas frecuentes

ما الفرق بين البحث الدلالي و grep؟
البحث الدلالي يجد الكود بالمعنى - جيد للأسئلة المفاهيمية مثل 'كيف يعمل المصادقة'. يجد grep النص أو الأنماط الدقيقة - جيد عندما تعرف مصطلحات محددة مثل أسماء الدوال.
كيف أجد جميع استدعاءات دالة ما؟
أولاً استخدم grep للعثور على تعريف الدالة، ثم ابحث عن اسم الدالة مع أقواس مثل 'function_name(' للعثور على جميع مواقع الاستدعاء.
هل يمكن لهذه المهارة تعديل الكود؟
لا، هذه المهارة تبحث وتقرأ الملفات فقط. تستخدم أدوات Read و Grep و Glob للعثور على المعلومات ولكن لا يمكنها كتابة أو تحرير الكود.
كيف أبحث في مجلد محدد؟
استخدم معلمة Target في البحث الدلالي لتحديد المجلدات مثل ['backend/auth/'] أو أضف وسيطات المسار إلى أوامر grep.
ماذا لو كانت نتائج بحثي كثيرة جداً؟
أضف استهداف المجلدات لتضييق النطاق، واستخدم أنماطاً أكثر تحديداً، وافلتر حسب نوع الملف باستخدام --type، أو استخدم عبارات دقيقة بعلامات تنصيص.
كيف أفهم قاعدة كود جديدة بسرعة؟
ابدأ بالبحث الدلالي لـ 'أين يبدأ التطبيق؟'، ثم اعثر على المسارات الرئيسية ونماذج البيانات والتكوين. استخدم glob للعثور على نقاط الإدخال مثل main.py أو index.js.

Detalles del desarrollador

Licencia

MIT

Repositorio

https://github.com/supercent-io/skills-template/tree/main/.agent-skills/codebase-search/

Ref.

main

Estructura de archivos

📄 SKILL.md

📄 SKILL.toon