# 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)