تخطَّ إلى المحتوى
البدء

كيف تكتب طلباً جيداً

ما الذي تضعه في طلب Codexe، مع أمثلة جيدة وأخرى سيئة للـ plugins والـ mods والـ datapacks والبوتات والمواقع.

آخر تحديث

في هذه الصفحة
  1. ما الذي تضعه في الطلب
  2. سيئ مقابل أفضل
  3. المشاريع الكبيرة: ابنِ على مراحل
  4. التحسين
  5. قل ما لا تريده

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

#ما الذي تضعه في الطلب

  • المنصة والإصدار. "Paper 1.21.4"، "Fabric for 1.20.1"، "datapack for 1.21.1"، "discord.py".
  • السلوك. ما الذي يحدث خطوة بخطوة، بما في ذلك ما يحدث عندما يسوء شيء ما.
  • الأوامر والوسائط. /home <name>، ومن يمكنه تشغيلها، والرسائل التي تظهر.
  • الصلاحيات. أسماء العُقد وقيمها الافتراضية.
  • الإعدادات. ما يجب أن يتمكن أصحاب الخوادم من تغييره.
  • التخزين. في الذاكرة، أو ملف YAML، أو SQLite، أو MySQL، وهل تبقى البيانات بعد إعادة التشغيل.
  • التكاملات. Vault، PlaceholderAPI، LuckPerms، WorldGuard. اذكرها بأسمائها صراحةً.
  • الواجهة. رسائل الدردشة، وواجهات GUI (قوائم المخزون)، ولوحات النتائج، وأشرطة الزعماء.
  • الحالات الحدّية. اللاعبون غير المتصلين، والمخزون الممتلئ، والعوالم المعطّلة، وإعادة التحميل.

#سيئ مقابل أفضل

سيئ: make a factions plugin

أفضل:

Text
A Paper 1.21.x factions plugin.
- /f create <name>, /f invite <player>, /f join <name>, /f leave, /f disband (owner only).
- Max 10 members per faction (configurable).
- Chunk claiming with /f claim and /f unclaim; claimed chunks block building by non-members.
- Faction power: +1 per online member, claims limited to power x 2.
- Data saved to SQLite, loaded on startup.
- Vault economy: creating a faction costs 1000 (configurable).
- Permissions: factions.use (default true), factions.admin (op) for /f admin bypass.

سيئ: a mod with new swords

أفضل:

Text
A Fabric mod for Minecraft 1.20.1.
- Adds three swords: Ember Blade (sets targets on fire for 3s), Frost Edge (Slowness II for 2s), Void Cutter (5% chance to teleport the target 8 blocks).
- Crafting recipes using blaze rods, packed ice and ender pearls with a netherite sword.
- English lang file and item models (textures can be placeholders).
- No client-only code on the server side.

سيئ: custom recipes

أفضل:

Text
A datapack for Minecraft 1.21.1.
- Shaped recipe: 8 rotten flesh around a leather = 1 leather.
- Shapeless recipe: 9 nether wart = 1 nether wart block, and the reverse.
- A function that runs every tick and gives Speed I to players standing on gold blocks.

سيئ: moderation bot

أفضل:

Text
A discord.py bot with slash commands.
- /warn <user> <reason>: stores warnings in SQLite, DMs the user.
- /warnings <user>: lists warnings with dates.
- /timeout <user> <minutes> <reason>: applies a Discord timeout; only for members with Moderate Members.
- Logs every action to a channel set with /setlog.
- Token read from an environment variable.

#المشاريع الكبيرة: ابنِ على مراحل

لا تلصق مواصفات من خمسين ميزة في طلب واحد. ابدأ بالجوهر (نموذج البيانات والأوامر الرئيسية)، ودع Codexe يتحقق منه، ثم أضف الميزات في رسائل المتابعة. كل خطوة تكون أصغر وأرخص ومُتحقَّقاً منها وأسهل في التصحيح.

#التحسين

في صفحة إنشاء (إنشاء مشروع)، يعيد زر تحسين صياغة الطلب الأولي إلى طلب أكثر اكتمالاً. يكلّف مبلغاً ثابتاً قدره 5,000 توكن. اقرأ دائماً النص المحسَّن قبل التوليد: فقد يفترض تفاصيل لا تريدها.

#قل ما لا تريده

"No database, keep everything in config.yml"، "don't use NMS"، "no external dependencies". تمنع القيود الذكاء الاصطناعي من اختيار شيء لا يمكنك استخدامه.

كيف تكتب طلباً جيداً | Codexe Docs