ai-sprint-kit 1.1.0

package/templates/docs/user-guide-th.md

@@ -0,0 +1,454 @@
+# คู่มือการใช้งาน AI Sprint
+
+คู่มือฉบับสมบูรณ์สำหรับการใช้งาน AI Sprint กับ Claude Code
+
+## สารบัญ
+
+1. [เริ่มต้นใช้งาน](#เริ่มต้นใช้งาน)
+2. [วิธีใช้งานแบบต่างๆ](#วิธีใช้งานแบบต่างๆ)
+3. [คำสั่งทั้งหมด](#คำสั่งทั้งหมด)
+4. [ตั้งค่าเครื่องมือเสริม MCP](#ตั้งค่าเครื่องมือเสริม-mcp)
+5. [เคล็ดลับการใช้งาน](#เคล็ดลับการใช้งาน)
+6. [แก้ปัญหาที่พบบ่อย](#แก้ปัญหาที่พบบ่อย)
+
+---
+
+## เริ่มต้นใช้งาน
+
+### AI Sprint คืออะไร?
+
+AI Sprint คือเครื่องมือที่ช่วยให้คุณสร้างซอฟต์แวร์ได้ง่ายขึ้น โดยมี AI ช่วยเขียนโค้ด ทดสอบ และตรวจสอบความปลอดภัยให้อัตโนมัติ
+
+**ข้อดีหลักๆ:**
+- 🤖 มี AI ผู้เชี่ยวชาญ 9 ตัว ช่วยงานแต่ละด้าน
+- ⚡ มีคำสั่งลัด 10 คำสั่ง ใช้งานง่าย
+- 🔒 ตรวจสอบความปลอดภัยอัตโนมัติ
+- 📝 สร้างเอกสารให้อัตโนมัติ
+
+### สิ่งที่ต้องมีก่อนใช้งาน
+
+1. **Claude Code** - โปรแกรมหลักที่ใช้รัน AI
+2. **Node.js** เวอร์ชัน 18 ขึ้นไป
+
+### เริ่มใช้งานครั้งแรก
+
+หลังจากติดตั้งเสร็จแล้ว ให้ทำตามขั้นตอนนี้:
+
+```bash
+# 1. เปิด Claude Code
+claude
+
+# 2. ลองใช้คำสั่ง /auto (ทำทุกอย่างอัตโนมัติ)
+/auto "สร้าง API สำหรับแสดงข้อมูลสินค้า"
+```
+
+เพียงเท่านี้ AI จะสร้างโค้ด, ทดสอบ, และตรวจสอบความปลอดภัยให้อัตโนมัติ!
+
+### โครงสร้างโฟลเดอร์
+
+หลังติดตั้ง จะมีโฟลเดอร์ใหม่ในโปรเจกต์ของคุณ:
+
+```
+โปรเจกต์ของคุณ/
+├── .claude/             ← ไฟล์ตั้งค่าของ AI
+├── ai_context/          ← ผลงานที่ AI สร้าง
+│   ├── plans/           ← แผนการทำงาน
+│   ├── reports/         ← รายงานต่างๆ
+│   └── memory/          ← บันทึกความจำของ AI
+├── docs/                ← คู่มือ (รวมถึงไฟล์นี้)
+└── CLAUDE.md            ← คำแนะนำสำหรับ AI
+```
+
+---
+
+## วิธีใช้งานแบบต่างๆ
+
+### วิธีที่ 1: อัตโนมัติเต็มรูปแบบ (แนะนำสำหรับมือใหม่)
+
+วิธีที่ง่ายที่สุด - บอก AI ว่าอยากได้อะไร แล้วให้ทำทุกอย่างเอง:
+
+```bash
+/auto "สร้างระบบลงทะเบียนสมาชิกด้วยอีเมลและรหัสผ่าน"
+```
+
+**AI จะทำอะไรบ้าง:**
+1. วางแผนการทำงาน
+2. เขียนโค้ด
+3. สร้างและรันการทดสอบ
+4. ตรวจสอบคุณภาพโค้ด
+5. ตรวจสอบความปลอดภัย
+6. สร้างเอกสาร
+
+**เหมาะกับ:** ฟีเจอร์ใหม่, งานที่ไม่ซับซ้อนมาก
+
+### วิธีที่ 2: ทำทีละขั้นตอน (สำหรับควบคุมรายละเอียด)
+
+ถ้าอยากตรวจสอบแต่ละขั้นตอน:
+
+```bash
+# ขั้นที่ 1: วางแผน
+/plan "สร้างระบบลงทะเบียนสมาชิก"
+# ดูแผนใน ai_context/plans/ แล้วค่อยไปต่อ
+
+# ขั้นที่ 2: เขียนโค้ด
+/code "สร้างระบบตามแผนที่วางไว้"
+
+# ขั้นที่ 3: ทดสอบ
+/test
+
+# ขั้นที่ 4: ตรวจสอบคุณภาพ
+/review
+
+# ขั้นที่ 5: ตรวจสอบความปลอดภัย
+/secure
+```
+
+**เหมาะกับ:** งานซับซ้อน, เมื่อต้องการตรวจสอบทุกขั้นตอน
+
+### วิธีที่ 3: แก้บัค (Bug)
+
+เมื่อโปรแกรมมีปัญหา:
+
+```bash
+# ขั้นที่ 1: หาสาเหตุ
+/debug "หน้าลงทะเบียนแสดง Error 500 ตอนกดสมัคร"
+
+# ขั้นที่ 2: แก้ไข
+/code "แก้ไขปัญหาตามที่วิเคราะห์"
+
+# ขั้นที่ 3: ทดสอบว่าแก้ได้จริง
+/test
+```
+
+### วิธีที่ 4: ตรวจสอบก่อนส่งงาน
+
+**ทำทุกครั้ง** ก่อนบันทึกโค้ดลง Git:
+
+```bash
+/validate
+```
+
+คำสั่งนี้จะ:
+- รันการทดสอบทั้งหมด
+- ตรวจสอบคุณภาพโค้ด
+- ตรวจสอบความปลอดภัย
+
+ถ้าพบปัญหา จะแจ้งเตือนให้แก้ไขก่อน
+
+---
+
+## คำสั่งทั้งหมด
+
+### /plan - วางแผนการทำงาน
+
+บอก AI ว่าอยากสร้างอะไร แล้วให้วางแผนก่อน
+
+```bash
+/plan "สร้างระบบตะกร้าสินค้า"
+/plan "เพิ่มระบบ Login ด้วย Google"
+```
+
+**ผลลัพธ์:** ได้แผนการทำงานใน `ai_context/plans/`
+
+---
+
+### /code - เขียนโค้ด
+
+ให้ AI เขียนหรือแก้ไขโค้ด
+
+```bash
+/code "สร้างระบบตามแผนที่วางไว้"
+/code "เพิ่มปุ่มออกจากระบบ"
+/code "แก้ไขหน้าแสดงสินค้าให้โหลดเร็วขึ้น"
+```
+
+---
+
+### /test - ทดสอบโค้ด
+
+สร้างและรันการทดสอบอัตโนมัติ
+
+```bash
+/test
+```
+
+**สิ่งที่ได้:**
+- การทดสอบใหม่สำหรับโค้ดที่เขียน
+- รายงานว่าผ่าน/ไม่ผ่าน
+- เปอร์เซ็นต์ความครอบคลุม (ต้องได้ 80% ขึ้นไป)
+
+---
+
+### /review - ตรวจสอบคุณภาพ
+
+ให้ AI ตรวจสอบว่าโค้ดเขียนดีหรือไม่
+
+```bash
+/review
+```
+
+**AI จะดู:**
+- โค้ดเข้าใจง่ายไหม
+- มีข้อผิดพลาดที่อาจเกิดขึ้นไหม
+- ทำงานเร็วพอไหม
+- มีจุดที่อาจไม่ปลอดภัยไหม
+
+---
+
+### /secure - ตรวจสอบความปลอดภัย
+
+ตรวจหาช่องโหว่และปัญหาด้านความปลอดภัย
+
+```bash
+/secure
+```
+
+**AI จะตรวจ:**
+- รหัสผ่านหรือข้อมูลลับที่ฝังในโค้ด
+- ช่องโหว่ที่แฮกเกอร์อาจโจมตีได้
+- ไลบรารีที่มีปัญหาความปลอดภัย
+
+---
+
+### /deploy - ตั้งค่าการ Deploy
+
+ตั้งค่าระบบ CI/CD สำหรับ Deploy อัตโนมัติ
+
+```bash
+/deploy
+```
+
+---
+
+### /docs - สร้างเอกสาร
+
+สร้างเอกสารอธิบายโค้ดอัตโนมัติ
+
+```bash
+/docs
+```
+
+---
+
+### /debug - หาสาเหตุปัญหา
+
+เมื่อโปรแกรมมีบัค ให้ AI ช่วยหาสาเหตุ
+
+```bash
+/debug "หน้าเว็บโหลดช้ามากเมื่อมีสินค้าเยอะ"
+/debug "ระบบล็อกอินใช้ไม่ได้"
+```
+
+**ผลลัพธ์:** รายงานวิเคราะห์สาเหตุและวิธีแก้ไข
+
+---
+
+### /validate - ตรวจสอบก่อนส่งงาน
+
+รวมการทดสอบ + ตรวจคุณภาพ + ตรวจความปลอดภัย
+
+```bash
+/validate
+```
+
+**ใช้ทุกครั้งก่อนบันทึกโค้ด!**
+
+---
+
+### /auto - ทำทุกอย่างอัตโนมัติ
+
+คำสั่งเดียวทำครบทุกขั้นตอน
+
+```bash
+/auto "สร้างหน้าแสดงรายการสั่งซื้อ"
+```
+
+**AI จะทำ:** วางแผน → เขียนโค้ด → ทดสอบ → ตรวจคุณภาพ → ตรวจความปลอดภัย → สร้างเอกสาร
+
+---
+
+## ตั้งค่าเครื่องมือเสริม MCP
+
+MCP คือเครื่องมือเสริมที่ช่วยให้ AI ทำงานได้ดีขึ้น (ไม่บังคับแต่แนะนำ)
+
+### ตั้งค่าเบื้องต้น
+
+```bash
+# 1. คัดลอกไฟล์ตัวอย่าง
+cp .mcp.json.example .mcp.json
+
+# 2. แก้ไขไฟล์ .mcp.json ใส่ API Key ของคุณ
+```
+
+### เครื่องมือที่มีให้ใช้
+
+| เครื่องมือ | ประโยชน์ | รับ API Key ได้ที่ |
+|-----------|---------|-------------------|
+| **exa** | ค้นหาข้อมูลบนเว็บ (ดีกว่าปกติ) | https://exa.ai |
+| **context7** | ดูเอกสารของไลบรารีต่างๆ | https://context7.com |
+| **chrome-devtools** | Debug เว็บไซต์ | ไม่ต้องใช้ Key |
+| **sequential-thinking** | คิดวิเคราะห์ซับซ้อน | ไม่ต้องใช้ Key |
+
+### วิธีตั้งค่า
+
+เปิดไฟล์ `.mcp.json` แล้วใส่ API Key:
+
+```json
+{
+  "mcpServers": {
+    "exa": {
+      "command": "npx",
+      "args": ["-y", "exa-mcp-server"],
+      "env": {
+        "EXA_API_KEY": "ใส่-key-ของคุณ-ตรงนี้"
+      }
+    }
+  }
+}
+```
+
+### ทำไมควรตั้งค่า?
+
+- **exa** - ช่วยให้ AI ค้นหาข้อมูลใหม่ๆ บนอินเทอร์เน็ตได้
+- **context7** - ช่วยให้ AI อ่านเอกสารของไลบรารีที่ใช้ได้
+
+---
+
+## เคล็ดลับการใช้งาน
+
+### 1. เริ่มต้นด้วยการวางแผนเสมอ
+
+สำหรับงานที่ซับซ้อน ให้วางแผนก่อนเขียนโค้ด:
+
+```bash
+/plan "อธิบายสิ่งที่ต้องการ"
+# ดูแผนก่อน แล้วค่อย
+/code "สร้างตามแผน"
+```
+
+### 2. ใช้ /validate ทุกครั้งก่อนบันทึก
+
+```bash
+/validate
+# ถ้าผ่าน ค่อยบันทึกโค้ด
+git add .
+git commit -m "เพิ่มฟีเจอร์ใหม่"
+```
+
+### 3. อ่านรายงานที่ AI สร้าง
+
+AI จะบันทึกผลการทำงานไว้ใน `ai_context/reports/`
+
+```bash
+# ดูรายงานความปลอดภัย
+cat ai_context/reports/security-*.md
+```
+
+### 4. ใช้ /auto สำหรับงานง่ายๆ
+
+ฟีเจอร์เล็กๆ ใช้ /auto ได้เลย:
+
+```bash
+/auto "เพิ่มปุ่มกลับหน้าแรก"
+```
+
+### 5. ใช้ทีละขั้นตอนสำหรับงานซับซ้อน
+
+งานใหญ่ๆ ควรทำทีละขั้น:
+
+```bash
+/plan "ระบบซับซ้อน"
+# ดูแผน
+/code "ทำส่วนที่ 1"
+/test
+/code "ทำส่วนที่ 2"
+/test
+/validate
+```
+
+---
+
+## แก้ปัญหาที่พบบ่อย
+
+### การทดสอบไม่ผ่าน
+
+```bash
+# ดูว่าผิดพลาดตรงไหน
+/test
+
+# ให้ AI ช่วยหาสาเหตุ
+/debug "การทดสอบ X ไม่ผ่าน แสดง Error Y"
+```
+
+### ความครอบคลุมการทดสอบต่ำ
+
+```bash
+# สร้างการทดสอบเพิ่ม
+/test "สร้างการทดสอบเพิ่มสำหรับฟังก์ชันที่ยังไม่ได้ทดสอบ"
+```
+
+### พบปัญหาความปลอดภัย
+
+```bash
+# ดูรายงาน
+cat ai_context/reports/security-*.md
+
+# แก้ไข
+/code "แก้ไขปัญหาความปลอดภัยตามรายงาน"
+
+# ตรวจสอบอีกครั้ง
+/secure
+```
+
+### คำสั่งไม่ทำงาน
+
+ตรวจสอบว่าอยู่ในโฟลเดอร์ที่มี `.claude/`:
+
+```bash
+ls .claude/
+```
+
+ถ้าไม่มี ให้ติดตั้งใหม่:
+
+```bash
+npx ai-sprint init --force
+```
+
+### MCP ไม่ทำงาน
+
+ตรวจสอบว่าไฟล์ `.mcp.json` ถูกต้อง:
+
+```bash
+# ดูว่ามีไฟล์ไหม
+cat .mcp.json
+
+# ตรวจสอบว่าไม่มี placeholder
+grep "YOUR_" .mcp.json
+# ถ้าพบ YOUR_ แสดงว่ายังไม่ได้ใส่ API Key จริง
+```
+
+---
+
+## สรุปคำสั่งลัด
+
+| ต้องการทำอะไร | ใช้คำสั่ง |
+|--------------|---------|
+| ทำทุกอย่างอัตโนมัติ | `/auto "คำอธิบาย"` |
+| วางแผนก่อน | `/plan "คำอธิบาย"` |
+| เขียนโค้ด | `/code "สิ่งที่ต้องการ"` |
+| ทดสอบ | `/test` |
+| ตรวจคุณภาพ | `/review` |
+| ตรวจความปลอดภัย | `/secure` |
+| หาสาเหตุบัค | `/debug "ปัญหาที่เจอ"` |
+| ตรวจก่อนส่งงาน | `/validate` |
+
+---
+
+## ต้องการความช่วยเหลือเพิ่มเติม?
+
+- ดูคู่มือภาษาอังกฤษ: `docs/user-guide.md`
+- ดูคำแนะนำโดยละเอียด: `CLAUDE.md`
+
+---
+
+**สร้างด้วย ❤️ สำหรับนักพัฒนาทุกคน**