بناء الموصل

# بناء موصل

حول أداة غير مدعومة إلى أداة متصلة.

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

## الخطوة 1 — جمع المتطلبات

قبل أي شيء آخر: ما الذي نتصل به، وما الذي نحتاجه منه، وكيف يجب أن يعمل. اجمع هذه الأربعة أشياء:

1. **النظام الدقيق.** احصل على المنتج الدقيق، وليس الفئة — "نظام ERP الخاص بي" قد يكون أي واحد من أربعين شيء، والإجابة تختلف لكل واحد. اطلب عنوان URL لتسجيل الدخول إذا كان الاسم غامضا؛ فهو عادة ما يحدد المنتج والإصدار فورا. 2. **ابحث عنه فورا.** في اللحظة التي تحصل فيها على الاسم الدقيق — لا تنتظر الخطوة 2 — اتبع `reference/discovery.md`، القسم 1، الآن، واحتفظ بالنتيجة. الخطوة 2 تفسرها بدلا من البحث مجددا. 3. **ما يحتاجه المالك فعليا.** ما البيانات التي تخرج، أو ما الإجراء الذي يدخل — وكم مرة. 4. **أي مهارة أو سير عمل يفتح هذا.**

**النطاق هو ما يبقي هذا بعد ظهر اليوم وليس مشروعا.** "ربط ERP الخاص بي" غير محدود. "سحب أوامر العمل المفتوحة يوميا بحيث تظهر في الإيجاز الصباحي" قابل للبناء اليوم. اترك هذه الخطوة بهذا النوع من النطاق الضيق والفردي والقابل للاختبار — وليس فئة من الاحتياجات.

## الخطوة 2 — الاكتشاف

اقرأ `reference/discovery.md` واتبعه بالترتيب: موصل Claude الأصلي أولا؛ ثم Zapier، مسار البناء لكل شيء يفتقده الدليل؛ ثم تصدير مجدول عندما تكون الأداة على أي منهما؛ ثم رفض صريح. API الموثق هو سياق، ليس أبدا مسار بناء. اقرر النتيجة قبل بناء أي شيء — التكلفة والجهد والعائق في ثلاثة أسطر، بالصيغة الموجودة في نهاية `discovery.md`.

تحقق أيضا مما إذا كانت الحاجة الحقيقية مغطاة بطريقة أخرى — عادة ما تكون خطوة نطاق أو DNS كنت على وشك بنائها يدويا. حصة مفاجئة من طلبات "الاتصال بهذه الأداة" تنتهي في سجل TXT للتحقق أو CNAME يضيفه المالك في المسجل الخاص به، ويتم حلها بإخبارهم بالسجل الدقيق بدلا من بناء شيء.

| المسار | متى | |---|---| | موصل Claude الموجود | موجود في الدليل. دائما أولا — اتصل، لا تبني. | | اتصال Zapier | كل شيء آخر موجود على Zapier. مسار البناء عندما لا يوجد للدليل شيء. | | تصدير مجدول | ليس على Zapier، لكن الأداة يمكنها إرسال بريد إلكتروني أو حذف ملف | | لا شيء قابل للحياة | نادر. قل ذلك بصراحة وسمِّ ما يمكن للمالك تصديره يدويا |

**فضل الخيار الممل.** تصدير CSV مجدول لا يفشل أبدا يفوق التكامل الذكي الذي يفشل بصمت في نوفمبر. لا يمكن للمالكين تصحيح موصل معطوب، وموصل يفشل بصمت أسوأ من عدم وجود واحد. المقايضات لكل مسار موجودة في `reference/paths.md`.

## الخطوة 3 — اتصل

اتبع التعليمات لأي شيء وجدته الخطوة 2:

- **موصل Claude الموجود أو أداة MCP:** اتصل به مباشرة — تثبيت، مصادقة، تحقق من النطاق. عادة دقائق. - **Zapier:** اتبع `reference/use-zapier.md` — مصادقة، توصيل حساب التطبيق الخاص به، تفعيل الإجراءات التي سماها النطاق بالضبط، والاختبار مقابل حالة استخدام المالك. - **تصدير مجدول:** قم بإعداده وفقا لـ `reference/paths.md`، القسم 3، بما في ذلك فحص القدم.

**بيانات الاعتماد، أي مسار.** اطلب أضيق نطاق يقوم بالعمل — قراءة فقط إلا إذا كانت الكتابة مطلوبة حقا. Tokens و OAuth فقط؛ لا تطلب كلمة مرور أبدا، وإذا كان النظام يوفر فقط مصادقة كلمة المرور، قل ذلك واترك المالك يقرر مع العلم بذلك. بيانات الاعتماد تدخل في تخزين المنصة الخاصة بها، ليس أبدا ملف أو موجه أو URL. يفضل مستخدم تكامل مخصص على بيانات اعتماد المالك الخاصة، بحيث يمكن إلغاء الوصول دون قفل الوصول. وقل ما الذي سيصل إليه الموصل بوضوح قبل إنشاؤه. الحالات المعملية موجودة في `reference/gotchas.md`.

## الخطوة 4 — اختبر مقابل البيانات الحقيقية بشكل مرئي

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

``` سحب 12 أمر عمل مفتوح. الثلاثة الأولى:

WO-4471 خاصية Ridgeline وحدة سقف 3 — لا تبريد مخصصة ل Teri WO-4468 Corwin & Bay PM ربع سنوي غير مخصصة WO-4465 Fairmount تغيير المرشح مكتملة

يبدو صحيح؟ هل هناك شيء مفقود كنت تتوقع رؤيته؟ ```

كل إجراء كتابة يحصل على بوابة موافقة قبل تشغيله، بغض النظر عما طلبه المالك. موصل يمكنه تعديل نظام سجل المالك دون السؤال ليس شيء يجب شحنه.

## الخطوة 5 — سجل وسلم

1. **سجل الموصل بحيث يمكن للمهارات استخدامه.** لاحظ ما يصل إليه، وما لا يمكنه فعله، وكيف ينتعش. 2. **سمِّ المهارات التي يخدمها الآن،** ولاحظ الصف لـ `skills/smb-router/reference/connector-m