Agent Skills
› ai-shifu/ai-shifu
› next-build-node-runtime
next-build-node-runtime
GitHub用于排查 Next.js 构建时因 Node 版本不兼容导致的语法错误。通过检查运行时版本、对照引擎要求并修复环境，解决 Unexpected token 报错，确保构建顺利进行。
Trigger Scenarios
npm run build 报 SyntaxError Unexpected token '?'
next/dist/compiled 内部文件报语法错误
Install
npx skills add ai-shifu/ai-shifu --skill next-build-node-runtime -g -y
SKILL.md
Frontmatter
{
"name": "next-build-node-runtime",
"description": "当 cook-web 执行 npm run build 出现 SyntaxError Unexpected token '?' 或 next\/dist\/compiled 报错时使用本技能，优先排查 Node 运行时版本不一致问题。"
}
Next Build Node 运行时排障
触发条件
npm run build在next/dist/compiled内部文件报语法错误。- 报错包含
SyntaxError: Unexpected token '?'、Unexpected token '.'等现代语法不兼容信息。 - 构建日志中 Warning 很多，但实际中断点不明确。
工作流
- 在当前目录分别检查运行时版本与路径：
node -v、npm -v、which node、which npm。 - 对照
package.json的engines.node，确认是否匹配。 - 如果 shell 初始化脚本切到了旧 Node，先切到项目要求版本再重新执行
npm run build。 - 构建失败时只抓第一个
Error作为阻断点，不把Warning当作失败原因。 - 若阻断点是 ESLint
Error，做最小改动修复；保留调试日志，不删除console.log。
Version History
- e65aa77 Current 2026-08-20 15:14
