Chuyển đến nội dung
Bắt đầu

Cách viết một yêu cầu tốt

Những gì nên có trong một yêu cầu gửi Codexe, kèm ví dụ tốt và chưa tốt cho plugin, mod, datapack, bot và website.

Đã cập nhật

Trên trang này
  1. Nên có những gì
  2. Chưa tốt và tốt hơn
  3. Dự án lớn: làm theo từng bước
  4. Cải thiện prompt
  5. Nói rõ điều bạn không muốn

Yêu cầu là yếu tố quan trọng nhất quyết định chất lượng kết quả. AI chỉ có thể tạo ra những gì nó suy ra được, vì vậy yêu cầu cụ thể tốt hơn yêu cầu dài.

#Nên có những gì

  • Nền tảng và phiên bản. "Paper 1.21.4", "Fabric cho 1.20.1", "datapack cho 1.21.1", "discord.py".
  • Hành vi. Điều gì xảy ra, từng bước một, kể cả điều gì xảy ra khi có sự cố.
  • Lệnh và tham số. /home <name>, ai được chạy lệnh, và các tin nhắn hiển thị.
  • Quyền. Tên node và giá trị mặc định.
  • Cấu hình. Những gì chủ máy chủ có thể thay đổi.
  • Lưu trữ. Trong bộ nhớ, tệp YAML, SQLite hay MySQL, và dữ liệu có còn sau khi khởi động lại hay không.
  • Tích hợp. Vault, PlaceholderAPI, LuckPerms, WorldGuard. Hãy nêu tên rõ ràng.
  • Giao diện. Tin nhắn chat, GUI (menu dạng kho đồ), bảng điểm, thanh boss.
  • Trường hợp biên. Người chơi offline, kho đồ đầy, thế giới bị tắt, reload.

#Chưa tốt và tốt hơn

Chưa tốt: make a factions plugin

Tốt hơn:

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.

Chưa tốt: a mod with new swords

Tốt hơn:

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.

Chưa tốt: custom recipes

Tốt hơn:

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.

Chưa tốt: moderation bot

Tốt hơn:

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.

#Dự án lớn: làm theo từng bước

Đừng dán một bản đặc tả năm mươi tính năng vào một yêu cầu duy nhất. Hãy bắt đầu với phần cốt lõi (mô hình dữ liệu, các lệnh chính), để Codexe xác minh, rồi thêm tính năng trong các tin nhắn tiếp theo. Mỗi bước nhỏ hơn, rẻ hơn, được xác minh và dễ chỉnh sửa hơn.

#Cải thiện prompt

Trên trang Tạo mới (Tạo dự án), nút Cải thiện prompt viết lại một yêu cầu sơ sài thành một yêu cầu đầy đủ hơn. Mỗi lần dùng tốn cố định 5,000 token. Hãy luôn đọc văn bản đã cải thiện trước khi tạo: nó có thể giả định những chi tiết bạn không muốn.

#Nói rõ điều bạn không muốn

"Không dùng cơ sở dữ liệu, giữ mọi thứ trong config.yml", "không dùng NMS", "không có phụ thuộc bên ngoài". Các ràng buộc ngăn AI chọn thứ mà bạn không thể dùng.

Cách viết một yêu cầu tốt | Codexe Docs