عن المشروع

CLI Printing Press هو مولّد ينتج أدوات سطر أوامر وخوادم MCP لواجهات برمجة التطبيقات أو المواقع الإلكترونية التعسفية، مع تركيز قوي على قابلية الاستخدام من قبل وكلاء الذكاء الاصطناعي. وهو مكتوب بلغة Go ويُوزَّع كملف ثنائي بالإضافة إلى مجموعة من مهارات الوكلاء (أوامر الشرطة المائلة) التي تقود الملف الثنائي. ما يفعله - يقرأ وثائق API الرسمية، ويدرس CLIs وخوادم MCP المجتمعية الشائعة، ويمكنه أيضًا هندسة عكسية لواجهات برمجة التطبيقات غير الموثقة عن طريق التقاط حركة مرور المتصفح. - يقبل مواصفات OpenAPI أو عنوان URL لموقع ويب أو ملف HAR كمدخلات. - ينتج ملفين ثنائيين لكل API: CLI قائم على Cobra (`<api>-pp-cli`) وخادم MCP (`<api>-pp-mcp`)، يتشاركان نفس رمز العميل والتخزين والمصادقة. - يولّد مستندات بحثية وإثباتات تحقق ودرجة جودة إلى جانب الكود. نقاط التصميم الرئيسية - طبقة بيانات محلية أولاً: جداول SQLite خاصة بالمجال، بحث نص كامل FTS5، مزامنة تدريجية مع تتبع المؤشر، وأمر `sql` للاستعلامات المباشرة. تعمل أوامر مثل `sync` و`search` و`sql` دون اتصال. - أوامر مركّبة: بمجرد أن تصبح البيانات محلية، يمكن لأوامر مثل `stale` و`health` و`bottleneck` و`reconcile` الربط عبر الموارد وتحليل السجل. - مخرجات صديقة للوكلاء: جداول قابلة للقراءة البشرية في الطرفية، JSON تلقائي عند الأنابيب، `--compact` لتقليل مخرجات الرموز، رموز خروج محددة (0/2/3/4/5/7)، `--dry-run`، `--select`، `--csv`، `--stdin`، وعلامات أخرى على كل أمر. - واجهة مزدوجة: يستهدف CLI الوكلاء القائمين على الصدفة، بينما يستهدف خادم MCP تكاملات IDEs مثل Claude Desktop وCursor. - التحقق: بطاقة أداء، واختبار ذاتي، وإثبات سلوك، واختبارات دخان API حية اختيارية تُستخدم لاكتشاف المسارات المختلقة والأعلام الميتة وعدم تطابق المصادقة. سير العمل - التثبيت عبر سكربت شل يشغّل `go install` للمولّد ويُثبّت المهارات عبر npm CLI `skills`. Claude Code هو الهدف الافتراضي والأفضل اختبارًا؛ Codex مدعوم بعلامة `--agent codex`. - داخل جلسة وكيل، يبدأ `/printing-press <app-name>` تشغيل التوليد. تتضمن الأوامر الإضافية `/printing-press-reprint` و`/printing-press-polish` و`/printing-press-publish` و`/printing-press-amend`. - يمر خط الأنابيب بمراحل: حل/إعادة استخدام، موجز بحثي، بوابة امتصاص النظام البيئي، بوابة فحص المتصفح، توليد، بناء GOAT، فحص الشحن، واختبار دخان حي اختياري. خط أنابيب مُدار أطول من 9 مراحل موثق للمستخدمين الذين يريدون إيقاف أو استئناف أو إعادة تشغيل خطوات فردية. - يتم تنظيم المخرجات تحت `~/printing-press/` مع أدلة منفصلة للتشغيلات النشطة وCLIs المنشورة والمخطوطات المؤرشفة. مفاهيم بارزة - "رؤية غير بديهية" (NOI): إعادة صياغة من جملة واحدة لما يكون API مفيدًا حقًا له، تُستخدم كأساس إبداعي للأوامر المولّدة. - "الامتصاص والتجاوز": فهرسة ميزات من الأدوات وخوادم MCP الموجودة، ومطابقتها، ثم إضافة قدرات مركّبة تتيحها البيانات المحلية. - "سلم إبداعي" من أغلفة نقاط النهاية البسيطة إلى أوامر الرؤى السلوكية. المتطلبات والتحفظات - يتطلب Go 1.26.6 أو أحدث، وNode/npm لـ `npx`، ووكيلًا يدعم المهارات (تم اختبار Claude Code). - يقدم ملف README ادعاءات بالأداء والجودة (على سبيل المثال، توفير الرموز والسرعة) وهي تأكيدات المشروع الخاصة وليست معايير تم التحقق منها بشكل مستقل. - لم يعد المستودع يحمل كتالوج مصادر؛ يتم الحفاظ على CLIs المنشورة في مستودع مكتبة منفصل.