メニュー
Translate common Next.js, TypeScript, Supabase, and npm build errors into plain Vietnamese with actionable fix hints. Used by taw-fix and taw-deploy so non-dev users never see raw English error messages.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
Single entrypoint for taw-kit. User types `/taw <anything in VN or EN>` — this skill classifies the intent (BUILD / FIX / SHIP / MAINTAIN / ADVISOR) and loads the matching branch file to execute. Replaces the old one-command-per-task model (/taw-new, /taw-add, /taw-fix, /taw-deploy, /taw-security) with a single unified command. Supports dev workflows out of the box: test, upgrade, clean, perf, rollback, refactor, types, seed, review, stack-swap, status, and ADVISOR group (analyze, suggest, coverage, adversarial, scope-check) for opinionated review of existing code. User-visible strings match the user's input language (Vietnamese by default for VN users). Two modes: SAFE (default — clarify + approval, max 1 round-trip) and YOLO (skip gates, smart defaults — for demos/power users). YOLO triggers: prose contains `yolo`, `nhanh nha`, `lam luon`, `khoi hoi`, `auto`, or args start with `yolo`. Trigger phrases (EN + VN) — broad match so user can keep typing plain prose without re-invoking /taw every turn. Grouped by
Safe dependency upgrade reference: breaking-change notes for common taw-kit deps (Next.js, React, Supabase, Tailwind, TypeScript, shadcn), codemod commands, and a standard safety protocol. Used by branches/maintain/upgrade.md. Trigger phrases (EN + VN): "breaking change", "codemod", "upgrade next", "upgrade react", "nang cap an toan", "cap nhat deps", "migration guide".
taw-kit's unified commit skill: stages files, scans for secrets/env/build-artefact leaks, generates a conventional commit message by READING the actual diff (not guessing), then commits. Two modes: CONTEXT mode (called by taw orchestrator — uses .taw/checkpoint.json phase info, writes strict [P<n>] format) and SMART mode (ad-hoc — infers type+scope+subject from diff content). Replaces the old git-auto-commit + commit-message-smart skills (merged). User never types git commands. Always prefixes output with "taw:" so you know which tool did it.
taw-kit's advanced git skill: create branches, open pull requests with auto-generated body (reads diff + commits + existing PR template), merge (fast-forward only), and recover from common mistakes. Replaces the old git-pro + pr-description skills (merged). Complements taw-commit (single commits) and taw-trace (history lookup). User-visible strings in user's language; raw git/gh commands verbatim so power users can learn. Every output prefixed "taw:" for branding.
Look up taw-kit git history without needing to know git. Find which commit added a feature, changed a file, or ran during which phase. Reads the strict format written by `taw-commit` (type(scope): subject [P<n>]). Every output prefixed "taw:" for branding. Replaces the old git-trace skill (rename only). Trigger phrases (VN + EN): "xem lich su", "ai sua cai nay", "khi nao them", "commit nao lam hong", "tra lai phase", "show git history", "blame".
ast-grep (sg) pattern cookbook for safe structural refactors in TypeScript / TSX projects. Covers rename, extract, find-and-replace with code context. Used by branches/maintain/refactor.md when ast-grep is available. Trigger phrases (EN + VN): "ast-grep", "structural replace", "rename symbol", "codemod tsx", "tim cau truc", "thay the theo pattern".
| name | error-to-vi |
| description | Translate common Next.js, TypeScript, Supabase, and npm build errors into plain Vietnamese with actionable fix hints. Used by taw-fix and taw-deploy so non-dev users never see raw English error messages. |
| argument-hint | [error message text] |
Take raw English error output and return a plain Vietnamese explanation with a simple fix instruction. Non-dev users see "Bi loi X, lam Y de sua" — not a stack trace.
| English error | Vietnamese | Fix hint |
|---|---|---|
Module not found: Can't resolve '...' | "Khong tim thay module [...]. Co the chua cai dat." | npm install <ten-package> |
Type error: Type 'X' is not assignable to type 'Y' | "Loi kieu du lieu: [...] khong phu hop." | "Kiem tra kieu du lieu tai dong loi, sua cho dung kieu." |
Error: NEXT_PUBLIC_ env var is missing | "Thieu bien moi truong [...] trong .env.local" | "Mo .env.local va them bien nay." |
SyntaxError: Unexpected token | "Loi cu phap tai dong [...]. Co the thieu dau ngoac hoac dau phay." | "Kiem tra dong loi, sua dau cu phap." |
Build failed because of webpack errors | "Build bi loi do Webpack. Xem loi cu the ben duoi." | "Doc thong bao loi va sua theo huong dan." |
ENOSPC: no space left on device | "May tinh het dung luong dia." | "Xoa thu muc .next/ va node_modules/, roi chay npm install lai." |
| English error | Vietnamese | Fix hint |
|---|---|---|
Invalid API key | "API key Supabase sai hoac het han." | "Kiem tra NEXT_PUBLIC_SUPABASE_ANON_KEY trong .env.local" |
relation does not exist | "Bang du lieu [...] chua duoc tao." | "Chay migration SQL trong Supabase dashboard." |
new row violates row-level security policy | "Khong co quyen ghi vao bang [...] (RLS)." | "Kiem tra policy RLS trong Supabase dashboard." |
JWT expired | "Phien dang nhap het han." | "Dang xuat va dang nhap lai." |
Email not confirmed | "Email chua duoc xac nhan." | "Kiem tra hop thu va bam vao link xac nhan." |
| English error | Vietnamese | Fix hint |
|---|---|---|
EACCES: permission denied | "Khong co quyen truy cap. Khong dung sudo voi npm." | "Chay: npm config set prefix ~/.npm-global" |
npm ERR! peer dep missing | "Thieu thu vien phu thuoc." | "Chay: npm install --legacy-peer-deps" |
Cannot find module 'next' | "Chua cai Next.js. Chay: npm install" | npm install |
Error: listen EADDRINUSE :::3000 | "Cong 3000 dang duoc su dung boi chuong trinh khac." | "Chay: npx kill-port 3000 roi thu lai." |
| English error | Vietnamese | Fix hint |
|---|---|---|
Build failed | "Build that bai tren Vercel. Kiem tra logs." | "Vao Vercel dashboard > Deployments > xem logs chi tiet." |
Environment variable not found | "Thieu bien moi truong tren Vercel." | "Vao Project Settings > Environment Variables va them bien." |
Function execution timeout | "Ham chay qua lau (>10 giay)." | "Kiem tra cac API route co ket noi database cham khong." |
When an error is encountered:
npm run dev."taw-error.log for debugging