อภิธานศัพท์
คำศัพท์ OpenSpec ทุกคำ หนึ่งบรรทัดต่อคำ
OpenSpec ใช้คำซ้ำที่มีความหมายอื่นใน git, CI และเครื่องมือเอเจนต์ แต่ละแถวให้ความหมายใน OpenSpec คอลัมน์สุดท้ายเชื่อมโยงไปยังรายละเอียดเพิ่มเติมหากมี
| คำศัพท์ | นิยาม | เพิ่มเติม |
|---|---|---|
| Apply | ดำเนินการตามงานในข้อเสนอการเปลี่ยนแปลง ทักษะ: openspec-apply-change | Apply a change |
| Archive | ทำให้ข้อเสนอการเปลี่ยนแปลงเสร็จสมบูรณ์: รวมเดลต้าของมันเข้ากับสเปกหลักและย้ายโฟลเดอร์ไปยัง openspec/changes/archive/ | Quickstart |
| Artifact | เอกสารการวางแผนภายในข้อเสนอการเปลี่ยนแปลง: proposal.md, delta specs, design.md, tasks.md ไม่ใช่ผลลัพธ์จากการ build | Artifacts |
| Capability | พื้นที่พฤติกรรมหนึ่งของระบบของคุณ แต่ละพื้นที่มีสเปกหนึ่งรายการที่ openspec/specs/<capability>/spec.md | Capabilities |
| Change proposal | หน่วยงานหนึ่งหน่วย: โฟลเดอร์ภายใต้ openspec/changes/<name>/ ที่เก็บ artifacts การวางแผน มักย่อเป็น "change" ไม่ใช่ git commit | Propose |
| Command | จุดเริ่มต้นที่พิมพ์ได้สำหรับเวิร์กโฟลว์ การสะกดแตกต่างกันไปตามเครื่องมือ (/opsx:propose, /opsx-propose) เอกสารอ้างอิงเวิร์กโฟลว์ตามทักษะแทน | Supported tools |
| Continue | สร้าง artifact การวางแผนถัดไปสำหรับข้อเสนอการเปลี่ยนแปลงที่มีอยู่ ทักษะ: openspec-continue-change | Skills |
| Delivery | วิธีการติดตั้งเวิร์กโฟลว์: เป็นทักษะ คำสั่ง หรือทั้งสองอย่าง | Set up your project |
| Delta spec | สเปกภายในข้อเสนอการเปลี่ยนแปลงที่ระบุเฉพาะสิ่งที่เปลี่ยนแปลง ภายใต้หัวข้อ ADDED, MODIFIED, REMOVED, และ RENAMED | Delta specs |
| Explore | คิดไอเดียให้ละเอียดกับเอเจนต์ก่อนเสนอ ไม่เขียนโค้ด ทักษะ: openspec-explore | Explore an idea |
| Fast-forward | สร้างข้อเสนอการเปลี่ยนแปลงพร้อม artifact การวางแผนทั้งหมดในครั้งเดียว พร้อมนำไปปฏิบัติ ทักษะ: openspec-ff-change ไม่ใช่ git fast-forward | Skills |
| Legacy workflow | คำสั่ง /openspec:* ก่อนยุค OPSX | |
| Loop | วงจรที่ข้อเสนอการเปลี่ยนแปลงดำเนินไป: สำรวจ เสนอ ทบทวน นำไปใช้ จัดเก็บ | Quickstart |
| Main specs | โครงสร้าง openspec/specs/: พฤติกรรมปัจจุบันที่ตกลงกันของระบบของคุณ การจัดเก็บรวมเดลต้าเข้าไป ความสามารถที่ยังไม่มีสเปกจะได้รับจากข้อกำหนด ADDED ของมัน | Archive |
| OpenSpec root | โครงสร้าง openspec/ ที่คำสั่งอ้างอิงและดำเนินการ: ของ repo ของคุณ หรือของ store | Stores |
| OPSX | ระบบเวิร์กโฟลว์ OpenSpec ปัจจุบัน และคำนำหน้าคำสั่งที่ติดตั้ง (/opsx:) | |
| Profile | เวิร์กโฟลว์ที่ init ติดตั้ง: core หรือ custom | Profiles |
| Propose | สร้างข้อเสนอการเปลี่ยนแปลงและสร้าง artifact การวางแผนทั้งหมดในขั้นตอนเดียว ทักษะ: openspec-propose | Quickstart |
| Registry | รายการระดับเครื่องของ store ที่ลงทะเบียน ใน registry.yaml ไม่ใช่ package registry | CLI |
| Requirement | พฤติกรรมหนึ่งที่ระบบต้องมี เขียนด้วย SHALL: ### Requirement: ในสเปก | Delta specs |
| Scenario | ตัวอย่างที่ทดสอบได้ภายใต้ข้อกำหนด ในรูปแบบ WHEN/THEN | Delta specs |
| Schema | คำนิยามว่า artifact ใดที่ข้อเสนอการเปลี่ยนแปลงสร้างขึ้น และในลำดับใด ไม่ใช่ JSON Schema | Schemas |
| Skill | คำแนะนำของเวิร์กโฟลว์ ติดตั้งในตำแหน่งที่เครื่องมือ AI ของคุณอ่าน (.agents/skills/, ...) | Skills |
| Spec | ไฟล์ที่อธิบายว่าความสามารถหนึ่งทำงานอย่างไรในปัจจุบัน ที่ openspec/specs/<capability>/spec.md | Archive |
| spec-driven | schema เริ่มต้น: proposal, ตามด้วย delta specs, ตามด้วย design, ตามด้วย tasks | spec-driven |
| Store | repo OpenSpec แบบสแตนด์อโลนที่ลงทะเบียนบนเครื่องของคุณ สำหรับการวางแผนที่ครอบคลุมหลาย repo ไม่ใช่ data store | Stores (beta) |
| Sync | รวมเดลต้าที่นำไปปฏิบัติแล้วเข้ากับสเปกหลักโดยไม่จัดเก็บ ทักษะ: openspec-sync-specs | Skills |
| Template | เนื้อหาเริ่มต้นที่ schema ให้กับแต่ละ artifact | Schemas |
| Update | ในฐานะทักษะ (openspec-update-change): แก้ไข artifact การวางแผนของข้อเสนอการเปลี่ยนแปลง ในฐานะคำสั่ง CLI (openspec update): อัปเดตไฟล์ที่ติดตั้งของ OpenSpec | Update a change, CLI |
| Verify | ตรวจสอบว่าการนำไปปฏิบัติตรงกับ artifact ของข้อเสนอการเปลี่ยนแปลงก่อนจัดเก็บ ทักษะ: openspec-verify-change | Skills |
| Workflow | การกระทำ OpenSpec ที่มีชื่อ (propose, apply, archive, ...) ติดตั้งในเครื่องมือ AI ของคุณเป็นทักษะหรือคำสั่ง | Set up your project |
| Workset | กลุ่มโฟลเดอร์ส่วนตัวในเครื่องที่เปิดพร้อมกันในเครื่องมือเดียว ไม่ใช่ store และไม่มีการแชร์อะไร | Worksets (beta) |