ضمن تصميم · ذكاء Apache-2.0 · صنع على الأرض
وكيل · Kiro CLI

Kiro CLI للتصميم.

Kiro CLI هو وكيل الطرفية من Amazon للتطوير المُوجَّه بالمواصفات — يحوّل المُوجّه إلى مواصفة متطلّبات ووثيقة تصميم وقائمة مهام قبل أن يكتب الشيفرة. وهذا الهيكل هو بالضبط ما يحتاجه العمل التصميمي: القصد أولًا، ثم البناء. ويربطه Open Design ضمن سير عمل تصميمي مفتوح المصدر: معرّف Builder ID أو تسجيل دخولك، وملفّاتك، ومحليًا أولًا.

حلقة التغذية الراجعة التصميمية لـ Kiro CLI: وكيل طرفية يحوّل مواصفة إلى تصميم، ومتصفّح يعرض الواجهة، ومساحة عمل، مع سهم تغذية راجعة يعود في حلقة

يحوّل Open Design أداة Kiro CLI إلى وكيل تصميم مفتوح المصدر يعمل محليًا أولًا — معرّف AWS Builder ID أو تسجيل دخولك، وملفّاتك، ومكتبة منسّقة من المهارات وأنظمة التصميم من حوله.

Kiro CLI هو وكيل الطرفية من Amazon للتطوير المُوجَّه بالمواصفات. وما يميّزه هو سير العمل: فبدلًا من القفز مباشرةً من المُوجّه إلى الشيفرة، يصيغ Kiro المتطلّبات في مواصفة، وينتج وثيقة تصميم وقائمة مهام متسلسلة، ثم ينفّذ بعد ذلك فقط — مبقيًا البناء خاضعًا للمساءلة أمام القصد المعلَن. كما يأتي بخطّافات وكيل تُطلَق عند أحداث مثل حفظ ملف، وملفات توجيه تحمل معاييرك وأعرافك إلى كل تشغيل، ودعم بروتوكول سياق النموذج للأدوات الخارجية. وKiro في معاينة، متاح بوصفه بيئة تطوير وواجهة سطر أوامر وواجهة ويب، ويمكنك البدء مجانًا. هذا دليل عملي شامل لاستخدام Kiro CLI في أعمال الواجهات والواجهات الأمامية وأنظمة التصميم، ولربطه ضمن سير عمل تصميمي منظّم مع Open Design.

يتناول الدليل ماهية Kiro CLI فعليًا، ولماذا يناسب التصميمَ سيرُ عمل مُوجَّه بالمواصفات، وكيفية إعداده من الصفر، وحلقة التحويل من لقطة الشاشة إلى الواجهة، وكيف توسّعه ملفات التوجيه والخطّافات وMCP، وكيف يُقارن بـ Codex وClaude Code وCursor وGemini CLI، والعثرات التي تجعل مخرجات الذكاء الاصطناعي تبدو عامة، وكيف يسدّ Open Design الفجوة بوصفه طبقة تصميم مفتوحة تعمل محليًا أولًا من حوله.

ماهية Kiro CLI فعليًا

Kiro ذكاء اصطناعي قائم على الوكيل من Amazon يُطرَح بوصفه بيئة تطوير وواجهة سطر أوامر وواجهة ويب، مبنيًّا لنقلك من النموذج الأولي إلى الإنتاج بالتطوير المُوجَّه بالمواصفات. وتجلب أداة Kiro CLI ذلك الوكيل إلى طرفيّتك: إذ يمكنك بدء جلسة محادثة تفاعلية، وإنشاء الوكلاء وإدارتهم، وتشغيل خوادم بروتوكول سياق النموذج — كلّه من سطر الأوامر. وKiro في معاينة.

في العمل التصميمي، الخاصية المميِّزة هي سير العمل. فبدلًا من تحويل المُوجّه مباشرةً إلى شيفرة، يكتب Kiro أولًا مواصفة — متطلّبات، ووثيقة تصميم، وقائمة مهام متسلسلة — وينفّذ بالاستناد إليها. وهذا يجعل خطّة الوكيل مرئية وقابلة للمراجعة قبل بناء أي واجهة، وهو ما ينطبق بسلاسة على الكيفية التي ينبغي أن تُتّخَذ بها القرارات التصميمية: القصد أولًا، ثم التنفيذ.

  • المواصفات: يحوّل Kiro المُوجّه إلى مواصفة منظّمة — متطلّبات، ووثيقة تصميم، ومهامّ منفصلة — قبل أن يكتب الشيفرة، فتكون الخطّة قابلة للمراجعة منذ البداية.
  • التوجيه + الخطّافات: تحمل ملفات التوجيه معاييرك وأعرافك وأدواتك المفضّلة إلى كل تشغيل؛ وتُطلَق خطّافات الوكيل عند أحداث مثل حفظ ملف لتشغيل مهامّ خلفية تلقائيًا.
  • مجاني للبدء، وجاهز لـ MCP: سجّل الدخول بمعرّف Builder ID أو Google أو GitHub أو مؤسّستك وابدأ مجانًا؛ كما يدير Kiro CLI خوادم MCP لإدخال سياق خارجي.
  • المُورّد: Amazon (AWS)
  • بيانات الاعتماد: AWS Builder ID أو Google أو GitHub أو AWS IAM Identity Center عبر kiro-cli login (لا يلزم حساب AWS)
  • الحالة: في معاينة؛ متاح بوصفه بيئة تطوير وواجهة سطر أوامر وواجهة ويب

لماذا يناسب التصميمَ التطويرُ المُوجَّه بالمواصفات

تأتي ميزة Kiro CLI التصميمية من سير عمله — لكن، كما هي الحال مع كل وكيل، يبقى الذوق أمرًا يجب توفيره.

  • القصد قبل البكسلات: بما أن Kiro يكتب مواصفة ووثيقة تصميم أولًا، يمكنك تصحيح التخطيط والتراتبية والنطاق في مرحلة التخطيط — قبل أن يلتزم الوكيل بتنفيذ عامّ.
  • التوجيه يحمل هويتك البصرية: تُبقي ملفات التوجيه رموزك التصميمية ومكوّناتك وأعرافك أمام الوكيل في كل تشغيل، فتعمل المخرجات وفق هوية بصرية بدلًا من مظهر افتراضي.
  • الخطّافات تُلزِم بالحلقة: تستطيع خطّافات الوكيل تشغيل فحوص تلقائيًا عند الحفظ — وهي موضع لربط خطوة تحقّق أو مراجعة بدلًا من الاعتماد على تذكّر الوكيل لها.
رسم تخطيطي يوضّح تلاقي نظام التصميم والمهارة وصورة المرجع للوصول إلى مخرجات تصميمية جيدة
يأتي الذوق من ثلاثة مدخلات توفّرها: نظام تصميم، ومهارة، وصور مرجعية حقيقية.

الدرس نفسه الذي يعلّمه كل وكيل: لا يمتلك Kiro CLI ذوقًا افتراضيًا. والمواصفة تُبقي البناء صادقًا، لكنه لا ينتج تصميمًا جيدًا إلا حين تمدّه بالقيود — نظام تصميم ومهارة جمالية ومراجع ملموسة. ويحزم Open Design هذه المدخلات بالضبط، ولهذا يتلاءم الاثنان معًا (المزيد أدناه).

إعداد Kiro CLI للعمل التصميمي، من الصفر

إليك المسار الكامل من جهاز نظيف إلى Kiro CLI قادر على بناء الواجهات والتحقّق منها.

# 1. Install Kiro CLI (see kiro.dev/docs/cli for the macOS/Linux/Windows command)

# 2. Authenticate — opens your browser to complete sign-in
kiro-cli login   # choose Builder ID, Google, GitHub, or your organization

# 3. Confirm you are signed in
kiro-cli whoami

# 4. Start an interactive session in your project
cd your-project
kiro-cli chat

# 5. Wire MCP servers (optional, e.g. for design handoff)
kiro-cli mcp add ...
سير إعداد من خمس خطوات: التثبيت، والمصادقة، وإضافة التوجيه، وإضافة مهارة، والتحقّق
تسلسل الإعداد: التثبيت ← المصادقة ← إضافة التوجيه ومواصفة تصميم ← إضافة مهارة ← تفعيل التحقّق عبر المتصفّح.
  • دوّن قواعد تصميمك: ضع رموزك التصميمية وعناصرك الأساسية وأعرافك في ملفات التوجيه كي يقرأها الوكيل في كل تشغيل، فتطابق المخرجات الهوية البصرية بدلًا من اللجوء افتراضيًا إلى مظهر عام.
  • أضِف التحقّق عبر المتصفّح: اربط Playwright أو خادم متصفّح عبر MCP كي يعرض Kiro في متصفّح حقيقي ويفحص مخرجاته عبر نقاط التوقّف بدلًا من مجرّد التأكّد من نجاح البناء.

سير عمل التحويل من لقطة الشاشة إلى الواجهة

أكثر حلقات التصميم تأثيرًا مع Kiro CLI هي تحويل صورة مرجعية إلى واجهة عاملة ومتجاوبة والتكرار حتى تتطابق — بترك المواصفة تلتقط القصد أولًا، ثم البناء بالاستناد إليها.

  1. ابدأ من أوضح المراجع البصرية لديك — وأدرِج حالات متعدّدة (سطح المكتب والجوال، والتمرير فوق العنصر، والحالة الفارغة، وحالة التحميل)، لا لقطة رئيسية واحدة فحسب.
  2. دَع Kiro يكتب مواصفة ووثيقة تصميم من مُوجّهك، وراجِع الخطّة قبل أن يبني — فهنا تلتقط مشكلات التخطيط والنطاق مبكّرًا.
  3. احتفظ بنظام تصميمك وأعرافك في ملفات التوجيه، وأخبِر Kiro بمواضع الرموز التصميمية والعناصر الأساسية المرجعية.
  4. شغّل خادم تطوير واجعل Kiro يعرض في متصفّح حقيقي، مع تغيير الحجم إلى نقاط التوقّف للتحقّق من النتيجة.
  5. كرّر العمل بأن تجعل Kiro يقارن تنفيذه بالمراجع — لا أن يكتفي بالتأكّد من نجاح البناء.

افتح جلسة تفاعلية وقدّم قيودًا ملموسة منذ البداية، كي تعكس المواصفة التي يكتبها قصدك الحقيقي:

kiro-cli chat
# in the prompt:
> Here are my references: reference-desktop.png and reference-mobile.png.
  Write a spec, then implement this design in React + Vite + Tailwind + TypeScript.
  Reuse my existing design-system components and tokens (see my steering files).
  Match spacing, layout, and hierarchy; make it responsive.
  Render it in the browser and iterate until it matches the references
  across breakpoints.

أبقِ المهامّ صغيرة ومركّزة، وأودِع التكرارات الجيدة وتراجع عن السيّئة (مع إخبار Kiro عند تراجعك)، كي تبني كل مرحلة على أساس نظيف.

المواصفات والتوجيه والخطّافات وMCP

أربع نقاط توسّع تجعل Kiro CLI عمليًا للعمل التصميمي المستمر، وتنطبق الأربع جميعها بسلاسة على سير عمل تصميمي مفتوح.

  • المواصفات: متطلّبات، ووثيقة تصميم، وقائمة مهام متسلسلة — وهي السجلّ المتين لما يُفترَض أن تكون عليه الميزة، قابل للمراجعة قبل البناء وأثناءه.
  • ملفات التوجيه: أضِف السياق ومعايير البرمجة وسير العمل أو الأدوات المفضّلة التي يقرأها الوكيل في كل تشغيل — وهي الموطن الطبيعي لأعراف تصميمك ورموزه التصميمية.
  • خطّافات الوكيل: أتمتة تُطلَق عند أحداث مثل حفظ ملف، وتشغّل مهامّ خلفية كالفحوص أو التوثيق — وهي موضع لإلزام خطوة تحقّق تلقائيًا.
  • خوادم MCP: يدير Kiro CLI خوادم بروتوكول سياق النموذج، وهي الطريقة القابلة للنقل لإدخال السياق التصميمي الخارجي والأدوات التي تعمل عبر الوكلاء، لا مع Kiro فحسب.

هذه قدرات قابلة للنقل ومتعدّدة الوكلاء — وهي بالضبط ما بُني Open Design لتنسيقه، بدلًا من إعادة إنشائه لكل مشروع.

Kiro مقابل Codex وClaude Code وCursor وGemini CLI في التصميم

لا يوجد فائز واحد في العمل التصميمي — فلكل وكيل نقطة قوة مختلفة، والفِرق المتمرّسة تجمع بينها. وفيما يلي ملخّص منصف:

الوكيلنقطة القوة التصميميةالأفضل لـ
Kiro CLIسير عمل مُوجَّه بالمواصفات — متطلّبات ووثيقة تصميم وقائمة مهام قبل الشيفرة؛ وملفات التوجيه والخطّافات تُبقي البناءات متوافقة مع الهوية البصريةبناءات منظّمة قابلة للمراجعة يُثبَّت فيها القصد والنطاق قبل التنفيذ
Codexصقل بصري قوي مع مهارة للواجهات الأمامية؛ وبناءات غير متزامنة في بيئة معزولةالبناءات غير المتزامنة المُفوَّضة وقواعد AGENTS.md القابلة للنقل
Claude Codeقرارات تصميمية محدّدة (الألوان الست عشرية والتباعد والخطوط) وتجربة استخدام مدرِكة لقاعدة الشيفرةالاستدلال في الواجهات الأمامية وإعادة الهيكلة ذات السياق الكبير
Cursorحلقة بناء ومعاينة بصرية مع معاينة حيّة وتعديلات ضمن السياقعمل واجهات محكم قائم على التكرار والمراقبة داخل بيئة تطوير متكاملة
Gemini CLIفهم قوي للصور متعدّد الوسائط وسياق كبير جدًا؛ مفتوح المصدر مع باقة مجانيةالعمل المعتمد بكثافة على لقطات الشاشة والاحتفاظ بنظام تصميم كامل في السياق

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

العثرات وكيفية تجنّب مظهر «ركاكة الذكاء الاصطناعي»

أكثر الشكاوى شيوعًا بشأن التصميم المُولَّد بالذكاء الاصطناعي أنه يبدو عامًا — تدرّجات لونية ناعمة، ولوحات طافية، وزوايا دائرية مفرطة الحجم، وظلال مبالَغ فيها، وطابع «خط Inter واللون الأرجواني» الذي «يصرخ بأن ذكاءً اصطناعيًا صنع هذا». ومن المشكلات المُبلَّغ عنها أيضًا تكسّر تخطيطات الجوال وتسرّب التعليمات إلى نصوص الواجهة. ولا يقتصر أيٌّ من هذا على Kiro CLI؛ بل هو ما يحدث حين يعمل أي وكيل دون سياق تصميمي منسّق — فالمواصفة تُبقي البناء على المسار، لكنها لا توفّر الذوق.

  • أضِف مهارة جمالية: تُلزِم المهارة التصميمية المنسّقة الوكيلَ بالالتزام باتجاه حقيقي بدلًا من المظهر الافتراضي.
  • تحقّق في متصفّح حقيقي: اعرض وتحقّق ذاتيًا عبر نقاط التوقّف — واربط ذلك بوصفه خطّافًا إن أمكنك — كي لا تتكسّر التخطيطات بصمت على الجوال.
  • وفّر الرموز التصميمية والمراجع: تمثّل الرموز التصميمية الحقيقية ولقطات الشاشة المرجعية أكبر عامل مؤثّر منفرد في جودة المخرجات.
  • دوّن القواعد في ملفات التوجيه: ضع قواعد من نوع «لا بطاقات رئيسية، وخطّان كحدّ أقصى، وتراتبية تُقدّم الهوية البصرية» حيث يقرؤها الوكيل في كل تشغيل.

لاحظ أن كل إجراء تخفيفي يدور حول منح الوكيل سياقًا تصميميًا منسّقًا. والحفاظ على هذا السياق يدويًا، ولكل مشروع، هو العناء الذي يزيله Open Design.

التصميم باستخدام Kiro CLI داخل Open Design

Open Design هو طبقة التصميم مفتوحة المصدر التي يطلبها سير العمل أعلاه باستمرار. فهو يتعامل مع Kiro CLI بوصفه مُحوّلًا أصيلًا ويغلّفه بمكتبة منسّقة من المهارات وأنظمة التصميم، وخط معالجة عرض منظّم، وواجهة سطح مكتب محلية — بحيث يكون السياق التصميمي الذي يجعل Kiro جيدًا حاضرًا منذ التشغيل الأول، لا مُجمَّعًا يدويًا في كل مرة. وOpen Design يعمل محليًا أولًا، ما يُبقي الاقتران بسيطًا: تبقى ملفّاتك وتسجيل دخولك على جهازك.

  1. ثبّت Open Design واختر Kiro CLI وكيلًا لك.
  2. صادِق بمعرّف AWS Builder ID أو بتسجيل دخول آخر — تبقى بيانات الاعتماد على جهازك ولا تُمرَّر عبرنا أبدًا.
  3. اختر نظام تصميم ومهارة، ثم أنشئ العروض التقديمية والنماذج الأولية وصفحات الهبوط بذوق متّسق.
  4. كل ناتج وملف DESIGN.md يبقى في مستودعك الخاص، لا في سحابة مستضافة.

وكيل Kiro CLI نفسه، وتسجيل الدخول نفسه — مع سير عمل تصميمي حقيقي وقابل للنقل ومفتوح المصدر من حوله. وOpen Design يعمل محليًا أولًا ومرخّص بـ Apache-2.0، فلا يغادر جهازك أيُّ شيء من عملك أو بيانات اعتمادك.

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

  1. 01 هل يستطيع Kiro CLI فعلًا أداء العمل التصميمي؟

    نعم — فمع مهارة جمالية ونظام تصميم وصور مرجعية حقيقية في السياق، ينتج Kiro CLI واجهات متجاوبة بجودة الإنتاج، ويُبقي سيرُه المُوجَّه بالمواصفات البناءَ خاضعًا للمساءلة أمام القصد المعلَن. ودون ذلك السياق يميل إلى اللجوء افتراضيًا إلى مظهر عام، وهي الفجوة التي يسدّها Open Design.

  2. 02 هل أحتاج إلى حساب AWS لاستخدام Kiro CLI؟

    لا — يتيح لك Kiro تسجيل الدخول بمعرّف AWS Builder ID أو Google أو GitHub أو مؤسّستك (AWS IAM Identity Center)، ولا تحتاج إلى حساب AWS لاستخدامه. وKiro في معاينة ومجاني للبدء. ولا يمرّر Open Design بيانات اعتمادك في كل الأحوال.

  3. 03 ما الذي يجعل Kiro CLI جيدًا للتصميم تحديدًا؟

    سيرُ عمله المُوجَّه بالمواصفات: يكتب Kiro متطلّبات ووثيقة تصميم وقائمة مهام قبل أن يبرمج، فتصحّح التخطيط والنطاق قبل أن يلتزم البناء. وتحمل ملفات التوجيه أعرافك، وتستطيع الخطّافات إلزام الفحوص — لكن الذوق يبقى نابعًا من نظام التصميم والمهارة والمراجع التي توفّرها.

  4. 04 Kiro CLI أم Claude Code لتصميم الواجهات الأمامية؟

    كلاهما قوي. يُعرَف Claude Code بقراراته التصميمية المحدّدة والمدرِكة لقاعدة الشيفرة؛ أما ميزة Kiro CLI فهي سير عمله المُوجَّه بالمواصفات والقابل للمراجعة مع التوجيه والخطّافات. وتستخدم فِرق كثيرة كليهما — ويتيح لك Open Design تبديل الوكلاء دون تغيير سير عملك التصميمي.

  5. 05 كيف أربط Kiro CLI بأدوات تصميم خارجية؟

    يدير Kiro CLI خوادم بروتوكول سياق النموذج (MCP) — استخدم kiro-cli mcp لإضافتها. ويستطيع خادم MCP إدخال سياق تصميمي حقيقي وأدوات إلى الوكيل بحيث تطابق الشيفرة المُولَّدة المصدرَ بدلًا من تقريبه.

  6. 06 هل Open Design تابع لـ Amazon أو AWS؟

    لا. Kiro منتج تابع لـ Amazon (AWS)؛ وOpen Design مشروع مستقل مفتوح المصدر يدعمه بوصفه مُحوّلًا أصيلًا. وKiro علامة تجارية لـ Amazon.

  7. 07 هل ملفّاتي وبيانات اعتمادي آمنة؟

    نعم — فـ Open Design يعمل محليًا أولًا ومرخّص بـ Apache-2.0. تبقى ملفّاتك ونواتجك وملف DESIGN.md في مستودعك الخاص، ويُستخدَم تسجيل دخول Kiro مباشرةً من قِبل وكيلك، ولا يُمرَّر عبر خوادم Open Design أبدًا.

صمّم باستخدام Kiro CLI، بالطريقة المفتوحة.

أحضِر معرّف AWS Builder ID أو تسجيل دخولك الخاص، وأبقِ كل ملف محليًا، واحصل على مكتبة تصميم منسّقة من حول الوكيل الذي تستخدمه أصلًا.

● Apache-2.0 Apache-2.0 · صنع على الأرض · BYOK اطّلع على جميع الوكلاء المدعومين