skill
مشاركة Lark
يستخدم لمهام إعداد/مصادقة lark-cli: تسجيل الدخول/الحالة/تسجيل الخروج للمصادقة، هوية المستخدم مقابل الروبوت، أذونات نطاق العمل (--domain، بما في ذلك all/docs/drive)، النطاقات المفقودة، إلغاء التفويض، أو التعامل مع _notice JSON.
نبذة
# قواعد مشاركة lark-cli
القاعدة الأساسية المشتركة لجميع مهارات `lark-*`: الهوية، المصادقة، عقد الإخراج، والعمليات عالية المخاطر.
## المبادئ التوجيهية العامة
1. **تأكيد الاستخدام قبل الاستدعاء**: اقرأ المرجع المقابل أو قم بتشغيل `--help` قبل التنفيذ، لا تخمن الأعلام وتستدعي بشكل أعمى.
2. **الهوية تحدد من تمثل في العملية**: `--as user` يمثل المستخدم نفسه (يمكنه رؤية والتحكم في تقويمه، مساحته السحابية/محرك الأقراص السحابي/التخزين السحابي، وغيرها من الموارد الشخصية)، بينما `--as bot` يمثل التطبيق نفسه، وهي عملية على مستوى التطبيق، ولا يمكنه الوصول إلا إلى موارد البوت الخاصة به. سيؤدي استعلام البوت عن موارد المستخدم إلى إرجاع نجاح فارغ بدلا من خطأ. تأكد من فهم الهوية `identity` قبل البدء. نموذج الهوية وإدارة الأذونات ← [`lark-shared-identity-and-permissions.md`](references/lark-shared-identity-and-permissions.md).
3. **يجب أن تحتوي عناوين URL الخاصة بالتفويض/التكوين على رمز QR**: عندما يخرج الأمر حقول URL مثل `verification_url`، `verification_uri_complete`، `console_url`، وما إلى ذلك، يجب استخدام `lark-cli auth qrcode` لإنشاء وعرض رمز QR في الرد، مع وضع URL أولا ثم رمز QR. الأولوية لإنشاء PNG (`--output`)، واستخدام ASCII (`--ascii`) فقط عندما يطلب المستخدم ذلك صراحة. قم بإعادة توجيه URL كما هو - لا تقم بترميزه أو فك ترميزه، ولا تضف علامات ترقيم، ولا تعيد بناء الاستعلام. يرجى عرض رمز QR والرابط معا للمستخدم.
4. **تحت `--format json` (افتراضي)، استخدم `ok == true` (أو رمز خروج العملية 0) للحكم على النجاح، لا تستخدم `code == 0`**: لا يحتوي غلاف النجاح على حقول `code` / `msg` علوية، ويظهر `code` فقط داخل `error` في غلاف الخطأ. سيؤدي الحكم وفقا لتنسيق OpenAPI القديم `{"code": 0, "msg": "ok"}` إلى الحكم بشكل خاطئ على جميع الاستدعاءات الناجحة على أنها فاشلة - وهذا خطير بشكل خاص عند تغليف أوامر الكتابة. عقد إخراج JSON ← [`lark-shared-output-contract.md`](references/lark-shared-output-contract.md).
## قواعد الأمان
1. **يحظر إخراج المفاتيح السرية** (مثل appSecret، accessToken) كنص عادي إلى الطرفية.
2. **يجب تأكيد نية المستخدم قبل عمليات الكتابة/الحذف**.
3. عندما يدعم الأمر المستهدف `--dry-run`، استخدم `--dry-run` لمعاينة الطلبات الخطيرة.
4. **رمز الخروج 10 هو بوابة تأكيد عالية المخاطر (`risk: "high-risk-write"`)، وليس خطأ**: توقف ← **اطلب تأكيد المستخدم** (اعرض `action`، `risk`، والمعلمات الرئيسية) ← بعد الحصول على **موافقة صريحة من المستخدم**، أضف علامة التأكيد المشار إليها بواسطة `hint` **إلى نهاية argv الأصلي الخاص بك** ثم أعد المحاولة؛ **لا تقم أبدا** بتجاوز ذلك بإضافة علامة التأكيد بصمت ← [`lark-shared-high-risk-approval.md`](references/lark-shared-high-risk-approval.md).
5. **مسارات الملفات تقبل فقط المسارات النسبية**: معلمات المسار مثل `--file`، `--output`، `--output-dir`، `@file` تقبل فقط المسارات النسبية ضمن دليل العمل الحالي (cwd). سيؤدي تمرير مسار مطلق إلى الإبلاغ عن `unsafe file path`. يجب إدخال البيانات (باستخدام `@file`، JSON كبير) عبر stdin أولا لتجنب مشاكل المسار والهروب.
## فهرس تشغيل المرجع القوي
عند استيفاء أي من شروط التشغيل، **يجب قراءة المرجع المقابل قبل تنفيذ الخطوة التالية**. إذا تم استيفاء شروط متعددة، اقرأها بالترتيب الموضح في الجدول، مع قراءة كل مرجع مرة واحدة فقط.
| شرط التشغيل القوي (يجب القراءة عند استيفاء أي شرط) | المرجع | |---|---| | معرفة من أنت (مستخدم/بوت)، الحصول على معلومات تفصيلية عن حقول الهوية الحالية، تشخيص الهوية، منطق اختيار `--as`، استمرارية الهوية، حالة تسجيل الدخول، المصادقة، النطاق، إدارة التفويض والأذونات، `missing_scopes` أو `console_url`، Agent يستعد لبدء أو إكمال `auth login` | [`lark-shared-identity-and-permissions.md`](references/lark-shared-identity-and-permissions.md) | | الحاجة إلى الاعتماد على عقد إخراج JSON للحكم على النجاح/الفشل، قراءة stdout/stderr، أو كتابة نصوص برمجية وتغليف للأوامر | [`lark-shared-output-contract.md`](references/lark-shared-output-contract.md) | | الاستعداد لتنفيذ high-risk-write (عملية عالية المخاطر)، الحكم على مستوى مخاطر الأمر، مواجهة رمز الخروج 10، `confirmation_required`، إعادة المحاولة بعد التأكيد | [`lark-shared-high-risk-approval.md`](references/lark-shared-high-risk-approval.md) | | الاستخدام الأول ل CLI يتطلب تشغيل `lark-cli config init` لإكمال تكوين التطبيق، أو عندما يشير CLI بوضوح إلى `config init --new` | [`lark-shared-config-init.md`](references/lark-shared-config-init.md) | | استفسار المستخدم عن إشعار، تحديث إصدار CLI، أو إخراج يحتوي على `_notice` (تحديث/مهارات متأخرة/تلميحات أوامر مهملة) | [`lark-shared-update-notice.md`](references/lark-shared-update-notice.md) |
التثبيت
شغل هذا الأمر
npx skills add larksuite/cliيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add larksuite/cli`، أو استنسخ المستودع وانسخ مجلد `skills/lark-shared` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة مشاركة Lark؟
يستخدم لمهام إعداد/مصادقة lark-cli: تسجيل الدخول/الحالة/تسجيل الخروج للمصادقة، هوية المستخدم مقابل الروبوت، أذونات نطاق العمل (--domain، بما في ذلك all/docs/drive)، النطاقات المفقودة، إلغاء التفويض، أو التعامل مع _notice JSON.
كيف أثبت مشاركة Lark؟
شغل هذا الأمر في الطرفية:
npx skills add larksuite/cliمع أي أدوات ذكاء اصطناعي تعمل مشاركة Lark؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور مشاركة Lark؟
طورها larksuite.
هل مشاركة Lark مجانية؟
نعم، يمكنك استخدامها مجانا.
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add microsoft/azure-skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى