用途:该技能用于在 Next.js/Supabase 应用中按既有约定创建类型安全的 Server Actions,生成 schema、service、action 三层文件,避免绕过鉴权、缺少校验、业务逻辑混入 action 等常见问题。
主要能力:生成 Zod 校验 schema;生成不直接导入数据库客户端、通过依赖注入接收 client 的 service 层;生成薄适配层 server action,包含手动鉴权(getSession)、结构化日志、调用 service、revalidatePath 重新验证。附带故障排查说明,如缺少 'use server' 指令、barrel 文件重复导出导致 Server Action 识别失败、mutation 后 UI 数据陈旧等。
使用方式:按工作流分三步——先在 _lib/schema/ 建 schema,再在 _lib/server/ 建 service,最后在 _lib/server/server-actions.ts 写以 'use server' 开头的 action。文件结构为 feature/_lib/schema、feature/_lib/server、feature/_components。示例中的 createFeatureAction 接收 CreateFeatureSchema 推断的输入类型,先 getSession,再 parse,再记日志、创建 client、调用 service、记日志并 revalidatePath。
适用场景:Next.js + Supabase 项目,需要统一 server action、校验、鉴权、日志、缓存刷新与服务层复用(server action、MCP 工具、CLI、单测共用同一 service)。
限制:资料未提供该技能的具体安装命令、运行环境要求、收费与价格、平台支持、性能效果等信息,暂未提供。内容以代码约定与模式说明为主,未提供量化验证结果。