skill
مستكشف Lark Openapi
استكشاف OpenAPI الأصلي ل Feishu/Lark: البحث في مكتبة الوثائق الرسمية عن واجهات OpenAPI الأصلية غير المغلفة بواسطة CLI. يستخدم هذا عندما لا يمكن تلبية متطلبات المستخدم بواسطة مهارات lark-* الحالية أو الأوامر المسجلة في lark-cli، ويحتاج المستخدم إلى البحث عن واجهة Feishu OpenAPI الأصلية واستدعائها.
نبذة
# مستكشف 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يعمل مع
خطوات التثبيت
ثبت باستخدام `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 مجانية؟
نعم، يمكنك استخدامها مجانا.
npx skills add vercel-labs/skills
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى