skill

مستكشف Lark Openapi

استكشاف OpenAPI الأصلي ل Feishu/Lark: البحث في مكتبة الوثائق الرسمية عن واجهات OpenAPI الأصلية غير المغلفة بواسطة CLI. يستخدم هذا عندما لا يمكن تلبية متطلبات المستخدم بواسطة مهارات lark-* الحالية أو الأوامر المسجلة في lark-cli، ويحتاج المستخدم إلى البحث عن واجهة Feishu OpenAPI الأصلية واستدعائها.

larksuite448,464+ تثبيتموثوق

نبذة

# مستكشف OpenAPI

> **المتطلبات المسبقة:** يرجى قراءة [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md) أولا لفهم المصادقة وتبديل الهوية وقواعد الأمان.

عندما لا يمكن تلبية متطلبات المستخدم **بواسطة skill موجود أو واجهة API مسجلة في CLI**، استخدم هذه المهارة للتنقيب تدريجيا عن واجهات OpenAPI الأصلية من مكتبة وثائق Markdown الرسمية ل Feishu، ثم استخدم `lark-cli api` لإجراء استدعاء مباشر لإكمال المهمة.

## هيكل مكتبة الوثائق

يتم تنظيم وثائق Feishu OpenAPI بشكل هرمي في Markdown:

``` llms.txt ← فهرس المستوى الأعلى، يسرد جميع روابط وثائق الوحدة └─ llms-<module>.txt ← وثيقة الوحدة، تتضمن نظرة عامة على الوظائف + روابط وثائق API الأساسية └─ <api-doc>.md ← وصف كامل لواجهة API واحدة (الأسلوب/المسار/المعلمات/الاستجابة/رموز الخطأ) ```

نقطة دخول الوثائق:

| العلامة التجارية | URL الدخول | |-----------------|------------| | Feishu | `https://open.feishu.cn/llms.txt` | | Lark | `https://open.larksuite.com/llms.txt` |

> جميع الوثائق مكتوبة **باللغة الصينية**. إذا كان المستخدم يتواصل باللغة الإنجليزية، يجب ترجمة محتوى الوثيقة إلى الإنجليزية قبل الإخراج.

## عملية التنقيب

اتبع الخطوات التالية بدقة للبحث طبقة تلو الأخرى، **لا تتخطى الخطوات أو تخمن واجهة API**:

### الخطوة 1: التأكد من عدم كفاية القدرات الحالية

```bash # تحقق أولا مما إذا كان هناك skill مطابق أو واجهة API مسجلة بالفعل lark-cli <الخدمة المحتملة> --help ```

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

### الخطوة 2: تحديد الوحدة من الفهرس العلوي

استخدم WebFetch للحصول على الفهرس العلوي، وابحث عن رابط وثيقة الوحدة ذات الصلة بالمتطلب:

``` WebFetch https://open.feishu.cn/llms.txt → استخراج السؤال: "اسرد جميع روابط وثائق الوحدة، وابحث عن الروابط المتعلقة ب <الكلمات المفتاحية لمتطلب المستخدم>" ```

- تستخدم علامة Feishu التجارية `open.feishu.cn` - تستخدم علامة Lark التجارية `open.larksuite.com` - إذا لم تكن متأكدا من علامة المستخدم التجارية، فاستخدم Feishu افتراضيا

### الخطوة 3: تحديد واجهة API المحددة من وثيقة الوحدة

استخدم WebFetch للحصول على وثيقة الوحدة، وابحث عن رابط وثيقة واجهة API المحددة:

``` WebFetch https://open.feishu.cn/llms-docs/zh-CN/llms-<module>.txt → استخراج السؤال: "ابحث عن وصف واجهة API وروابط الوثائق المتعلقة ب <متطلب المستخدم>" ```

### الخطوة 4: الحصول على المواصفات الكاملة لواجهة API

استخدم WebFetch للحصول على وثيقة واجهة API المحددة، واستخرج مواصفات الاستدعاء الكاملة:

``` WebFetch https://open.feishu.cn/document/server-docs/.../<api>.md → استخراج السؤال: "أعد مواصفات API الكاملة: طريقة HTTP، مسار URL، معلمات المسار، معلمات الاستعلام، حقول نص الطلب (الاسم/النوع/مطلوب/الوصف)، حقول الاستجابة، الأذونات المطلوبة، رموز الخطأ" ```

### الخطوة 5: استدعاء واجهة API عبر CLI

استخدم `lark-cli api` للاستدعاء المباشر:

```bash # طلب GET lark-cli api GET /open-apis/<path> --params '{"key":"value"}'

# طلب POST lark-cli api POST /open-apis/<path> --data '{"key":"value"}'

# طلب PUT lark-cli api PUT /open-apis/<path> --data '{"key":"value"}'

# طلب DELETE lark-cli api DELETE /open-apis/<path> ```

## مواصفات الإخراج

عند تقديم نتائج التنقيب للمستخدم، قم بتنظيمها بالتنسيق التالي:

1. **اسم ووظيفة واجهة API**: وصف موجز في جملة واحدة. 2. **طريقة HTTP والمسار**: `METHOD /open-apis/...` 3. **المعلمات الرئيسية**: قائمة بالمعلمات المطلوبة والمعلمات الاختيارية الشائعة. 4. **الأذونات المطلوبة**: قائمة بالنطاقات (scopes). 5. **مثال على الاستدعاء**: قدم أمر `lark-cli api` كاملا. 6. **ملاحظات**: قيود التردد، قيود خاصة، إلخ.

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

## قواعد الأمان

- **واجهات API من نوع الكتابة/الحذف** (POST/PUT/DELETE) يجب تأكيد نية المستخدم قبل الاستدعاء. - يوصى بمعاينة الطلب باستخدام `--dry-run` (إذا كان مدعوما). - لا تخمن مسارات أو معلمات واجهة API - يجب الحصول عليها وتأكيدها من الوثائق. - عند التعامل مع العمليات الحساسة (حذف مجموعة، إزالة أعضاء، إلخ)، اشرح للمستخدم نطاق التأثير.

## أمثلة على سيناريوهات الاستخدام

### السيناريو 1: يحتاج المستخدم إلى إضافة أشخاص إلى مجموعة (غير مغلفة في CLI)

```bash # الخطوة 1: التأكد من أن CLI لا تحتوي على تغليف lark-cli im --help # → اكتشاف عدم وجود أوامر create ذات صلة ب chat_members

# الخطوات 2-4: الحصول على مواصفات API من خلال التنقيب في الوثائق # → POST /open-apis/im/v1/chats/:chat_id/members

# الخطوة 5: الاستدعاء lark-cli api POST /open-apis/im/v1/chats/oc_xxx/members \ --data '{"id_list":["ou_xxx","ou_yyy"]}' \ --params '{"member_id_type":"open_id"}' ```

### السيناريو 2: يحتاج المستخدم إلى تعيين إعلان للمجموعة

```bash # الخطوة 1: التأكد من أن CLI لا تحتوي على تغليف lark-cli im --help # → لا توجد أوامر متعلقة ب announcement

# الخطوات 2-4: التنقيب في الوثائق # → PATCH /open-apis/im/v1/chats/:chat_id/announcement

# الخطوة 5: الاستدعاء lark-cli api PATCH /open-apis/im/v1/chats/oc_xxx/announcement \ --data '{"revision":"0","requests":["<html>محتوى الإعلان</html>"]}' ```

## المراجع

- [lark-shared](../lark-shared/SKILL.md) — المصادقة والمعلمات العامة - [lark-skill-maker](../lark-skill-maker/SKILL.md) — إذا كنت بحاجة إلى تحويل واجهة API التي تم التنقيب عنها إلى Skill جديد

التثبيت

شغل هذا الأمر

npx skills add larksuite/cli

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `npx skills add larksuite/cli`، أو استنسخ المستودع وانسخ مجلد `skills/lark-openapi-explorer` إلى دليل مهارات Claude الخاص بك.

عرض المصدر

أسئلة شائعة

ما هي مهارة مستكشف Lark Openapi؟

استكشاف OpenAPI الأصلي ل Feishu/Lark: البحث في مكتبة الوثائق الرسمية عن واجهات OpenAPI الأصلية غير المغلفة بواسطة CLI. يستخدم هذا عندما لا يمكن تلبية متطلبات المستخدم بواسطة مهارات lark-* الحالية أو الأوامر المسجلة في lark-cli، ويحتاج المستخدم إلى البحث عن واجهة Feishu OpenAPI الأصلية واستدعائها.

كيف أثبت مستكشف Lark Openapi؟

شغل هذا الأمر في الطرفية:

npx skills add larksuite/cli
مع أي أدوات ذكاء اصطناعي تعمل مستكشف Lark Openapi؟

تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.

من طور مستكشف Lark Openapi؟

طورها larksuite.

هل مستكشف Lark Openapi مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في الإنتاجية والمكتب.

كل بدائل مستكشف Lark Openapi ←
skillclaude_appclaude_codeclaude_api
npx skills add vercel-labs/skills
البحث عن المهارات
يساعد المستخدمين على اكتشاف وتثبيت مهارات الوكلاء عندما يطرحون أسئلة مثل "كيف أفعل X؟"، "ابحث عن مهارة ل X"، "هل توجد مهارة يمكنها..."، أو يعبرون عن ا…3,611,572+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
استخدام الوسائط
احصل على أو أنشئ أي وسائط لفيديو HyperFrames - موسيقى، مؤثرات صوتية، صور، أيقونات، شعارات، تعليق صوتي، صورة رمزية وفيديو مولد، نصوص، قصاصات، درجات ألو…1,085,267+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تحسين هيكلية قاعدة الكود
افحص قاعدة بيانات برمجية بحثا عن فرص للتحسين والتعميق، وقدمها كتقرير HTML مرئي، ثم تعمق في أي فرصة تختارها.1,040,100+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تسليم المهام
لخص المحادثة الحالية في وثيقة تسليم ليتابعها وكيل آخر.946,569+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
فرز أولي
نقل المشكلات وطلبات السحب الخارجية عبر آلة حالة لأدوار الفرز، وتصنيفها، والتحقق منها، والتدقيق فيها عند الحاجة، وكتابة ملخصات جاهزة للوكلاء.881,979+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تعليم
علم المستخدم مهارة أو مفهوما جديدا ضمن مساحة العمل هذه.778,928+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في الإنتاجية والمكتب