# Yzy Project Bootstrap

> 初始化有赞云开放工程。用于完成工程获取、登录和选择应用、安装 AI Skills、检查浏览器插件、初始化前端开放 2.0 工程、启动 H5/小程序/商家端 dev，或排查工程首次启动流程。

- Skill: `youzan/yzy-project-bootstrap` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add youzan/yzy-project-bootstrap`
- Raw SKILL.md: https://api.skillmd.com/api/skills/youzan/yzy-project-bootstrap/raw
- Safety review: WARNING
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: youzan (https://skillmd.com/u/youzan)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/youzan/yzy-project-bootstrap

---


# YZY 有赞云工程初始化

## 目标

使用官方 YZY CLI 完成工程获取和本地开发初始化。不要手工拼装应用上下文、复制 Runtime 源码或绕过插件检测。

## 新工程

在计划存放工程的父目录执行：

```bash
npx --yes --registry=http://registry.npm.qima-inc.com @youzan-cloud/cli@beta
```

按终端交互完成登录、团队和应用选择、代码分支选择、保存目录、AI Skills 安装、开发目标初始化与 dev 启动。

不要在初始化完成后重复运行仓库内底层 `yzc` 命令。开发和构建应使用生成仓库根目录 `package.json` 暴露的命令。

CLI 的实际兼容检查是浏览器扩展最低版本的判定源。涉及 H5 或商家端调试时，优先运行上述官方 CLI 流程或 CLI 给出的版本检查；如果 CLI 提示扩展版本过低，以 CLI 报出的最低版本为准，不要只依据 Toolkit 静态清单判断登录、工程或 Runtime 是否兼容。

## 已有工程

1. 先阅读仓库根目录的 `AGENTS.md`、`README.md` 和 `package.json`。
2. 如果仓库已有前端开放 2.0 目录和脚本，直接使用其 `dev:*` 或 `build:*` 命令。
3. 如果缺少前端开放 2.0 结构，重新运行 YZY CLI，让 CLI 完成兼容初始化；不要手工复制模板目录。
4. 如果仅需继续开发，不要重新 clone 或覆盖已有业务代码。

## 制品边界

读取相对本 Skill 的 `../../assets/yzy-release.json` 获取当前发布渠道和安装地址：

- `@youzan-cloud/cli`：工程初始化入口，独立 npm 包。
- `@youzan-cloud/browser-runtime`：仓库根目录开发依赖，由模板或 CLI 安装并锁定具体版本。
- YZY Browser Developer Tool：独立 Chrome 扩展，不把扩展源码复制到业务仓库。
- `cloud-ui-v2`：前端开放 2.0 模板，不作为 Skill 内容分发。

不要把 Runtime 加入 `cloud/client`、`cloud/admin` 等业务子项目依赖。

## 启动与排错

- 插件未安装或版本过低：先执行 CLI 版本检查；确认需要升级后，再使用版本清单中的下载地址安装或更新，并重新运行 CLI。清单里的 `minimumVersion` 只记录发布时已校验门槛，若与 CLI 提示冲突，以 CLI 为准。
- dev 等待应用：优先确认 YZY CLI 是否已经生成应用上下文，不要再次手工选择另一个应用。
- H5、消费者端小程序和商家后台需要并行开发时，使用 CLI 或仓库提供的并行启动流程，不要让多个 Runtime 争用同一固定端口。
- 页面未渲染本地代码：使用 `yzy-browser-debug` 检查 Runtime、页面连接和真实浏览器证据。
- 需要开放能力或 Slot 规则：使用 `yzy-frontend-dev` 并先查询 `yzy-knowledge-search`。

## 安全边界

不得输出或提交登录 Cookie、Authorization、应用密钥、Runtime session token。涉及发布、支付、下单、授权、删除等不可逆操作时，停止自动执行并请求用户明确确认。