Skip to content

ภาพรวม ​

ตัวเลือกของคุณสำหรับการปรับแต่ง 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)"]