حين تعمل على عقد ذكي في Claude Code، تعيد في كل جلسة شرح قواعد الأمان وطريقة الاختبار وشكل التسليم. هذه الحزمة تحفظ تلك التعليمات في وكيلين فرعيين (subagents): واحد للعقود الذكية وتطبيقات DeFi على الشبكات العامة، وآخر لشبكات Hyperledger Fabric المُصرَّح بها (permissioned) التي تبنيها الشركات. الملفان بصيغة وكلاء Claude Code، ولم أجهّز منهما نسخة لـ claude.ai أو Codex.
وكيل العقود الذكية (blockchain-developer)
- يغطي بروتوكولات DeFi مثل AMM والإقراض والـ staking، والجسور بين الشبكات.
- يفترض أن كل مدخل قد يكون خبيثًا، ويتبع نمط Checks-Effects-Interactions عند تغيير الحالة، ويضيف حماية من إعادة الدخول (reentrancy) وضوابط للصلاحيات.
- يعتمد عقود OpenZeppelin للوظائف القياسية، ويكتب الاختبارات بـ Hardhat أو Foundry.
- يحتاط للثغرات الشائعة: القروض الخاطفة (flash loans)، والاستباق (front-running)، والتلاعب بمصادر الأسعار (oracles).
- يقدّم الأمان على توفير الغاز عند التعارض، ثم يحلل استهلاك الغاز ويقترح تحسينات.
- يسلّم عقودًا موثّقة، واختبارات لحالات الحافة ومسارات الهجوم، وسكربتات نشر لعدة شبكات، وقائمة تدقيق أمني، وأمثلة ربط بالواجهة الأمامية.
وكيل شبكات الشركات (hyperledger-fabric-developer)
ملفه مكتوب لإصداري Fabric 2.5 LTS و3.x:
- chaincode بلغات Go وJava وTypeScript، مع private data واستعلامات CouchDB الغنية.
- الإجماع: Raft لتحمّل تعطّل العُقد، وSmartBFT بدءًا من 3.0 لتحمّل الأعطال البيزنطية.
- الهويات والصلاحيات: MSP وFabric CA وسياسات المصادقة (endorsement policies) وقوائم ACL.
- التشغيل والاختبار: Kubernetes عبر Helm، ومراقبة بـ Prometheus وGrafana، واختبار وحدات بـ mockstub وأداء بـ Caliper.
- الترحيل: من 2.2 إلى 2.5 LTS، ومن Kafka إلى Raft، ومن Raft إلى SmartBFT، مع خطة تراجع.
- تشخيص الأعطال: فشل المصادقة، وانتهاء صلاحية الشهادات، وتعثّر الاتصال بين المؤسسات.
مثال: مراجعة عقد Staking قبل نشره
اكتب في Claude Code: «استخدم وكيل blockchain-developer لمراجعة StakingPool.sol وكتابة اختبارات Foundry له». تنص تعليمات ملفه على أن يلتزم بترتيب التحقق ثم تحديث الحالة ثم الاستدعاء الخارجي، وأن يحتاط لإعادة الدخول والتلاعب بمصادر الأسعار، وأن يسلّم اختبارات لمسارات الهجوم وقائمة تدقيق أمني. ويتضمن وصف الوكيلين عبارة Use PROACTIVELY، وهي تشجّع Claude Code على تسليمهما المهام المطابقة دون أن تذكر اسميهما.
التثبيت والمتطلبات
- فكّ ضغط الملف في مجلد ثابت.
- لجلسة واحدة: شغّل من مجلد مشروعك
claude --plugin-dir "PATH/TO/EXTRACTED/plugin"بعد وضع مسار فك الضغط مكان PATH/TO/EXTRACTED، فيُحمَّل الوكيلان لتلك الجلسة فقط. - للتثبيت الدائم: انسخ الملفين من plugin/agents إلى ~/.claude/agents (على ويندوز %USERPROFILE%\.claude\agents)، أو إلى .claude/agents داخل مشروع بعينه، ثم أعد تشغيل Claude Code.
- تحتاج إلى Claude Code مثبتًا ومسجّل الدخول، وتكلفة النموذج على حسابك. Foundry وHardhat وDocker لا تأتي مع الحزمة؛ ثبّتها إن أردت أن يشغّل الوكيل الاختبارات أو الشبكة فعليًا.
حدود الوكيلين
- الملفان تعليمات للنموذج وليسا أداة فحص؛ رأي الوكيل في أمان عقد لا يغني عن تدقيق مستقل قبل نشر عقد يدير أموالًا حقيقية.
- لا يحدد أيّ منهما قائمة أدوات، فيرث أدوات جلستك كاملة، ومنها تنفيذ الأوامر وتعديل الملفات؛ راجع ما يطلب تشغيله.
- أرقام إصدارات Fabric في الملف كُتبت وقت تأليفه؛ تحقّق من الإصدار الحالي في توثيق Hyperledger.
داخل الملف المضغوط
مجلد plugin فيه بيان الإضافة (الإصدار 1.0.0) وملفا الوكيلين بالإنجليزية، وأرفقتُ معه دليلًا عربيًا (README-AR.md) وفهرسًا للمكوّنات ومعلومات المصدر ونص الترخيص.
الترخيص MIT، والحقوق لـ davepoon ومجتمع BuildWithClaude؛ نقلتُ الملفين دون تعديل من مستودع buildwithclaude (commit 2e757da).
