الاستخدام
تهيئة قواعد الشيفرة الكبيرة
قائمة إعداد قواعد الشيفرة الكبيرة لـ Apothem: تسلسل السياق، والمهارات، والخطافات، والبحث بالرموز، وإيقاع المراجعة.
استخدم هذه الصفحة عندما يكون المستودع أوسع من أن تستوعبه مُطالبة واحدة، أو عندما يكون مسح الشجرة بالكامل مكلفًا، أو عندما يكون لكل خدمة أوامر بناء واختبار خاصة بها.
ابدأ من هنا
- ثبِّت محوِّل البيئة المستهدفة أو حدِّثه، ثم شغِّل
apothem verify --harness <name>. - أبقِ سطح السياق الجذري قصيرًا: خريطة المشروع، والأوامر الحرجة، والمؤشِّرات فقط.
- ضع الأعراف المحلية بجوار الشيفرة عندما تدعم البيئة المستهدفة السياق المتعدد الطبقات.
- انقل الإجراءات المتخصِّصة إلى
skills/أوrules/أو وثائق الأوامر مع مُرشِّحات المسارات. - استخدم عمّالًا مُفوَّضين للقراءة فقط للاستكشاف الواسع، ثم أعِد مجموعة نتائج مُوجَزة قبل التحرير.
- أضِف استثناءات الذاكرة المؤقتة والمُولَّدات والبناء والمورِّدين إلى سطح التجاهل في البيئة حيث يكون ذلك موثَّقًا.
- استخدم LSP أو أدوات الرموز عند توفرها؛ وإلا فاستخدم rg ومسارات مُضيَّقة ونطاقات ملفات صريحة.
- شغِّل أضيق أمر فحص أو اختبار يُغطِّي الشيفرة المُلامَسة؛ وشغِّل البوابة الكاملة قبل الإصدار.
خريطة الممارسات
| الممارسة | الربط في Apothem |
|---|---|
| سياق نحيل دائم التحميل | يُبقي src/apothem/rules/token-budget-discipline.md القواعد الدائمة قصيرة؛ وينبغي أن تحمل ملفات السياق الجذري المؤشِّرات والمزالق الحرجة فقط. |
| خبرة عند الطلب | يُعرِّف src/apothem/skills/README.md عُرف SKILL.md؛ وتُبقي القواعد المُرافِقة المُرشَّحة بالمسار الإجراءات الضيقة خارج السياق الأساسي. |
| سياق متعدد الطبقات | يُعلِن كل صف بيئة عن layered_context_surface في src/apothem/harnesses/<name>/capabilities.yml؛ ويبقى STANDARD-CONVENTION-PIN.md مرجع الصف. |
| استكشاف معزول | يربط دليل العمّال المُفوَّضين نوافذ سياق منفصلة وعقود إرجاع مُوجَزة. |
| التنقّل بالرموز | lsp_symbol_navigation هي خلية قدرة مُتتبَّعة. تبقى الصفوف على tracked-gap إلى أن يُثبَّت سطح إضافة أو أداة مدعوم من المورِّد. |
| سطح التجاهل | يُسجِّل context_ignore_surface آلية الاستثناء الموثَّقة. ويُسقِط محوِّل Claude Code استثناءات المُولَّدات والذاكرة المؤقتة عبر permissions.deny في settings.json. |
| تعلُّم الخطافات | تبقى خطافات فئة العبور صامتة. وتُوجَّه النتائج المتكررة عبر دورة تطوُّر الأدلة في src/apothem/rules/persistent-conventions-vigilance.md. |
| مراجعة دورية | شغِّل مراجعة تكوين كل ثلاثة إلى ستة أشهر، وبعد التغييرات الكبرى في البيئة أو النموذج، باستخدام إيقاع خطط *-maintenance. |
ملاحظات الصيانة
يحمل صف قدرة البيئة القابل للقراءة آليًّا أربع خلايا خاصة بقواعد الشيفرة الكبيرة:
context_ignore_surface، وlayered_context_surface، وlsp_symbol_navigation،
وhook_learning_capture. أبقِ هذه الخلايا متزامنة مع STANDARD-CONVENTION-PIN.md
الشقيق كلما تغيَّر سطح مورِّد.
مراجع المصدر: ممارسات قواعد الشيفرة الكبيرة، أذونات الإعدادات.