ภาพรวม
ตัวเลือกของคุณสำหรับการปรับแต่ง OpenSpec
OpenSpec รองรับตัวเลือกการปรับแต่งหลายแบบ หน้านี้แสดงให้เห็นว่าแต่ละตัวเลือกเปลี่ยนแปลงอะไรและควรใช้เมื่อใด
สิ่งที่คุณปรับแต่งได้
| ตัวเลือก | สิ่งที่เปลี่ยนแปลง | ใช้เมื่อใด |
|---|---|---|
| Profiles | เวิร์กโฟลว์ใดที่ติดตั้ง และเป็นสกิล คำสั่ง หรือทั้งสองอย่าง | คุณต้องการเวิร์กโฟลว์และรูปแบบการทำงานเพิ่มเติม หรือต้องการลบเวิร์กโฟลว์ที่ไม่จำเป็น |
| Project configuration | คำแนะนำที่แทรกเข้าไปในทุกการรันเวิร์กโฟลว์: บริบท กฎ และคำแนะนำการทำงาน (config.yaml) | คุณต้องการวางแผนการเปลี่ยนแปลงตามแบบของคุณ เช่น งานต้องรวมการทดสอบ Playwright เสมอ |
| Schemas | สิ่งที่ OpenSpec สร้างขึ้น: อาร์ติแฟกต์ ลำดับ และเทมเพลต | การเปลี่ยนแปลงควรสร้างไฟล์การวางแผน ส่วน หรือรูปแบบที่แตกต่างกัน |
ไม่แน่ใจว่าจะใช้แบบไหน?
Config และ schemas เป็นการปรับแต่งสองระดับ เลือกตามระดับที่คุณต้องการลงมือทำเอง:
- เริ่มต้นด้วย project configuration: มันเบากว่า และสำหรับโปรเจกต์ส่วนใหญ่ก็เพียงพอแล้ว คุณยังคงใช้อาร์ติแฟกต์มาตรฐานและเพิ่มบริบทและกฎของคุณเองเข้าไปด้านบน
- ฟอร์ก schema เมื่อการเพิ่มไม่เพียงพอ: config ทำได้แค่เพิ่มบนเวิร์กโฟลว์หลักเท่านั้น มันสามารถเพิ่มกฎเช่น "งานต้องรวมการทดสอบเสมอ" แต่ไม่สามารถลบเอกสารการออกแบบหรือเปลี่ยนชื่อไฟล์ได้ นั่นคือขอบเขตของ schema การฟอร์กจะทำให้คุณมีสำเนาของคุณเองเพื่อแก้ไข
"ฟอร์ก" ในที่นี้หมายถึงคำสั่ง openspec schema fork ไม่ใช่การฟอร์ก git repo Schemas มีรายละเอียด
flowchart LR
a["เวิร์กโฟลว์ควรรู้จักสแตกและธรรมเนียมของฉัน"] --> config
b["อาร์ติแฟกต์หนึ่งต้องการกฎเพิ่มเติม เช่น งานต้องรวมการทดสอบเสมอ"] --> config
c["อาร์ติแฟกต์ ชื่อไฟล์ หรือโครงสร้างเอกสารที่แตกต่างกัน"] --> schema
d["คำแนะนำในตัวบอกสิ่งที่ทีมของฉันทำแตกต่างออกไป"] --> schema
config["การตั้งค่าโปรเจกต์<br/>(config.yaml)"]
schema["ฟอร์ก schema<br/>(openspec schema fork)"]