Перейти до вмісту
Початок роботи

Як написати хороший запит

Що включити в запит до Codexe, з хорошими й поганими прикладами для плагінів, модів, датапаків, ботів і вебсайтів.

Оновлено

На цій сторінці
  1. Що включити
  2. Погано й краще
  3. Великі проєкти: будуйте поетапно
  4. Покращення запиту
  5. Скажіть, чого ви не хочете

Запит є найважливішим окремим чинником якості результату. AI може створити лише те, що здатен вивести із запиту, тому конкретні запити кращі за довгі.

#Що включити

  • Платформу й версію. «Paper 1.21.4», «Fabric для 1.20.1», «датапак для 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 токенів. Завжди читайте покращений текст перед генерацією: у ньому можуть бути припущення, яких ви не хочете.

#Скажіть, чого ви не хочете

«Без бази даних, тримай усе в config.yml», «не використовуй NMS», «без зовнішніх залежностей». Обмеження не дають AI вибрати те, чим ви не зможете скористатися.

Як написати хороший запит | Codexe Docs