Impeccable لغة تصميم وكلاء الذكاء الاصطناعي: يصف المستودع pbakaus/impeccable نفسه بأنه «لغة التصميم التي تحسّن تصميم harness الذكاء الاصطناعي لديك». عمليًا هو skill (تعليمات قابلة لإعادة الاستخدام لوكيل برمجة) تصحبه 24 أمرًا، وكاشف بـ 61 قاعدة لرصد العيوب النموذجية في واجهات frontend التي يولّدها الذكاء الاصطناعي، ووضع للتكرار داخل المتصفح. ويضم المستودع نحو 84600 نجمة في نهاية أكتوبر 2026.
لماذا نتحدث عنه في مدوّنة للتشغيل؟ لأن skill يثبّت hooks وينزّل ملفًا تنفيذيًا ويقترح قياسًا عن بُعد (telemetry) هو مكوّن في سلسلة التسليم لديك. يتبع هذا المقال README ووثائق المشروع: ماذا يفعل، وكيف يُثبَّت، وماذا يكتب على قرصك، وكيف تقيس ما يرصده. وللاطلاع على skill آخر من السلسلة، راجع skill تدقيق الأمان لـ Cloudflare.
توضيح للأمانة: لم تثبّت span.observer أداة Impeccable. الأوامر مأخوذة من README، واللقطة مأخوذة من موقع المشروع.
Impeccable لغة تصميم وكلاء الذكاء الاصطناعي: ما يقوله المستودع
- المؤلف والترخيص: يذكر README أن المشروع أنشأه Paul Bakaus؛ والترخيص Apache 2.0 (ملف LICENSE).
- أرقام أُعيدت قراءتها في 22 أكتوبر 2026: نحو 84600 نجمة، ونحو 5100 فرع (fork)، و2517 commit. لا تعرض صفحة المستودع أي إصدار (release).
- المحتوى المعلن: skill واحد، و24 أمرًا (
craftوshapeوcritiqueوauditوpolishوhardenوanimateوlive…)، و61 قاعدة كشف حتمية، وأوامر نقد تعتمد على LLM. - الأصل: يقول README إن المشروع انطلق من skill
frontend-designالخاص بـ Anthropic؛ ولا يُقدَّم على أنه منتج لتلك الشركة. - الأدوات المدعومة: Cursor وClaude Code وGitHub Copilot وGemini CLI وCodex CLI وGrok Build وOpenCode وعشر أدوات أخرى تقريبًا، بحسب قائمة README.
مبدأ README: كل النماذج تعلمت من قوالب SaaS نفسها، ومن هنا العيوب نفسها (الخط Inter في كل مكان، وتدرجات البنفسجي والأزرق، وبطاقات داخل بطاقات). يمنح skill الوكيل مفردات مشتركة، ويتحقق الكاشف من النتيجة من دون نموذج ولا مفتاح API.
جولة: ما الذي يبحث عنه الكاشف
يوضح موقع المشروع كل عيب بصفحة مثال. وهذه صفحة التدرجات البنفسجية: صفحة نموذجية عن قصد، بعلامة تجارية خيالية، يصنفها المشروع ضمن الأنماط الواجب تجنبها.

وتعرض وثائق الكاشف رصدًا حقيقيًا في ملف CSS صغير (القاعدة gradient-text، السطر 3) وأوامر المسح.

التثبيت خطوة بخطوة
الخطوة 1 — المثبّت الموصى به
من جذر مشروعك:
npx impeccable install
/impeccable init
يكتشف المثبّت أدواتك (مثل ~/.claude أو مجلد .cursor في المشروع)، ويسأل هل التثبيت للمشروع أم للجهاز، ثم يضع skill. الخياران --providers=claude,cursor و--scope=project|global يتجنبان الأسئلة في السكربتات. وللتحديث: npx impeccable update. وفي الوكيل يكتب /impeccable init ملف PRODUCT.md يصف الجمهور والاستخدام والقيود.
الخطوة 2 — بدائل README
- وحدة Git فرعية (submodule):
git submodule add https://github.com/pbakaus/impeccable .impeccable، ثمnpx impeccable link --source=.impeccable --providers=claude,cursor. - Claude Code:
/plugin marketplace add pbakaus/impeccable، ثم التثبيت من/plugin. - نسخ يدوي من
dist/، أو ملف ZIP من الموقع الرسمي.
الخطوة 3 — الكاشف وحده، من دون وكيل
npx impeccable detect src/
npx impeccable detect http://localhost:3000
npx impeccable detect --json src/
npx impeccable detect --github src/
يوضح README رموز الخروج: 0 من دون رصد، و2 مع وجود رصد، و1 إذا تعذّر تحليل هدف. ويولّد الخيار --github تعليقات توضيحية لـ GitHub Actions (10 من كل نوع على الأكثر في كل خطوة و50 في كل job، بحسب README). وهذا الجزء الأنفع لفريق SRE: فحص في التكامل المستمر من دون نموذج.
ما الذي تكتبه الأداة وترسله
- Hooks: على Claude Code وCopilot وCodex وCursor وGrok Build يضيف المثبّت ملف hooks يشغّل الكاشف بعد كل تعديل لملف واجهة. ويحذر README من أن هذه الـ hooks تعمل في Claude Code بمعزل عن موافقة الأدوات: فقد ينزّل أول حدث المحرك ويخزّنه في
~/.impeccable/bin/. راجع الـ hooks قبل أي تشغيل بلا مراقبة. - المجلد
.impeccable/: لقطات وحالة الوضع الحي (live) وذاكرات مؤقتة. يقدم README كتلة.gitignoreللنسخ، ويسرد الملفات الواجب إدراجها في الإصدارات (config.jsonوdesign.jsonوsurfaces/*.md). - القياس عن بُعد: يستدعي skill واجهة API لموقع impeccable.style لسحب «يد» من العوالم البصرية؛ وما لم تعترض يُرسَل تسجيل مجهول للاختيار. ويقول README إن اسم المشروع والملفات والشيفرة و
PRODUCT.mdلا تغادر الجهاز. ولإيقافه:npx impeccable telemetry off، أوDO_NOT_TRACK=1، أوIMPECCABLE_NO_TELEMETRY=1. - الوضع الحي: يعدّل مستودعًا محليًا عبر خادم تطوير؛ وتطبيقه على موقع إنتاج غير مدعوم. أما تطبيق تعديلات النصوص فينفذ في shell السكربت الاختياري
impeccable:manual-edit-validateمن ملفpackage.jsonلديك: اقرأه في أي مستودع غير معروف.
مراقبة Impeccable
Impeccable ليس خدمة: لا توجد تتبعات ولا مقاييس لتصديرها، ولا يصفها README. أما ما يمكن قياسه فهو:
- رصد الكاشف: يعطي الخرج
--jsonأو التعليقات--githubعدد الرصد لكل قاعدة. تتبّعه عبر طلبات الدمج (pull requests) مؤشرَ جودة، من دون جعله هدفًا مطلقًا: يذكّر README بأن مسحًا نظيفًا ليس دليلًا على الجودة البصرية ولا على إمكانية الوصول. - تنفيذ الـ hooks: المعامل
hook.auditLogفي.impeccable/config.json(أو المتغيرIMPECCABLE_HOOK_LOG) يكتب سطر NDJSON لكل استدعاء hook. اربط هذا الملف بمجمّع السجلات لديك. - تكلفة الـ tokens: أوامر النقد تمر عبر نموذج وكيلك. ولنسبتها إلى مصدرها، اتبع مراقبة وكيل البرمجة.
الحدود والنقاط المفتوحة
- يتغير المشروع بسرعة (24 أمرًا، وخمس عشرة أداة مدعومة تقريبًا): أعد قراءة الوثائق قبل كل تحديث.
- يطبّق الكاشف قواعد ذوقية: «لا Inter» و«لا تدرج بنفسجي» تظل خيارات تصميم قابلة للنقاش، وليست أخطاء مطلقة. وتُعلَن الاستثناءات في الإعداد.
- يمر جزء من التدفق (سحب العوالم البصرية) عبر خادم المشروع؛ ولا يقول README ما يحدث من دون شبكة. اختبر ذلك قبل الاعتماد على هذا الوضع.
- التوافق: لم تعرض صفحة المستودع أي إصدار وقت إعادة القراءة.
أفضل الممارسات
- جرّب الكاشف وحده في CI أولًا، ثم skill داخل الوكيل.
- عطّل القياس عن بُعد على الأجهزة الخاضعة لسياسة بيانات، ودوّن القرار في الإصدارات داخل
.impeccable/config.json. - أخضع skills وكلائك للمراجعة كما تفعل مع الشيفرة؛ راجع أيضًا الفهرس الرسمي لإضافات Claude Code.
- لا تعلن استثناءً عامًا لإسكات قاعدة: فضّل التنازل المحدد داخل الملف.
الأسئلة الشائعة
هل يعمل Impeccable من دون مفتاح API؟
الكاشف نعم: يقول README إن واجهة سطر الأوامر وإضافة المتصفح تنفذان القواعد الحتمية من دون نموذج ولا مفتاح. أما أوامر التصميم فتمر عبر الوكيل الذي تستخدمه أصلًا.
هل يلزم Node.js؟
فقط لـ npx. يضم skill مشغّلًا ينفذ ملفًا تنفيذيًا مستقلًا، ينزَّل مرة واحدة في ~/.impeccable/bin/ إن لم يكن مرفقًا.
هل له صلة بـ Anthropic أو Cursor؟
لا يقدّمه README على أنه منتج لـ Anthropic ولا لـ Cursor: يقول إنه انطلق من skill frontend-design لدى Anthropic، ويدعم أدوات كثيرة، منها هاتان.
الخلاصة
يمنح Impeccable لغة مشتركة لتطلب من الوكيل ما يفوق واجهة frontend «عامة»، وكاشفًا يندمج في CI. ويقوم حسن استخدامه على ثلاثة إعدادات: الكاشف أولًا، وقرار القياس عن بُعد، ومراجعة الـ hooks. المصادر: مستودع pbakaus/impeccable ووثائق الكاشف.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا للمشاريع المذكورة. العلامات التجارية المذكورة ملك لأصحابها. الأدوات تتطور بسرعة: تحقق من الأوامر والخيارات في وثائقها الرسمية.