Kiro
محوّل أداة Apothem لـ Kiro (إصدار عام).
المورّد: AWS
اسم التثبيت: kiro
الحالة: إصدار عام
الإعداد الأصلي: <project>/.kiro/steering/apothem-rules.md
التثبيت
apothem install --harness kiro --project /path/to/projectيكتب المحوّل ملفّ توجيه (steering) واحدًا لـKiro على نطاق المشروع، انطلاقًا من قواعد Apothem المشتركة وسطح الحوكمة.
الملفات المكتوبة: <project>/.kiro/steering/apothem-rules.md
تعيين الملف التعريفي إلى الإعداد الأصلي
يقرأ المحوّل الملف التعريفي المشترك لـApothem ويجسّد ملفّ توجيه المشروع
في كلّ عملية apothem install أو apothem update. الملف
التعريفي المشترك هو مصدر الحقيقة؛ وتُنسَخ احتياطيًا التعديلات المحلّية للمشروع على
الملفّ المُولَّد قبل أن تستبدل المزامنة التالية المحتوى الذي يديره Apothem.
ملاحظات التوافق
سطح التوجيه في Kiro على نطاق المشروع تحت .kiro/steering/.
يكتب المحوّل ملفّ توجيه مُخصّصًا apothem-rules.md يحمل البيانات الأمامية
inclusion: always، ولا يطمس أبدًا ملفات الأساس التي كتبها مشغّل
Kiro (product.md وtech.md وstructure.md).
تخصّ مواصفات Kiro (.kiro/specs/) وخطافات المساعِدات المشغّلَ؛
ولا يكتبها Apothem.
التحقّق
apothem verify --harness kiro --project /path/to/projectيؤكّد أمر التحقّق ما يلي:
- وجود الإعداد الأصلي في المسار المتوقَّع.
- وجود جميع الحقول الإلزامية من الملف التعريفي المشترك.
- إبلاغ روتين التحقّق الخاص بالمحوّل بالنجاح.
التحديث
apothem update --harness kiro --project /path/to/projectيعيد اشتقاق ملفّ توجيه المشروع من الحالة الراهنة للملف التعريفي المشترك.
إلغاء التثبيت
apothem uninstall --harness kiro --project /path/to/projectيزيل ملفات الإعداد الأصلي التي كتبها المحوّل. لا يتأثّر ملفّ YAML الخاص بالملف التعريفي المشترك ولا محرّك Apothem.
بوّابة المطابقة
python -m apothem.conformity.gate --all .استكشاف الأخطاء وإصلاحها
| العَرَض | الإصلاح |
|---|---|
| ملف الإعداد غير موجود | أعد تشغيل apothem install --harness kiro --project /path/to/project |
| فشل التحقّق | شغّل apothem update --harness kiro --project /path/to/project، ثم تحقّق مجدّدًا |
| محتوى إعداد غير متوقَّع | تحقّق من ~/.config/apothem/profile.yaml أو --profile PATH، ثم أعد تشغيل apothem update --harness kiro --project /path/to/project |
مفاتيح الضبط
| العَلَم | الافتراضي | الوصف |
|---|---|---|
--dry-run | false | معاينة التثبيت دون كتابة ملفات. |