سجل المهارات
مسارات عمل التطويرالمهارات العامة

Code Search & Navigation

ذكاء الكود لوكلاء الذكاء الاصطناعي — البحث الدلالي، البحث عن الرموز، مخططات الاستدعاء، رسم تبعيات، تحليل نطاق التأثير، وحل الملكية عبر mcp-code-search.

ما تعلمه هذه المهارة

دليل قابل لإعادة الاستخدام لنوع معين من العمل.

يخبر خادم MCP الوكيل بالإجراءات المتاحة. تضيف المهارة الحكم حول تلك الإجراءات: كيفية التعرف على المهمة، التسلسل الذي يجب اتباعه، ما يجب تجنبه، وكيفية تحديد اكتمال النتيجة.

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

الهيكلية

كيف يوجه Code Search & Navigation وكيل ADK-Rust.

تبقى المهارة قابلة للقراءة وقابلة للنقل لأنها تحتوي على تعليمات بدلاً من بيانات اعتماد الخدمة أو بيانات العمل. يوفرها ADK-Rust للوكيل، يختار الوكيل من حدود الأدوات المراجعة، ويؤدي خادم MCP المتصل العملية المصادق عليها.

01

طلب المستخدم

يتلقى الوكيل هدفًا معبرًا عنه بلغة عادية.

02

مهارة Code Search & Navigation

يطابق النية، يزود دليل القرار، ويضيق حدود الأداة.

03

وكيل ADK-Rust

يخطط سير العمل ويبث كل خطوة ذات معنى عبر بيئة التشغيل.

04

mcp-code-search

ينفذ العمليات المصادق عليها ضد النظام الذي يمتلك القدرة.

05

النتيجة الموثوقة

تشكل قواعد إكمال المهارة الأدلة التي تُعاد إلى المستخدم.

تعليمات محمولة: SKILL.md · حدود القدرة: mcp-code-search · الأدوات المسموح بها: 8

دليل القرار

كيف يحول الوكيل الطلب إلى الإجراء الصحيح.

تأتي هذه المسارات مباشرة من تعليمات المهارة. تساعد النموذج على التعرف على النية واختيار أداة أو سير عمل مركّز بدلاً من الارتجال عبر كامل سطح القدرة.

01

"find", "where is", "search code"?

semantic_search

02

"definition", "what is", "symbol"?

lookup_symbol / explain_symbol

03

"who calls", "callers", "call graph"?

call_graph

04

"depends on", "dependency"?

dependency_graph

05

"who owns", "reviewer", "owner"?

codeowners

06

"context", "all files for"?

context_pack

07

"references", "usages", "used where"?

find_references

سير عمل مثبتة

تسلسلات قابلة للتكرار لنتائج مفيدة.

يربط سير العمل عدة استدعاءات أدوات في مهمة يتعرف عليها المستخدم فعليًا. تشرح المهارة التسلسل والنتيجة المقصودة بينما يقوم ADK-Rust ببث تقدم الوكيل عبر بيئة التشغيل المشتركة.

011 استدعاء

إيجاد الكود

بحث دلالي عبر المستودعات

022-3 استدعاء

فهم الرمز

التعريف + مخطط الاستدعاء + المالكين

032-3 استدعاء

نطاق التأثير

تحليل التأثير قبل التغييرات

041 استدعاء

بناء السياق

جميع الملفات اللازمة لمهمة

حدود الأداة

قد تستخدم المهارة 8 أدوات موثقة.

يتم إعلان هذه القائمة المسموح بها من قبل المهارة. تحافظ على تركيز الوكيل على الإجراءات اللازمة لهذه المهمة بينما يحتفظ mcp-code-search بالمسؤولية عن المصادقة، التحقق، والنظام المتصل.

semantic_search
lookup_symbol
find_references
call_graph
dependency_graph
codeowners
context_pack
explain_symbol

قواعد العمل

ما الذي يجب على الوكيل القيام به.

  • تضمين مسارات الملفات وأرقام الأسطر في جميع النتائج
  • عرض نطاق التأثير قبل التوصية بالتغييرات
  • توجيه المراجعات إلى مالكي الكود

حدود التشغيل

ما الذي يجب على الوكيل تجنبه.

  • راجع SKILL.md الكامل قبل تمكين هذه المهارة للعمل الإنتاجي.

التثبيت والاتصال

أضف المهارة بجانب القدرة التي تتوقعها.

ثبت المستودع حيث يمكن لمحمّل مهارات ADK-Rust اكتشافه، اتصل بـ mcp-code-search، وتأكد من توفر الأدوات المعلنة قبل طلب الوكيل استخدام سير العمل.

ثبت المهارة
git clone https://github.com/zavora-ai/skill-code-search-navigation.git \
  ~/.skills/skills/code-search-navigation
شكل تحميل ADK-Rust
let skills = SkillLoader::from_dir("~/.skills/skills").await?;
let skill = skills.load("code-search-navigation").await?;

let agent = LlmAgentBuilder::new("agent")
    .instruction(skill.instructions())
    .tools(skill.allowed_tools(toolset)?)
    .build()?;

بيان التوافق الخاص بالمستودع: يتطلب اتصال بخادم mcp-code-search.

الوثائق الرسمية

اقرأ حزمة المهارة الكاملة.

يبقى المستودع هو المرجع الدقيق لتعليماته، أمثلته، سكريبتات المساعدة، الأصول، متطلبات MCP، الترخيص، والتحديثات اللاحقة.

سجل المصدر

بيانات المستودع لهذا الإدخال في المهارة.

عرض المستودع العام ↗
الرخصة
Apache-2.0
الأدوات المسموح بها
8
المراجع
3
المراجعة
983ea87d4b08
تم التحديث
31 مايو 2026