مشبك الورق: أداة مجانية تحول وكلاء الذكاء الاصطناعي إلى فريق برمجيات

تفضل ترجمة الـ HTML إلى العربية:

يواجه معظم المطورين الذين يديرون العديد من وكلاء الذكاء الاصطناعي نفس العقبة عند الوكيل رقم خمسة. لديك Claude Code في نافذة طرفية واحدة تعيد كتابة خدمة خلفية، وCodex في أخرى يولد الاختبارات، وCursor يقوم بتحرير مكون، وثلاث علامات تبويب أخرى نسيت التحقق منها. لا أحد يعرف ما يفعله الآخر. تتصاعد التكاليف. يتكرر نفس العمل بواسطة وكيلين. يعمل أحدهما لمدة ست ساعات ولا ينتج أي شيء مفيد لأن أحداً لم يمنحه هدفاً واضحاً.

Paperclip يصلح هذا. إنه منصة تنسيق مفتوحة المصدر تحول وكلاء الذكاء الاصطناعي المتناثرين لديك إلى شركة منظمة، مكتملة بخرائط تنظيمية، أدوار محددة، إدارة مهام، حدود ميزانية، وسجلات تدقيق. حقق أكثر من 35,000 نجمة على GitHub في أقل من ثلاثة أسابيع، وهذا يخبرك كم عدد المطورين الذين كانوا يعانون من نفس الإحباط.

button

يوضح لك هذا المقال كيفية إعدادها، وهيكلة أول شركة وكلاء لك، وتشغيلها بحيث يتم إنجاز العمل بالفعل دون الحاجة إلى مراقبة كل نافذة طرفية.

ما هو Paperclip (وما ليس هو)

قبل تثبيت أي شيء، افهم ما ستحصل عليه.

Paperclip هو طبقة تنسيق. يقوم بتنسيق الوكلاء، وتتبع عملهم، والتحكم في ميزانياتهم، ويزودهم بالسياق حول أهداف الشركة. لا يقوم ببناء وكلاء، ولا يحل محل مزود الذكاء الاصطناعي الخاص بك، ولا يضيف واجهة دردشة.

النموذج الذهني الذي يستخدمه فريق Paperclip: "إذا كان Claude Code موظفاً، فإن Paperclip هي الشركة."

هذا يعني:

الوكلاء لديهم أدوار، وليس مجرد أوامر (prompts)
المهام لها أصحاب، وليس مجرد نوافذ طرفية مفتوحة
الميزانيات لها حدود صارمة، وليس مجرد تقديرات
يتم تسجيل كل شيء في مسار تدقيق

يعمل Paperclip مع Claude Code، OpenAI Codex، Cursor، Gemini CLI، وأي وكيل يمكنه استقبال إشارة webhook أو heartbeat. أنت من يجلب الوكلاء. Paperclip تدير الشركة.

إنه ليس بشكل صريح:

واجهة مستخدم لروبوت الدردشة
منشئ سير عمل بالسحب والإفلات مثل n8n أو Zapier
إطار عمل لكتابة الوكلاء
مفيد لحالات الاستخدام الفردية للوكيل

إذا كنت تدير وكيل ذكاء اصطناعي واحداً من حين لآخر، فإن Paperclip مبالغة. إذا كنت تدير ثلاثة وكلاء أو أكثر في عمل مستمر، فهو الجزء المفقود.

تثبيت Paperclip

تحتاج إلى Node.js 20+، و pnpm 9.15+، وهذا كل شيء. يأتي Paperclip مع قاعدة بيانات PostgreSQL مدمجة، لذا لا تحتاج إلى إعداد تخزين خارجي.

أسرع طريقة للبدء:

npx paperclipai onboard --yes

يقوم هذا بتنزيل واجهة سطر الأوامر (CLI)، وتشغيل الإعدادات الافتراضية المعقولة، وبدء تشغيل الخادم على المنفذ 3100. افتح http://127.0.0.1:3100 وستشاهد لوحة التحكم.

إذا كنت ترغب في المساهمة أو التعمق في الكود:

git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm dev

إذا كنت تفضل Docker:

docker compose -f docker-compose.quickstart.yml up --build

ما الذي يتم إنشاؤه على القرص:

يخزن Paperclip كل شيء تحت ~/.paperclip/instances/default/:

~/.paperclip/instances/default/
  config.json          — server and storage settings
  db/                  — embedded PostgreSQL data files
  secrets/master.key   — encryption key (auto-generated)
  logs/                — server logs
  data/storage/        — file attachments
  workspaces/<agent>/  — per-agent working directories

يستخدم الوضع المحلي مصادقة local_trusted افتراضياً، والتي تتجاوز تسجيل الدخول وتستخدم مستخدم "Board" صناعياً. يمكنك البدء في استخدام لوحة التحكم على الفور، لا حاجة لإنشاء حساب.

بمجرد الدخول، قم بتشغيل فحص الصحة:

paperclipai doctor

إذا كان هناك أي شيء غير مهيأ بشكل صحيح، يقوم --repair بإصلاح معظم المشكلات تلقائياً:

paperclipai doctor --repair

إعداد شركتك الأولى

في Paperclip، "الشركة" هي الحاوية العليا لوكلائك ومهامك وأهدافك وميزانياتك. فكر فيها كمشروع، إلا أن كل عضو في المشروع هو وكيل ذكاء اصطناعي له دور وخط إبلاغ.

من لوحة التحكم، أنشئ شركة جديدة وامنحها بيان مهمة. هذا ليس مجرد ديكور. كل مهمة يتلقاها الوكيل تعود إلى مهمة الشركة، لذلك يمتلك الوكلاء سياقاً لـ *لماذا* يقومون بالعمل، وليس فقط *ماذا* يفعلون. هذا مهم لاتخاذ القرار في التشغيل الآلي للوكيل على المدى الطويل.

مثال بسيط للمهمة: "بناء وصيانة واجهة برمجة تطبيقات REST لإدارة طلبات العملاء. إعطاء الأولوية للصحة على السرعة. توثيق كل نقطة نهاية عامة."

يمنح هذا البيان الواحد وكلاءك مرشحاً لكل قرار يتخذونه.

إضافة وكلائك الأوائل

يمتلك كل وكيل في Paperclip محولًا (adapter) يحدد أداة الذكاء الاصطناعي التي يستخدمها وكيفية تواصله.

المحولات المدعومة جاهزة للاستخدام:

الوكيل	نوع المحول	الحزمة
Claude Code	`claude_local`	`@paperclipai/adapter-claude-local`
OpenAI Codex	`codex_local`	`@paperclipai/adapter-codex-local`
Gemini CLI	`gemini_local`	`@paperclipai/adapter-gemini-local`
Cursor	`cursor`	`@paperclipai/adapter-cursor-local`
HTTP webhooks	محول HTTP	نقطة نهاية مخصصة

لإضافة وكيل Claude Code عبر CLI:

paperclipai agent local-cli "Backend Engineer" --company-id <your-company-id>

يقوم هذا بتهيئة الوكيل، وتثبيت مهاراته في ~/.claude/skills، وتوليد بيانات اعتماد API. الوكيل موجود الآن في الهيكل التنظيمي لشركتك ويمكنه تلقي تعيينات المهام.

تهيئة وكيل Claude (يتم ضبطها في واجهة المستخدم أو في تهيئة الوكيل الفردي):

الحقل	ما يفعله
`model`	أي نموذج Claude سيتم استخدامه (مثل `claude-sonnet-4-6`)
`cwd`	دليل العمل للوكيل (يتم إنشاؤه تلقائياً إذا كان مفقوداً)
`promptTemplate`	مطالبة النظام مع استبدال `{{variable}}`
`maxTurnsPerRun`	أقصى عدد من الدورات للوكيل لكل نبضة (افتراضي: 300)
`timeoutSec`	الحد الأقصى للتنفيذ (0 = لا يوجد مهلة)

تخصيص النموذج حسب الدور يستحق التفكير فيه قبل البدء. تشغيل Opus على كل وكيل يصبح مكلفًا بسرعة. تقسيم عملي:

وكلاء المدير التنفيذي (CEO) / التنسيق: Sonnet (الاستدلال الاستراتيجي، يستحق التكلفة)
وكلاء المديرين: Haiku (التوجيه والتفويض، رخيص وسريع)
الموظفون الفنيون (ICs) المبدعون / البرمجة: Sonnet (جودة المخرجات مهمة هنا)
الموظفون الفنيون (ICs) ذوو المهام الروتينية: Haiku (توليد الكود الأساسي، إعداد اختبارات، عمليات ترحيل)

يمكن لهذا التخصيص أن يخفض إنفاق الوكيل الشهري بنسبة 40-60% مقارنة بتشغيل Sonnet في كل مكان، دون فقدان كبير في الجودة للمهام الروتينية.

هيكلة منظمة وكلائك

إليك هيكل عمل لمشروع برمجي صغير:

الرئيس التنفيذي (CEO) (Sonnet)
 ├── المدير التقني (CTO) (Haiku)
 │    ├── مهندس الواجهة الخلفية (Backend Engineer) (Sonnet)
 │    ├── مهندس الواجهة الأمامية (Frontend Engineer) (Sonnet)
 │    └── مهندس ضمان الجودة (QA Engineer) (Haiku)
 └── الكاتب التقني (Technical Writer) (Haiku)

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

لكل وكيل فترة نبض (heartbeat interval)، وهي التردد الذي يستيقظ فيه، يتحقق من مهامه المخصصة، يقوم بالعمل، ويخرج. الوكلاء لا يعملون باستمرار. يستيقظون، ينفذون، وينامون. هذا ما يمنع التكاليف من التصاعد.

الفترات الموصى بها:

وكلاء البرمجة: 600 ثانية (10 دقائق)
وكلاء عند الطلب: 86,400 ثانية (مرة واحدة في اليوم) مع تمكين الاستيقاظ عند الطلب
الحد الأدنى للفترة الآمنة: 30 ثانية (أقل من هذا يعرضك لخطر تجاوز التكاليف والرسائل غير المرغوب فيها)

كيف تعمل نبضة القلب (Heartbeat)

فهم نموذج "نبضة القلب" أمر أساسي للحصول على عمل موثوق به من وكلائك.

في كل مرة يستيقظ فيها الوكيل، يتبع بروتوكولاً من تسع خطوات:

تأكيد الهوية عبر GET /api/agents/me
معالجة أي ردود اتصال معلقة للموافقة
جلب المهام المخصصة من GET /api/companies/{companyId}/issues
تحديد الأولويات: المهام قيد التقدم أولاً، ثم المهام المخطط لها؛ تخطي المهام المحظورة ما لم يمكن إلغاء حظرها
سحب المهمة عبر POST /api/issues/{issueId}/checkout (إذا كان وكيل آخر قد استولى عليها بالفعل، يكون الرد 409 وينتقل هذا الوكيل)
قراءة سياق المهمة الكامل وسلسلة التعليقات
القيام بالعمل
تحديث المهمة بالتعليقات وتغييرات الحالة
تفويض المهام الفرعية بمعرفات الوالدين والأهداف إذا لزم الأمر

آلية السحب في الخطوة 5 هي ما يمنع تكرار العمل. لا يمكن لوكيلين التقاط نفس المهمة. إذا كان أحدهما يعمل عليها، يتخطاها الآخر تلقائياً.

يقوم Paperclip بحقن السياق في كل تشغيل للوكيل عبر متغيرات البيئة:

PAPERCLIP_TASK_ID          # المهمة التي أدت إلى هذا التشغيل
PAPERCLIP_WAKE_REASON      # لماذا استيقظ الوكيل (المؤقت، الإشارة، التعيين)
PAPERCLIP_AGENT_ID         # هوية الوكيل
PAPERCLIP_API_URL          # عنوان URL للاتصال بواجهة برمجة تطبيقات Paperclip

يمكن للوكلاء استخدام هذه البيانات لنشر التحديثات، وإنشاء مهام فرعية، وطلب الموافقات، والتفويض - كل ذلك ضمن نبضة قلب واحدة.

تعيين المهام وتتبع العمل

تعمل المهام في Paperclip كإصدارات GitHub مدمجة مع أداة إدارة المشاريع. أنشئ مهمة من واجهة المستخدم أو واجهة سطر الأوامر:

paperclipai issue create \
  --company-id <id> \
  --title "Add pagination to the orders endpoint" \
  --assignee-agent-id <backend-engineer-id>

يمكن أن تحتوي المهام على:

مهام رئيسية لتقسيم العمل الكبير إلى مهام فرعية
روابط للأهداف حتى يعرف الوكلاء الهدف الذي تخدمه هذه المهمة
تعليقات للسياق، طلبات الموافقة، وتحديثات الحالة
إشارات @ لإيقاظ وكيل معين عند الطلب (لا انتظار للنبضة التالية)

يمكنك عرض جميع المهام المفتوحة من واجهة سطر الأوامر:

paperclipai issue list

أو في لوحة التحكم، حيث تُظهر المهام مالكها الحالي، وحالتها، وأي تشغيل للنبضة القلبية أثر عليها آخر مرة.

التحكم في الميزانية الذي يعمل فعليًا

هذه إحدى الميزات الأكثر فائدة في Paperclip، والتي يتجاهلها معظم الأشخاص الجدد في إعدادات الوكلاء المتعددين.

يحصل كل وكيل على ميزانية رمزية شهرية. عندما يصل إلى 80%، ينتقل الوكيل تلقائيًا إلى المهام الحرجة فقط. وعندما يصل إلى 100%، يتوقف تمامًا.

عيّن ميزانية في تكوين الوكيل. نقطة البداية المقترحة من المجتمع هي 20-50 دولارًا شهريًا لكل مستوى وكيل. يمكنك تتبع معدل الاستهلاك لكل وكيل، والتكلفة لكل نبضة، والإنفاق الشهري التراكمي من لوحة التحكم.

تُظهر لوحة التحكم الخاصة بالتكلفة الوكلاء الفعالين والوكلاء الذين يستهلكون الرموز في عمل غير مركز. إذا كانت تكلفة الوكيل لكل نبضة تتصاعد، فعادة ما يكون ذلك علامة على أن التوجيهات غامضة جدًا أو أن نطاق المهمة واسع جدًا. يمكنك إصلاحه عن طريق تضييق نطاق التعيين، وليس بزيادة الميزانية.

بدون أدوات التحكم في الميزانية، يمكن لوكيل غير مهيأ يعمل بفاصل زمني مدته 30 ثانية مع تمكين "التفكير الموسع" أن يستهلك مئات الدولارات قبل أن تلاحظ. يوقف Paperclip ذلك تلقائيًا.

مهارات وقت التشغيل: تعليم الوكلاء سير عمل جديد دون إعادة تدريب

إحدى الميزات الأكثر قوة في Paperclip هي حقن المهارات. عندما يعمل الوكيل، ينشئ محول Paperclip روابط رمزية لملفات SKILL.md في دليل تكوين الوكيل ويمررها عبر --add-dir. يقرأ الوكيل ملف المهارة كجزء من سياقه ويتبع سير العمل.

هذا يعني أنه يمكنك تعليم الوكيل عملية جديدة، مثل كيفية كتابة رسائل التزام (commit messages)، أو كيفية التعامل مع ترحيلات قاعدة البيانات (database migrations)، أو كيفية تنسيق وثائق API، عن طريق كتابة ملف markdown. لا إعادة كتابة للتوجيهات. لا إعادة نشر.

تكتب المهارة:

# SKILL: Database migrations

When creating a migration:
1. Never modify existing migration files
2. Use descriptive names: YYYYMMDD_description.sql
3. Include both up and down SQL
4. Test locally before committing
5. Add a comment explaining the business reason for the change

احفظها في دليل المهارات، خصصها لوكيل الواجهة الخلفية الخاص بك، وكل نبضة قلب مستقبلية تتبع هذه العملية.

إذا كنت تختبر واجهات برمجة التطبيقات (APIs) التي أنشأها وكلاؤك

عندما يبني وكلاؤك واجهات برمجة التطبيقات (APIs)، تحتاج إلى طريقة لاختبار ما ينتجونه بسرعة. Apidog يتناسب هنا بشكل طبيعي. يتعامل مع تصميم واجهات برمجة التطبيقات، وخوادم وهمية، واختبارات آلية في مكان واحد، لذلك عندما يقوم وكيل الواجهة الخلفية الخاص بك بشحن نقطة نهاية، يمكنك التحقق منها على الفور دون التبديل بين Swagger و Postman وأداة وهمية منفصلة.

يمكنك إنشاء مجموعات اختبار تلقائيًا من مواصفات OpenAPI الخاصة بك، وتشغيلها مقابل مخرجات الوكيل، وتغذية النتائج مرة أخرى كتعليق مهمة. يلتقط الوكيل ذلك في النبضة التالية ويصلح الأخطاء. تعمل الحلقة الكاملة، من الكود إلى الاختبار إلى الإصلاح، دون تدخل بشري.

يدعم Apidog REST و GraphQL و gRPC، وهو مجاني للبدء.

إدارة عدة مثيلات

يدعم Paperclip عدة مثيلات معزولة على جهاز واحد عبر متغير البيئة PAPERCLIP_INSTANCE_ID أو علامة --instance. لكل مثيل تكوينه الخاص، وقاعدة بياناته، ومنافذه، ومساحات عمله.

للتطوير المحلي، ينشئ أمر worktree مثيل تطوير معزول تمامًا لكل فرع git:

paperclipai worktree:make feature/orders-pagination

يمنحك هذا منافذ منفصلة، وتكوينًا، وقاعدة بيانات مخصصة لهذا الفرع. يمكنك تشغيل شركة اختبار مقابل كود الميزة دون المساس بإعداد وكيل الإنتاج الخاص بك. عندما تنتهي، قم بإزالته وسيختفي.

إعدادات وكلاء متعددين فعالة

بعض الأنماط التي تعمل جيدًا بمجرد تشغيل الأساسيات:

تسلسل الأهداف: اكتب هدفًا واحدًا رفيع المستوى على مستوى الشركة، ثم دع وكيل الرئيس التنفيذي يقسمه إلى أهداف مشروع، وكل وكيل مدير يقسمها إلى مهام. يقوم الوكلاء بعمل أفضل عندما يفهمون سلسلة الغرض بدلاً من تلقي تعليمات معزولة.

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

الاستيقاظ عند الطلب عبر الإشارة @: بدلاً من فاصل زمني سريع للنبض (وما يصاحبه من تكلفة الرموز)، اضبط الوكلاء على فاصل زمني بطيء واستخدم الإشارات @ في تعليقات المهام لإيقاظهم فورًا عند الحاجة. تحصل على أوقات استجابة سريعة للعمل المهم دون دفع ثمن الاستقصاء المستمر.

مساحة عمل منفصلة لكل وكيل: يمتلك كل وكيل دليل عمل خاص به ضمن workspaces/<agent-id>/. حافظ على هذه الدلائل نظيفة. الوكلاء الذين يتشاركون مساحة عمل واحدة يتداخلون في عمل بعضهم البعض. العزل مدمج؛ لا تحاربه.

البدء يستغرق حوالي 15 دقيقة

للمرة الأولى، يستغرق الإعداد أقل من 15 دقيقة. يقوم أمر واحد بتثبيت الخادم وبدء تشغيله. يستغرق إضافة وكيلك الأول وإنشاء مهمة خمس دقائق أخرى في لوحة التحكم.

الجزء الأصعب هو هيكلة شركتك بشكل جيد: كتابة مهمة واضحة، واختيار النموذج الصحيح لكل دور، وتحديد حدود ميزانية معقولة. اقضِ 30 دقيقة على ذلك قبل البدء في تعيين العمل وسينتج وكلاؤك نتائج أفضل بكثير مما لو قمت بتوصيل كل شيء بسرعة وتمنيت الأفضل.

إذا كنت تدير بالفعل أكثر من وكيلين للذكاء الاصطناعي في أي مشروع مستمر، فإن هذا يستحق قضاء فترة بعد الظهر في الإعداد. الفرق بين علامة تبويب طرفية لكل وكيل وشركة منظمة بضوابط الميزانية، وملكية المهام، وسجلات التدقيق هو الفرق بين مشروع جانبي وشيء يمكن أن يعمل بالفعل بدون إشراف.