| name | spk-jumpstart |
| description | เริ่มต้นใช้งานครั้งแรกแบบ jumpstart - ตรวจ repo, สร้าง AGENTS.md ถ้ายังไม่มี, ถาม 1 คำถาม, พาไปถึง first win (plan ที่รีวิวแล้ว) และยืนยัน 1 ครั้งก่อนเขียนโค้ด |
| argument-hint | [เป้าหมาย (ไม่บังคับ) เช่น เพิ่มหน้า login] |
spk-jumpstart
เส้นทางที่เร็วที่สุดจากติดตั้งเสร็จไปถึง first win บน project จริงของคุณ: ถาม 1 คำถาม ยืนยัน 1 ครั้ง และไม่แตะ source code ก่อนได้รับอนุมัติ
ใช้ตอน: เพิ่งเริ่มใช้ครั้งแรก, "เริ่มยังไง", "start here", หรืออยากได้ guided first run
Workflow
- Orient ตรวจ repo status, instructions, manifests และ SPK scaffold แบบ read-only ถ้า scoped guidance หายให้บอก effect
PROJECT_WRITE แล้วทำ repository priming
- ถามเป้าหมายหนึ่งข้อ ถ้า user ให้ goal แล้วให้ใช้เลย ไม่งั้นถามว่าอยาก build, fix หรือ redesign อะไร ห้ามเริ่ม interview ยาว
- เลือกเส้นทางเดียว
- behavior/architecture ใหม่ → planning
- bug/regression → root-cause debugging โดยไม่ patch
- UI direction → design-shotgun โดยไม่แก้ production
- งานอื่น → canonical SPK router
- สร้าง first win คืน reviewed plan, proven diagnosis + smallest fix หรือ comparison board + recommendation และมี verifier pass
- ถามครั้งเดียวก่อน implement สรุป scope, paths, tests และ effect แล้วเริ่ม source write เฉพาะคำตอบ yes ที่ชัด คำตอบกำกวมไม่นับ
- Implement เมื่ออนุมัติ ใช้ implementation/TDD workflow โดยยึด first-win artifact ห้าม stage, commit, push, เปิด PR หรือ deploy เว้นแต่ขอและอนุมัติแยก
Budget: orientation หนึ่ง pass, user question หนึ่งข้อ, primary workflow หนึ่งอัน, verifier หนึ่งอัน และ implementation confirmation หนึ่งครั้ง
Evidence Receipt
คืน spk.evidence/v1 ที่มี routed workflow, effect, orientation artifacts, first-win artifact, verification, assumptions, approval state, risks และ next action
Guardrails
- ห้ามเขียน production source ก่อน explicit implementation approval
- ถ้า host ไม่มีผู้ช่วยย่อยให้ทำ sequential ต่อ ไม่ถือเป็น blocker
- External writes และ uninstall ต้องผ่าน manual approval protocol ของตัวเอง
- Repo ว่างเปล่า: สร้าง
AGENTS.md แบบ minimal แล้วชวนวาง plan ของ feature แรก
- ถ้า user ยกเลิกกลางทาง: มีแค่
AGENTS.md / CLAUDE.md / ai_context/ ที่ถูกสร้าง ซึ่งมีประโยชน์ในตัวเองอยู่แล้ว บอก user 1 บรรทัด
