أدلة التأليف وخط الأنابيب العملية

إرشادات موجَّهة إلى المهام لـ تأليف قطع Apothem وتشغيل خط أنابيب الخطّة. يجيب كل دليل عن سؤال ملموس واحد.

لوصفات الإعداد الأول — إضافة إطار عمل، وتحرير الملف التعريفي، وتشغيل المثبّت — انظر قسم وصفات الإرشاد العملي بدلًا من ذلك.

خط أنابيب حزمة الخطّةCopy Anchor Link

كيف أنقّح محتوى خامًا إلى مواصفة؟Copy Anchor Link

استدعِ /plan-spec مع المحتوى الخام مدخلًا. يشغّل دور Forge ست مراحل تحويل (الاكتشاف، والاعتبار الدقيق، وتخطيط الفاعلية، والتحقق من الحفظ، وتطبيق الخبرة، ومسح حلّ الأسئلة)، ويُصدر المواصفة المُجمَّعة في .apothem/plans/{suite}/_spec/spec.md. انظر src/apothem/commands/plan-spec.md للبروتوكول الكامل.

كيف أولّد حزمة خطّة من مواصفة؟Copy Anchor Link

استدعِ /plan-generate .apothem/plans/{suite}/_spec/spec.md بمجرّد أن يكتب /plan-spec المواصفة. يُصدر المولّد ملفات البنية التحتية المعيارية، إضافةً إلى ملفات phases/NN-kebab-topic/PHASE.md الخاصة بكل مرحلة. انظر src/apothem/commands/plan-generate.md.

كيف أراجع خطّة مولَّدة؟Copy Anchor Link

استدعِ /plan-review path/to/plan-suite/. يطبّق المراجِع تسع تقنيات للتخطيط ويُصدر بطاقات التقييم. تحجب بطاقات التقييم الفاشلة التنفيذ عند SHARED+ حتى تُحَلّ. انظر src/apothem/commands/plan-review.md.

كيف أنفّذ خطّة؟Copy Anchor Link

استدعِ /plan-execute path/to/plan-suite/ [phase-id]. بدون phase-id تُشغَّل المرحلة المعلّقة التالية. ومع معرّف محدّد لا تُشغَّل إلا تلك المرحلة. انظر src/apothem/commands/plan-execute.md.

كيف أتحقّق من حالة الخطّة؟Copy Anchor Link

استدعِ /plan-status path/to/plan-suite/ [--verbose]. تقرير للقراءة فقط. انظر src/apothem/commands/plan-status.md.

تأليف القطعCopy Anchor Link

كيف أضيف قاعدة جديدة؟Copy Anchor Link

1. اختر اسم ملف بصيغة kebab-case ضمن src/apothem/rules/، مثل src/apothem/rules/my-new-rule.md.
2. ألّف الـfrontmatter (name، وdescription، وpathFilter، وalwaysApply).
3. اكتب النص بالأقسام المعيارية: Purpose، وObligations، وSeriousness Scaling، وAnti-Patterns، وEnforcement، وBindings.
4. شغّل python scripts/dev/validate_ecosystem.py --check frontmatter-cohort للتحقق.

محمّل القواعد يعتمد على glob، فهو يلتقط كل ملف يطابق src/apothem/rules/*.md، ولا يحتاج الأمر إلى أي مُدخل في سجلّ؛ إذ إن إسقاط الملف المُسمّى وفق الاصطلاح المعياري داخل المجلد هو التسجيل بأكمله.

كيف أضيف عاملًا مفوَّضًا جديدًا؟Copy Anchor Link

اختر اسم ملف بصيغة kebab-case ضمن المجلد المعروض أدناه، على الشكل my-worker.md:

src/apothem/agents/
src/apothem/agents/my-worker.md

ثم:

1. ألّف الـfrontmatter، متضمّنًا name، وversion، وupdated، وdescription، وtools، وdisallowedTools، وmaxTurns، وeffort.

2. اكتب موجّه النظام بوصفه متن الملف.

تُحمَّل حزمة العمّال المفوَّضين عبر glob من src/apothem/agents/*.md، فيُلتقط الملف المُسمّى وفق الاصطلاح المعياري عند وضعه في موضعه، ولا يوجد جدول سجلّ لتحريره.

كيف أضيف خطّافًا جديدًا؟Copy Anchor Link

1. ألّف رسالة سياق تحت src/apothem/hooks/messages/<event>-<scope>.md.
2. وصّل الخطّاف في settings.json.
3. حدّث خط أنابيب الخطّافات.
4. شغّل python scripts/dev/validate_ecosystem.py.

بوابات الجودةCopy Anchor Link

كيف أشغّل بوابات الجودة المحلية؟Copy Anchor Link

python -m ruff check .
python -m ruff format --check .
python -m mypy
python -m pytest -q
python scripts/dev/validate_ecosystem.py
python scripts/dev/chaos_pass.py

يشغّل خط أنابيب التكامل المستمر (CI) المجموعة ذاتها بالتوازي.

كيف أتحقّق من الـfrontmatter لصنف قطعة واحد؟Copy Anchor Link

python scripts/dev/validate_ecosystem.py --check frontmatter-cohort