70 lines
2.5 KiB
Markdown
70 lines
2.5 KiB
Markdown
|
# CF Workers 快速原型模板
|
|||
|
|
|
|||
|
|
`Cloudflare Workers` `Hono` `D1` `React` `模板脚手架`
|
|||
|
|
|
|||
|
|
# Growth Boilerplate
|
|||
|
|
|
|||
|
|
基于 Cloudflare Workers 的快速原型开发脚手架，集成 Hono、D1 和可移植知识库。
|
|||
|
|
|
|||
|
|
## 快速开始
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npx skills add aem-growth-adoption/team-boilerplate --agent claude-code --global -y
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
然后在任意目录运行 `claude /setup`（或让你常用的 AI 编程工具执行 `/setup`）。它会自动从模板创建新仓库、完成定制化配置、安装依赖并配置 D1。
|
|||
|
|
|
|||
|
|
## 包含内容
|
|||
|
|
|
|||
|
|
- **Hono** Worker，集成 Cloudflare Zero Trust 身份认证
|
|||
|
|
- **D1** 数据库，含通用 KV 存储
|
|||
|
|
- **React + Adobe React Spectrum** 前端
|
|||
|
|
- **Vite** 开发服务器，监听端口 3000
|
|||
|
|
- **知识库** — 可移植的 Markdown 文档，任何 AI 工具均可读取
|
|||
|
|
|
|||
|
|
## 技术栈
|
|||
|
|
|
|||
|
|
| 层级 | 技术 |
|
|||
|
|
|-------|------|
|
|||
|
|
| 运行时 | Cloudflare Workers |
|
|||
|
|
| 路由 | Hono |
|
|||
|
|
| 认证 | Cloudflare Zero Trust（JWT） |
|
|||
|
|
| 数据库 | Cloudflare D1（SQLite） |
|
|||
|
|
| 前端 | React + Adobe React Spectrum |
|
|||
|
|
| 构建 | Vite + @cloudflare/vite-plugin |
|
|||
|
|
|
|||
|
|
## 项目结构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
├── .claude/skills/setup/SKILL.md # /setup 技能
|
|||
|
|
├── knowledge-base/ # 团队规范（可移植 Markdown）
|
|||
|
|
├── worker/
|
|||
|
|
│ ├── index.js # Hono 应用入口
|
|||
|
|
│ ├── auth.js # Cloudflare Zero Trust 认证中间件
|
|||
|
|
│ └── db.js # D1 工具函数（KV）
|
|||
|
|
├── migrations/0001_init.sql # KV 数据表
|
|||
|
|
├── index.html # 前端 HTML 壳
|
|||
|
|
├── app.jsx # React 应用组件
|
|||
|
|
├── vite.config.js # Vite + Cloudflare 插件配置
|
|||
|
|
├── CLAUDE.md # AI 工具上下文（指向 knowledge-base/）
|
|||
|
|
└── AGENTS.md # 同上，供 Codex/Cursor 等工具使用
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 开发命令
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
npm run dev # 启动开发服务器（端口 3000）
|
|||
|
|
npm run build # 生产环境构建
|
|||
|
|
npm run deploy # 构建并部署到 Cloudflare Workers
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 知识库
|
|||
|
|
|
|||
|
|
`knowledge-base/` 目录为纯 Markdown 格式，可被任何 AI 工具、IDE 或人类直接阅读，涵盖以下内容：
|
|||
|
|
|
|||
|
|
- [Cloudflare Workers 模式](knowledge-base/cloudflare-workers.md)
|
|||
|
|
- [Hono 模式](knowledge-base/hono-patterns.md)
|
|||
|
|
- [D1 模式](knowledge-base/d1-patterns.md)
|
|||
|
|
- [AI 开发规范](knowledge-base/ai-development.md)
|
|||
|
|
- [实验生命周期](knowledge-base/experiment-lifecycle.md)
|
|||
|
|
- [上线检查清单](knowledge-base/go-live-checklist.md)
|