Impeccable ليس ArtCraft، وليس منتجًا من منتجات ArtCraft أو جزءًا من مجموعتها؛ هذه الصفحة دليل مستقل، والمعلومات الرسمية متاحة على impeccable.style وgithub.com/pbakaus/impeccable.

Impeccable: مفردات التصميم لوكيل البرمجة لديك

Impeccable مهارة تصميم وأداة سطر أوامر مفتوحة المصدر تمنح وكيل البرمجة مفردات مشتركة لمراجعة الواجهات وضبطها وصقلها. أنشأها Paul Bakaus انطلاقًا من مهارة frontend-design لدى Anthropic، وتُوزَّع بترخيص Apache-2.0. هذه الصفحة دليل مستقل وليست الوثائق الرسمية.

الموقع الرسميمستودع GitHubالوثائق

آخر تحديث: · English

صفحة Villa Castagneto المبنية دون Impeccable: خلفية كريمية، وعنوان رفيع بخط مزدوج مع لمسة مائلة، وزران بشكل حبة الدواء، ورسوم متجهية مسطحة داخل بطاقات مستديرة.
مثال من README الرسمي: الموجز نفسه لمنزل الضيافة والنموذج نفسه، لكن دون Impeccable. النتيجة هي الخيار الافتراضي الآمن: الكريمي والخط المزدوج وأزرار حبة الدواء.

ما هو Impeccable؟

Impeccable مهارة تُثبَّت داخل وكيل البرمجة وتمنحه مفردات تصميم، إلى جانب أداة CLI مستقلة. لا تفتح لك لوحة رسم، بل تحوّل التصميم إلى أوامر يستطيع الوكيل تنفيذها: نقد، تكثيف، ضبط للخطوط، تنظيف، وتقوية. انطلق المشروع من مهارة frontend-design لدى Anthropic، ويُنشر بترخيص Apache-2.0.

يستهدف المشروع الذوق الافتراضي للوكلاء: خط Inter في كل مكان، وتدرجات من البنفسجي إلى الأزرق، وبطاقات داخل بطاقات، ونص رمادي فوق خلفية ملوّنة، ومربّع أيقونة مستدير فوق كل عنوان. ترصد 62 قاعدة حتمية هذه العلامات أثناء التحرير، من دون LLM ومن دون مفتاح API.

يقدّم أفضل نتائجه على الواجهات القائمة: تشير إلى صفحة أو مكوّن وتكرّر التحسين. يستطيع بناء صفحات جديدة أيضًا، لكن المشروع نفسه يعترف بأن هذا الوضع أصعب. ومن المهم التوضيح أن Impeccable مشروع مفتوح المصدر ومستقل، وليس منتجًا من ArtCraft ولا جزءًا من مجموعتها.

التثبيت والتهيئة

نفّذ الأمر من جذر المشروع. يحتاج npx إلى Node 18.19 أو أحدث. يكتشف المثبّت أدوات البرمجة لديك، ويسأل هل التثبيت للمشروع أم عام، ويعرض خطاف التصميم حيث تدعمه الأداة. يُفضّل قبول الخطاف.

بعد الانتهاء، أعد تحميل أداة البرمجة ثم نفّذ /impeccable init (وفي Codex استخدم $impeccable init). في السكربتات يمكن تمرير --providers=claude,codex,cursor و--scope=project|global. ولتحديث تثبيت قائم استخدم npx impeccable update.

npx impeccable install
  1. تأكد من توفر Node 18.19 أو أحدث وانتقل إلى جذر المشروع.
  2. نفّذ npx impeccable install، واختر نطاق المشروع أو النطاق العام، وفعّل خطاف التصميم إن كان مدعومًا.
  3. أعد تحميل أداة البرمجة، ثم نفّذ /impeccable init (وفي Codex: $impeccable init) لإنشاء PRODUCT.md.
  4. إذا أردت تثبيت النظام البصري، نفّذ /impeccable document لإنشاء DESIGN.md، ثم حافظ على التحديث عبر npx impeccable update.

الأوامر الأساسية

يضم Impeccable 24 أمرًا. تُستدعى بصيغة «الأمر + الهدف»، مثل /impeccable critique the pricing cards، وفي Codex تُستبدل الشرطة المائلة بعلامة $. كتابة /impeccable وحدها تعرض القائمة. هذه هي الأوامر السبعة الأكثر فائدة.

الأمرما يفعلهمتى تستخدمه
/impeccable initيقرأ الشيفرة، ويسأل فقط عمّا لا يستطيع استنتاجه، ثم يكتب PRODUCT.md.مرة واحدة عند بداية المشروع، لتوفير السياق للأوامر التالية.
/impeccable critiqueيقدّم مراجعة تجربة استخدام مُقيَّمة وفق قواعد الاستخدامية، ويرتّب ما ينبغي إصلاحه أولًا.قبل إعادة التصميم، أو لمعرفة أين يتعثر مسار معيّن.
/impeccable polishيقوم باللمسة الأخيرة قبل الإطلاق.عندما تستقر الوظائف ويقترب موعد النشر.
/impeccable auditينتج تقريرًا تقنيًا عن إمكانية الوصول والأداء والسمات والتجاوب وسلامة التنفيذ، مع تصنيف الملاحظات من P0 إلى P3.قبل الإصدار، أو لمعالجة دين تنفيذي متراكم.
/impeccable typesetيصلح الخطوط والتسلسل الهرمي والأحجام والمسافات.عندما تبدو الطباعة متراخية أو يضيع التسلسل الهرمي.
/impeccable distillيحذف ما لا تحتاجه الصفحة.عندما يزدحم المحتوى ويتشتت التركيز.
/impeccable hooks status|on|offيعرض حالة خطاف التصميم أو يفعّله أو يعطّله؛ والخطاف يفحص ملفات الواجهة التي يحرّرها الوكيل.للتحقق من عمل الفحص التلقائي، أو لإيقافه مؤقتًا.

سير العمل المقترح

السياق أولًا، ثم الشاشة. لا يسأل init إلا عمّا لا يمكن استنتاجه: لمن المنتج، وما الذي يجب أن ينجزه، وما القيود. تُكتب الإجابات في PRODUCT.md وتقرأها كل الأوامر اللاحقة. وإذا كان لديك نظام بصري قائم، فنفّذ document لتسجيل قواعد العلامة في DESIGN.md، حتى لا يغيّر الوكيل الأسلوب في منتصف العمل.

كلما ضاق الهدف تحسّنت النتيجة. بدلًا من «أعد تصميم الصفحة كلها»، جرّب «راجع بطاقات الأسعار باستخدام critique». ويمكن تثبيت الأوامر المتكررة عبر /impeccable pin audit لتصبح اختصارًا هو /audit؛ وقبل النشر اختم بـ audit ثم polish.

  1. نفّذ /impeccable init مرة لكل مشروع، وراجع ملف PRODUCT.md الناتج.
  2. إذا وُجد نظام تصميم قائم، نفّذ /impeccable document ولخّص الخطوط والألوان والمكوّنات في DESIGN.md.
  3. كرّر التحسين قسمًا بقسم: /impeccable critique the pricing cards، ثم استخدم bolder أو quieter أو distill أو typeset لضبط الاتجاه.
  4. قبل النشر، شغّل /impeccable audit ثم /impeccable polish، وثبّت أوامرك المعتادة باستخدام pin.

الوكلاء المدعومون

القائمة الرسمية واسعة: Claude Code وCursor وCodex CLI وGitHub Copilot وDevin وReplit Agent وGemini CLI وGrok Build وOpenCode وGoogle Antigravity وKiro وTrae وRovo Dev وQoder وMistral Vibe وPi وHermes Agent وDeepSeek Harness وVeto. تختلف طريقة التثبيت بحسب الأداة، والقائمة الكاملة في الوثائق الرسمية.

تتوفر إضافات لـ Claude Code وCopilot وGrok، وخطاف التصميم مدعوم في Claude Code وCursor وCodex وGitHub Copilot وGrok Build وHermes Agent. في Codex يجب الموافقة على خطاف المشروع من /hooks، وفي Grok Build نفّذ /hooks-trust، وفي Hermes فعّل الإضافة.

إن لم ترغب في تثبيت Node، يمكنك نسخ مجلد المهارة يدويًا. وللاستفادة من الكاشف وحده، يعمل npx impeccable detect من دون وكيل. يدعم الوضع المباشر Vite وNext وSvelteKit وAstro وNuxt وHTML العادي، لكنه لا يعدّل سوى نسخة عمل محلية.

صفحة Villa Castagneto المبنية باستخدام Impeccable: مشهد ليلي محفور يملأ الصفحة للفيلا على الجرف فوق البحر، وعنوان مكثّف بالكريمي والقرمزي، وشريط أشهر في الأسفل.
مثال من README الرسمي: الموجز نفسه، هذه المرة مع Impeccable. تُبنى الصفحة حول صورة واحدة، المنزل ليلًا كما يُرى من الماء.

Impeccable مقابل ArtCraft MCP

يتشابه الاسمان لأن كليهما يجعل الوكيل ينتج شيئًا، لكنهما يعملان في طبقتين مختلفتين. يتعامل Impeccable مع الشيفرة المصدرية للواجهة، بينما ArtCraft MCP هو واجهة MCP/CLI الرسمية لكل تطبيق من storytold، ويقود تطبيقات Crafting Apps المحلية مثل PhotoCraft. وهو ليس واجهة artcraft-mcp المجتمعية القائمة على الاشتراك.

الجانبImpeccableArtCraft MCP
ما يعمل عليهشيفرة الواجهة الأمامية في المستودع: المكوّنات وJSX/TSX وCSS وبنية الصفحة.تطبيقات Crafting Apps المحلية (مثل PhotoCraft) ومسارات العمل الخاصة بالصور والفيديو.
ما ينتجهتوصيات تصميم وتعديلات على الشيفرة وتقارير critique/audit وملفّي PRODUCT.md وDESIGN.md.صور أو فيديوهات، وعمليات مؤتمتة داخل تلك التطبيقات.
متى تختارهعند بناء واجهة أمامية أو تقييمها أو صقلها.عند إنتاج الصور والفيديو أو معالجتها بكميات، وأتمتة العمل داخل التطبيقات.
هل يتكاملان؟نعم: الواجهة مع Impeccable، وإنتاج الوسائط مع ArtCraft MCP.نعم، لكنه مخصّص لأصول الوسائط؛ لا يقدّم مراجعة تصميم للواجهة ولا يحل محل Impeccable.

دليل ArtCraft MCPتطبيقات Crafting

الحدود والسلامة

Impeccable مهارة تصميم أمامي وأداة CLI، وليس تطبيق تصميم ولا مولّد صور. الوضع المباشر يعدّل نسخة عمل محلية فقط؛ لا تحقنه في موقع منشور، ولا تُرخِ سياسة CSP في الإنتاج من أجل تشغيله.

تعمل الخطافات خارج موافقة النموذج. في Claude Code قد ينفّذ خطاف أوامر مثبّت حتى إذا رفضت أوامر النموذج، وقد يؤدي أول تحرير إلى تنزيل المحرّك. راجع الخطافات قبل التشغيل دون إشراف، أو عطّلها بـ --settings '{"disableAllHooks": true}'.

يسجّل القياس عن بُعد بشكل مجهول الاتجاهات البصرية التي عُرضت والتي اختيرت، ولا يرسل اسم المشروع أو الملفات أو الشيفرة أو PRODUCT.md. يمكن إيقافه عبر npx impeccable telemetry off أو DO_NOT_TRACK=1 أو "telemetry": false في .impeccable/config.json. أما رمز الخروج 2 في الكاشف فيعني وجود ملاحظات، و1 يعني تعذّر فحص الهدف.

أدلة ذات صلة

الأسئلة الشائعة

ما هو Impeccable؟ وهل هو منتج من ArtCraft؟

Impeccable مهارة تصميم وأداة CLI لوكلاء البرمجة، أنشأها Paul Bakaus، وتضم 24 أمرًا وكاشفًا من 62 قاعدة بترخيص Apache-2.0. ليس منتجًا من ArtCraft ولا ينتمي إلى مجموعتها. هذه الصفحة دليل مستقل، والمصدران الرسميان هما impeccable.style وgithub.com/pbakaus/impeccable.

كيف أثبّته؟

من جذر المشروع نفّذ npx impeccable install ثم أعد تحميل أداة البرمجة. بعد ذلك شغّل /impeccable init، أو $impeccable init في Codex، لإنشاء PRODUCT.md. يحتاج npx إلى Node 18.19 أو أحدث، ويحدّث npx impeccable update التثبيت القائم؛ والخطوات الكاملة على impeccable.style/docs.

ما الفرق بين critique وaudit؟

critique مراجعة تجربة استخدام مُقيَّمة وفق قواعد الاستخدامية، وتخبرك بما ينبغي إصلاحه أولًا. أما audit فهو تقرير تقني يغطي إمكانية الوصول والأداء والسمات والتجاوب وسلامة التنفيذ، ويصنّف الملاحظات من P0 إلى P3. الأول يحكم على التجربة والثاني يفحص الهندسة، وكثيرًا ما يُستخدمان بالتتابع.

هل يحتاج إلى مفتاح API؟

لا يحتاجه الكاشف؛ فقواعده الـ62 حتمية ولا تستدعي LLM ولا تقرأ مفتاحًا. والمهارة نفسها تعمل داخل وكيلك، فلا تحتاج مفتاح نموذج إضافيًا. ويمكن إيقاف القياس عن بُعد عبر npx impeccable telemetry off أو DO_NOT_TRACK=1.

مع أي وكلاء يعمل؟

مع Claude Code وCursor وCodex CLI وGitHub Copilot وDevin وReplit Agent وGemini CLI وGrok Build وOpenCode وGoogle Antigravity وKiro وTrae وRovo Dev وQoder وMistral Vibe وPi وHermes Agent وDeepSeek Harness وVeto. يختلف التثبيت ودعم الخطافات بحسب الأداة، والقائمة المحدّثة على impeccable.style/docs.

أيهما أختار: Impeccable أم ArtCraft MCP؟

يعتمد على ما تريد تغييره. يعمل Impeccable على شيفرة الواجهة ويعيد توصيات وتعديلات ومراجعات. أما ArtCraft MCP فيقود تطبيقات محلية مثل PhotoCraft لإنتاج الصور والفيديو وأتمتة مساراتها. يمكن استخدامهما معًا، لكن ArtCraft MCP ليس أداة مراجعة تصميم ولا يغني عن Impeccable.

تنبيه الاستقلالية

Impeccable مشروع مفتوح المصدر ومستقل أنشأه Paul Bakaus، ولا تربطه علاقة بـ ArtCraft، وليس منتجًا من ArtCraft ولا جزءًا من مجموعتها أو مكوّناتها الرسمية. هذه الصفحة يكتبها طرف ثالث لجمهور عربي؛ وللأوامر والمتطلبات والمستجدات، المرجع هو الموقع الرسمي impeccable.style والمستودع github.com/pbakaus/impeccable. أما ArtCraft MCP فهو تكامل رسمي آخر موجّه إلى Crafting Apps ويعالج مشكلة مختلفة.

Sources

Every fact on this page comes from the pages below, checked on 3 November 2026.