Genesis

> 太初有道，道生代码

首要决策：初始化模式

在开始前，必须询问用户选择初始化模式：

| 模式 | 说明 | 适用场景 | | --------------- | ---------------------------------- | ------------------------------ | | A. 模板复制 | 直接复制 templates/ 下的现成项目 | 快速启动、标准项目、不需要定制 | | B. AI 生成 | 根据 references/ 文档从零构建 | 深度定制、学习过程、特殊需求 |

询问话术：

> 请选择初始化模式： > > - A 模板复制：秒级启动，复制现成模板 > - B AI 生成：逐步构建，可深度定制 > > 输入 A 或 B：

决策流程

用户触发 "新建项目"
    ↓
确认项目类型 → Web 前端 / Python 后端 / Go 后端 / Taro 小程序
    ↓
确认项目名称和目标目录
    ↓
询问初始化模式 → A 模板复制 / B AI 生成
    ↓
A: 复制模板 → 改名 → 安装依赖 → 完成
B: 读取 references → 逐步执行 → 完成

前端初始化（React + 设计系统）

触发词：创建 React 项目、新建前端项目、Web 应用、H5 项目

技术栈：React 19 + TypeScript + Vite + TailwindCSS V4 + shadcn/ui

模式 A：模板复制（秒级完成）

直接执行，无需确认：

bash
cp -r ~/.claude/skills/genesis/templates/web-react {目标目录}
cd {目标目录} && sed -i '' 's/"name": "web-react"/"name": "{项目名}"/g' package.json
npm install && npm run dev

模板已包含：Vite + React 19 + TypeScript + TailwindCSS V4 + shadcn/ui + 微拟物光影

模式 B：AI 生成

执行顺序：

1. 读取 web-react.md → 搭建 Vite + React + TypeScript + Tailwind 环境
2. 读取 design-system.md → 集成 shadcn/ui 组件库
3. 读取 design-enhance.md → 应用微拟物光影质感

Python 后端初始化（FastAPI）

触发词：Python 后端、FastAPI、新建 API、初始化 Python 项目、创建 Python 项目

技术栈：FastAPI + UV + SQLModel + AsyncPG

模式 A：模板复制（秒级完成）

直接执行，无需确认：

bash
cp -r ~/.claude/skills/genesis/templates/backend-python {目标目录}
cd {目标目录} && sed -i '' 's/name = "backend-python"/name = "{项目名}"/g' pyproject.toml
uv sync && ./deploy/local-run.sh

模板已包含：FastAPI + UV + SQLModel + AsyncPG + 统一响应格式

模式 B：AI 生成

参考文档：backend-python.md

按文档逐步执行：环境初始化 → 目录结构 → 核心模块 → 路由配置

Taro 小程序初始化（React + Tailwind）

触发词：新建小程序、创建小程序、Taro 项目、小程序开发、跨端小程序

技术栈：Taro 4.x + React 18 + TailwindCSS V4 + weapp-tailwindcss

模式 A：模板复制（秒级完成）

直接执行，无需确认：

bash
cp -r ~/.claude/skills/genesis/templates/miniapp {目标目录}
cd {目标目录}
sed -i '' 's/"name": "mini0app"/"name": "{项目名}"/g' package.json
sed -i '' 's/projectName: '\''mini0app'\''/projectName: '\''${项目名}'\''/g' config/index.js
npm install && npm run dev:weapp

模板已包含：Taro 4.x + React + TailwindCSS V4 + weapp-tailwindcss + tweakcn 主题 + 跨端配置

模式 B：AI 生成

参考文档：taro-miniapp.md

按文档逐步执行：Taro CLI 初始化 → Tailwind 集成 → weapp-tailwindcss 配置 → tweakcn 主题集成 → 多端适配

支持平台：

• 微信小程序 (npm run dev:weapp)
• 支付宝小程序 (npm run dev:alipay)
• 抖音小程序 (npm run dev:tt)
• H5 (npm run dev:h5)

Go 后端初始化（Gin）

触发词：Go 后端、Gin、Go API、初始化 Go 项目、创建 Go 项目

技术栈：Go + Gin + GORM + Viper

模式 A：模板复制（秒级完成）

直接执行，无需确认：

bash
cp -r ~/.claude/skills/genesis/templates/backend-go {目标目录}
cd {目标目录}
# 替换模块名（go.mod + 所有 import）
find . -type f -name "*.go" -exec sed -i '' 's|backend-go|{项目名}|g' {} +
sed -i '' 's|module backend-go|module {项目名}|g' go.mod
go mod tidy && go run cmd/api/main.go

模板已包含：Gin + GORM + Viper + 标准目录结构 + 中间件

模式 B：AI 生成

参考文档：backend-go.md

按文档逐步执行：go mod init → 目录结构 → 核心模块 → 路由配置

动画提升（React 项目）

触发词：动画提升、Apple 动效、添加动画、动效升级

前置条件：已完成前端初始化 + 页面内容搭建

参考文档：design-motion.md

执行内容：

• 为现有 React 项目添加 Framer Motion 动画
• Apple 级 Spring 物理引擎
• 页面路由过渡、组件交互动效

Landing Page 生成（React 项目）

触发词：生成落地页、生成 Landing Page、生成官网首页、生成产品页、做一个落地页

前置条件：已完成前端初始化

参考文档：landing-page.md

执行内容：

• 一次性生成生产级落地页
• 10 个标准 Section 组件
• 遵循设计系统约束
• Framer Motion 入场动画
• 响应式 + 可访问性

通用原则

模式选择建议

| 场景 | 推荐模式 | | ------------------------ | ---------- | | 快速原型、标准项目 | A 模板复制 | | 学习技术栈、理解构建过程 | B AI 生成 | | 需要深度定制、非标准配置 | B AI 生成 | | 团队统一模板、批量创建 | A 模板复制 |

初始化检查清单

• ] 确认项目类型
• ] 确认项目名称（小写+连字符）
• ] 确认目标目录
• ] 确认初始化模式（A/B）
• ] 安装依赖并验证运行

交互规范

1. 必须询问模式：A 模板复制 or B AI 生成
2. 验证运行：确保项目能正常启动
3. 模板自带文档：L1/L2/L3 分形文档已内置于模板中，无需额外构建