คำสั่ง

นี่คือเอกสารอ้างอิงสำหรับคำสั่งแบบ slash ของ OpenSpec คำสั่งเหล่านี้จะถูกเรียกใช้ในอินเทอร์เฟซแชทของ AI coding assistant ของคุณ (เช่น Claude Code, Cursor, Windsurf)

สำหรับรูปแบบขั้นตอนการทำงานและเวลาที่ควรใช้แต่ละคำสั่ง โปรดดูที่ ขั้นตอนการทำงาน สำหรับคำสั่ง CLI โปรดดูที่ CLI

สรุปอย่างรวดเร็ว

เส้นทางด่วนเริ่มต้น (โปรไฟล์ `core`)

คำสั่ง	วัตถุประสงค์
`/opsx:propose`	สร้างการเปลี่ยนแปลงและสร้างเอกสารประกอบการวางแผนในขั้นตอนเดียว
`/opsx:explore`	คิดทบทวนไอเดียก่อนที่จะตัดสินใจเปลี่ยนแปลง
`/opsx:apply`	ดำเนินการตามงานที่กำหนดไว้ในการเปลี่ยนแปลง
`/opsx:archive`	จัดเก็บการเปลี่ยนแปลงที่เสร็จสมบูรณ์แล้ว

คำสั่งขั้นตอนการทำงานที่ขยาย (เลือกขั้นตอนการทำงานแบบกำหนดเอง)

คำสั่ง	วัตถุประสงค์
`/opsx:new`	เริ่มต้นโครงสร้างการเปลี่ยนแปลงใหม่
`/opsx:continue`	สร้างเอกสารประกอบถัดไปโดยอิงจากความเชื่อมโยง
`/opsx:ff`	ไปข้างหน้าอย่างรวดเร็ว: สร้างเอกสารประกอบการวางแผนทั้งหมดในครั้งเดียว
`/opsx:verify`	ตรวจสอบว่าการดำเนินการตรงกับเอกสารประกอบหรือไม่
`/opsx:sync`	ผสานข้อกำหนดแบบ delta เข้ากับข้อกำหนดหลัก
`/opsx:bulk-archive`	จัดเก็บการเปลี่ยนแปลงหลายรายการพร้อมกัน
`/opsx:onboard`	แนะนำขั้นตอนการทำงานที่สมบูรณ์ผ่านการสอน

โปรไฟล์ global เริ่มต้นคือ core หากต้องการเปิดใช้งานคำสั่งขั้นตอนการทำงานที่ขยาย ให้รัน openspec config profile เลือก workflows จากนั้นรัน openspec update ในโปรเจกต์ของคุณ

คำสั่งอ้างอิง

`/opsx:propose`

สร้างการเปลี่ยนแปลงใหม่และสร้างเอกสารประกอบการวางแผนในขั้นตอนเดียว นี่คือคำสั่งเริ่มต้นในโปรไฟล์ core

รูปแบบ:

text

/opsx:propose [change-name-or-description]

อาร์กิวเมนต์:

อาร์กิวเมนต์	จำเป็น	คำอธิบาย
`change-name-or-description`	ไม่	ชื่อแบบ kebab-case หรือคำอธิบายการเปลี่ยนแปลง

สิ่งที่ทำได้:

สร้าง openspec/changes/<change-name>/
สร้างเอกสารประกอบที่จำเป็นก่อนการดำเนินการ (สำหรับ spec-driven: ข้อเสนอ, ข้อกำหนด, การออกแบบ, งาน)
หยุดเมื่อการเปลี่ยนแปลงพร้อมสำหรับ /opsx:apply

ตัวอย่าง:

text

You: /opsx:propose add-dark-mode

AI:  Created openspec/changes/add-dark-mode/
     ✓ proposal.md
     ✓ specs/ui/spec.md
     ✓ design.md
     ✓ tasks.md
     Ready for implementation. Run /opsx:apply.

เคล็ดลับ:

ใช้คำสั่งนี้สำหรับเส้นทางที่เร็วที่สุดจากต้นจนจบ
หากต้องการควบคุมเอกสารประกอบทีละขั้นตอน ให้เปิดใช้งานขั้นตอนที่ขยายและใช้ /opsx:new + /opsx:continue

`/opsx:explore`

คิดทบทวนไอเดีย ตรวจสอบปัญหา และชี้แจงข้อกำหนดก่อนที่จะตัดสินใจดำเนินการเปลี่ยนแปลง

รูปแบบ:

/opsx:explore [topic]

อาร์กิวเมนต์:

อาร์กิวเมนต์	จำเป็น	คำอธิบาย
`topic`	ไม่	สิ่งที่คุณต้องการสำรวจหรือตรวจสอบ

สิ่งที่ทำได้:

เปิดการสนทนาเชิงสำรวจโดยไม่ต้องมีโครงสร้าง
ตรวจสอบโค้ดเบสเพื่อตอบคำถาม
เปรียบเทียบตัวเลือกและวิธีการต่างๆ
สร้างแผนภาพเพื่อช่วยชี้แจงความคิด
สามารถเปลี่ยนไปใช้ /opsx:propose (ค่าเริ่มต้น) หรือ /opsx:new (ขั้นตอนที่ขยาย) เมื่อข้อมูลเชิงลึกชัดเจนแล้ว

ตัวอย่าง:

text

You: /opsx:explore

AI:  What would you like to explore?

You: How should we handle authentication for the mobile app?

AI:  Let me investigate your current auth setup...
     [Analyzes codebase]

     I see you're using session-based auth for the web app.
     For mobile, we have three main options:

     1. JWT tokens (stateless, works offline)
     2. OAuth2 (if you need third-party login)
     3. Extend current sessions (simpler, but requires connectivity)

     Your API already has CORS configured. Which direction interests you?

You: Let's go with JWT. Can we start a change for that?

AI:  Ready when you are. Run /opsx:propose add-jwt-auth to begin.

เคล็ดลับ:

ใช้เมื่อข้อกำหนดไม่ชัดเจนหรือคุณต้องการตรวจสอบ
ไม่มีการสร้างเอกสารประกอบระหว่างการสำรวจ
เหมาะสำหรับการเปรียบเทียบวิธีการหลายแบบก่อนตัดสินใจ
สามารถอ่านไฟล์และค้นหาในโค้ดเบสได้

`/opsx:new`

เริ่มโครงสร้างการเปลี่ยนแปลงใหม่ สร้างโฟลเดอร์การเปลี่ยนแปลงและรอให้คุณสร้างเอกสารประกอบด้วย /opsx:continue หรือ /opsx:ff

คำสั่งนี้เป็นส่วนหนึ่งของชุดขั้นตอนที่ขยาย (ไม่รวมอยู่ในโปรไฟล์ core เริ่มต้น)

รูปแบบ:

/opsx:new [change-name] [--schema <schema-name>]

อาร์กิวเมนต์:

อาร์กิวเมนต์	จำเป็น	คำอธิบาย
`change-name`	ไม่	ชื่อสำหรับโฟลเดอร์การเปลี่ยนแปลง (จะถามถ้าไม่ได้ระบุ)
`--schema`	ไม่	สคีมาขั้นตอนที่จะใช้ (ค่าเริ่มต้น: จากการกำหนดค่าหรือ `spec-driven`)

สิ่งที่ทำได้:

สร้างไดเรกทอรี openspec/changes/<change-name>/
สร้างไฟล์เมตาดาต้า .openspec.yaml ในโฟลเดอร์การเปลี่ยนแปลง
แสดงเทมเพลตเอกสารประกอบแรกที่พร้อมสร้าง
ถามชื่อการเปลี่ยนแปลงและสคีมาหากไม่ได้ระบุ

สิ่งที่สร้าง:

openspec/changes/<change-name>/
└── .openspec.yaml    # เมตาดาต้าการเปลี่ยนแปลง (สคีมา, วันที่สร้าง)

ตัวอย่าง:

You: /opsx:new add-dark-mode

AI:  Created openspec/changes/add-dark-mode/
     Schema: spec-driven

     Ready to create: proposal
     Use /opsx:continue to create it, or /opsx:ff to create all artifacts.

เคล็ดลับ:

ใช้ชื่อที่อธิบายได้ชัดเจน: add-feature, fix-bug, refactor-module
หลีกเลี่ยงชื่อทั่วไปเช่น update, changes, wip
สคีมาสามารถตั้งค่าในการกำหนดค่าโปรเจกต์ (openspec/config.yaml) ได้เช่นกัน

`/opsx:continue`

สร้างเอกสารประกอบถัดไปในสายพานการพึ่งพา สร้างเอกสารประกอบทีละรายการเพื่อความคืบหน้าแบบเพิ่มทีละน้อย

รูปแบบ:

/opsx:continue [change-name]

อาร์กิวเมนต์:

อาร์กิวเมนต์	จำเป็น	คำอธิบาย
`change-name`	ไม่	การเปลี่ยนแปลงใดที่จะดำเนินการต่อ (จะอนุมานจากบริบทหากไม่ได้ระบุ)

สิ่งที่ทำได้:

สอบถามแผนผังการพึ่งพาของเอกสารประกอบ
แสดงว่าเอกสารประกอบใดพร้อมแล้ว vs ถูกบล็อก
สร้างเอกสารประกอบแรกที่พร้อม
อ่านไฟล์ที่พึ่งพาเพื่อเป็นบริบท
แสดงว่าสิ่งใดพร้อมใช้งานหลังจากสร้างแล้ว

ตัวอย่าง:

You: /opsx:continue

AI:  Change: add-dark-mode

     Artifact status:
     ✓ proposal    (done)
     ◆ specs       (ready)
     ◆ design      (ready)
     ○ tasks       (blocked - needs: specs)

     Creating specs...

     [Reads proposal.md, creates specs based on requirements]

     ✓ Created openspec/changes/add-dark-mode/specs/ui/spec.md

     Now available: tasks
     Run /opsx:continue to create the next artifact.

เคล็ดลับ:

ใช้เมื่อคุณต้องการตรวจสอบเอกสารประกอบแต่ละชิ้นก่อนดำเนินการต่อ
เหมาะสำหรับการเปลี่ยนแปลงที่ซับซ้อนซึ่งคุณต้องการควบคุม
เอกสารประกอบหลายชิ้นอาจพร้อมใช้งานพร้อมกัน
คุณสามารถแก้ไขเอกสารประกอบที่สร้างแล้วก่อนดำเนินการต่อ

`/opsx:ff`

ข้ามขั้นตอนการสร้างเอกสารประกอบอย่างรวดเร็ว สร้างเอกสารประกอบทั้งหมดในการวางแผนพร้อมกัน

รูปแบบ:

/opsx:ff [change-name]

อาร์กิวเมนต์:

อาร์กิวเมนต์	จำเป็น	คำอธิบาย
`change-name`	ไม่	การเปลี่ยนแปลงใดที่จะข้ามขั้นตอน (จะอนุมานจากบริบทหากไม่ได้ระบุ)

สิ่งที่ทำได้:

สร้างเอกสารประกอบทั้งหมดตามลำดับการพึ่งพา
ติดตามความคืบหน้าผ่านรายการงาน
หยุดเมื่อเอกสารประกอบทั้งหมดที่จำเป็นต้องนำไปใช้เสร็จสมบูรณ์
อ่านไฟล์ที่พึ่งพาแต่ละไฟล์ก่อนสร้างเอกสารประกอบถัดไป

ตัวอย่าง:

You: /opsx:ff add-dark-mode

AI:  Fast-forwarding add-dark-mode...

     ✓ Creating proposal.md
     ✓ Creating specs/ui/spec.md
     ✓ Creating design.md
     ✓ Creating tasks.md

     All planning artifacts complete!
     Ready for implementation. Run /opsx:apply to begin.

เคล็ดลับ:

ใช้เมื่อคุณมีภาพชัดเจนว่าจะสร้างอะไร
เร็วกว่า /opsx:continue สำหรับการเปลี่ยนแปลงที่ตรงไปตรงมา
คุณยังสามารถแก้ไขเอกสารประกอบได้หลังจากนั้น
เหมาะสำหรับฟีเจอร์ขนาดเล็กถึงขนาดกลาง

`/opsx:apply`

ดำเนินการตามงานจากแผนการเปลี่ยนแปลง ทำงานผ่านรายการงาน เขียนโค้ด และทำเครื่องหมายรายการที่เสร็จสมบูรณ์

รูปแบบ:

/opsx:apply [change-name]

อาร์กิวเมนต์:

อาร์กิวเมนต์	จำเป็น	คำอธิบาย
`change-name`	ไม่	การเปลี่ยนแปลงใดที่จะดำเนินการ (จะอนุมานจากบริบทหากไม่ได้ระบุ)

สิ่งที่ทำได้:

อ่าน tasks.md และระบุงานที่ยังไม่เสร็จสมบูรณ์
ดำเนินการตามงานทีละรายการ
เขียนโค้ด สร้างไฟล์ รันการทดสอบตามความจำเป็น
ทำเครื่องหมายงานที่เสร็จสมบูรณ์ด้วยช่องทำเครื่องหมาย [x]

ตัวอย่าง:

You: /opsx:apply

AI:  Implementing add-dark-mode...

     Reading tasks.md:
     - [ ] 1.1 Create ThemeContext
     - [ ] 1.2 Add CSS custom properties
     - [ ] 1.3 Implement localStorage persistence

     Working on 1.1: Create ThemeContext...
     [Creates src/context/ThemeContext.tsx]

     ✓ 1.1 Complete

     Working on 1.2: Add CSS custom properties...
     [Updates src/styles/globals.css]

     ✓ 1.2 Complete
     ...

เคล็ดลับ:

สามารถดำเนินการต่อจากจุดที่คุณหยุดได้หากรบกวน
ใช้สำหรับการเปลี่ยนแปลงแบบขนานโดยระบุชื่อการเปลี่ยนแปลง
สถานะการเสร็จสมบูรณ์จะถูกติดตามในช่องทำเครื่องหมายของ tasks.md

`/opsx:verify`

ตรวจสอบว่าการดำเนินการตรงกับเอกสารประกอบการเปลี่ยนแปลงของคุณ ตรวจสอบความสมบูรณ์ ความถูกต้อง และความสอดคล้อง

รูปแบบ:

/opsx:verify [change-name]

อาร์กิวเมนต์:

อาร์กิวเมนต์	จำเป็น	คำอธิบาย
`change-name`	ไม่	การเปลี่ยนแปลงใดที่จะตรวจสอบ (จะอนุมานจากบริบทหากไม่ได้ระบุ)

สิ่งที่ทำได้:

ตรวจสอบคุณภาพการดำเนินการในสามมิติ
ค้นหาหลักฐานการดำเนินการในโค้ดเบส
รายงานปัญหาที่จัดหมวดหมู่เป็น CRITICAL, WARNING, หรือ SUGGESTION
ไม่บล็อกการเก็บถาวร แต่จะแสดงปัญหา

มิติการตรวจสอบ:

มิติ	สิ่งที่ตรวจสอบ
ความสมบูรณ์	งานทั้งหมดเสร็จสมบูรณ์ ข้อกำหนดทั้งหมดถูกดำเนินการ สถานการณ์ทั้งหมดได้รับการพิจารณา
ความถูกต้อง	การดำเนินการตรงกับเจตนาของข้อกำหนด กรณีขอบได้รับการจัดการ
ความสอดคล้อง	การตัดสินใจในการออกแบบสะท้อนในโค้ด รูปแบบมีความสอดคล้องกัน

ตัวอย่าง:

You: /opsx:verify

AI:  Verifying add-dark-mode...

     COMPLETENESS
     ✓ All 8 tasks in tasks.md are checked
     ✓ All requirements in specs have corresponding code
     ⚠ Scenario "System preference detection" has no test coverage

     CORRECTNESS
     ✓ Implementation matches spec intent
     ✓ Edge cases from scenarios are handled
     ✓ Error states match spec definitions

     COHERENCE
     ✓ Design decisions reflected in code structure
     ✓ Naming conventions consistent with design.md
     ⚠ Design mentions "CSS variables" but implementation uses Tailwind classes

     SUMMARY
     ─────────────────────────────
     Critical issues: 0
     Warnings: 2
     Ready to archive: Yes (with warnings)

     Recommendations:
     1. Add test for system preference detection
     2. Update design.md to reflect Tailwind usage, or refactor to use CSS variables

เคล็ดลับ:

รันก่อนเก็บถาวรเพื่อจับความไม่ตรงกันตั้งแต่เนิ่นๆ
คำเตือนไม่บล็อกการเก็บถาวรแต่บ่งชี้ปัญหาที่อาจเกิดขึ้น
เหมาะสำหรับการตรวจสอบงานของ AI ก่อนที่จะยืนยัน
สามารถเปิดเผยความคลาดเคลื่อนระหว่างเอกสารประกอบและการดำเนินการได้

`/opsx:sync`

คำสั่งเสริม ผสานสเปกเดลต้าจากการเปลี่ยนแปลงเข้ากับสเปกหลัก การเก็บถาวรจะถามเพื่อซิงค์หากจำเป็น ดังนั้นโดยปกติคุณไม่จำเป็นต้องรันคำสั่งนี้ด้วยตนเอง

รูปแบบ:

/opsx:sync [change-name]

อาร์กิวเมนต์:

อาร์กิวเมนต์	จำเป็น	คำอธิบาย
`change-name`	ไม่	การเปลี่ยนแปลงใดที่จะซิงค์ (จะอนุมานจากบริบทหากไม่ได้ระบุ)

สิ่งที่ทำได้:

อ่านสเปกเดลต้าจากโฟลเดอร์การเปลี่ยนแปลง
แยกวิเคราะห์ส่วนที่เพิ่ม/แก้ไข/ลบ/เปลี่ยนชื่อ
ผสานการเปลี่ยนแปลงเข้ากับไดเรกทอรีหลัก openspec/specs/
รักษาเนื้อหาที่มีอยู่ซึ่งไม่ได้กล่าวถึงในเดลต้า
ไม่เก็บถาวรการเปลี่ยนแปลง (ยังคงใช้งานอยู่)

ตัวอย่าง:

text

You: /opsx:sync

AI:  Syncing add-dark-mode delta specs...

     Reading: openspec/changes/add-dark-mode/specs/ui/spec.md
     Target:  openspec/specs/ui/spec.md

     Changes to apply:
     ✓ ADDED: Theme Selection requirement (2 scenarios)
     ✓ ADDED: Accessibility requirement (1 scenario)

     Merging...
     ✓ openspec/specs/ui/spec.md updated

     Change remains active. Run /opsx:archive when ready to complete.

เมื่อใดควรใช้ด้วยตนเอง:

สถานการณ์	ใช้ sync?
การเปลี่ยนแปลงที่ใช้เวลานาน ต้องการให้สเปกอยู่ในสเปกหลักก่อนเก็บถาวร	ใช่
การเปลี่ยนแปลงแบบขนานหลายรายการต้องการสเปกพื้นฐานที่อัปเดต	ใช่
ต้องการดูตัวอย่าง/ตรวจสอบการผสานแยกต่างหาก	ใช่
การเปลี่ยนแปลงอย่างรวดเร็ว ไปเก็บถาวรโดยตรง	ไม่ (การเก็บถาวรจะจัดการให้)

เคล็ดลับ:

การซิงค์เป็นแบบอัจฉริยะ ไม่ใช่การคัดลอกและวาง
สามารถเพิ่มสถานการณ์ให้กับข้อกำหนดที่มีอยู่โดยไม่ซ้ำกัน
การเปลี่ยนแปลงยังคงใช้งานอยู่หลังจากซิงค์ (ไม่ได้เก็บถาวร)
ผู้ใช้ส่วนใหญ่จะไม่จำเป็นต้องเรียกใช้คำสั่งนี้โดยตรง—การเก็บถาวรจะถามหากจำเป็น

`/opsx:archive`

เก็บถาวรการเปลี่ยนแปลงที่เสร็จสมบูรณ์ ทำให้การเปลี่ยนแปลงเสร็จสมบูรณ์และย้ายไปยังโฟลเดอร์เก็บถาวร

รูปแบบ:

/opsx:archive [change-name]

อาร์กิวเมนต์:

อาร์กิวเมนต์	จำเป็น	คำอธิบาย
`change-name`	ไม่	การเปลี่ยนแปลงใดที่จะเก็บถาวร (จะอนุมานจากบริบทหากไม่ได้ระบุ)

สิ่งที่ทำได้:

ตรวจสอบสถานะการเสร็จสมบูรณ์ของเอกสารประกอบ
ตรวจสอบการเสร็จสมบูรณ์ของงาน (เตือนหากไม่เสร็จสมบูรณ์)
เสนอให้ซิงค์สเปกเดลต้าหากยังไม่ได้ซิงค์
ย้ายโฟลเดอร์การเปลี่ยนแปลงไปยัง openspec/changes/archive/YYYY-MM-DD-<name>/
รักษาเอกสารประกอบทั้งหมดสำหรับการตรวจสอบย้อนหลัง

ตัวอย่าง:

text

You: /opsx:archive

AI:  Archiving add-dark-mode...

     Artifact status:
     ✓ proposal.md exists
     ✓ specs/ exists
     ✓ design.md exists
     ✓ tasks.md exists (8/8 tasks complete)

     Delta specs: Not yet synced
     → Sync now? (recommended)

You: Yes

AI:  ✓ Synced specs to openspec/specs/ui/spec.md
     ✓ Moved to openspec/changes/archive/2025-01-24-add-dark-mode/

     Change archived successfully.

เคล็ดลับ:

การเก็บถาวรจะไม่บล็อกงานที่ยังไม่เสร็จสมบูรณ์ แต่จะเตือน
สเปกเดลต้าสามารถซิงค์ได้ระหว่างการเก็บถาวรหรือก่อนหน้านั้น
การเปลี่ยนแปลงที่เก็บถาวรจะถูกเก็บรักษาไว้สำหรับประวัติ
ใช้ /opsx:verify ก่อนเพื่อจับปัญหา

`/opsx:bulk-archive`

เก็บถาวรการเปลี่ยนแปลงที่เสร็จสมบูรณ์หลายรายการพร้อมกัน จัดการความขัดแย้งของสเปกระหว่างการเปลี่ยนแปลง

รูปแบบ:

/opsx:bulk-archive [change-names...]

อาร์กิวเมนต์:

อาร์กิวเมนต์	จำเป็น	คำอธิบาย
`change-names`	ไม่	การเปลี่ยนแปลงเฉพาะที่จะเก็บถาวร (จะถามเพื่อเลือกหากไม่ได้ระบุ)

สิ่งที่ทำได้:

แสดงรายการการเปลี่ยนแปลงที่เสร็จสมบูรณ์ทั้งหมด
ตรวจสอบการเปลี่ยนแปลงแต่ละรายการก่อนเก็บถาวร
ตรวจจับความขัดแย้งของสเปกระหว่างการเปลี่ยนแปลง
แก้ไขความขัดแย้งโดยตรวจสอบว่ามีการดำเนินการจริงอย่างไร
เก็บถาวรตามลำดับเวลา

ตัวอย่าง:

You: /opsx:bulk-archive

AI:  Found 3 completed changes:
     - add-dark-mode (8/8 tasks complete)
     - fix-login-bug (3/3 tasks complete)
     - update-footer (2/2 tasks complete)

     Checking for spec conflicts...
     ⚠ add-dark-mode and update-footer both touch specs/ui/

     Inspecting codebase to resolve...
     Both changes are implemented. Will merge in chronological order:
     1. add-dark-mode (created Jan 20)
     2. update-footer (created Jan 22)

     Archive all 3 changes?

You: Yes

AI:  ✓ Archived add-dark-mode
     ✓ Archived fix-login-bug
     ✓ Archived update-footer
     Specs merged: add-dark-mode → update-footer

เคล็ดลับ:

เหมาะสำหรับกระแสงานแบบขนาน
การแก้ไขความขัดแย้งเป็นแบบอัจฉริยะ (ตรวจสอบโค้ดเบส)
การเปลี่ยนแปลงจะถูกเก็บถาวรตามลำดับที่สร้าง
ถามก่อนเขียนทับเนื้อหาสเปก

`/opsx:onboard`

การเริ่มต้นใช้งานแบบมีคำแนะนำผ่านขั้นตอน OpenSpec ที่สมบูรณ์ บทช่วยสอนแบบโต้ตอบโดยใช้โค้ดเบสจริงของคุณ

รูปแบบ:

/opsx:onboard

สิ่งที่ทำได้:

แนะนำขั้นตอนการทำงานที่สมบูรณ์พร้อมคำอธิบาย
สแกนโค้ดเบสของคุณเพื่อหาโอกาสในการปรับปรุงจริง
สร้างการเปลี่ยนแปลงจริงพร้อมเอกสารประกอบจริง
ดำเนินการงานจริง (การเปลี่ยนแปลงเล็กๆ ที่ปลอดภัย)
เก็บถาวรการเปลี่ยนแปลงที่เสร็จสมบูรณ์
อธิบายแต่ละขั้นตอนในขณะที่ดำเนินการ

ขั้นตอน:

ยินดีต้อนรับและการวิเคราะห์โค้ดเบส
ค้นหาโอกาสในการปรับปรุง
สร้างการเปลี่ยนแปลง (/opsx:new)
เขียนข้อเสนอ
สร้างข้อกำหนด
เขียนการออกแบบ
สร้างงาน
ดำเนินการตามงาน (/opsx:apply)
ตรวจสอบการดำเนินการ
เก็บถาวรการเปลี่ยนแปลง
สรุปและขั้นตอนถัดไป

ตัวอย่าง:

You: /opsx:onboard

AI:  Welcome to OpenSpec!

     I'll walk you through the complete workflow using your actual codebase.
     We'll find something small to improve, create a proper change for it,
     implement it, and archive it.

     Let me scan your codebase for opportunities...

     [Analyzes codebase]

     I found a few things we could work on:
     1. Add input validation to the contact form
     2. Improve error messages in the auth flow
     3. Add loading states to async buttons

     Which interests you? (or suggest something else)

เคล็ดลับ:

เหมาะที่สุดสำหรับผู้ใช้ใหม่ที่เรียนรู้ขั้นตอนการทำงาน
ใช้โค้ดจริง ไม่ใช่ตัวอย่างจำลอง
สร้างการเปลี่ยนแปลงจริงที่คุณสามารถเก็บไว้หรือละทิ้งได้
ใช้เวลาประมาณ 15-30 นาทีในการดำเนินการให้เสร็จสมบูรณ์

ไวยากรณ์คำสั่งตามเครื่องมือ AI

เครื่องมือ AI แต่ละตัวใช้ไวยากรณ์คำสั่งที่แตกต่างกันเล็กน้อย ใช้รูปแบบที่ตรงกับเครื่องมือของคุณ:

เครื่องมือ	ตัวอย่างไวยากรณ์
Claude Code	`/opsx:propose`, `/opsx:apply`
Cursor	`/opsx-propose`, `/opsx-apply`
Windsurf	`/opsx-propose`, `/opsx-apply`
Copilot (IDE)	`/opsx-propose`, `/opsx-apply`
Trae	การเรียกใช้ที่อิงตามทักษะ เช่น `/openspec-propose`, `/openspec-apply-change` (ไม่มีไฟล์คำสั่ง `opsx-*` ที่สร้างขึ้น)

เจตนาเดียวกันในทุกเครื่องมือ แต่วิธีที่คำสั่งถูกนำเสนออาจแตกต่างกันไปตามการผสานรวม

หมายเหตุ: คำสั่ง GitHub Copilot (.github/prompts/*.prompt.md) ใช้ได้เฉพาะในส่วนขยาย IDE (VS Code, JetBrains, Visual Studio) เท่านั้น GitHub Copilot CLI ไม่รองรับไฟล์ prompt แบบกำหนดเองในปัจจุบัน — ดู เครื่องมือที่รองรับ สำหรับรายละเอียดและวิธีแก้ปัญหา

คำสั่งแบบเดิม

คำสั่งเหล่านี้ใช้ขั้นตอนการทำงานแบบ "ทั้งหมดในครั้งเดียว" ที่เก่ากว่า ยังใช้งานได้ แต่แนะนำให้ใช้คำสั่ง OPSX

คำสั่ง	หน้าที่
`/openspec:proposal`	สร้างสิ่งที่สร้างทั้งหมดในครั้งเดียว (ข้อเสนอ, ข้อกำหนด, การออกแบบ, งาน)
`/openspec:apply`	ดำเนินการเปลี่ยนแปลง
`/openspec:archive`	จัดเก็บการเปลี่ยนแปลง

เมื่อใดควรใช้คำสั่งแบบเดิม:

โครงการที่มีอยู่แล้วที่ใช้ขั้นตอนการทำงานเดิม
การเปลี่ยนแปลงง่ายๆ ที่คุณไม่ต้องการการสร้างสิ่งที่สร้างแบบค่อยเป็นค่อยไป
ความต้องการใช้วิธีการแบบทั้งหมดหรือไม่มีเลย

การย้ายไปยัง OPSX: การเปลี่ยนแปลงแบบเดิมสามารถดำเนินการต่อด้วยคำสั่ง OPSX ได้ โครงสร้างสิ่งที่สร้างเข้ากันได้

การแก้ไขปัญหา

"ไม่พบการเปลี่ยนแปลง"

คำสั่งไม่สามารถระบุได้ว่าจะทำงานกับการเปลี่ยนแปลงใด

วิธีแก้ไข:

ระบุชื่อการเปลี่ยนแปลงอย่างชัดเจน: /opsx:apply add-dark-mode
ตรวจสอบว่าโฟลเดอร์การเปลี่ยนแปลงมีอยู่: openspec list
ยืนยันว่าคุณอยู่ในไดเรกทอรีโครงการที่ถูกต้อง

"ไม่มีสิ่งที่สร้างพร้อมใช้งาน"

สิ่งที่สร้างทั้งหมดเสร็จสมบูรณ์แล้วหรือถูกบล็อกโดยการพึ่งพาที่ขาดหายไป

วิธีแก้ไข:

รัน openspec status --change <name> เพื่อดูว่าสิ่งใดกำลังบล็อก
ตรวจสอบว่าสิ่งที่สร้างที่จำเป็นมีอยู่แล้ว
สร้างสิ่งที่สร้างการพึ่งพาที่ขาดหายไปก่อน

"ไม่พบสคีมา"

สคีมาที่ระบุไม่มีอยู่

วิธีแก้ไข:

แสดงรายการสคีมาที่มีอยู่: openspec schemas
ตรวจสอบการสะกดชื่อสคีมา
สร้างสคีมาหากเป็นแบบกำหนดเอง: openspec schema init <name>

คำสั่งไม่ได้รับการยอมรับ

เครื่องมือ AI ไม่รู้จักคำสั่ง OpenSpec

วิธีแก้ไข:

ตรวจสอบให้แน่ใจว่า OpenSpec ถูกเริ่มต้นแล้ว: openspec init
สร้างทักษะใหม่: openspec update
ตรวจสอบว่าไดเรกทอรี .claude/skills/ มีอยู่ (สำหรับ Claude Code)
เริ่มต้นเครื่องมือ AI ของคุณใหม่เพื่อรับทักษะใหม่

สิ่งที่สร้างไม่ถูกสร้างอย่างถูกต้อง

AI สร้างสิ่งที่สร้างที่ไม่สมบูรณ์หรือไม่ถูกต้อง

วิธีแก้ไข:

เพิ่มบริบทโครงการใน openspec/config.yaml
เพิ่มกฎสำหรับแต่ละสิ่งที่สร้างเพื่อคำแนะนำเฉพาะ
ให้รายละเอียดเพิ่มเติมในการอธิบายการเปลี่ยนแปลงของคุณ
ใช้ /opsx:continue แทน /opsx:ff เพื่อการควบคุมที่มากขึ้น

ขั้นตอนถัดไป

ขั้นตอนการทำงาน - รูปแบบทั่วไปและเมื่อใดควรใช้คำสั่งแต่ละตัว
CLI - คำสั่งเทอร์มินัลสำหรับการจัดการและการตรวจสอบ
การปรับแต่ง - สร้างสคีมาและขั้นตอนการทำงานแบบกำหนดเอง

คำสั่ง ​

สรุปอย่างรวดเร็ว ​

เส้นทางด่วนเริ่มต้น (โปรไฟล์ core) ​

คำสั่งขั้นตอนการทำงานที่ขยาย (เลือกขั้นตอนการทำงานแบบกำหนดเอง) ​

คำสั่งอ้างอิง ​

/opsx:propose ​

/opsx:explore ​

/opsx:new ​

/opsx:continue ​

/opsx:ff ​

/opsx:apply ​

/opsx:verify ​

/opsx:sync ​

/opsx:archive ​

/opsx:bulk-archive ​

/opsx:onboard ​

ไวยากรณ์คำสั่งตามเครื่องมือ AI ​

คำสั่งแบบเดิม ​

การแก้ไขปัญหา ​

"ไม่พบการเปลี่ยนแปลง" ​

"ไม่มีสิ่งที่สร้างพร้อมใช้งาน" ​

"ไม่พบสคีมา" ​

คำสั่งไม่ได้รับการยอมรับ ​

สิ่งที่สร้างไม่ถูกสร้างอย่างถูกต้อง ​

ขั้นตอนถัดไป ​

คำสั่ง

สรุปอย่างรวดเร็ว

เส้นทางด่วนเริ่มต้น (โปรไฟล์ `core`)

คำสั่งขั้นตอนการทำงานที่ขยาย (เลือกขั้นตอนการทำงานแบบกำหนดเอง)

คำสั่งอ้างอิง

`/opsx:propose`

`/opsx:explore`

`/opsx:new`

`/opsx:continue`

`/opsx:ff`

`/opsx:apply`

`/opsx:verify`

`/opsx:sync`

`/opsx:archive`

`/opsx:bulk-archive`

`/opsx:onboard`

ไวยากรณ์คำสั่งตามเครื่องมือ AI

คำสั่งแบบเดิม

การแก้ไขปัญหา

"ไม่พบการเปลี่ยนแปลง"

"ไม่มีสิ่งที่สร้างพร้อมใช้งาน"

"ไม่พบสคีมา"

คำสั่งไม่ได้รับการยอมรับ

สิ่งที่สร้างไม่ถูกสร้างอย่างถูกต้อง

ขั้นตอนถัดไป