Перейти к содержимому
Начало работы

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

Что включить в запрос к 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