OpenSpecการพัฒนาที่ขับเคลื่อนด้วยข้อกำหนด สำหรับ AI ผู้ช่วย

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

ติดตาม @0xTab บน X สำหรับการอัปเดต · เข้าร่วม OpenSpec Discord เพื่อขอความช่วยเหลือและถามคำถาม

ดูตัวอย่างการใช้งาน ​

You: /opsx:propose add-dark-mode
AI:  Created openspec/changes/add-dark-mode/
     ✓ proposal.md — why we're doing this, what's changing
     ✓ specs/       — requirements and scenarios
     ✓ design.md    — technical approach
     ✓ tasks.md     — implementation checklist
     Ready for implementation!

You: /opsx:apply
AI:  Implementing tasks...
     ✓ 1.1 Add theme context provider
     ✓ 1.2 Create toggle component
     ✓ 2.1 Add CSS variables
     ✓ 2.2 Wire up localStorage
     All tasks complete!

You: /opsx:archive
AI:  Archived to openspec/changes/archive/2025-01-23-add-dark-mode/
     Specs updated. Ready for the next feature.

เริ่มต้นอย่างรวดเร็ว ​

ต้องใช้ Node.js เวอร์ชัน 20.19.0 หรือใหม่กว่า

ติดตั้ง OpenSpec ทั่วทั้งระบบ:

npm install -g @fission-ai/openspec@latest

จากนั้นไปที่ไดเรกทอรีโปรเจกต์ของคุณและเริ่มต้น:

cd your-project
openspec init

ตอนนี้บอก AI ของคุณ: /opsx:propose <what-you-want-to-build>

หากคุณต้องการขั้นตอนการทำงานที่ขยาย (/opsx:new, /opsx:continue, /opsx:ff, /opsx:verify, /opsx:sync, /opsx:bulk-archive, /opsx:onboard) ให้เลือกด้วย openspec config profile และนำไปใช้ด้วย openspec update

เอกสารประกอบ ​

→ เริ่มต้นใช้งาน: ขั้นตอนแรก
→ ขั้นตอนการทำงาน: การผสมผสานและรูปแบบ
→ คำสั่ง: คำสั่งแบบ slash และทักษะ
→ CLI: อ้างอิงเทอร์มินัล
→ เครื่องมือที่รองรับ: การผสานรวมเครื่องมือและเส้นทางการติดตั้ง
→ แนวคิด: วิธีที่ทุกอย่างเชื่อมต่อกัน
→ หลายภาษา: การสนับสนุนหลายภาษา
→ การปรับแต่ง: ทำให้เป็นของคุณเอง

ทำไมต้อง OpenSpec? ​

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

• ตกลงก่อนที่จะสร้าง — มนุษย์และ AI ตกลงในข้อกำหนดก่อนที่จะเขียนโค้ด
• จัดระเบียบอยู่เสมอ — การเปลี่ยนแปลงแต่ละครั้งจะมีโฟลเดอร์ของตัวเองพร้อมข้อเสนอ ข้อกำหนด การออกแบบ และงาน
• ทำงานอย่างยืดหยุ่น — อัปเดต artifact ใดก็ได้ตลอดเวลา ไม่มีขั้นตอนที่เข้มงวด
• ใช้เครื่องมือของคุณ — ทำงานร่วมกับ AI ผู้ช่วยมากกว่า 20 รายการผ่านคำสั่งแบบ slash

เปรียบเทียบกับเรา ​

vs. Spec Kit (GitHub) — ละเอียดถี่ถ้วนแต่หนัก OpenSpec เบากว่าและให้คุณวนซ้ำได้อย่างอิสระ

vs. Kiro (AWS) — ทรงพลังแต่คุณถูกล็อกไว้ใน IDE ของพวกเขาและจำกัดเฉพาะโมเดล Claude OpenSpec ทำงานร่วมกับเครื่องมือที่คุณใช้อยู่แล้ว

vs. ไม่มีอะไร — การเขียนโค้ดด้วย AI โดยไม่มีข้อกำหนดหมายถึง prompt ที่คลุมเครือและผลลัพธ์ที่คาดเดาไม่ได้ OpenSpec นำความคาดเดาได้มาโดยไม่ต้องมีพิธีรีตอง

การอัปเดต OpenSpec ​

อัปเกรดแพ็กเกจ

npm install -g @fission-ai/openspec@latest

รีเฟรชคำแนะนำของ agent

รันคำสั่งนี้ในแต่ละโปรเจกต์เพื่อสร้างคำแนะนำ AI ใหม่และให้แน่ใจว่าคำสั่งแบบ slash ล่าสุดทำงานอยู่:

openspec update

บันทึกการใช้งาน ​

การเลือกโมเดล: OpenSpec ทำงานได้ดีที่สุดกับโมเดลที่มีเหตุผลสูง เราแนะนำ Opus 4.5 และ GPT 5.2 สำหรับทั้งการวางแผนและการนำไปใช้งาน

สุขอนามัยบริบท: OpenSpec ได้ประโยชน์จากหน้าต่างบริบทที่สะอาด ล้างบริบทของคุณก่อนเริ่มการนำไปใช้งานและรักษาสุขอนามัยบริบทที่ดีตลอดเซสชันของคุณ

การมีส่วนร่วม ​

การแก้ไขเล็กน้อย — การแก้ไขข้อผิดพลาด การแก้ไขข้อผิดพลาด และการปรับปรุงเล็กน้อยสามารถส่งเป็น PR ได้โดยตรง

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

เมื่อเขียนข้อเสนอ โปรดคำนึงถึงปรัชญาของ OpenSpec: เราให้บริการผู้ใช้ที่หลากหลายใน agent ต่างๆ โมเดล และกรณีการใช้งาน การเปลี่ยนแปลงควรทำงานได้ดีสำหรับทุกคน

ยินดีต้อนรับโค้ดที่สร้างโดย AI — ตราบใดที่ได้รับการทดสอบและตรวจสอบแล้ว PR ที่มีโค้ดที่สร้างโดย AI ควรระบุ agent ที่ใช้เขียนโค้ดและโมเดล (เช่น "สร้างด้วย Claude Code โดยใช้ claude-opus-4-5-20251101")

การพัฒนา ​

• ติดตั้ง dependency: pnpm install
• สร้าง: pnpm run build
• ทดสอบ: pnpm test
• พัฒนา CLI ท้องถิ่น: pnpm run dev หรือ pnpm run dev:cli
• การ commit แบบ conventional (บรรทัดเดียว): type(scope): subject

อื่นๆ ​

ลิขสิทธิ์ ​

MIT