Přeskočit na obsah
Začínáme

Jak napsat dobré zadání

Co uvést v zadání pro Codexe, s dobrými a špatnými příklady pro pluginy, módy, datapacky, boty a weby.

Aktualizováno

Na této stránce
  1. Co uvést
  2. Špatně vs. lépe
  3. Velké projekty: stavěj po krocích
  4. Vylepšit zadání
  5. Řekni, co nechceš

Zadání je největší jednotlivý faktor, který ovlivňuje kvalitu výsledku. AI dokáže vytvořit jen to, co si dokáže odvodit, takže konkrétní zadání vítězí nad dlouhými.

#Co uvést

  • Platforma a verze. „Paper 1.21.4“, „Fabric pro 1.20.1“, „datapack pro 1.21.1“, „discord.py“.
  • Chování. Co se děje krok za krokem, včetně toho, co se stane, když se něco pokazí.
  • Příkazy a argumenty. /home <name>, kdo je smí spouštět a jaké zprávy se zobrazí.
  • Oprávnění. Názvy uzlů a výchozí hodnoty.
  • Konfigurace. Co mají majitelé serverů mít možnost měnit.
  • Ukládání dat. V paměti, v souboru YAML, SQLite nebo MySQL, a zda data přežijí restart.
  • Integrace. Vault, PlaceholderAPI, LuckPerms, WorldGuard. Jmenuj je výslovně.
  • Rozhraní. Zprávy v chatu, GUI (menu v inventáři), scoreboardy, boss bary.
  • Okrajové případy. Hráči offline, plné inventáře, vypnuté světy, reloady.

#Špatně vs. lépe

Špatně: make a factions plugin

Lépe:

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.

Špatně: a mod with new swords

Lépe:

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.

Špatně: custom recipes

Lépe:

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.

Špatně: moderation bot

Lépe:

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.

#Velké projekty: stavěj po krocích

Nevkládej specifikaci s padesáti funkcemi do jednoho zadání. Začni jádrem (datový model, hlavní příkazy), nech Codexe projekt ověřit a pak přidávej funkce v navazujících zprávách. Každý krok je menší, levnější, ověřený a snáz se opravuje.

#Vylepšit zadání

Na stránce Vytvořit (Vytvoření projektu) přepíše tlačítko Vylepšit zadání hrubé zadání do úplnější podoby. Stojí paušálně 5 000 tokenů. Vylepšený text si před generováním vždy přečti: může předpokládat podrobnosti, které nechceš.

#Řekni, co nechceš

„Žádná databáze, všechno drž v config.yml“, „nepoužívej NMS“, „žádné externí závislosti“. Omezení zabrání AI, aby zvolila něco, co nemůžeš použít.

Jak napsat dobré zadání | Codexe Docs