المعرفة – أعط وكيل الترميز الخاص بك القرارات التي اتخذها فريقك
Quickstart · كيف تتم المقارنة · كيف يعمل · Docs · CLI · Changelog امنح وكيل البرمجة الخاص بك القرارات التي اتخذها فريقك بالفعل – حتى يتوقف عن إعادة القيام بالأشياء التي استبعدتها. يحتفظ Lore بالمعرفة المسجلة لفريقك – المتطلبات والقرارات والتصاميم وخرائط الطريق والمطالبات – كما هو مكتوب Markdown في الريبو الخاص بك ويقدمها للقراءة فقط لـ Claude Code وCursor وClaude Desktop عبر MCP، لذلك يستشهد الوكيل بقراراتك بدلاً من انتهاكها. لا توجد RAG، ولا عمليات تضمين، ولا توجد دعوة نموذجية لتحديد ما هو ذي صلة – فالاسترجاع أمر حتمي وقابل للتكرار. إنه مبني على RAC — المتطلبات كرمز، وهو المحرك مفتوح المصدر الموجود تحته؛ يتم شحن خادم الحزمة وCLI وMCP تحت اسم rac. المعرفة ليست فهرس بحث أو أداة ذاكرة – إنها نظام حتمي لتسجيل أساس الوكيل ضده. يعد الاسترجاع الغامض (RAG، ذاكرة الوكيل) جيدًا في العثور على ما هو قريب من سؤال فضفاض؛ يعتبر Lore جيدًا في إعادة القرار الدقيق والحالي ورفض القرارات التي حلت محلها. إنهم يؤلفون بشكل جيد – يتذكرون بشكل غامض، ثم يتحققون من المعرفة. الاسترجاع الغامض (RAG / ذاكرة الوكيل) جيد في القرار الدقيق الحالي للعثور على ما هو قريب من السؤال استرجاع حتمي، تصنيف التشابه القابل للتكرار، يختلف حسب التشغيل مصدر الحقيقة، للقراءة فقط فهرس سريع أو نسخة عمل في CI المفروضة (التحقق من صحة السباق / بوابة راك) ليست وظيفتها تثبيت المحرك: هوية السقالة والقطعة الأثرية الأولى: قم بتوصيل وكيلك (كود كلود، من جذر الريبو الخاص بك): كلود mcp add lore – rac mcp فرض في CI المعرفة السيئة جدًا لا تصل أبدًا: rac التحقق من صحة rac/ && rac gate rac/ Command يحصل على تثبيت rac-core the rac CLI + العلم تثبيت نقطة خادم MCP ‘rac-core(ingest)’ + DOCX / HTML import pip install ‘rac-core(ingest-all)’ + PDF / PPTX / XLSX import pip install ‘rac-core(explorer)’ + the يتطلب Terminal Explorer (rac Explorer) إصدار Python 3.11+. تعمل أداة تثبيت الأشعة فوق البنفسجية rac-core أيضًا. مكتوب تخفيض السعر، في الريبو الخاص بك. كل قطعة أثرية عبارة عن تخفيض بسيط مع مظروف أمامي صغير؛ يقوم المحرك بتصنيفها بشكل حتمي والتحقق من صحتها مقابل مخطط لكل نوع. للقراءة فقط في وقت الخدمة. خادم MCP يقرأ فقط؛ حدود الثقة هي مراجعة العلاقات العامة البشرية، ولا يمكن للوكيل تعديل المتجر. القسري في وقت الكتابة. يرفض التحقق من صحة rac وبوابة rac القطع الأثرية المشوهة، والروابط المعطلة أو الغامضة، والإشارات إلى القرارات التي تم استبدالها – في CI، قبل وصول المعرفة. فجوة الهواء حسب التصميم. لا يقوم المحرك بإجراء مكالمات LLM ولا يقوم بإجراء مكالمات عبر الشبكة؛ المخرج الوحيد هو اختبار اتصال الاستخدام الخالي من المحتوى والذي يتم إيقافه افتراضيًا، ويمكن أن تثبت عمليات التثبيت المنظمة بقاءه معطلاً مع إيقاف تشغيل القياس عن بعد rac –enterprise (الوضع الأمني، ADR-086). كود كلود (من جذر الريبو الخاص بك): claude mcp add lore — rac mcp Claude Desktop / Cursor (mcpServers in the client config): { “mcpServers”: { “lore”: { “command”: “rac”، “args”: (“mcp”، “–root”، “/absolute/path/to/your/repo”) } } } مؤلف وفرض القطع الأثرية rac Quickstart # إعداد الهوية + سقالة أول قطعة أثرية rac قرار جديد adr.md # سقالة قطعة أثرية مكتوبة (نعت المعرف) rac التحقق من صحة rac/ # تحقق من كل قطعة أثرية في الدليل rac فحص المتطلبات.md # انظر نوعها واكتمالها مراجعة rac rac/ # مراجعة المستودع الكاملة، أسوأ المشاكل أولًا بوابة rac rac/ # بوابة الدمج: التحقق من صحة + علاقات + مراجعة استيراد قرار موجود بالفعل لديك قرارات في التقاء أو فكرة أو فضفاضة تخفيض السعر؟ تعمل مهارة وكيل استيراد rac على تحويل مستند موجود إلى قطعة أثرية واحدة صالحة، مع خطوة مراجعة بشرية قبل كتابة أي شيء: مهارة rac تثبيت rac-import ثم اسأل وكيلك، بلغة واضحة: “قم باستيراد مستند القرار هذا إلى المعرفة.” إنه يُصاغ فقط مما تقوله وثيقتك، ويعرض لك النوع المقترح والعنوان والعلاقات للتأكيد، ويدعم مع rac new، ويغلق عند التحقق من صحة rac. بالنسبة للتحويل متعدد التنسيقات أو التحويلات المجمعة، استخدم مهارة استيعاب السباق. rac Export rac/ –html –out lore.html # البوابة: الرسم البياني بأكمله، ملف واحد rac Export rac/ –okf # حزمة تنسيق المعرفة المفتوحة المتوافقة rac Export rac/ –documents # JSONL للواجهات الخلفية للذاكرة/RAG rac Export rac/ –graph # الرسم البياني للقرار المكتوب للواجهات الخلفية للرسم البياني تغذي أوضاع –documents و –graph الذاكرة الخارجية وRAG وأدوات الرسم البياني حتى يتمكن الوكيل من التذكر بشكل غامض هناك و ثم تحقق في المعرفة – راجع مرجع CLI. الموصلات نفسها تعيش في رفيق موصلات المعرفة المنفصلة. المحرك عبارة عن مكتبة أيضًا؛ سطحه العام هو rac.__all__. from rac import parse_file, classify, find_artifacts art = parse_file(“rac/decisions/adr-001-markdown-first.md”) print(classify(art).type) # -> “decision” result = find_artifacts(“rac/”, “caching”) # يُرجع نتيجة البحث للنتيجة في result.matches: print(hit.id, hit.title) تنسيق المعرفة المفتوحة لـ Google (OKF) يعمل على توحيد الناقل – شجرة Git الخاصة بـ Markdown مع واجهة YAML – وهو متساهل بشكل متعمد. يكتب RAC نفس الناقل ويضيف ما يتركه OKF للمستهلك: فرض وقت الكتابة في CI. التحقق من صحة rac وعلاقات rac – التحقق من صحة رفض القطع الأثرية المشوهة، والروابط المعطلة، والإشارات إلى القرارات التي تم استبدالها، بشكل حتمي، قبل وصول المعرفة. rac Export –okf يحول أي RAC repo إلى حزمة OKF متوافقة – لذا فإن الاثنين يؤلفان بدلاً من التنافس. لقد سئمت الفرق التي تستخدم وكلاء الترميز بشكل كبير (Claude Code وCursor) من تجاهل الوكيل للقرارات التي اتخذها الفريق بالفعل. الفرق التي تكتب بالفعل ADRs وتريد أن تشكل هذه القرارات فعليًا ما يفعله الوكيل. أي شخص يريد السبب وراء إصدار برنامجه جنبًا إلى جنب مع الكود. التوثيق الكامل: https://itsthlore.github.io/rac-core/ العلم هو سطح منتج RAC – المتطلبات كرمز، المحرك مفتوح المصدر الموجود تحته؛ يتم شحن خادم الحزمة وCLI وMCP تحت اسم rac، والتقاليد هي هوية الخادم والعلامة التجارية. بدأ Wayfinder، جهاز التوجيه الحتمي والتعقيد الفوري، كتجربة مسار داخل RAC وتم تقسيمه إلى أداة خاصة به – يعد التوجيه مصدر قلق في وقت التشغيل، وليس اهتمامًا معرفيًا. rac-core/ src/rac/ المحرك: واجهة سطر الأوامر (CLI)، والأساسية، والخدمات، والمخرجات، وخادم MCP قيد التشغيل (rac mcp)، والمهارات المجمعة، والقوالب، وخطافات git rac/ the dogfood corpus – المتطلبات والقرارات والتصميمات وخرائط الطريق والمطالبات التي تحكم المشروع نفسه الاختبارات/ البطاريات لكل خدمة بالإضافة إلى تغطية الأدوات الأساسية / cli / artifacts (ADR-027) docs/ موقع التوثيق (MkDocs) أمثلة / العرض التوضيحي للتأريض، المنسوج في المجموعة وتركيبات الاختبار rac-localview/ عارض البوابة / الرسم البياني، الذي تم بيعه في المحرك pip install -e .(dev) python -m pytest ruff check، ruff format –check، و mypy src/ run in CI جنبًا إلى جنب مع البطاريات لكل خدمة (ADR-027). المعرفة مبكرة وتتطور بسرعة. يتم شحن خادم MCP اليوم. نرحب بالمساهمات والأفكار والتجارب – راجع CONTRIBUTING.md. ترخيص أباتشي 2.0.
تم النشر: 2026-06-29 05:40:00
مصدر: github.com
