Wizard

wizard คือ bash script ที่พาคนทำ manual procedure ทีละขั้นตอน สำหรับงานที่น่าเบื่อถ้าต้องทำเอง และน่าเบื่อพอกันถ้าต้องอธิบายให้ AI ฟังใหม่ทุกครั้ง มันเปิด URL ให้ทีละอัน บอกชัด ๆ ว่าต้องคลิกอะไร copy อะไร เก็บค่าที่ได้ แล้วเขียนลงที่ที่มันควรอยู่ (.env, GitHub secrets) confirm ทุกขั้น และโชว์ว่าเหลืออีกเท่าไหร่ ตัว wizard อาจใช้ config service ของ third-party, รัน migration แบบครั้งเดียว หรือย้าย project จาก state หนึ่งไปอีก state หนึ่งก็ได้

UX ที่ใช้งานลื่น ๆ ถูกแก้ไว้ให้แล้วใน template.sh — progress พร้อมเวลาที่เหลือ, confirmation gate, การเปิด URL แบบ cross-platform (รวม WSL), การกรอก secret แบบซ่อน, upsert ค่าใน .env แบบ idempotent, การเขียน gh secret/gh variable และสรุปปิดท้าย หน้าที่ของคุณมีแค่ scope ตัว procedure แล้วเขียน stage ของมันเท่านั้น library ที่อยู่เหนือ marker STAGES เหมือนกันทุก wizard — ความสม่ำเสมอนี่แหละคือประเด็น ห้ามแก้มันด้วยมือเด็ดขาด

โดย default wizard เป็นของชั่วคราว — สร้างมาเพื่อรันครั้งเดียว เซฟไว้ใน scratch หรือ path scripts/ แล้วลบทิ้งเมื่องานเสร็จ commit เข้า repo ก็ต่อเมื่อ user อยากได้ setup path ที่ทำซ้ำได้และควรอยู่ใน repo จริง ๆ

ขั้นตอนการทำงาน

1. Scope ตัว procedure

ไล่ให้ครบว่าคนต้องทำ manual step อะไรบ้าง และมีค่าอะไรถูกเก็บระหว่างทาง อ่าน repo ก่อน — อย่าถามทั้งที่ยังไม่มีข้อมูล:

• สำหรับ setup: ดู .env, .env.example, .env.*, README, docker-compose*, config ของ framework และ .github/workflows/* (ทุกจุดที่อ้างถึง secrets.* / vars.* คือค่าที่ wizard ต้อง produce ให้ได้)
• สำหรับ migration หรือ transition: state ปัจจุบัน, state ปลายทาง และ action ที่ย้อนกลับไม่ได้ระหว่างทาง

จากนั้นโชว์รายการ stage ตามลำดับพร้อมค่าที่แต่ละ stage produce ให้ user ดูแล้วขอ confirm — เขาอาจเพิ่ม ตัด หรือสลับลำดับก็ได้