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 <สิ่งที่คุณต้องการสร้าง>

หากคุณต้องการเวิร์กโฟลว์แบบขยาย (/opsx:new, /opsx:continue, /opsx:ff, /opsx:verify, /opsx:sync, /opsx:bulk-archive, /opsx:onboard) ให้เลือกด้วย openspec config profile และใช้งานด้วย openspec update

เอกสาร ​

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

ทำไมต้อง OpenSpec? ​

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

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

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

เทียบกับ Spec Kit (GitHub) — ละเอียดแต่หนัก ขั้นตอนแข็งทื่อ, มาร์กดาวน์เยอะ, ต้องตั้งค่า Python OpenSpec เบากว่าและให้คุณทำซ้ำได้อย่างอิสระ

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

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

การอัปเดต OpenSpec ​

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

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

รีเฟรชคำแนะนำของเอเจนต์

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

openspec update

หมายเหตุการใช้งาน ​

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

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

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

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

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

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

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

การพัฒนา ​

• ติดตั้ง dependencies: pnpm install
• Build: pnpm run build
• ทดสอบ: pnpm test
• พัฒนา CLI ภายในเครื่อง: pnpm run dev หรือ pnpm run dev:cli
• Conventional commits (บรรทัดเดียว): type(scope): subject

อื่นๆ ​

ใบอนุญาต ​

MIT