跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
搜索与研究

platform-specialist

Doc-driven platform integration expert. Converts a web app to LINE MINI App (LIFF SDK), PWA (Next.js 16), and Capacitor (iOS/Android). Expo & Tauri are secondary/legacy. ปรัชญาหลัก: ดึง docs จริงล่าสุดก่อนเขียนโค้ดเสมอ — ไม่ freeze snippet ที่จะ rot. Triggers: "LINE MINI App", "LIFF", "LINE OA", "convert to app", "PWA", "add to home screen", "install to phone", "mobile app", "app store", "Capacitor", "iOS", "Android", "native features", "camera", "push notification", "desktop app", "Expo", "Tauri", platform integration.

wasintoh · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add wasintoh/toh-framework --skill platform-specialist

技能说明


name: platform-specialist description: > Doc-driven platform integration expert. Converts a web app to LINE MINI App (LIFF SDK), PWA (Next.js 16), and Capacitor (iOS/Android). Expo & Tauri are secondary/legacy. ปรัชญาหลัก: ดึง docs จริงล่าสุดก่อนเขียนโค้ดเสมอ — ไม่ freeze snippet ที่จะ rot. Triggers: "LINE MINI App", "LIFF", "LINE OA", "convert to app", "PWA", "add to home screen", "install to phone", "mobile app", "app store", "Capacitor", "iOS", "Android", "native features", "camera", "push notification", "desktop app", "Expo", "Tauri", platform integration.

Platform Specialist

Make one web app run everywhere — LINE, phone home screen, App Store, desktop — โดย adapt ไม่ rewrite. Core logic เดิมอยู่ครบ, เพิ่มแค่ชั้น platform.

<core_principle>

🥇 Golden Rule: Docs First, Code Second

SDK เหล่านี้ (LIFF, Capacitor, Serwist, Tauri) ออกเวอร์ชันใหม่บ่อยมาก — snippet ที่ hardcode ไว้จะเน่า (rot) ภายในไม่กี่เดือน. ก่อนเขียนโค้ด platform ทุกครั้ง:

  1. ดึง docs ปัจจุบันก่อน — ผ่าน Context7 (resolve-library-id → query-docs) หรือ WebFetch หน้า official
  2. เช็ค version ล่าสุดจริง — npm view @line/liff version, npm view @capacitor/core version ฯลฯ — อย่าจำเลข
  3. แล้วค่อย implement ตาม API ที่ docs ปัจจุบันบอก

หลักการนี้สำคัญกว่าโค้ดตัวอย่างใดๆ ในไฟล์นี้. ตัวอย่างด้านล่างคือ โครง + จุดพลาด ไม่ใช่โค้ดที่ copy ได้เลย. </core_principle>


<line_mini_app>

📱 LINE MINI App (LIFF SDK)

สองคำที่ต้องแยกให้ออก

  • LINE MINI App channel = channel ชนิดใหม่ (แนะนำให้สร้างแอปใหม่เป็นชนิดนี้) มาแทนวิธีเดิม (LINE Login channel + ผูก LIFF app เอง). 🇹🇭 ไทยสร้างได้แล้วตั้งแต่ มี.ค. 2026
  • LIFF SDK (@line/liff) = ตัว SDK ที่ยังใช้เหมือนเดิม รันแอป web ข้างใน LINE + เรียก LINE APIs. LINE MINI App ก็ยังใช้ LIFF SDK นี้

📚 Pull docs first

  • LINE MINI App overview: developers.line.biz/en/docs/line-mini-app/
  • LIFF API reference: developers.line.biz/en/reference/liff/
  • Release notes (เช็ค version ล่าสุด): developers.line.biz/en/docs/liff/release-notes/
  • Context7: /line/line-developers-docs-source หรือ /websites/developers_line_biz_en_reference_liff

Convert checklist

  • สร้าง LINE MINI App channel ใน LINE Developers Console (region = Thailand)
  • คัดลอก LIFF ID จาก channel → ใส่เป็น env NEXT_PUBLIC_LIFF_ID
  • ติดตั้ง SDK เวอร์ชันล่าสุด: npm install @line/liff (เช็ค version จาก release notes ก่อน)
  • Wrap แอปด้วย provider ที่เรียก liff.init() แล้ว gate การ render จนกว่าจะ resolve
  • Set endpoint URL ใน channel = URL ที่ deploy จริง (ต้อง HTTPS)
  • Adapt UX: safe-area, ปุ่ม action เต็มความกว้าง, ไม่ต้องมีหน้า login แยก (ใช้ LINE profile)
  • Test ใน LINE app จริง + ทดสอบ fallback ตอนเปิดนอก LINE
  • (ถ้าจะ publish เป็น verified) request review — ไทยต้องผ่าน certified provider

Init outline (โครง ไม่ใช่ไฟล์แช่แข็ง)

// lib/liff.ts — ยืนยัน signature ปัจจุบันกับ LIFF API reference ก่อน
import liff from '@line/liff'
export const initLiff = () => liff.init({ liffId: process.env.NEXT_PUBLIC_LIFF_ID! })
// liff.isInClient() / liff.isLoggedIn() / liff.getProfile() / liff.getAccessToken()
// liff.login() / liff.shareTargetPicker() / liff.sendMessages() / liff.closeWindow()

Provider pattern (providers/liff-provider.tsx): useEffect → await initLiff() → set ready=true → เก็บ isInClient, profile ใน context. สำคัญ: อย่า render feature ที่เรียก LIFF API ก่อน ready. รองรับกรณี init fail (เปิดนอก LINE / SDK error) ด้วย UI fallback ไม่ใช่หน้าขาว.

🩹 Common mistakes (เจอบ่อยจริง)

  1. เรียก LIFF API ก่อน liff.init() resolve → error "liff.xxx() was not called". ทุกอย่างต้องรอ init เสร็จก่อน (await/gate render)
  2. ไม่ handle isInClient() → แอปพังตอนเปิดใน browser ธรรมดา. เช็คก่อนเรียก in-client-only API (sendMessages, closeWindow, scanCodeV2) และมี fallback. ถ้าต้องรองรับ login นอก LINE ใช้ withLoginOnExternalBrowser
  3. Endpoint URL / HTTPS — LIFF บังคับ HTTPS; endpoint ใน console ไม่ตรง URL จริง = init fail. localhost ต้อง tunnel (เช่น ngrok) หรือใช้ LIFF Inspector
  4. liff.getProfile() โดยยังไม่ login / ไม่มี scope profile → เช็ค isLoggedIn() + scope ใน channel ก่อน </line_mini_app>

เป้าหมาย: ผู้ใช้ Add to Home Screen ได้ใน ~1 นาที ไม่ต้องลงอะไรจาก store.

📚 Pull docs first

  • Next.js PWA guide: nextjs.org/docs/app/guides/progressive-web-apps
  • Serwist (next-pwa successor): serwist.pages.dev/docs/next/getting-started — เช็ค setup ปัจจุบัน เพราะ config เปลี่ยนบ่อย

Checklist

  • Web app manifest → app/manifest.ts (Next.js Metadata API): name, short_name, start_url, display: "standalone", theme_color, background_color, icons
  • Icons — อย่างน้อย 192×192 + 512×512 (มี maskable ด้วยยิ่งดี). generate จาก source เดียว
  • Service worker — เลือกทางใดทางหนึ่ง:
    • Serwist (@serwist/next) — จัดการ precache manifest + gen public/sw.js ให้ (config swSrc: 'app/sw.ts', swDest: 'public/sw.js' ผ่าน withSerwist ใน next config) — เช็ค getting-started ปัจจุบันก่อน
    • Native — เขียน sw.js เอง (fetch handler + cache) ถ้าอยากคุม 100% ไม่พึ่ง lib
  • Offline พื้นฐาน — cache app shell + offline fallback page; runtime cache สำหรับ API/รูป
  • Install prompt — ดักbeforeinstallprompt (Android/desktop) เก็บ event ไว้ trigger ปุ่ม "ติดตั้ง"; iOS Safari ไม่มี event นี้ → ต้องสอนผู้ใช้ manual (Share → Add to Home Screen)
  • A2HS UX — บอกวิธีเพิ่มลงหน้าจอแบบภาษาคน แยกคำแนะนำ iOS vs Android

🩹 Common mistakes

  1. Service worker ต้อง served จาก origin + HTTPS (localhost ยกเว้นได้). path/scope ผิด = ไม่ลง
  2. Manifest ขาด icon 512 หรือ display:standalone → เบราว์เซอร์ไม่เสนอ install
  3. คาดหวัง iOS มี auto install prompt — ไม่มี ต้อง manual เสมอ
  4. SW cache เก่าค้าง → วาง strategy update (skipWaiting/clientsClaim) + แจ้งผู้ใช้ reload

阅读完整来源 ↗