feat: 初始提交

docs/user/usage.md

@@ -0,0 +1,65 @@
+# 使用模板
+
+本文档说明如何使用本模板创建新项目。
+
+## 1. 克隆模板
+
+```bash
+git clone <template-repo-url> my-project
+cd my-project
+rm -rf .git && git init
+```
+
+## 2. 配置应用信息
+
+编辑 `src/shared/app.ts`，修改应用元信息：
+
+```typescript
+export const APP = {
+  name: "your-app", // 机器标识（kebab-case）
+  title: "Your App", // 人类可读标题
+  subtitle: "你的副标题", // 副标题
+  description: "应用描述", // SEO meta 描述
+} as const;
+```
+
+同时修改 `package.json` 的 `name` 字段保持一致，`version` 字段管理应用版本号。
+
+## 3. 准备配置文件
+
+```bash
+cp config.example.yaml config.yaml
+```
+
+按需编辑 `config.yaml` 中的监听地址、日志、存储路径等配置。配置文件为启动时的必传参数。
+
+## 4. 清理 OpenSpec 历史
+
+删除模板自带的 OpenSpec 变更历史，保留框架配置：
+
+```bash
+rm -rf openspec/specs/*
+rm -rf openspec/changes/*
+```
+
+`openspec/config.yaml` 和 `openspec/schemas/fast-drive/` 需要保留，其中包含项目开发规范配置与自定义 OpenSpec workflow schema。
+
+## 5. 安装依赖
+
+```bash
+bun install
+```
+
+## 6. 开始开发
+
+```bash
+bun run dev config.yaml
+```
+
+访问 http://127.0.0.1:5173 查看应用。
+
+## 下一步
+
+- [配置文件](config.md) — 了解 YAML 结构、变量语法和配置字段
+- [部署文档](deploy.md) — 生产构建和运行方式
+- [开发文档](../development/README.md) — 开发规范、架构和质量门禁