技能介绍

解决的问题

在 EdgeOne Pages 上写全栈应用时，平台能力容易被当成普通 Node.js 项目处理：Edge Functions 运行在 V8，不是 Node.js，不能使用 fs、path 等 Node 内置模块；Cloud Functions 又支持 Node.js、Go、Python，入口文件、依赖管理、返回格式和框架适配都不同。该技能用于避免选错运行时、把重计算放进中间件，或把 edgeone pages dev 配置成普通开发脚本导致递归。

技能如何工作

技能先按 Decision Tree 判断任务落在哪类能力，再按 Routing 表加载参考文件：

Edge Functions：轻量 API、边缘计算、KV Storage，适合低延迟请求处理。
Cloud Functions：Node.js 适合 npm、Express/Koa、WebSocket；Go 适合 Gin/Echo 等高吞吐场景；Python 适合 Flask/FastAPI/Django 原型。
Middleware：只做请求拦截、重定向、鉴权、A/B 测试，不放重计算或数据库调用。

实现时会强调正确入口：Node.js 返回标准 Web Response；Go 支持 http.HandlerFunc 或框架模式；Python 通过 handler、Flask、FastAPI app 实例识别入口。本地开发统一使用 edgeone pages dev，执行 CLI 前设置 AI skill 上下文环境变量。

适用边界

该技能只覆盖开发阶段，不负责部署，部署应使用 edgeone-pages-deploy。Next.js、Nuxt 等框架项目应使用框架自带 middleware 或 API 路由，而不是平台 middleware.js。通用 Express、Flask、Cloudflare Workers、Vercel Functions 不在适用范围内。