Apothem مقابل تهيئة Kiro اليدوية
صيانة ملفّات توجيه Kiro ضمن .kiro/steering/ يدويًّا، مقابل تصييرها من الملف التعريفي المشترك لـ Apothem.
يقرأ Kiro التوجيه من دليل .kiro/steering/ مكوَّن من ملفّات
Markdown. ويصيّر محوِّل kiro في Apothem ملفّ توجيه
apothem-rules.md مخصّصًا من الملف التعريفي المشترك. وتقابل هذه الصفحة بين صيانة
تلك التهيئة يدويًّا وإدارتها بـ Apothem.
مقارنة الجهد
| المهمة | تهيئة يدوية | يديرها Apothem |
|---|---|---|
| كتابة قواعد التوجيه | كتابة كلّ ملفّ ضمن .kiro/steering/ يدويًّا | مُصيَّرة من المتن المشترك |
| إبقاء ملفّات الأساس دون مساس | تذكُّر عدم استبدال product.md / tech.md / structure.md | يكتب المحوِّل ملفّ apothem-rules.md فقط |
| إبقاء القواعد متوائمة مع أُطُر العمل الأخرى | يدويًّا، لكل أداة | تلقائيًّا عند apothem update |
| مشاركة المهارات والأوامر القابلة لإعادة الاستخدام | نسخ كل مجلد مهارة يدويًّا إلى ~/.kiro/skills/ وإبقاء النسخ محدَّثة | يكتبها المحوِّل في ~/.kiro/skills/، نسخة واحدة لكل المشاريع، ويُحدِّثها عند apothem update |
| إبقاء المساعِدات القابلة لإعادة الاستخدام متزامنة | كتابة كل ملف وكيل مخصّص يدويًّا ضمن .kiro/agents/ وتتبّع فئات أدوات Kiro | أربعة عشر مساعِدًا تُكتب في .kiro/agents/ مع ترجمة أدواتها، وتُحدَّث عند apothem update |
| التحقّق من صحّة التهيئة | فحص يدوي | apothem verify --harness kiro --project <path> |
ما الذي يديره Apothem
يصيّر محوِّل kiro القواعد المشتركة في ملفّ توجيه apothem-rules.md
مخصّص يحمل بيانات أمامية inclusion: always، ولا يمسّ ملفّات الأساس التي
كتبها مشغّل Kiro. ويكتب أيضًا مساعِدات Apothem الأربعة عشر بوصفها وكلاء
مخصّصين لـ Kiro في <project>/.kiro/agents/، لكلٍّ من Kiro IDE 1.0
وKiro CLI V3. ويوثّق Kiro خطّافات الوكلاء، ولا يكتبها المحوِّل، لذا
يسكن مقصد المتراس في نصّ القواعد بدلًا من نقطة اعتراض لاستدعاء الأداة. وكلّ تغيير في
القواعد المشتركة يعيد تصيير الملفّ عند apothem update التالي.
مسار الترحيل
- شغّل
apothem profile initلإنشاء الملف التعريفي المشترك إن لم تكن قد فعلت بعد. - انقل القواعد من
.kiro/steering/الموجود لديك إلى المتن المشترك. - شغّل
apothem install --harness kiro --project <path>لتصيير ملف التوجيهapothem-rules.md. - شغّل
apothem verify --harness kiro --project <path>للتأكّد من وصول التهيئة. - استخدم
apothem update --harness kiro --project <path>مع كل تغيير لاحق.