Przejdź do treści
Pierwsze kroki

Jak napisać dobrą prośbę

Co zawrzeć w prośbie do Codexe, z dobrymi i złymi przykładami dla pluginów, modów, datapacków, botów i stron internetowych.

Zaktualizowano

Na tej stronie
  1. Co zawrzeć
  2. Źle i lepiej
  3. Duże projekty: buduj etapami
  4. Ulepsz prompt
  5. Napisz, czego nie chcesz

Prośba to najważniejszy pojedynczy czynnik wpływający na jakość wyniku. AI może zbudować tylko to, co jest w stanie wywnioskować, więc konkretne prośby wygrywają z długimi.

#Co zawrzeć

  • Platformę i wersję. „Paper 1.21.4”, „Fabric dla 1.20.1”, „datapack dla 1.21.1”, „discord.py”.
  • Działanie. Co się dzieje, krok po kroku, łącznie z tym, co ma się stać, gdy coś pójdzie nie tak.
  • Komendy i argumenty. /home <name>, kto może ich używać i jakie wiadomości są wyświetlane.
  • Uprawnienia. Nazwy węzłów i wartości domyślne.
  • Konfigurację. Co właściciele serwerów powinni móc zmieniać.
  • Zapis danych. W pamięci, w pliku YAML, w SQLite czy MySQL, i czy dane przetrwają restart.
  • Integracje. Vault, PlaceholderAPI, LuckPerms, WorldGuard. Wymień je wprost.
  • Interfejs. Wiadomości na czacie, GUI (menu w ekwipunku), tablice wyników, paski bossa.
  • Przypadki brzegowe. Gracze offline, pełne ekwipunki, wyłączone światy, przeładowania.

#Źle i lepiej

Źle: make a factions plugin

Lepiej:

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.

Źle: a mod with new swords

Lepiej:

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.

Źle: custom recipes

Lepiej:

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.

Źle: moderation bot

Lepiej:

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.

#Duże projekty: buduj etapami

Nie wklejaj specyfikacji z pięćdziesięcioma funkcjami do jednej prośby. Zacznij od rdzenia (model danych, główne komendy), pozwól Codexe go zweryfikować, a potem dodawaj funkcje w kolejnych wiadomościach. Każdy krok jest mniejszy, tańszy, zweryfikowany i łatwiejszy do poprawienia.

#Ulepsz prompt

W sekcji Utwórz (Tworzenie projektu) przycisk Ulepsz prompt przepisuje szkicową prośbę na pełniejszą. Kosztuje stałe 5000 tokenów. Zawsze przeczytaj ulepszony tekst przed generowaniem: może zakładać szczegóły, których nie chcesz.

#Napisz, czego nie chcesz

„Bez bazy danych, wszystko w config.yml”, „nie używaj NMS”, „bez zewnętrznych zależności”. Ograniczenia powstrzymują AI przed wyborem czegoś, czego nie możesz użyć.

Jak napisać dobrą prośbę | Codexe Docs