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
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:
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:
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:
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:
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.