المهارات وإضافة Claude Code

• larecipe-write-docs تقرأ الكود أولًا، وتبحث في التوثيق الموجود، وتضبط sources:، وتفضّل المراجع الحية على القيم الملصوقة، وتضيف الصفحة إلى التنقل وتشغّل larecipe:validate. وتحوي أيضًا سير عمل الإعداد الأولي وإعداداته المسبقة لكل جمهور.
• larecipe-update-docs تشغّل larecipe:affected، ولا تغيّر إلا ما جعله تغيير الكود خاطئًا، وتحافظ على كل جملة لا علاقة لها به، وتتحقق، وتلخّص تغيير التوثيق في سطر واحد. وتحمل أيضًا سير عمل الترجمة.
• larecipe-audit-docs تبحث عن الصفحات المنحرفة، والصفحات التي لا تحوي sources:، والأوصاف الضعيفة، والمسارات والأوامر والنماذج والأحداث غير الموثّقة، والأمثلة المعطوبة. وترتّب ما تجده إلى P1 (خاطئ أو غير آمن) و P2 (ناقص) و P3 (ضعيف)، ولا تصلح إلا ما تطلبه.
• larecipe-upgrade-v2 تعالج مكوّنات Vue المخصّصة، و CSS المظهر، و Blade داخل Markdown، وكل ما يعدّه تقرير الترقية عملًا يدويًا. راجع الترقية من الإصدار 2.

لا يستخدم كل ملف SKILL.md إلا مفاتيح Agent Skills القابلة للنقل: name و description، وعلى الأكثر license و compatibility و metadata و allowed-tools. لا مفاتيح خاصة بوكيل بعينه، فيقرؤها كل وكيل بالطريقة نفسها. وهذه ترويسة larecipe-write-docs:

---
name: larecipe-write-docs
description: Write new LaRecipe docs pages from this app's code. Use when asked to document a feature, an API, an artisan command or part of the codebase, to add a page or section to the docs, or to run LaRecipe onboarding (starter docs for product users, API consumers, package users or an internal team).
license: MIT
compatibility: A Laravel app with larecipe/larecipe installed, so php artisan larecipe:* works. The larecipe MCP server is recommended and required for database doc sets.
metadata:
  author: larecipe
  version: "3.0"
---

يبقى كل SKILL.md أقصر من 500 سطر. والتفاصيل في مجلد references/ لا يفتحه الوكيل إلا حين يحتاج إليه.

المهارة التي تصف مكوّنًا أو مفتاحًا غير موجود تعلّم الوكيل أن يكتب صفحات معطوبة. لذا فالمراجع التي تصف لغة LaRecipe يولّدها larecipe:agents من الكود، ولا تُكتب بيد:

تظهر مكوّناتك الخاصة في الفهرس موسومة بعبارة "(defined by this app)"، فيعرف الوكيل الذي يكتب توثيقك أنها موجودة وما خصائصها. ويبدأ كل ملف مولَّد بسطر يقول إنه وُلّد بالأمر php artisan larecipe:agents وإنه لا ينبغي تعديله.

أما المراجع الأخرى فمكتوبة بيد وتُقدَّم كما هي: writing-style.md و live-references.md و database-sets.md (متطابقة في كل المهارات التي تحملها)، والإعدادات المسبقة للإعداد الأولي في larecipe-write-docs، وسير عمل الترجمة في larecipe-update-docs، وجدول المقابلة مع الإصدار 2 في larecipe-upgrade-v2.

حين تكون الحزمة laravel/boost مثبّتة، يوزّع Boost المهارات على التطبيق كله، فلا يكتب LaRecipe نسخًا خاصة به. وتأتي المهارات من المجلد resources/boost/skills/ في الحزمة: شغّل php artisan boost:install (أو boost:update) واختر larecipe/larecipe، فينسخها Boost إلى مجلد كل وكيل.

ويبقى larecipe:agents مهمًا مع Boost. فهو يجد النسخ التي كتبها Boost (في .claude/skills و .agents/skills و .github/skills و .cursor/skills والمجلدات الأخرى التي يستخدمها Boost) ويعيد توليد مراجعها، فتظهر مكوّناتك الخاصة فيها أيضًا. راجع تعليمات الوكلاء.

تجمع الإضافة:

• المهارات الأربع، من resources/boost/skills/؛
• خطّافي pre-push و SessionStart، من claude-plugin/hooks.json؛
• الأمر /larecipe:onboard، من claude-plugin/commands/onboard.md، الذي يشغّل سير عمل الإعداد الأولي في larecipe-write-docs للجماهير التي تسمّيها (product و api و package و internal)؛
• خادم MCP المحلي larecipe.

ليعرضها Claude Code لدى كل زميل في الفريق، سجّل سوق الإضافات وفعّل الإضافة في ملف .claude/settings.json الخاص بالمشروع:

{
  "extraKnownMarketplaces": {
    "larecipe": {
      "source": { "source": "github", "repo": "saleem-hadad/larecipe" }
    }
  },
  "enabledPlugins": {
    "larecipe@larecipe": true
  }
}

تشغّل خطّافات الإضافة نسخة الإضافة الخاصة من larecipe-hook، التي تشغّل بدورها php artisan larecipe:hook في تطبيقك. والإضافة مثبّتة لك أنت، لا لمشروع واحد، لذا لا يفعل الخطّاف شيئًا في مشروع لا يحوي LaRecipe: يبحث عن أقرب تطبيق Laravel، ويتوقف عند جذر مستودع git، ولا يتصرف إلا حين يكون larecipe/larecipe مثبّتًا أو مطلوبًا في ذلك التطبيق. وفي غير ذلك يترك كل أمر يمرّ.

ثلاثة أمور يجب أن تعرفها قبل أن تختار الإضافة بدلًا من ملفات المثبّت:

• ملفات المثبّت أولًا. تشغّل الإضافة خادم MCP بالأمر php ${CLAUDE_PROJECT_DIR}/artisan larecipe:mcp، وهو طريق لم يُتحقق منه بالكامل بعد. والملف .mcp.json الذي يكتبه larecipe:install هو الطريقة الموصى بها لربط الخادم.
• مراجعها تأتي من الحزمة، لا من تطبيقك. مهارات الإضافة لا تذكر مكوّناتك الخاصة أبدًا. فثبّت المهارات في المستودع أيضًا حين تكون لديك مكوّنات مخصّصة.
• مجموعة واحدة من الخطّافات تكفي. حين تكون خطّافات الإضافة مفعّلة، ثبّت بالأمر larecipe:install --no-hooks كي لا يعمل الفحص مرتين مع كل push.