نواة صغيرة، حدود حادة

يبقى Pi بسيطاً. ومهارات Felo تتولى العالم الخارجي.

يشحن Pi نواة وكيل صغيرة عن قصد، ويطلب منك توسيعها بالإضافات والمهارات وقوالب الطلبات والسمات والحزم. وتوسّعه مهارات Felo دون إضافة كود إلى النواة — بحث مباشر واستخراج صفحات ونصوص ومخرجات عروض تقديمية تصل كحِزم Markdown عادية.

مصمم لـ Pi~/.pi/agent/skillsبحث وشرائح ونصوص ومنصة X
ثبّت مهارةاطّلع على المقايضات

هارنس برمجي بسيط للطرفية

01ثبّت Pi
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
02جذور المهارات
~/.pi/agent/skills, ~/.agents/skills, .pi/skills, .agents/skills
03تثبيت الحزم
pi install npm:@scope/pkg أو pi install git:github.com/user/repo
04المعيار
Agent Skills — التنسيق نفسه لـ SKILL.md المستخدم في هارنسات أخرى
جرّبه في مجلد مشروعpi # ثم اطلب مهارة تجلب الصفحة بصيغة Markdown
نواة بسيطةالمهارات هي نقطة التوسيع، لا مزيد من الأدوات
أربعة جذور للمهارات~/.pi/agent/skills و .pi/skills و .agents/skills والحزم
npm أو curlثبّت الهارنس، ثم أضف المجلدات
بلا صندوق رملاقرأ كل حزمة قبل تثبيتها
توزيع العمل

ما يحتفظ به Pi، وما يجب أن تحمله المهارة

وثائق Pi صريحة في النطاق: النواة صغيرة عن قصد، وميزات مثل الوكلاء الفرعيين ووضع الخطة مستبعدة. والمهارات هي نقطة التوسيع المقصودة لمعرفة المهام — بما في ذلك المهام التي تخرج من الطرفية.

نواة Piمهارة Felo
ما هيزمن التشغيل، وإدارة الجلسة، وواجهة الطرفية، وتمديد المزوّد والنموذجحزمة SKILL.md تصف مهمة واحدة من أولها إلى آخرها
كيف تتغيّرإضافات TypeScript وحزم وإعدادات وسماتأضف مجلداً أو احذفه — بلا إعادة بناء ولا إعادة تشغيل للنواة
الأنسب لـجعل الهارنس يتصرف كما تعمل أنتجعل مهمة متكررة واحدة تنتج نتيجة موثوقة
الوصول إلى الويبمتروك للمزوّد وللأدوات التي تضيفهابحث مباشر واستخراج صفحات ونصوص مع قوائم مصادر
المخرجاتالطرفية أولاً، نص متدفق وفروقMarkdown وملاحظات بحث وعروض جاهزة للتسليم
عبء المراجعةتراجع إضافات تشغّل كوداً عشوائياًتقرأ إجراءً مكتوباً بـ Markdown قبل أن تثق به
المهارات المقترحة

خمس مهارات Felo تُبقي نواة Pi بعيدة عن الطريق

يحمّل Pi المهارات من ~/.pi/agent/skills و ~/.agents/skills، ومن .pi/skills و .agents/skills على مستوى المشروع، أو من مجلد skills/ داخل حزمة. أضف ما تحتاجه واترك الباقي.

Felo Search

إجابات مع مصادر
بحثمصادر

يبقى Pi بسيطاً عن قصد، فالمهارة هي طريقتك لإضافة مدى دون إضافة أدوات تحتاج إلى رعاية. تصل النتائج مؤرّخة ومربوطة، جاهزة للاستشهاد بها في الرد نفسه.

طلب نموذجيابحث عن إصدار Node الموصى به لهذه التبعية واستشهد بالمكان الذي قرأت فيه ذلك.
cp -r felo-skills/felo-search ~/.pi/agent/skills/
افتح صفحة Felo Search →

Felo Slides

عرض من الفرق
مخرجاتعرض

المراجعون يقرؤون العروض لا سجل تمرير الطرفية. يحوّل هذا ما وجدته الجلسة إلى شرائح دون مغادرة سير عمل Pi.

طلب نموذجيلخّص إعادة الهيكلة هذه في خمس شرائح: ما انتقل، وما انكسر، وما يحتاج مراجعة.
cp -r felo-skills/felo-slides ~/.pi/agent/skills/
افتح صفحة Felo Slides →

Felo YouTube Subtitling

نصوص بلا متصفح
فيديونص

لا يملك Pi لوحة متصفح، فمحتوى الفيديو عادةً خارج المدى. هذا يسحب التسميات التوضيحية ويعيد نصاً تستطيع الجلسة البحث فيه.

طلب نموذجيأحضر النص المفرّغ لهذا الحديث واستخرج كل رقم قياس يستشهد به.
cp -r felo-skills/felo-youtube-subtitling ~/.pi/agent/skills/
افتح صفحة Felo YouTube Subtitling →

Felo X Search

ما يبلغ عنه الناس على X
إشاراتتواصل اجتماعي

يستحق التشغيل قبل الإصدار: تحقّق مما إذا كان آخرون على هذا الإصدار يواجهون الخطأ نفسه الذي تحدّق فيه.

طلب نموذجيابحث على X عن أخطاء من إصدار هذه المكتبة وأدرج أكثر ثلاثة أخطاء تكراراً.
cp -r felo-skills/felo-x-search ~/.pi/agent/skills/
افتح صفحة Felo X Search →

Felo SuperAgent

صور الهوية والمنتج
صورهوية

عندما يحتاج المشروع أيقونة موقع أو شعاراً مركّباً أو صورة منتج، تستطيع الجلسة نفسها توليده والتنويع عليه بدلاً من تسليمك طلباً لتشغيله في مكان آخر.

طلب نموذجيارسم شعاراً لهذه الحزمة بثلاثة اتجاهات واحفظ النسخ كملفات.
cp -r felo-skills/felo-superagent ~/.pi/agent/skills/
افتح صفحة Felo SuperAgent →
الفهرس الكامل

اختر مهارة Felo لتثبيتها على Pi

يحمّل Pi المهارات من مجلد تملكه، فإضافة واحدة مجرد نسخ. اختر المهمة التالية التي تريد إنجازها: البحث أو الاستخراج أو الشرائح أو النصوص أو المراقبة الاجتماعية أو سير عمل طويل المدى.

أضف على Pi

Felo Search

بحث مباشر على الويب بمصادر قابلة للاستشهاد

cp -r felo-skills/felo-search ~/.pi/agent/skills/

Felo Web Fetch

حوّل الصفحات إلى بيانات منظمة قابلة لإعادة الاستخدام

cp -r felo-skills/felo-web-fetch ~/.pi/agent/skills/

Felo LiveDoc

إجابات مستندة إلى مستنداتك أنت

cp -r felo-skills/felo-livedoc ~/.pi/agent/skills/

Felo YouTube Subtitling

تفريغ نصي للمحاضرات والعروض والمراجعات

cp -r felo-skills/felo-youtube-subtitling ~/.pi/agent/skills/

Felo X Search

تابع المنشورات والردود على X

cp -r felo-skills/felo-x-search ~/.pi/agent/skills/

Felo Slides

أنشئ عرضًا من طلب واحد

cp -r felo-skills/felo-slides ~/.pi/agent/skills/

Felo Content to Slides

حوّل الملاحظات والروابط إلى مخطط عرض

cp -r felo-skills/felo-content-to-slides ~/.pi/agent/skills/

Felo SuperAgent

مسارات عمل طويلة تحتفظ بذاكرتها

cp -r felo-skills/felo-superagent ~/.pi/agent/skills/

Website Screenshot Agent

احفظ الصفحات كلقطات وMarkdown

cp -r felo-skills/doc-screenshot-agent ~/.pi/agent/skills/

Felo Twitter Writer

اكتب مسودات منشورات X من موادك الخاصة

cp -r felo-skills/felo-twitter-writer ~/.pi/agent/skills/

Felo Landing Page

أنشئ صفحة هبوط من موجز

cp -r felo-skills/felo-landingpage ~/.pi/agent/skills/

Apple Buy Advisor

بحث عن منتجات Apple قبل الشراء

cp -r felo-skills/apple-buy-advisor ~/.pi/agent/skills/

تريدها على نطاق المشروع؟ انسخها إلى .pi/skills/ واثق بالمشروع عندما يسألك Pi.

مسار التبنّي

كيف يضيف مستخدمو Pi مهارات Felo

يبدأ مستخدمو Pi عادةً بتثبيت مجلد مهارة واحد، ويبقون الجلسة مفتوحة، ولا يضيفون مهارات الإخراج إلا بعد أن ينجح البحث.

ثبّت مجلد مهارة واحد

يقرأ Pi المهارات من طبقة المستخدم أو المشروع أو حزمة، فابدأ بأضيق نطاق.

  • ~/.pi/agent/skills لكل مشروع على الجهاز
  • .pi/skills لمستودع واحد فقط
  • مجلد skills/ داخل حزمة عندما يتشارك فريق الإعداد نفسه

شغّل طلب البحث الأول

تظهر القيمة أول مرة تجيب فيها الجلسة بمصدر بدلاً من تخمين.

  • قارن تبعية مثبّتة بملاحظات إصدار اليوم
  • تحقّق من تنبيه أمني قبل الدمج
  • أبقِ الإجابة في الطرفية، لا في تبويب متصفح

أضف مهارات الإخراج

بعد أن ينجح البحث، تستطيع الجلسة نفسها إنتاج ما يقرؤه الفريق فعلاً.

  • شرائح من الفرق أو من التحقيق
  • نصوص من حديث أو عرض توضيحي
  • تقارير X قبل الإصدار، وصور عندما يحتاج المشروع شعاراً
التثبيت

انسخ مجلداً، أو أضفه كحزمة

طريقان: النسخ المباشر يعمل في كل مكان، وحزم Pi هي الخيار الأنظف عندما تريد الحزمة نفسها على عدة أجهزة.

  1. 01

    ثبّت Pi وسجّل الدخول

    استخدم npm install أو مثبّت الصدفة، ثم شغّل pi داخل مجلد مشروع وسجّل الدخول عبر /login أو بمفتاح API من مزوّد.

    الطرفية
    npm install -g --ignore-scripts @earendil-works/pi-coding-agent
    # or
    curl -fsSL https://pi.dev/install.sh | sh
    
    # then, in a project directory
    pi
  2. 02

    جهّز بيانات اعتماد Felo

    المهارات تستدعي Felo CLI، فثبّته مرة واحدة واحفظ المفتاح خارج المستودع.

    الطرفية
    npm install -g felo-ai
    felo config set FELO_API_KEY your-api-key-here
  3. 03

    أضف المهارات

    المهارات العامة تعيش تحت ~/.pi/agent/skills. ومهارات المشروع مكانها .pi/skills ولا تُحمَّل إلا بعد أن تأتمن المشروع. وإن أبقيت مجلداً مشتركاً لعدة هارنسات، فيعمل ~/.agents/skills أيضاً.

    الطرفية
    git clone https://github.com/Felo-Inc/felo-skills.git
    
    # Every project on this machine
    mkdir -p ~/.pi/agent/skills
    cp -r felo-skills/felo-search ~/.pi/agent/skills/
    
    # Or just this repository
    mkdir -p .pi/skills
    cp -r felo-skills/felo-search .pi/skills/

    يمكنك أيضاً تحميل حزمة دون نسخها: pi --skill /path/to/felo-search. والعلَم إضافي حتى عندما تبدأ بـ --no-skills.

  4. 04

    تحقّق مما حمّله Pi

    يتحقق Pi من المهارات وفق معيار Agent Skills ويبلّغ عن معظم المخالفات. اطلب قائمة المهارات، ثم شغّل المهمة التي تهمك فعلاً.

    اسأل Pi
    ما المهارات المتاحة في هذه الجلسة؟ ثم استخدم felo-search
    لجلب ملاحظات الإصدار الخاصة ببرنامج قاعدة البيانات لدينا.
عملياً

ما يتغيّر في يوم من جلسات Pi

ثلاث لحظات يومية تتفوق فيها مهارة على إضافة أخرى.

01

أصلح خللاً وفق سلوك المكتبة الحالي

يشير أثر التتبّع إلى إحدى التبعيات، وإصدارك المثبّت متأخر بإصدارين عن الوثائق.

الأمر النصياجلب الوثائق الحالية لهذه الدالة، وقارن التوقيع بالإصدار المثبّت، وصلّح موضع الاستدعاء.
ما يعود إليك

تصحيح مع الوثائق الدقيقة التي بُني عليها، بدلاً من تخمين يُصرّف لكنه يتصرف بغرابة.

Felo SearchFelo YouTube Subtitling
02

جهّز موجزاً تقنياً أثناء البرمجة

تحتاج إلى شرح قرار «نبني أم نشتري» لفريق لا يقرأ المستودع.

الأمر النصيابحث عن الأسعار والحدود الحالية لهذه الخدمات الثلاث واكتب ست شرائح أستطيع تحريرها.
ما يعود إليك

مقارنة موثّقة ومسودة عرض، أُنتجتا في الجلسة الطرفية نفسها.

Felo SuperAgentFelo Slides
03

لحق بحدث إصدار مسجّل

حديث إطلاق من مورّد يذكر تغييراً في السلوك لم يصل قط إلى سجل التغييرات.

الأمر النصياسحب النص المفرّغ، وأدرج كل تغيير سلوك مذكور، وتحقق من أيّها يمسّ إعداداتنا.
ما يعود إليك

قائمة تحقق مبنية على التسجيل، مع طوابع زمنية تستطيع التحقق منها.

Felo YouTube Subtitling
أسئلة

أسئلة تظهر في جلسة Pi

ما الفرق بين إضافة Pi ومهارة Felo؟
الإضافات كود TypeScript يغيّر طريقة عمل الهارنس. أما المهارات فهي إجراءات Markdown يحمّلها الوكيل عند الطلب. وحِزم Felo مهارات، لذا لا تُنفَّذ داخل نواة Pi كما تفعل الإضافة.
أين يبحث Pi عن المهارات؟
عالمياً في ~/.pi/agent/skills و ~/.agents/skills؛ ولكل مشروع في .pi/skills و .agents/skills بعد الوثوق بالمشروع؛ وداخل الحزم عبر مجلد skills/ أو مدخل pi.skills في package.json.
هل أستطيع توزيع مهارات Felo على فريق عبر npm؟
تدعم حزم Pi مسارات npm و git والمسارات المحلية. وإن كان فريقك يثبّت حزماً مشتركة عبر pi install، فيمكن لحِزم Felo أن تُشحن معها في الحزمة نفسها تحت مجلد skills/.
هل تحتاج مهارات Felo مفتاح API داخل المستودع؟
لا. يقرأ Felo CLI الملف ~/.felo/config.json. أبقِ المفتاح في إعداد المستخدم حتى لا يصل أبداً إلى commit في المشروع.
لا يملك Pi صندوق رمل للصلاحيات. هل هذا مشكلة للمهارات؟
إنه سبب لقراءة ما تثبّته قبل تثبيته. تقول ملاحظات Pi الأمنية إن المهارات تستطيع أن توجّه النموذج لتشغيل أي شيء يستطيع المستخدم تشغيله. التزم بالحِزم التي راجعتها، وفضّل ما يمكنك قراءته في دقيقة.
بأي مهارة Felo أبدأ؟
ابدأ بـ felo-search إن كان عملك يعتمد على إصدارات أو أسعار أو تنبيهات حديثة.

أبقِ النواة صغيرة. وأضف القدرة التي تحتاجها.

انسخ مجلداً واحداً إلى ~/.pi/agent/skills، وأعد تشغيل الجلسة، واسأل Pi سؤالاً يحتاج الويب المباشر.

Felo AI ناشر مستقل للمهارات. أما Pi فيصونه Earendil Inc.

إلى ما هو أبعد من المهارات الجاهزة

مفتاح API واحد. مجموعة أدوات كاملة للوكيل.

ابدأ بمهارة، ثم ركّب النماذج والبيانات الحية والمعرفة وأدوات الإخراج التي يحتاجها سير عملك على Pi Coding Agent — بالمفتاح نفسه الذي تستخدمه مهارات Felo بالفعل.

النماذج

استخدم وصولًا اقتصاديًا إلى نماذج LLM عندما يحتاج وكيلك إلى استدلال أو توليد مخصص.

  • LLM API
  • Chat completions
  • الوصول إلى النماذج
استكشف LLM API →

المعرفة والإخراج

ابنِ العمل على معرفة قابلة لإعادة الاستخدام، ثم حوّلها إلى مخرجات قابلة للمشاركة.

  • LiveDoc
  • توليد PPT
  • الخرائط الذهنية
استكشف أدوات المعرفة →

أدوات إبداعية

وسّع سير العمل من البحث إلى نتائج بصرية وجاهزة للاستخدام في Office.

  • توليد الصور
  • أدوات الصفحات
  • مخرجات Office
استكشف أدوات المنصة →