skill

الساحر

أنشئ معالج bash تفاعليا يرشد المستخدم البشري عبر خطوات لا يمكن إلا له تنفيذها. استخدمه عند توفير البنية التحتية، أو إعداد بيانات الاعتماد أو أسرار CI، أو التنقل في لوحة تحكم طرف ثالث غير مألوفة، أو تشغيل عملية ترحيل أو تحويل لمرة واحدة. لا تستدعه للخطوات التي يمكن للوكيل تنفيذها بنفسه.

mattpocock424,988+ تثبيتموثوق

نبذة

# المعالج (Wizard)

**المعالج (wizard)** هو نص برمجي (bash script) يرشد المستخدم خطوة بخطوة خلال إجراء يدوي ممل يصعب القيام به يدويا ويصعب إعادة شرحه للذكاء الاصطناعي في كل مرة. يفتح كل URL، ويحدد بالضبط ما يجب النقر عليه ونسخه، ويلتقط القيم، ويكتبها في مكانها الصحيح (`.env`، GitHub secrets)، ويؤكد في كل مرحلة، ويظهر عدد المراحل المتبقية. قد يقوم بتكوين خدمات طرف ثالث، أو تشغيل ترحيل لمرة واحدة، أو نقل المشروع من حالة إلى أخرى.

تجربة المستخدم الممتعة تم حلها بالفعل بواسطة [template.sh](template.sh): تقدم مرحلة تلو الأخرى، بوابات تأكيد، فتح URL عبر الأنظمة الأساسية (بما في ذلك WSL)، إدخال سري مخفي، تحديثات `.env` متكررة، كتابة `gh secret`/`gh variable`، وملخص ختامي. **مهمتك الوحيدة هي تحديد نطاق الإجراء وتأليف مراحله.** المكتبة الموجودة فوق علامة `STAGES` متطابقة في كل معالج؛ هذا الاتساق هو الهدف: لا تقم بتحريرها يدويا أبدا.

المعالج مؤقت بشكل افتراضي: مصمم لتشغيل واحد، يتم حفظه في مسار مؤقت أو `scripts/`، ويتم حذفه عند الانتهاء من المهمة. قم بتثبيته (commit) فقط عندما يريد المستخدم مسار إعداد قابل للتكرار يجب أن يبقى في المستودع.

## العملية

### 1. تحديد نطاق الإجراء

حدد كل خطوة يدوية يجب على المستخدم اتخاذها وكل قيمة يتم التقاطها على طول الطريق. اقرأ المستودع أولا، لا تسأل بشكل عشوائي:

- للإعداد: `.env`، `.env.example`، `.env.*`، `README`، `docker-compose*`، إعدادات الإطار، و`.github/workflows/*` (كل مرجع `secrets.*` / `vars.*` هو قيمة يجب أن ينتجها المعالج). - للترحيل أو الانتقال: الحالة الحالية، الحالة المستهدفة، والإجراءات غير القابلة للإلغاء بينهما.

ثم اعرض على المستخدم القائمة المرتبة للمراحل والقيم التي تنتجها كل مرحلة، وقم بالتأكيد: قد يضيفون أو يحذفون أو يعيدون ترتيبها.

**يتم الانتهاء عندما:** يتم تسمية كل مرحلة بالترتيب، ولكل قيمة تم التقاطها تعرف (أ) من أين يحصل عليها المستخدم، (ب) أين يتم كتابتها (`.env`، GitHub secret، كلاهما، أو لا شيء؛ بعض المراحل هي مجرد إجراءات)، و (ج) ما إذا كانت سرية (إدخال مخفي) أو عامة.

### 2. رسم مسار كل مرحلة

لكل مرحلة، اكتب المسار الدقيق الذي يتبعه المستخدم: أي URL يجب فتحه، وماذا تفعل هناك، أين تظهر القيمة، أي متغير تملأ: على سبيل المثال "لوحة التحكم → المطورون → مفاتيح API → الكشف عن مفتاح الاختبار → نسخ". عندما لا تعرف واجهة المستخدم الحالية أو الأمر الدقيق، اذكر ذلك واطلب من المستخدم أو تحقق من الوثائق: لا تخترع أبدا خطوات قد لا تكون موجودة.

**يتم الانتهاء عندما:** تتبع كل مرحلة تعليمات ملموسة يمكن لشخص غريب اتباعها.

### 3. تأليف المعالج

انسخ `template.sh` إلى المسار المستهدف. استبدل المرحلة المثال بمرحلة `stage` واحدة لكل خطوة، بترتيب الاعتمادية. استخدم مساعدي المكتبة: `stage`، `say`/`step`، `open_url`، `ask`/`ask_secret`، `write_env`، `set_secret`/`set_var`، `pause`/`confirm`. اضبط `TOTAL_STAGES` على عدد المراحل التي كتبتها.

حافظ على المعيار الذي يحدده القالب: افتح URL قبل طلب قيمته، استخدم `ask_secret` لأي شيء سري، `write_env` لكل قيمة مستمرة، `set_secret` فقط القيم التي تحتاجها CI بالفعل، و`confirm` قبل أي إجراء لا رجعة فيه. كل `stage` يمسح الشاشة بحيث تكون الخطوة الحالية فقط مرئية: حافظ على المرحلة لمهمة واحدة مركزة حتى لا يختفي أي شيء يحتاجه المستخدم. لا تلمس المكتبة فوق العلامة.

### 4. التحقق والتسليم

- `bash -n <script>`؛ قم بتشغيل `shellcheck` إذا كان متاحا. - `chmod +x <script>`. - لا تقم بتشغيله من البداية إلى النهاية بنفسك: فهو يفتح المتصفحات ويتوقف عند إدخال المستخدم. تتبعه بشكل ثابت بدلا من ذلك: يتم التقاط كل قيمة من الخطوة 1 وتهبط حيث قالت الخطوة 1، وكل اسم `set_secret` يطابق تماما مرجع `secrets.*` في CI. - أخبر المستخدم كيفية تشغيله. إذا كان مسار إعداد قابل للتكرار، قم بتثبيته (commit) واربطه من ملف README حتى يقوم الشخص التالي بتشغيل النص البرمجي بدلا من سؤال الذكاء الاصطناعي.

التثبيت

شغل هذا الأمر

npx skills add mattpocock/skills

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

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

ثبت باستخدام `npx skills add mattpocock/skills`، أو استنسخ المستودع وانسخ مجلد `skills/engineering/wizard` إلى دليل مهارات Claude الخاص بك.

عرض المصدر

أسئلة شائعة

ما هي مهارة الساحر؟

أنشئ معالج bash تفاعليا يرشد المستخدم البشري عبر خطوات لا يمكن إلا له تنفيذها. استخدمه عند توفير البنية التحتية، أو إعداد بيانات الاعتماد أو أسرار CI، أو التنقل في لوحة تحكم طرف ثالث غير مألوفة، أو تشغيل عملية ترحيل أو تحويل لمرة واحدة. لا تستدعه للخطوات التي يمكن للوكيل تنفيذها بنفسه.

كيف أثبت الساحر؟

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

npx skills add mattpocock/skills
مع أي أدوات ذكاء اصطناعي تعمل الساحر؟

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

من طور الساحر؟

طورها mattpocock.

هل الساحر مجانية؟

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

أصول ذات صلة

مختارات أخرى في البيانات والتحليلات.

كل بدائل الساحر ←
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
سجل Hyperframes
حوالي 450 قالبا ومكونا جاهزا من HyperFrames مثبتة كمصدر قابل للتعديل - انتقالات، تراكبات، عناوين، نصوص حركية، تسميات توضيحية، رسوم بيانية، تراكبات خرا…985,203+
skillclaude_appclaude_codeclaude_api
npx skills add microsoft/azure-skills
Microsoft Foundry
بناء ونشر وتقييم وتحسين وضبط وإدارة وكلاء ونماذج وموارد Microsoft Foundry من البداية إلى النهاية. يستخدم ل: foundry, azd ai agent, azd provision/deplo…576,257+
skillclaude_appclaude_codeclaude_api
npx skills add microsoft/azure-skills
Azure Kusto
استعلام وتحليل البيانات في Azure Data Explorer (Kusto/ADX) باستخدام KQL لتحليلات السجلات، القياس عن بعد، وتحليل السلاسل الزمنية. متى: استعلامات KQL، ا…552,598+
skillclaude_appclaude_codeclaude_api
npx skills add microsoft/azure-skills
تخزين Azure
خدمات Azure Storage بما في ذلك Blob Storage وFile Shares وQueue Storage وTable Storage وData Lake. يجيب على الأسئلة المتعلقة بمستويات الوصول للتخزين (…546,701+
skillclaude_appclaude_codeclaude_api
npx skills add google/agents-cli
مراقبة واجهة سطر الأوامر لوكلاء Google
تستخدم هذه المهارة عندما يرغب المستخدم في "إعداد التتبع"، "مراقبة وكيله"، "تكوين التسجيل"، "إضافة قابلية المراقبة"، "تصحيح أخطاء حركة المرور في الإنتا…508,876+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
الترحيل إلى Shoehorn
ترحيل ملفات الاختبار من تأكيدات النوع `as` إلى @total-typescript/shoehorn. استخدمه عندما يذكر المستخدم shoehorn، أو يريد استبدال `as` في الاختبارات، أ…388,771+

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

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

المزيد في البيانات والتحليلات