ما هي وكالات الوكلاء؟

الوكالة (The Agency) هي مجموعة مفتوحة المصدر تضم 147 وكيل ذكاء اصطناعي متخصصًا لـ Claude Code، وCursor، وAider، وWindsurf، وGitHub Copilot، والمزيد. يتمتع كل وكيل بشخصية مميزة، ومخرجات تقنية، ومقاييس نجاح. يتعمق هذا التحليل الفني في بنية الوكيل، وتكامل الأدوات المتعددة، وذاكرة MCP، وسكربتات bash التي تشغل كل ذلك.

ربما تعرف الروتين: "تصرّف كمطور كبير" يليه نصيحة عامة يمكن تطبيقها على أي مهمة برمجة. تتخذ الوكالة نهجًا مختلفًا. فبدلاً من مطالبة واحدة تحاول القيام بكل شيء، تقدم 147 متخصصًا منظمين في 12 قسمًا.

فكر في الأمر وكأنك تجمع وكالة خدمات متكاملة، باستثناء أنهم وكلاء ذكاء اصطناعي لا ينامون أبدًا، ولا يشتكون أبدًا، ويقدمون دائمًا.

ما هي الوكالة؟

باختصار: الوكالة تستبدل "تصرّف كمطور" بـ "تنشيط وضع مطور الواجهة الأمامية" — ووكيل مطور الواجهة الأمامية يعرف بالفعل React وVue وAngular ومقاييس الأداء الأساسية للويب (Core Web Vitals) والامتثال لإمكانية الوصول.

هيكل المستودع: 12 قسمًا، 147 وكيلًا

توجد الوكالة على github.com/msitarzewski/agency-agents. يتم تنظيم الوكلاء في 12 قسمًا تعكس هيكل وكالة حقيقي:

agency-agents/
├── engineering/          # هندسة/ # أكثر من 20 وكيلًا: الواجهة الأمامية، الواجهة الخلفية، DevOps، الذكاء الاصطناعي، الأجهزة المحمولة، الأمن
├── design/               # تصميم/ # 8 وكلاء: مصمم واجهة المستخدم، باحث تجربة المستخدم، حارس العلامة التجارية، مُدخل الغرابة
├── marketing/            # تسويق/ # أكثر من 20 وكيلًا: مُحترف النمو، تحسين محركات البحث، TikTok، Reddit، LinkedIn
├── sales/                # مبيعات/ # 8 وكلاء: مدرب الاكتشاف، استراتيجي الصفقات، مهندس المبيعات
├── product/              # منتج/ # 5 وكلاء: مدير المنتج، باحث الاتجاهات، مُحلل الملاحظات
├── project-management/   # إدارة المشاريع/ # 6 وكلاء: منتج استوديو، راعي المشروع، متتبع التجارب
├── testing/              # اختبار/ # 8 وكلاء: مدقق الواقع، جامع الأدلة، مختبر API
├── support/              # دعم/ # 6 وكلاء: مستجيب الدعم، مُبلغ التحليلات، الامتثال القانوني
├── spatial-computing/    # الحوسبة المكانية/ # 6 وكلاء: مهندس الواقع الممتد، مهندس visionOS، مطور Metal
├── specialized/          # متخصص/ # أكثر من 30 وكيلًا: مُنشئ MCP، مدقق بلوكتشين، مدقق امتثال
├── game-development/     # تطوير الألعاب/ # أكثر من 20 وكيلًا: مهندس Unity، أنظمة Unreal، مُبرمج Godot، Roblox
└── academic/             # أكاديمي/ # 5 وكلاء: عالم أنثروبولوجيا، مؤرخ، عالم نفس، عالم سرد

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

تشريح الوكيل: داخل متخصص الذكاء الاصطناعي الذي يبلغ 400 سطر

يتبع كل وكيل نفس الهيكل. إليك التفصيل باستخدام وكيل **مهندس الواجهة الخلفية (Backend Architect)** كمثال:

المعلومات الأولية (YAML)

---
name: مهندس الواجهة الخلفية
description: مهندس واجهة خلفية أول متخصص في تصميم الأنظمة القابلة للتطوير، وهندسة قواعد البيانات، وتطوير API، والبنية التحتية السحابية
color: blue
emoji: 🏗️
vibe: يصمم الأنظمة التي تدعم كل شيء — قواعد البيانات، واجهات برمجة التطبيقات، السحابة، قابلية التوسع.
---

هذه البيانات الوصفية ليست مجرد زينة. تستخدم أدوات مثل Cursor وClaude Code حقلي name وdescription لاكتشاف الوكلاء. يوفر emoji تعريفًا مرئيًا في واجهات الدردشة.

الهوية والذاكرة

## 🧠 هويتك وذاكرتك
- **الدور**: متخصص في هندسة الأنظمة وتطوير جانب الخادم
- **الشخصية**: استراتيجي، يركز على الأمن، يهتم بقابلية التوسع، مهووس بالموثوقية
- **الذاكرة**: تتذكر أنماط البنية الناجحة، وتحسينات الأداء، وأطر عمل الأمان
- **الخبرة**: لقد رأيت أنظمة تنجح من خلال البنية الصحيحة وتفشل من خلال الاختصارات التقنية

يحدد هذا القسم شخصية الوكيل وحدود خبرته. إنه ليس مجرد نص تجميلي — بل يهيئ نموذج اللغة الكبير (LLM) لتبني عقلية محددة.

المهمة الأساسية

## 🎯 مهمتك الأساسية

### التميز في هندسة البيانات/المخطط
- تعريف وصيانة مخططات البيانات ومواصفات الفهارس
- تصميم هياكل بيانات فعالة لمجموعات البيانات الكبيرة (أكثر من 100 ألف كيان)
- تنفيذ مسارات ETL لتحويل البيانات وتوحيدها
- إنشاء طبقات استمرارية عالية الأداء مع أوقات استعلام أقل من 20 مللي ثانية

يتضمن كل بند من بنود المهمة أهدافًا قابلة للقياس. لاحظ "أوقات استعلام أقل من 20 مللي ثانية" و"أكثر من 100 ألف كيان" — هذه ليست أهدافًا غامضة.

القواعد الحرجة

## 🚨 قواعد حرجة يجب عليك اتباعها

### بنية تعتمد على الأمن أولاً
- تنفيذ استراتيجيات الدفاع العميق عبر جميع طبقات النظام
- استخدام مبدأ أقل امتياز لجميع الخدمات والوصول إلى قواعد البيانات
- تشفير البيانات في حالة السكون وأثناء النقل باستخدام معايير الأمان الحالية

القواعد هي قيود غير قابلة للتفاوض. إنها تتجاوز السلوك العام لنموذج اللغة الكبير (LLM).

المخرجات التقنية

هنا يتميز الوكلاء عن المطالبات العامة. يوفر مهندس الواجهة الخلفية كودًا كاملاً وقابلاً للتشغيل:

-- تصميم مخطط قاعدة بيانات التجارة الإلكترونية
CREATE TABLE users (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    email VARCHAR(255) UNIQUE NOT NULL,
    password_hash VARCHAR(255) NOT NULL,
    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
    updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
    deleted_at TIMESTAMP WITH TIME ZONE NULL
);

CREATE INDEX idx_users_email ON users(email) WHERE deleted_at IS NULL;
CREATE INDEX idx_users_created_at ON users(created_at);

// Express.js API مع برمجية وسيطة للأمن
const helmet = require('helmet');
const rateLimit = require('express-rate-limit');

const limiter = rateLimit({
  windowMs: 15 * 60 * 1000,
  max: 100,
  message: 'Too many requests from this IP, please try again later.',
});

مقاييس النجاح

## 🎯 مقاييس نجاحك

تكون ناجحًا عندما:
- تظل أوقات استجابة API أقل من 200 مللي ثانية للشريحة المئوية 95
- يتجاوز وقت تشغيل النظام توافر 99.9%
- تعمل استعلامات قاعدة البيانات بمتوسط أقل من 100 مللي ثانية
- لا تجد مراجعات الأمان أي ثغرات أمنية حرجة

يحدد كل وكيل نتائج قابلة للقياس. هذا ليس تأكيدًا علاجيًا — إنه مساءلة هندسية.

تكامل الأدوات المتعددة: وكيل واحد، 10 بيئات تطوير متكاملة (IDEs)

تعمل الوكالة عبر أكثر من 10 أدوات برمجة بالذكاء الاصطناعي. إليك كيفية عمل طبقة التكامل:

الأدوات المدعومة

سكربت التحويل (convert.sh)

يتعامل سكربت bash scripts/convert.sh مع ترجمة التنسيقات. إليك البنية:

#!/usr/bin/env bash
# convert.sh — تحويل ملفات .md لوكلاء الوكالة إلى تنسيقات خاصة بالأداة

set -euo pipefail

AGENT_DIRS=(
  academic design engineering game-development marketing paid-media
  sales product project-management testing support spatial-computing specialized
)

# استخراج حقول المعلومات الأولية
get_field() {
  local field="$1" file="$2"
  awk -v f="$field" '
    /^---$/ { fm++; next }
    fm == 1 && $0 ~ "^" f ": " { sub("^" f ": ", ""); print; exit }
  ' "$file"
}

# تجريد المعلومات الأولية، وإرجاع المحتوى
get_body() {
  awk 'BEGIN{fm=0} /^---$/{fm++; next} fm>=2{print}' "$1"
}

بالنسبة لـ **Cursor**، يحول السكربت ملفات .md إلى تنسيق قواعد .mdc:

convert_cursor() {
  local agent_file="$1"
  local slug=$(to_kebab "$(get_field 'name' "$agent_file")")
  local output_file="$OUT_DIR/cursor/.cursor/rules/agency-${slug}.mdc"

  cat > "$output_file" << EOF
---
description: وكيل الوكالة: $(get_field 'description' "$agent_file")
---
$(get_body "$agent_file")
EOF
}

بالنسبة لـ **Aider** و**Windsurf**، يتم تجميع جميع الوكلاء في ملفات فردية:

convert_aider() {
  local output="$OUT_DIR/aider/CONVENTIONS.md"
  echo "# وكلاء الوكالة لـ Aider" > "$output"
  echo "" >> "$output"

  for dir in "${AGENT_DIRS[@]}"; do
    for file in "$REPO_ROOT/$dir"/*.md; do
      echo "---" >> "$output"
      cat "$file" >> "$output"
    done
  done
}

سكربت التثبيت (install.sh)

بعد التحويل، يقوم install.sh بنسخ الملفات إلى الدلائل الخاصة بالأداة:

#!/usr/bin/env bash
# install.sh — تثبيت وكلاء الوكالة في أدواتك المحلية

install_claude_code() {
  local src="$REPO_ROOT"
  local dest="$HOME/.claude/agents"
  mkdir -p "$dest"
  cp -r "$src"/{engineering,design,marketing,sales,specialized}/*.md "$dest/"
  ok "Claude Code: $(find "$dest" -name '*.md' | wc -l) وكيل تم تثبيته"
}

install_cursor() {
  local src="$OUT_DIR/cursor/.cursor/rules"
  local dest="./.cursor/rules"
  mkdir -p "$dest"
  cp "$src"/*.mdc "$dest/"
  ok "Cursor: $(find "$dest" -name '*.mdc' | wc -l) قاعدة تم تثبيتها"
}

يدعم السكربت الاختيار التفاعلي:

  +------------------------------------------------+
  |   الوكالة — مثبّت الأدوات                  |
  +------------------------------------------------+

  فحص النظام: [*] = تم اكتشافه على هذا الجهاز

  [x]  1)  [*]  Claude Code     (claude.ai/code)
  [x]  2)  [*]  Copilot         (~/.github + ~/.copilot)
  [x]  3)  [*]  Antigravity     (~/.gemini/antigravity)
  [ ]  4)  [ ]  Gemini CLI      (ملحق gemini)
  [x]  7)  [*]  Cursor          (.cursor/rules)

  [1-10] تبديل   [a] الكل   [n] لا شيء   [d] تم الكشف عنه
  [Enter] تثبيت   [q] إنهاء

التنفيذ المتوازي يسرع عمليات تثبيت الأدوات المتعددة:

./scripts/install.sh --parallel --jobs 8

ذاكرة MCP: سياق دائم عبر الجلسات

بشكل افتراضي، يبدأ وكلاء الذكاء الاصطناعي كل جلسة من الصفر. يغير تكامل **ذاكرة MCP** هذا.

ما هو MCP؟

MCP (بروتوكول سياق النموذج) هو بروتوكول لوكلاء الذكاء الاصطناعي للوصول إلى الأدوات الخارجية والتخزين الدائم. تستخدم الوكالة MCP لتمكين:

• ذاكرة عبر الجلسات: يتذكر الوكلاء القرارات من الجلسات السابقة
• تسليم المهام بين الوكلاء: يمكن لوكيل أن يترك السياق لوكيل آخر
• التراجع عند الفشل: الاستعادة إلى حالات معروفة جيدة عندما يفشل ضمان الجودة

نمط الذاكرة

أضف هذا القسم إلى أي وكيل لتمكين ذاكرة MCP:

## تكامل الذاكرة

عندما تبدأ جلسة:
- استدعاء السياق ذي الصلة من الجلسات السابقة باستخدام دورك ومشروعك كمصطلحات بحث
- مراجعة أي ذكريات تم تعليمها باسم وكيلك

عندما تتخذ قرارات رئيسية أو تكمل مخرجات:
- تذكر القرار بعلامات وصفية (اسم الوكيل، المشروع، الموضوع)
- تضمين سياق كافٍ يمكن لجلسة مستقبلية أن تفهم ما تم القيام به ولماذا

عند تسليم المهمة لوكيل آخر:
- تذكر مخرجاتك المعلمة للوكيل المستلم
- تضمين: ما أكملته، وما هو معلق، وما يحتاج الوكيل التالي لمعرفته

أدوات MCP

يعمل أي خادم MCP يعرض هذه الأدوات:

مثال: سير عمل مدعوم بالذاكرة

بدون ذاكرة MCP:

المستخدم: "أنشئ واجهة برمجة التطبيقات"
الوكيل: [ينشئ واجهة برمجة التطبيقات، تنتهي الجلسة]

[الجلسة التالية]
المستخدم: "استمر من الأمس"
الوكيل: "ليس لدي سياق من الجلسات السابقة. هل يمكنك لصق ما فعلناه؟"

مع ذاكرة MCP:

المستخدم: "أنشئ واجهة برمجة التطبيقات"
الوكيل: [ينشئ واجهة برمجة التطبيقات، يتذكر: "مهندس الواجهة الخلفية - واجهة برمجة تطبيقات التجارة الإلكترونية - جدول المستخدمين، مصادقة JWT، تحديد المعدل"]

[الجلسة التالية]
المستخدم: "استمر من الأمس"
الوكيل: [يستدعي: "بالأمس، قمت بتصميم جدول المستخدمين بمفاتيح أساسية UUID، ونفذت مصادقة JWT باستخدام تجزئة bcrypt، وأضفت تحديد المعدل بـ 100 طلب كل 15 دقيقة. الخطوة التالية: مخطط خدمة الطلبات."]

انظر integrations/mcp-memory/backend-architect-with-memory.md للحصول على مثال كامل.

وكلاء متميزون: ثلاثة تحليلات عميقة

1. مدقق الواقع (قسم الاختبار)

يوقف مدقق الواقع الموافقات الوهمية. الموقف الافتراضي: "يحتاج إلى عمل" حتى يثبت العكس.

## 🚨 عمليتك الإلزامية

### الخطوة 1: أوامر التحقق من الواقع (لا تتخطاها أبدًا)
```bash
# تحقق مما تم بناؤه بالفعل
ls -la resources/views/ || ls -la *.html

# تحقق متقاطع من الميزات المدعاة
grep -r "luxury\|premium\|glass\|morphism" . --include="*.html" --include="*.css" || echo "لم يتم العثور على ميزات مميزة"

# تشغيل التقاط لقطة شاشة احترافية باستخدام Playwright
./qa-playwright-capture.sh http://localhost:8000 public/qa-screenshots

الخطوة 2: التحقق المتقاطع لضمان الجودة

• مراجعة نتائج وكيل ضمان الجودة من اختبار Chrome بدون واجهة رسومية
• مطابقة لقطات الشاشة الآلية مع تقييم ضمان الجودة
• تأكيد أو تحدي تقييم ضمان الجودة بأدلة إضافية

الخطوة 3: التحقق الشامل (من البداية للنهاية)

• تحليل responsive-desktop.png، responsive-tablet.png، responsive-mobile.png
• التحقق من تدفقات التفاعل: تسلسلات nav-*-click.png، form-*.png
• مراجعة بيانات الأداء الفعلية (أوقات التحميل، الأخطاء، المقاييس)

يتطلب هذا الوكيل **دليلاً مرئيًا** قبل الموافقة على أي شيء. لا مزيد من "يبدو رائعًا!" بدون دليل.

---

### 2. مُدخل الغرابة (قسم التصميم)

يضيف مُدخل الغرابة شخصية دون التضحية بقابلية الاستخدام.

```css
/* تفاعلات أزرار مبهجة */
.btn-whimsy {
  position: relative;
  overflow: hidden;
  transition: all 0.3s cubic-bezier(0.23, 1, 0.32, 1);

  &::before {
    content: '';
    position: absolute;
    top: 0;
    left: -100%;
    width: 100%;
    height: 100%;
    background: linear-gradient(90deg, transparent, rgba(255, 255, 255, 0.2), transparent);
    transition: left 0.5s;
  }

  &:hover {
    transform: translateY(-2px) scale(1.02);
    box-shadow: 0 8px 25px rgba(0, 0, 0, 0.15);
  }
}

// نظام إنجازات مع غرابة
class WhimsyAchievements {
  unlock(achievementId) {
    const achievement = this.achievements[achievementId];
    this.showCelebration(achievement);
    this.saveProgress(achievementId);
  }

  showCelebration(achievement) {
    const celebration = document.createElement('div');
    celebration.className = `achievement-celebration ${achievement.celebration}`;
    celebration.innerHTML = `
      <div class="achievement-card">
        <div class="achievement-icon">${achievement.icon}</div>
        <h3>${achievement.title}</h3>
        <p>${achievement.description}</p>
      </div>
    `;
    document.body.appendChild(celebration);
    setTimeout(() => celebration.remove(), 3000);
  }
}

يجب أن يخدم كل عنصر مرح غرضًا وظيفيًا أو عاطفيًا. يتضمن الوكيل مكتبة كاملة من النصوص القصيرة (microcopy):

## رسائل الخطأ
**صفحة 404**: "عذرًا! يبدو أن هذه الصفحة ذهبت في إجازة دون إخبارنا."
**التحقق من صحة النموذج**: "يبدو بريدك الإلكتروني خجولاً بعض الشيء – هل تمانع في إضافة رمز @؟"
**خطأ في الشبكة**: "يبدو أن الإنترنت تعثر. هل تجرب مرة أخرى؟"

3. مُنشئ MCP (القسم المتخصص)

يقوم مُنشئ MCP بإنشاء أدوات مخصصة توسع قدرات وكيل الذكاء الاصطناعي.

// هيكل خادم MCP بلغة TypeScript
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

const server = new McpServer({ name: "my-server", version: "1.0.0" });

server.tool("search_items", { query: z.string(), limit: z.number().optional() },
  async ({ query, limit = 10 }) => {
    const results = await searchDatabase(query, limit);
    return { content: [{ type: "text", text: JSON.stringify(results, null, 2) }] };
  }
);

const transport = new StdioServerTransport();
await server.connect(transport);

القواعد الحرجة:

• أسماء أدوات وصفية: search_users وليس query1 — يختار الوكلاء الأدوات بالاسم
• معلمات مكتوبة (typed parameters) باستخدام Zod: يتم التحقق من صحة كل إدخال، والمعلمات الاختيارية لها قيم افتراضية
• مخرجات منظمة: إرجاع JSON للبيانات، وMarkdown للمحتوى المقروء بشريًا
• فشل رشيق: إرجاع رسائل الخطأ، وعدم تعطل الخادم أبدًا

المجتمع والترجمات

بدأت الوكالة من موضوع على Reddit. والآن لديها:

• 147 وكيلًا عبر 12 قسمًا
• أكثر من 10,000 سطر من الشخصية، والعملية، وأمثلة الكود
• ترجمات المجتمع: الصينية المبسطة (نسختان منفصلتان)، والمزيد قيد الإنجاز
• دعم الأدوات المتعددة: أكثر من 10 تكاملات تتم صيانتها عبر سكربتات التحويل

النسخ المتفرعة البارزة:

• agency-agents-zh بواسطة @jnMetaCode: 100 وكيل مترجم + 9 أصلية للسوق الصيني
• agent-teams بواسطة @dsclca12: ترجمة مستقلة مع توطين Bilibili، WeChat، Xiaohongshu

التثبيت: بدء سريع

الخيار 1: Claude Code (موصى به)

# انسخ الوكلاء إلى دليل Claude Code الخاص بك
cp -r agency-agents/* ~/.claude/agents/

# التنشيط في أي جلسة:
"مرحباً كلود، قم بتنشيط وضع مطور الواجهة الأمامية وساعدني في بناء مكون React"

الخيار 2: تثبيت الأدوات المتعددة

# الخطوة 1: إنشاء ملفات التكامل
./scripts/convert.sh

# الخطوة 2: التثبيت التفاعلي (يكتشف الأدوات تلقائيًا)
./scripts/install.sh

# أو قم بتثبيت أداة محددة مباشرة
./scripts/install.sh --tool cursor
./scripts/install.sh --tool aider

الخيار 3: الاستخدام كمرجع

تصفح الوكلاء على github.com/msitarzewski/agency-agents وكيّف ما تحتاجه منها. يحتوي كل ملف على الهوية، وسير العمل، والمخرجات، وأمثلة الكود.

ما الذي يميز هذا؟

مقابل مطالبات الذكاء الاصطناعي العامة

مقابل مكتبات المطالبات

مقابل أدوات الذكاء الاصطناعي

الدروس التقنية المستفادة

1. التخصص يتفوق على التعميم: 147 متخصصًا يتفوقون على مطالبة واحدة "تفعل كل شيء"
2. الهيكل يدفع المخرجات: المعلومات الأولية + الهوية + المهمة + القواعد + المخرجات + المقاييس
3. التكامل مهم: سكربتات Bash تحول الوكلاء إلى أكثر من 10 تنسيقات تلقائيًا
4. الذاكرة تمكن الاستمرارية: يحل بروتوكول MCP مشكلة "لا أتذكر الأمس"
5. توسع المجتمع: موضوع Reddit ← 147 وكيلًا ← ترجمات ← دعم الأدوات المتعددة

الخطوات التالية

هل تريد تجربة الوكالة؟

1. تصفح قائمة الوكلاء الكاملة
2. التثبيت لأداتك المفضلة (Claude Code، Cursor، Aider، إلخ.)
3. تنشيط المتخصصين بالاسم: "استخدم مدقق الواقع للتحقق من أن هذا جاهز للإنتاج"
4. المساهمة: إضافة وكلاء جدد، تحسين الموجودين، مشاركة قصص النجاح

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

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