Agent Skills
返回列表
Neway Commerce 电商脚手架

Neway Commerce 电商脚手架

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_217d8d33/neway-commerce-os。

技能介绍

要解决什么问题

用自然语言描述品牌、品类和调性后,你往往仍要手工搭 React 店铺、对齐路由与状态管理,还要在「能跑 demo」和「能交付构建」之间反复踩坑。Neway Commerce OS 把单次产品 brief 收敛成一套固定交付物:React + Vite 前台、约定好的 7 条路由,以及可切换的 mock/真实支付与 EdgeOne Pages 部署相关文件。

技能如何工作

执行流程是写死的,代理必须按顺序完成:

  1. 语言检测(Convention 0):zh-* 则全站中文 UI,否则英文;商品数据在中文模式下用 name + nameEn 双字段。
  2. 脚手架:从 templates/base/ 复制到 {brand}-store/。
  3. 内容接线:替换 __PLACEHOLDERS__、翻译 UI 文案、写入商品数据、在 tailwind.config.js 里落品牌色。
  4. 规范落地:字体(Noto Sans SC + Playfair Display)、图标仅用 lucide-react(禁止 emoji)、Zustand persist 的 cartStore / wishlistStore、商品详情 /product/:id 必须 useParams 查数、framer-motion 动效、strict TypeScript。
  5. 质量门禁:校验商品图 URL 为 HTTP 200;npm run build 零错误后再 npm run dev 验路由。

默认能力面包括:商品目录与筛选排序的 /shop、购物车侧栏 CartDrawer、三步结算、收藏夹、管理后台、AI 销售助手,以及文档中列出的最低 UX 复杂度(首页分区、双色系 brand + fresh/leaf 调色板等)。

该 Skill 被声明为所有生成店铺的代码规范权威来源,调用方不得跳过其中的硬约束。

适用边界

  • 输出是脚手架 + 约定,交付说明里会区分已搭好的部分与仍需接生产 API/支付/库存的接线。
  • 语言策略以系统 locale 检测为准,不是任意多语言 i18n 框架。
  • 未通过 npm run build 的项目不算可交付物;代理需在交付前修完 TypeScript 与构建错误。

使用场景

  • 客户只提供品牌与品类 brief,你需要在单次代理任务里产出含 `/shop`、购物车侧栏与 `/checkout` 三步流的完整店铺。
  • 本机 locale 为 `zh-CN`,要生成导航、按钮与商品 `name`/`nameEn` 均已本地化的 React + Vite 站点,而非英文模板硬套。
  • 评审或交付前要求零 TypeScript 构建错误,需要按 Skill 流程跑 `npm run build` 并核对 7 条路由均可访问。
  • 计划部署到 EdgeOne Pages,需要脚手架里已带部署相关文件,且 `products.ts` 中图片 URL 全部通过 HTTP 200 校验。

适合人员

  • 接品牌定制单、要在几小时内交出可点击购物流程 demo 的前端外包工程师
  • 用 Cursor 等代理编排 Skill、需要输出统一 lucide-react 与 Zustand 持久化购物车约定的全栈协作者
  • 电商 PM 要在无后端条件下用 mock 支付开关验证结算页与 AI 购物助手入口的交互原型
  • 负责把生成站从 mock 支付切到真实网关、并维护 `tailwind.config.js` 双色系主题的前端负责人