इस प्रोजेक्ट के बारे में

OpenSpec एक स्पेक-ड्रिवन डेवलपमेंट (SDD) फ्रेमवर्क है जो AI कोडिंग सहायकों के लिए डिज़ाइन किया गया है। यह एक हल्का स्पेसिफिकेशन लेयर जोड़ता है ताकि मानव डेवलपर्स और AI सहायक एक साथ क्या बनाना है, इस पर कोड लिखने से पहले सहमत हो सकें। यह प्रोजेक्ट @fission-ai/openspec नाम के npm पैकेज के रूप में प्रकाशित किया गया है, MIT लाइसेंस के तहत उपलब्ध है और Node.js 20.19.0 या उससे अधिक की आवश्यकता होती है। इसका वर्कफ्लो समर्थित AI कोडिंग टूल्स के भीतर काम करने वाले स्लैश कमांड्स पर आधारित है। प्रोजेक्ट में `openspec init` चलाने के बाद, उपयोगकर्ता `/opsx:explore` कमांड का उपयोग करके AI के साथ एक विचार पर चर्चा कर सकते हैं, `/opsx:propose <name>` के साथ एक परिवर्तन प्रस्ताव बना सकते हैं, `/opsx:apply` से योजनाबद्ध कार्यों को लागू कर सकते हैं, और `/opsx:archive` से परिवर्तन को समाप्त और आर्काइव कर सकते हैं। प्रत्येक प्रस्तावित परिवर्तन के लिए `openspec/changes/` के अंतर्गत एक अलग फोल्डर बनता है, जिसमें `proposal.md`, आवश्यकताओं और परिदृश्यों के साथ `specs/` फोल्डर, `design.md`, और `tasks.md` शामिल होते हैं। स्पेसिफिकेशन साधारण Markdown में लिखे जाते हैं, जिसमें एक सरल आवश्यकता-और-परिदृश्य प्रारूप होता है और कोई विशेष सिंटैक्स की आवश्यकता नहीं होती। OpenSpec 30 से अधिक AI कोडिंग सहायकों और टूल्स को समर्थन देता है, जिनमें कैनॉनिकल कमांड के विभिन्न स्पेलिंग्स होती हैं, जैसे `/opsx-propose`, `@opsx-propose`, या `$openspec-propose`। एक विस्तारित वर्कफ्लो प्रोफाइल भी उपलब्ध है जिसमें अतिरिक्त कमांड्स जैसे `/opsx:new`, `/opsx:continue`, `/opsx:ff`, `/opsx:verify`, और `/opsx:onboard` शामिल हैं। प्रोजेक्ट एक बीटा फीचर भी पेश करता है जिसे Stores कहा जाता है, जो एक अलग रिपोजिटरी में टीम द्वारा शेयर किए जाने वाले योजनाबद्ध कार्यों की अनुमति देता है, जिसे git push के माध्यम से सिंक किया जाता है। Stores भी `openspec/` संरचना का उपयोग करते हैं और क्रॉस-रिपो फीचर्स, एक टीम द्वारा स्वीकृत साझा आवश्यकताओं, और ऐसे योजनाबद्ध वर्कफ्लो का समर्थन करने का लक्ष्य रखते हैं जहां कोड रिपोजिटरी बाद में अपडेट होते हैं। OpenSpec अनाम उपयोग सांख्यिकी एकत्र करता है, जो केवल कमांड नाम और संस्करण तक सीमित है—कोई तर्क, पथ, सामग्री या व्यक्तिगत पहचान योग्य जानकारी नहीं। टेलीमेट्री CI में स्वचालित रूप से अक्षम हो जाती है और कॉन्फिगरेशन या एनवायरनमेंट वेरिएबल्स के माध्यम से अनुमति देकर इसे अक्षम किया जा सकता है। डॉक्यूमेंटेशन में शुरुआत, कमांड्स कैसे काम करते हैं, मौजूदा प्रोजेक्ट्स में अपनाया गया उपयोग, परिवर्तन संपादित करना, CLI रेफरेंस, बहुभाषी समर्थन, कस्टमाइजेशन और समुदाय स्कीमास शामिल हैं। प्रोजेक्ट OpenSpec के स्वयं के द्वारा बनाया गया है और इसका रिपोजिटरी स्पेसिफिकेशन और चल रहे परिवर्तनों के लाइव उदाहरण शामिल है।