Skip to main content

Custom Prompts

Deprecated

Custom Prompts ถูก deprecated แล้ว OpenAI แนะนำให้ใช้ Skills แทน สำหรับ reusable instructions ที่ Codex สามารถเรียกใช้ได้ทั้งแบบ explicit และ implicit

Custom Prompts คืออะไร

Custom Prompts ช่วยให้คุณแปลงไฟล์ Markdown เป็น reusable prompts ที่เรียกใช้ได้เป็น slash commands ใน Codex CLI และ IDE extension คุณสมบัติหลัก:

  • ต้องเรียกใช้แบบ explicit (ไม่ automatic)
  • เก็บในเครื่องที่ ~/.codex — ไม่สามารถแชร์ข้าม repositories ได้

ขั้นตอนการตั้งค่า

1. สร้าง prompts directory

mkdir -p ~/.codex/prompts

2. สร้างไฟล์ prompt

ตัวอย่างไฟล์ ~/.codex/prompts/draftpr.md:

---
description: Prep a branch, commit, and open a draft PR
argument-hint: [FILES=<paths>] [PR_TITLE="<title>"]
---

Create a branch named `dev/<feature_name>` for this work.
If files are specified, stage them first: $FILES.
Commit the staged changes with a clear message.
Open a draft PR on the same branch. Use $PR_TITLE when supplied; otherwise write a concise summary yourself.

3. Restart Codex

รีสตาร์ท Codex เพื่อโหลด prompt ใหม่

Metadata ที่รองรับ

Fieldคำอธิบาย
descriptionแสดงใน command menu
argument-hintแสดง parameter ที่คาดหวัง

ประเภทของ Placeholders

ประเภทไวยากรณ์ตัวอย่าง
Positional$1 ถึง $9$1 สำหรับ argument แรก
Named$VARIABLE_NAME$FILE หรือ $TICKET_ID
Literal $$$ใช้ $$ เพื่อแสดง $

Named placeholders ใช้ KEY=value syntax เมื่อเรียกใช้

การเรียกใช้งาน

/prompts:draftpr FILES="src/pages/index.astro" PR_TITLE="Add hero animation"

Codex จะ expand placeholders และส่ง result เป็น message

หมายเหตุการ Migration

สำหรับ shared, reusable instructions ให้ใช้ Skills แทน Custom Prompts เนื่องจาก Skills รองรับ:

  • การแชร์ข้าม repositories ได้
  • Implicit invocation (Codex เลือกใช้โดยอัตโนมัติ)
  • การแจกจ่ายผ่าน plugins
  • Directory scope ที่ยืดหยุ่นกว่า