تخطَّ إلى المحتوى

محسّن وصف الأدوات

⬇ تنزيل vsha-41b13a46bbef

SHA-256: 41b13a46bbef336c36f05dc28e6d709a4e4e089cf5b501bba7b43c4f0bd33b40 2 كيلوبايت

✦ جاهزة لبيئة عملك

ثبّت هذه المهارة مباشرة داخل وكيلك

اختر الوكيل، انسخ الأمر، وشغّله من مجلد مشروعك. يتولى CLI تنزيل الحزمة والتحقق من بصمة SHA-256 ووضع الملفات في المسار المناسب.

$npx @ai-dalil/skills add tool-description-optimizer --agent codex

@ai-dalil/skills على npm - Node.js 18.18 أو أحدث.

الوصف

عربي

يعيد كتابة أوصاف أدوات الوكيل لتوضيح متى تُستخدم ومتى لا، ويميّز الأدوات المتقاربة بخط استخدام حاسم يمنع الخلط.

English

Rewrite tool descriptions to state when to use and when not, disambiguating similar tools with decisive usage lines.

بيانات المهارة التقنية

SKILL name
tool-description-optimizer
الوصف الأصلي
Rewrite tool descriptions to state when to use and when not, disambiguating similar tools with decisive usage lines.
إصدار المهارة
1.2.0
التوافق
وكيل يدعم Agent Skills · اختبارات قبل الاعتماد
الأدوات المسموح بها
Read, Write
الكلمات المفتاحية
tools, agent-design, mcp, descriptions
لغة المصدر
multilingual
الفرع / المرجع
main
دليل الترخيص
Original editorial content authored for the AiDalil catalog and released under MIT by the catalog owner. (high)

بيانات المصدر الأصلية (YAML)

عرض Frontmatter الأصلي
name: tool-description-optimizer
description: Rewrite tool descriptions to state when to use and when not, disambiguating similar tools with decisive usage lines.
version: 1.2.0
metadata:
  author: AiDalil Editorial
  category: ai-agent-design
  compatibility: cursor, trae, claude-desktop, crush, droid, api
  difficulty: intermediate
  tags: [tools, agent-design, mcp, descriptions]

تعليمات SKILL.md

المحتوى الأصلي للمهارة كما ورد من المصدر، مع الحفاظ على تنسيق Markdown.

عرض التعليمات الكاملة
# Tool Description Optimizer

**Goal:** Rewrite tool descriptions to state when to use and when not, disambiguating similar tools with decisive usage lines.

> الهدف: يعيد كتابة أوصاف أدوات الوكيل لتوضيح متى تُستخدم ومتى لا، ويميّز الأدوات المتقاربة بخط استخدام حاسم يمنع الخلط.

## When to use
- الحالة النموذجية: يعيد كتابة أوصاف أدوات الوكيل لتوضيح متى تُستخدم ومتى لا، ويميّز الأدوات المتقاربة بخط استخدام حاسم يمنع.
- ضبط التكلفة وزمن الاستجابة دون فقدان الجودة.
- اختيار الأدوات المناسبة وتحديد صلاحياتها.
- تصميم وكيل جديد أو تحسين سلوك وكيل قائم.
- تصميم الذاكرة وإدارة السياق الطويل.

## Workflow
1. اكتب تعليمات النظام كدور ثم قواعد ثم إجراءات ثم أمثلة.
2. حدّد سياسة الرفض والحدود الأخلاقية والأمنية صراحة.
3. أنتج بطاقة وكيل: القدرات، الحدود، والمخاطر المعروفة.
4. ابنِ مجموعة تقييم: حالات نجاح وحالات فشل مرغوب وحالات غامضة.
5. عدّل متغيراً واحداً في كل جولة تقييم ووثّق الفرق.
6. قيّس الجودة والتكلفة وزمن الاستجابة على المجموعة قبل أي تعديل.
7. عرّف الوكيل: محسّن وصف الأدوات. اذكر المهمة والمستخدم وحدود السلطة بوضوح.
8. حدّد الأدوات: لكل أداة وصف دقيق ومتى تستخدم ومتى لا تستخدم.

## Rules
- سلوك الرفض يُصمم بلطف ووضوح مع بديل مفيد.
- لا تسلّم قراراً حساساً للوكيل دون نقطة موافقة بشرية.
- الأمثلة القليلة الجيدة تتفوق على فقرات إرشاد طويلة.
- السجلات توثق القرارات للتحسين اللاحق دون كشف أسرار.
- كل أداة قوية تحتاج قيداً واضحاً وتحققاً قبل التنفيذ.

## Output contract
- مجموعة تقييم ونتائج مقارنة.
- مواصفات أدوات بحدود واضحة.
- قائمة تعديلات مقترحة بالأثر الأعلى.
- بطاقة وكيل بالقدرات والحدود.

## Quality checks
- [ ] هل تُقاس التكلفة والزمن مع الجودة في كل جولة؟
- [ ] هل نقاط الموافقة البشرية موضوعة في الأماكن الصحيحة؟
- [ ] هل بطاقة الوكيل محدثة بعد آخر تعديل؟
- [ ] هل وصف كل أداة يفرّقه بوضوح عن الأدوات المشابهة؟
- [ ] هل تعليمات النظام خالية من التناقض والتكرار المضلل؟

## Skill identity
- Skill name: `tool-description-optimizer`
- Version: 1.2.0
- Domain: AI Agent Design (تصميم وكلاء الذكاء الاصطناعي)
- Tags: tools, agent-design, mcp, descriptions

التثبيت اليدوي

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

  1. نزّل ملف ZIP للإصدار المطلوب من أعلى الصفحة، أو افتح المصدر الأصلي إذا لم تتوفر حزمة مستضافة.
  2. فك الضغط، ثم انقل مجلد المهارة الذي يحتوي مباشرة على SKILL.md إلى مجلد الوكيل.
  3. أعد تحميل الوكيل أو افتح جلسة جديدة، ثم تأكد من ظهور المهارة ضمن المهارات المتاحة.
Codex.agents/skills/tool-description-optimizer/
Claude Code.claude/skills/tool-description-optimizer/
Cursor.cursor/skills/tool-description-optimizer/

تعليمات خاصة بهذه المهارة

Extract the skill folder into your agent's skills directory (for example the project skills folder) or install the ZIP package from the skill page. No build step is required; everything is Markdown.

حالات الاستخدام

• تصميم وكيل جديد أو تحسين سلوك وكيل قائم. • تصميم الذاكرة وإدارة السياق الطويل. • ضبط التكلفة وزمن الاستجابة دون فقدان الجودة.

المتطلبات

• Any Agent Skills compatible assistant (Claude Code, Claude Desktop, or API agents). • Basic file access to read the bundled reference playbook. • No external services required for the standard workflow.

الإصدارات

الإصدار الحجم الملفات تاريخ النشر تنزيل
vsha-41b13a46bbef 2 كيلوبايت 2 4 نوفمبر، 2026 تحميل

الأمان والفحص

فحص أساسي ✓ — 1 نوفمبر، 2026