أوامر خط الأنابيب
/plan-generate
/plan-generate — يُولّد حزمة خطة رئيسية كاملة من ملف `_spec/spec.md` المكتوب.
الدور: المُولِّد الموضع في خط المعالجة: وسطي
يُولّد حزمة خطة رئيسية كاملة من ملف _spec/spec.md المكتوب.
الاستدعاء المعياري
/plan-generateمع الوسائط:
/plan-generate [path/to/prose.md] [--mode NEW|OVERHAUL] [--seriousness LEVEL] [--context CONTEXT] [--mission MISSION] [--domain DOMAIN] [--dry-run]المدخلات
ملف _spec/spec.md المكتوب + _inputs/handoff-manifest.yml من /plan-spec (أو نثر يقدّمه المشغّل).
المخرجات
PREAMBLE.md، وMASTER-PLAN.md، وPROGRESS.md، وPLAN-NOTES.md، وملفات phases/**/PHASE.md لكل مرحلة، إضافةً إلى _inputs/handoff-manifest.yml المُعزَّز.
المراحل اللاحقة
/plan-review أو /plan-execute (المستهلِك اللاحق)
مراحل سير العمل
يُولّد الأمر حزمة خطة رئيسية كاملة من المواصفة المكتوبة:
- استيعاب المتطلبات — قراءة
_spec/spec.mdوبيان التسليم الأعلى منه؛ والرفض بـBlocked: run /plan-spec firstعند غياب المواصفة. - الاكتشاف — تشغيل اكتشاف مُقاس بالجدّية مع المرشّحات الإدراكية الخمسة؛ وحسم كل فجوة بيانات موثوقة عبر قناة الاستفسار المُهيكَل.
- التفكيك — تجزئة العمل إلى رسم مراحل لا دوري بترتيب تبعية صريح.
- إصدار الحزمة — كتابة
PREAMBLE.md، وMASTER-PLAN.md، وPROGRESS.md، وPLAN-NOTES.md، وكلphases/NN-topic/PHASE.md. - تشغيل بوّابة ما قبل الإصدار — تشغيل المسح ذي الخمسة عشر شريطًا مقابل كل ناتج مُصدَر؛ والفشل يمنع موافقة المستخدم حتى الحلّ.
أنماط الفشل
| العَرَض | السبب | المعالجة |
|---|---|---|
| Blocked: run /plan-spec first | لا توجد _spec/spec.md مكتوبة | شغّل /plan-spec لكتابة المواصفة وإصدار البيان |
توليد مقابل ملف _inputs/ | المواصفة لا تزال أثناء الاستنباط | رقِّ _inputs/forge.md إلى _spec/spec.md عبر /plan-spec أولًا |
| يُخفِق شريط ما قبل الإصدار | ناتج مُصدَر يُخفِق في البوّابة | أصلح الشريط المُخفِق قبل موافقة المستخدم |
أمثلة
# تشغيل تجريبي لمعاينة رسم المراحل المُولَّد
/plan-generate --dry-run
# توليد حزمة من نثر مكتوب
/plan-generate path/to/prose.md --mode NEW