create-dwy 0.8.0 → 0.9.0

package/templates/claude-global/skills/dwy-fullstack-scaffold/SKILL.md

@@ -1,214 +1,202 @@
 ---
 name: dwy-fullstack-scaffold
-description: "按 quant-cloud monorepo 架构生成 Web 全栈项目骨架。触发条件：用户说'创建新项目'、'搭骨架'、'新建全栈项目'、'按 quant-cloud 架构创建'、'全栈脚手架'、'scaffold'、'新项目按这个架构'、'开新项目'时。"
+description: "调用 dwy create CLI 生成全栈 Vue 3 + FastAPI monorepo 骨架，并完成 post-create 安装 + health check 编排。触发条件：用户说'创建新项目'、'搭骨架'、'新建全栈项目'、'fullstack monorepo'、'全栈脚手架'、'scaffold'、'开新项目'时。"
 ---
 
 # dwy-fullstack-scaffold
 
-按照 quant-cloud(/Users/chances/WebstormProjects/ai-quant/quant-cloud/) 的 monorepo 架构生成全栈项目骨架。
+调用 `dwy create` CLI 选 `fullstack-monorepo` 模板生成全栈 monorepo 骨架，然后用 Bash 编排 post-action（依赖安装 + health check）。
 
 ## 触发后该做什么(决策树)
 
 ```
 用户说 "创建新项目 xxx" / "搭骨架"
     ↓
-1. 用 AskUserQuestion 收集 5 个关键参数:
-   - project_name (kebab-case, 用作目录名 + Docker 服务名)
-   - target_dir (默认 /Users/chances/WebstormProjects/<project_name>)
-   - scope_prefix (业务包前缀, 默认 'app', 也可填 'quant' / 'foo' 等)
-   - initial_domain (示例业务域, 默认 'core', 用户可填 'order' / 'user' 等)
-   - include_frontend (默认 true; false 则只生成 backend + 根级)
+1. 用 AskUserQuestion 收集 5 个关键参数（如用户已说明部分，直接用，缺什么问什么）:
+   - project_name (kebab-case, 用作目录名 + Docker DB 名)
+   - target_parent_dir (默认 /Users/chances/WebstormProjects)
+   - scope_prefix (业务包前缀, 默认 'app')
+   - initial_domain (示例业务域, 默认 'core')
+   - include_frontend (默认 true)
+   - port_prefix (端口前缀数字, 1-9, 默认 '2')
     ↓
-2. 检查 target_dir 不存在或为空。如已存在且非空, AskUserQuestion 确认是否清理。
+2. 检查 <target_parent_dir>/<project_name> 不存在或为空。已存在且非空 → AskUserQuestion 确认是否清理。
     ↓
-3. 调用 scripts/scaffold.py 生成全部文件:
-     uv run python /Users/chances/.claude/skills/dwy-fullstack-scaffold/scripts/scaffold.py \
-       --project-name <name> \
-       --target-dir <dir> \
-       --scope-prefix <prefix> \
-       --initial-domain <domain> \
-       --include-frontend <true|false>
+3. 调用 dwy create（在 target_parent_dir 下执行）:
+     cd <target_parent_dir>
+     dwy create <project_name>
+   交互时回答:
+     - 项目模板: fullstack-monorepo
+     - 业务包前缀: <scope_prefix>
+     - 初始业务域: <initial_domain>
+     - 是否生成 frontend: <include_frontend>
+     - 端口前缀数字: <port_prefix>
+
+   或者用环境变量 / 配置非交互模式（如果 dwy CLI 支持）。当前最稳的做法是用 expect 模拟交互，或者让用户自己跑 dwy create，本 skill 负责后续编排。
+
+   **推荐做法**：让用户在终端跑 `dwy create <project_name>` 自己回答交互（每次脚手架问题需要人 review），然后 skill 介入做 post-action。
     ↓
-4. 生成完成后自动执行(脚本内做):
-   - cd <target_dir>/backend && uv sync --dev
-   - cd <target_dir>/frontend && pnpm install (如开 frontend)
+4. 安装依赖（在 <target_parent_dir>/<project_name> 下）:
+   - cp .env.example .env (如未存在)
+   - cd backend && uv sync --dev
+   - cd frontend && pnpm install (仅当 include_frontend=true)
     ↓
-5. Health check (脚本内做, 临时端口避免冲突):
-   - 启 backend: uv run uvicorn app.main:app --port <free_port_be>
-   - curl http://127.0.0.1:<free_port_be>/api/health 期望 {"status":"ok"}
-   - 启 frontend: pnpm --filter web dev --port <free_port_fe>
-   - curl http://127.0.0.1:<free_port_fe>/ 期望 200
-   - 全部 kill 干净
+5. Health check（用临时端口避免冲突）:
+   - free_port_be=$(python3 -c "import socket;s=socket.socket();s.bind(('',0));print(s.getsockname()[1])")
+   - 临时启 backend: uv run uvicorn app.main:app --port $free_port_be &
+   - 等 1-3 秒，curl http://127.0.0.1:$free_port_be/api/health 期望 {"status":"ok",...}
+   - kill backend 进程
+   - 如 include_frontend=true:
+     - free_port_fe=$(...)
+     - pnpm --filter @<project_name>/web dev --port $free_port_fe &
+     - 等 3-5 秒，curl http://127.0.0.1:$free_port_fe/ 期望 200
+     - kill frontend 进程
     ↓
 6. 报告结果 + 下一步指引
 ```
 
 ## 生成的目录结构
 
+`dwy create` 选 `fullstack-monorepo` 模板会生成：
+
 ```
 <project_name>/
-├── CLAUDE.md                        # 项目级总入口(融入 quant-cloud 关键约束)
-├── dev.sh                           # 一键启动: 杀端口 + Docker + backend + frontend
-├── docker-compose.dev.yml           # PG + Redis 基础设施(端口前缀 2xxxx 避冲突)
-├── docker-compose.prod.yml          # 生产:三服务硬资源限制 + Redis 双持久化 + 日志轮转
-├── deploy/                          # 部署脚本占位
-├── docs/                            # 设计文档占位
+├── CLAUDE.md                            # 项目级总入口
+├── dev.sh                               # 一键启动: 杀端口 + Docker + backend + frontend
+├── docker-compose.dev.yml               # PG + Redis（端口前缀 <port_prefix>xxxx）
 ├── .env.example
 ├── .gitignore
 ├── backend/
-│   ├── CLAUDE.md                    # 后端约束(分层/Provider/异常/eapi 优先使用等)
-│   ├── pyproject.toml               # 单一版本中心 + uv workspace + 双 index(aliyun + pypi)
+│   ├── CLAUDE.md                        # 后端约束（域分包 / Provider / dwyeapi 优先）
+│   ├── pyproject.toml                   # uv workspace + 双 index + 版本中心
 │   ├── Dockerfile.dev
-│   ├── alembic.ini                  # 数据库迁移
-│   ├── alembic/env.py
-│   ├── src/app/                     # 装配层
-│   │   ├── __init__.py              # __version__
-│   │   ├── main.py                  # FastAPI lifespan + 装载 packages
-│   │   ├── config.py                # eapi BaseSettings 嵌套分组
+│   ├── alembic.ini + alembic/env.py
+│   ├── src/app/                         # 装配层
+│   │   ├── main.py                      # FastAPI lifespan + register 业务包
+│   │   ├── config.py                    # Settings 嵌套配置
+│   │   ├── factories.py                 # Provider 工厂占位
 │   │   ├── exceptions.py
-│   │   ├── factories.py             # Provider 工厂(配置驱动切换实现)
-│   │   ├── middleware/__init__.py
-│   │   └── infra/__init__.py
+│   │   ├── middleware/  infra/
 │   ├── packages/
-│   │   ├── dwy-shared/              # 跨项目可复用 kernel
-│   │   │   ├── pyproject.toml
-│   │   │   └── src/dwy_shared/__init__.py
+│   │   ├── dwy-shared/                  # 跨项目通用 kernel
 │   │   └── <scope_prefix>-<initial_domain>/   # 业务包雏形
-│   │       ├── pyproject.toml
-│   │       └── src/<scope_prefix>_<initial_domain>/
-│   │           ├── __init__.py      # register(app) 装载入口
-│   │           ├── router.py        # /api/health endpoint
+│   │       └── src/<scope>_<domain>/
+│   │           ├── __init__.py          # register(app, *, config) 装载入口
+│   │           ├── config.py            # DomainConfig
+│   │           ├── router.py            # /api/<domain>/health endpoint
 │   │           ├── service.py
 │   │           ├── schemas.py
 │   │           ├── models.py
-│   │           └── protocols.py     # Provider 协议定义
-│   └── tests/
-│       └── conftest.py
-└── frontend/
-    ├── CLAUDE.md                    # 前端约束(eui 优先 / pnpm catalog / features 域分包)
+│   │           └── protocols.py
+│   └── tests/conftest.py
+└── frontend/                            # 仅当 include_frontend=true
+    ├── CLAUDE.md                        # 前端约束（eui 优先 / catalog / features 域分包）
     ├── package.json
-    ├── pnpm-workspace.yaml          # catalog: 第三方依赖版本统一管理
+    ├── pnpm-workspace.yaml              # catalog 统一版本
     ├── tsconfig.base.json
-    ├── Dockerfile
-    ├── apps/
-    │   └── web/
-    │       ├── package.json
-    │       ├── vite.config.ts
-    │       ├── tsconfig.json
-    │       ├── index.html
-    │       └── src/
-    │           ├── main.ts
-    │           ├── App.vue          # 起始页含 "Welcome <project_name>" + /api/health 探活
-    │           ├── index.css
-    │           ├── api/client.ts
-    │           ├── router/index.ts
-    │           ├── stores/.gitkeep
-    │           ├── types/.gitkeep
-    │           └── features/<initial_domain>/.gitkeep
+    ├── Dockerfile + nginx.conf
+    ├── apps/web/
+    │   ├── vite.config.ts               # 端口前缀 + /api proxy
+    │   └── src/{main.ts, App.vue, router, api, views, features/, stores/, types/}
     └── packages/
-        ├── core/                    # 横切核心(如全局 logger / 类型)
-        │   ├── package.json
-        │   └── src/index.ts
-        ├── ui/                      # 共享 UI 组件包(可选挂载 @dwydev/eui 默认)
-        │   ├── package.json
-        │   └── src/index.ts
-        └── features/
-            └── <initial_domain>/
-                ├── package.json
-                └── src/index.ts
+        ├── core/                         # 横切核心
+        ├── ui/                           # 项目级共享 UI（基于 @dwydev/eui）
+        └── features/<initial_domain>/    # 业务功能包雏形（导出 createFeatureRoutes()）
 ```
 
-## 关键模式(由模板严格保留)
+## 关键模式
 
-参考 references/architecture.md 的详细说明。要点:
+详细参考生成的项目内 `CLAUDE.md`。要点：
 
-1. **单一版本中心**:backend `pyproject.toml` 集中管理所有外部依赖版本号; frontend `pnpm-workspace.yaml` 的 catalog 集中管理 npm 依赖版本。子包 pyproject/package.json 只写包名,不写版本。
-2. **装配层**:`backend/src/app/main.py` 只做"装配",装载 `packages/` 内 `register(app)` 函数。业务逻辑严禁出现在装配层。
-3. **域分包**:每个业务 package 内按域(domain)子目录,域内再分 router/service/schemas/models/protocols 五件套。
-4. **Provider 模式**:外部服务(数据库 / Redis / SMS / OSS / 第三方 API) 抽象为 Protocol; `factories.py` 按 settings 选具体实现。改实现不改业务代码。
-5. **dwy- vs 业务-前缀**:`packages/dwy-*` 是跨项目可复用 kernel; `packages/<scope>-*` 是项目业务专属。
-6. **dwyeapi 优先**:后端基础设施(配置 / 异常 / 健康检查 / 缓存 / 任务)先用 dwyeapi,不重复实现。
-7. **端口前缀隔离**:每个项目用 1xxxx / 2xxxx / 3xxxx 万位前缀,避免与其他项目冲突。Skill 默认用 2xxxx。
-8. **eui / ekit 默认**:前端 catalog 默认含 `@dwydev/eui` + `@dwydev/ekit`(项目可去掉)。
+1. **单一版本中心**：backend `pyproject.toml` 集中管理外部依赖版本；frontend `pnpm-workspace.yaml` 的 `catalog:` 集中管理 npm 依赖版本
+2. **装配层只装配**：业务逻辑在 `packages/<scope>-<domain>/`，不在 `src/app/`
+3. **域分包**：每业务包五件套 router/service/schemas/models/protocols + 一个 config
+4. **Provider 模式**：外部服务抽象为 Protocol，`factories.py` 选实现
+5. **dwy- vs 业务-前缀**：`packages/dwy-*` 跨项目；`packages/<scope>-*` 项目专属
+6. **dwyeapi 优先**：后端基础设施先用 dwyeapi
+7. **端口前缀**：`<port_prefix>xxxx`，默认 2（28001/25173/25432/26379）
+8. **eui / ekit 默认**：前端 catalog 默认含 `@dwydev/eui` + `@dwydev/ekit`
 
-## 用户参数收集
+## 用户参数收集（必做）
 
-调用脚本前 **必须** 用 AskUserQuestion 收集 5 个参数。提供合理默认值:
+调用 `dwy create` 前 **必须** 用 AskUserQuestion 收集 5 个参数（用户已明确给出的省去）：
 
 | 参数 | 含义 | 默认 | 示例 |
 |------|------|------|------|
-| project_name | kebab-case 项目名 | (无默认,必问) | `my-app` / `quant-admin` |
-| target_dir | 目标父目录 | `/Users/chances/WebstormProjects/<project_name>` | 同上 |
+| project_name | kebab-case 项目名 | (无默认,必问) | `my-app` |
 | scope_prefix | 业务包前缀 | `app` | `quant`, `foo` |
-| initial_domain | 初始示例业务域 | `core` | `order`, `user`, `factor` |
+| initial_domain | 初始示例业务域 | `core` | `order`, `user` |
 | include_frontend | 是否生成 frontend | `true` | `true` / `false` |
+| port_prefix | 端口万位前缀 (1-9) | `2` | `2`, `3` |
 
-**target_dir 检查**:已存在且非空 → 用 AskUserQuestion 让用户确认"清理后重建"或"换个目录"或"放弃"。
+**目录检查**：`<target_parent_dir>/<project_name>` 已存在且非空 → AskUserQuestion 让用户确认"清理后重建"或"换个目录"或"放弃"。
 
 ## 不要做的事
 
-- **不要**改 `templates/` 里的内容(那是 skill 资产,改了影响后续生成)。如要扩展架构,在 SKILL.md 添加描述、补充模板文件,不要 in-place 修改。
-- **不要**生成业务代码(订单、用户管理等)。skill 只产出"骨架 + 1 个示意 endpoint"。业务代码由 AI 后续按 CLAUDE.md 引导补。
-- **不要**跳过 health check。生成完成必须验证 backend `/api/health` + frontend 首页 200。失败要报告原因,不能假装成功。
-- **不要**生成 `.git/`(让用户自己 `git init`)。
-- **不要**安装 `@dwydev/eui` 之外的额外 UI 库(如 Element Plus / Ant Design Vue)。
+- **不要**直接写脚本生成模板。模板由 `dwy create` 渲染，本 skill 只负责参数收集 + post-action 编排
+- **不要**修改生成的项目骨架（除非用户要求扩展业务）。生成完后的业务代码由 AI 后续按生成项目里的 `CLAUDE.md` 引导补
+- **不要**跳过 health check。失败要报告原因，不能假装成功
+- **不要**生成 `.git/`（让用户自己 `git init`）
+- **不要**在生成后强行 `git init && commit`（让用户决策）
+- **不要**安装 `@dwydev/eui` 之外的额外 UI 库
 
 ## 生成完成后的报告模板
 
 ```markdown
 ✅ 项目 <project_name> 骨架已生成
 
-📁 路径: <target_dir>
+📁 路径: /Users/chances/WebstormProjects/<project_name>
 
 📦 已安装依赖:
   - backend (uv sync --dev): <duration> s
-  - frontend (pnpm install): <duration> s   [仅当 include_frontend=true]
+  - frontend (pnpm install): <duration> s    [仅当 include_frontend=true]
 
 ✅ Health check:
-  - GET http://127.0.0.1:<be_port>/api/health → 200 {"status":"ok"}
-  - GET http://127.0.0.1:<fe_port>/ → 200          [仅当 include_frontend=true]
+  - GET http://127.0.0.1:<free_port_be>/api/health → 200 {"status":"ok",...}
+  - GET http://127.0.0.1:<free_port_fe>/ → 200           [仅当 include_frontend=true]
 
 🚀 下一步:
-  cd <target_dir>
+  cd /Users/chances/WebstormProjects/<project_name>
+  cp .env.example .env  # 修改 DATABASE_URL / SECRET_KEY 等
   ./dev.sh
 
 🛠 业务开发起点:
   - backend: backend/src/app/main.py 装载 packages/<scope>-<domain>/
-    -> 加新业务: 复制 <scope>-<domain>/ 整个目录,改名后在 main.py 装载
-  - frontend: frontend/apps/web/src/features/<domain>/ + packages/features/<domain>/
-    -> 加新功能: 在 features/ 下加目录,在 router/index.ts 注册路由
+    → 加新业务: 复制 packages/<scope>-<domain>/ 整体改名 + 在 main.py 装载
+  - frontend: frontend/packages/features/<domain>/ + frontend/apps/web/src/features/<domain>/
+    → 加新功能: 在 features/ 下加目录，在 router/index.ts 注册路由
 
 📋 待办(skill 没替你做):
-  - git init && git add . && git commit -m "chore: initial scaffold from dwy-fullstack-scaffold"
+  - cd /Users/chances/WebstormProjects/<project_name> && git init && git add . && git commit -m "chore: initial scaffold"
   - 在 .env 中填真实 DATABASE_URL / REDIS_URL / SECRET_KEY (默认值仅适合本地)
-  - 按需调整 packages/dwy-shared/ 的依赖范围
-  - 按需启用 alembic: cd backend && uv run alembic init -t async alembic (skill 已留 alembic.ini, env.py 雏形)
+  - 按需 alembic init: cd backend && uv run alembic upgrade head
 ```
 
 ## 失败排错
 
-生成或 health check 失败时,先看脚本输出最后 50 行(脚本会打印每一步的命令 + stderr)。常见失败:
-
 | 症状 | 原因 | 解决 |
 |------|------|------|
-| `uv sync` 报 dwyeapi 找不到 | 默认 aliyun 镜像可能没同步 | pyproject 里 dwyeapi 已声明 `index = "pypi-org"`,确保 uv >=0.4 |
-| `pnpm install` 报 catalog 找不到 | pnpm <8.x 不支持 catalog | 升 pnpm: `npm i -g pnpm@latest` |
-| backend health check 端口冲突 | 别的进程占了 28001 | 脚本会自动找 free port,不应发生; 看脚本日志 |
-| `vite` 启不来 | apps/web 缺 `@vitejs/plugin-vue` | catalog 已含,确认 pnpm install 没出错 |
-| `register()` 找不到 | scope_prefix 含特殊字符 | 用 lowercase + 字母数字下划线,kebab-case |
+| `dwy create` 命令找不到 | create-dwy 未安装或不在 PATH | `pnpm i -g create-dwy` 或在 dwy-shared 仓库 `pnpm link --global` |
+| `dwy create` 报模板找不到 | Gitee 缓存过期或 dwy-shared 未推送最新版 | 删 `~/.dwy/cache/` 重试，确认 Gitee 上 dwy-shared 含 `fullstack-monorepo` 模板 |
+| `uv sync` 报 dwyeapi 找不到 | aliyun 镜像未同步 | pyproject 已声明 pypi-org 备 index，确保 uv >=0.4 |
+| `pnpm install` 报 catalog 找不到 | pnpm <10 不支持 catalog | 升级: `npm i -g pnpm@latest` |
+| backend health check 失败 | DATABASE_URL/SECRET_KEY 用了占位值导致启动报错 | 检查 .env 是否已 cp 自 .env.example；查 uvicorn stderr 输出 |
+| frontend health check 失败 | catalog 版本未对齐或 EUI peerDep 缺失 | 看 pnpm install 输出错误，按 catalog 加缺失版本 |
+| `register()` 找不到 | scope_prefix 含特殊字符 | scope_prefix 只允许小写字母开头 + 字母数字 |
 
 ## 后续扩展
 
-加新业务 package(例如订单系统 `quant-order`):
+**加新后端业务包**（如 `app-order`）:
 
-1. 复制 `backend/packages/<scope>-<initial_domain>/` 整体到 `<scope>-<new_domain>/`
+1. 复制 `backend/packages/<scope_prefix>-<initial_domain>/` 整体改名 `app-order/`
 2. 改 `pyproject.toml` 的 `name` 字段
-3. 改 `src/<scope>_<new_domain>/__init__.py` 的 `register()` 函数名(可选,主要是 import 路径)
-4. 改 `src/app/main.py` 加 `from <scope>_<new_domain> import register as register_<new_domain>`
-5. lifespan 里调 `register_<new_domain>(app)`
+3. 改 `src/app_order/__init__.py` 的导入路径
+4. 改 `src/app/main.py` 加 `from app_order import register as register_order; register_order(app, config=settings.order)`
+5. 在 `src/app/config.py` 加 `order: DomainConfig` 字段
 
-加新前端 feature:
+**加新前端 feature**（如 `order`）:
 
-1. 在 `frontend/packages/features/` 复制示例 feature 整体改名
-2. 在 `frontend/apps/web/src/features/` 加同名目录(页面层)
-3. `apps/web/src/router/index.ts` 注册路由
+1. 复制 `frontend/packages/features/<initial_domain>/` 改名 `frontend/packages/features/order/`
+2. 在 `frontend/apps/web/src/router/index.ts` 加 `import { createFeatureRoutes as createOrderRoutes } from '@<project_name>/features-order'` 并装载
+3. 在 `frontend/tsconfig.base.json` 加路径别名 `@<project_name>/features-order`
+4. 在 `frontend/apps/web/package.json` 加 workspace 依赖 `@<project_name>/features-order: workspace:*`

package/templates/claude-global/skills/dwy-git-commit/SKILL.md

@@ -0,0 +1,125 @@
+---
+name: dwy-git-commit
+description: "Git commit 强制规范（敏感数据扫描 + message 格式 + 禁 AI 署名）。触发场景：用户说'提交' / 'commit' / 'git commit' / 'git add'；AI 准备执行 `git add` / `git commit` 之前；用户让你帮忙写 commit message；review 已有 commit message。强制：先扫描暂存物是否含 .env / 密钥 / API Key / 连接串等敏感数据；再检查 CLAUDE.md 的 Git Commit Scope 段；subject 用中文动宾短语 ≤72 字符；message 任何位置禁止 Claude / GPT / Copilot / AI / LLM 字样及 Co-Authored-By trailer。"
+---
+
+# Git Commit 强制规范
+
+每次 `git add` / `git commit` 前按顺序执行以下检查，任一步未通过 → **STOP，不得提交**。
+
+## Step 0: 敏感数据扫描
+
+`git diff --cached` + `git diff --cached --name-only` 同时扫文件名和内容。
+
+### 禁止提交的文件
+
+| 类型 | 示例 |
+|---|---|
+| 环境变量 | `.env`, `.env.*`, `*.env` |
+| SSH 密钥 | `id_rsa`, `id_ed25519`, `*.pem`, `*.key` |
+| 证书 | `*.p12`, `*.pfx`, `*.jks`, `*.keystore` |
+| 数据库 | `*.sql`（含真实数据）、`*.dump`, `*.sqlite` |
+| 原始数据 | `*.xlsx`, `*.csv`（含用户/学生等敏感数据） |
+| 日志 | `*.log` |
+| Docker 卷 | `pgdata/`, `cache/*.json` |
+
+### 禁止出现的敏感内容
+
+**总则**：代码、文档、规则文件、注释里禁止出现真实的 API Key / Token / 密码 / IP / 凭证，即使作为"示例"也不行。GitHub Secret Scanning 不区分上下文，真实格式的 key 写在文档里也会触发泄露告警。示例必须用明显假值（`sk-xxxxxxxxxxxx`、`your-key-here`、`192.168.x.x`）。
+
+| 类型 | 匹配模式 |
+|---|---|
+| API Key | `sk-[a-zA-Z0-9]{20,}` |
+| AWS Key | `AKIA[0-9A-Z]{16}` |
+| GitHub Token | `ghp_[a-zA-Z0-9]{36}` |
+| 密码赋值 | `password\s*[:=]\s*["'][^"']{4,}` |
+| 数据库连接串 | `://\w+:[^@\s]+@`（含密码） |
+| 私钥内容 | `-----BEGIN (RSA \|EC )?PRIVATE KEY-----` |
+| Token 赋值 | `token\s*[:=]\s*["'][a-zA-Z0-9_\-]{20,}` |
+| Secret 赋值 | `secret\s*[:=]\s*["'][^"']{8,}` |
+| 服务器 IP+端口 | `\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}:\d+` |
+| SSH 连接 | `ssh\s+.*@\d{1,3}\.\d{1,3}` |
+
+**例外（不算违规）**：`.env.example` 占位符；从环境变量读取（`os.getenv("API_KEY")`）；`localhost` / `127.0.0.1` 的连接串；文档假数据；配置文件空字符串默认值。
+
+### 违规处理
+
+1. **立即停止** `git add` / `git commit`
+2. **列出违规项**：文件 + 行号 + 匹配的敏感模式 + 脱敏摘要（如 `sk-5522****dc3`）
+3. **建议修复**：加入 `.gitignore` / 移到 `.env` / 改用环境变量 / 替换为占位符
+4. **等用户明确确认**后才能继续；确认强制提交时，commit body 附 `GIT-SECURITY: 用户已确认提交此内容`
+
+## Step 1: 分析变更
+
+`git diff --cached` 回答：这次改做了几件事？涉及哪些模块？
+
+**做了多件事（无法用 ≤72 字符 subject 清晰描述）→ 必须拆成多个 commit。**
+
+## Step 2: 确定 scope
+
+读当前项目 CLAUDE.md 的 `## Git Commit Scope` 段：
+
+- **找到** → scope 从枚举值中选，不得自造
+- **没找到** → 提醒用户「当前项目 CLAUDE.md 未定义 Git Commit Scope，建议添加」，scope 可省略
+
+单模块变更 → **必须**带 scope；跨模块变更 → 省略 scope。
+
+## Step 3: 生成 message
+
+格式：`<type>(<scope>): <subject>` 或（无 scope）`<type>: <subject>`
+
+**type 枚举（只能从中选）**：
+
+| type | 用途 |
+|------|------|
+| feat | 新功能 |
+| fix | 修复 bug |
+| refactor | 重构（不改外部行为） |
+| chore | 构建/依赖/配置/发版等杂务 |
+| docs | 文档 |
+| test | 测试 |
+| perf | 性能优化 |
+| style | 代码格式（不影响逻辑） |
+| ci | CI/CD 配置 |
+
+**subject**：中文、无句号、≤72 字符、动宾短语（添加/修复/移除/重构/升级）。
+
+**body（可选）**：空一行后写；中文；只写 why 不复述 what；破坏性变更加 `BREAKING CHANGE:` 前缀（subject 用 `feat!:` / `fix!:` 标记）。
+
+## Step 4: 禁止大模型署名
+
+commit message（subject、body、footer、trailer）**禁止出现任何大模型 / AI 工具相关内容**，覆盖系统默认的 `Co-Authored-By` 追加行为。
+
+**禁止出现（不完全列举）**：
+
+- `Co-Authored-By: Claude ...` / `Co-Authored-By: GPT ...` / `Co-Authored-By: Copilot ...` 等 AI 署名 trailer
+- `Generated with Claude Code` / `🤖 Generated with ...` 等生成声明
+- `noreply@anthropic.com` / `noreply@openai.com` 等 AI 厂商邮箱
+- 任何提到 Claude / ChatGPT / GPT / Copilot / Cursor / AI / 大模型 / LLM 的字样
+
+**执行要点**：
+
+- `git commit -m "..."` 只写规范内容，**绝不**附加 `Co-Authored-By` trailer
+- HEREDOC 传 message 时，HEREDOC 内容也不得包含上述字样
+- 暂存的 message 含大模型信息 → **立即删除**后再提交
+
+## 常见错误 vs 正确
+
+| 错误 | 正确 |
+|------|------|
+| `feat: add user login`（英文） | `feat: 添加用户登录功能` |
+| `fix(eui): 修复了按钮样式。` | `fix(eui): 修复按钮样式`（无句号、不用"了"） |
+| `feat: 添加登录并修复登出 bug` | 拆成两个 commit |
+| `update: 修改配置` | `update` 不在枚举，应为 `chore` |
+| `feat(auth): ...`（项目无 auth scope） | 用项目已定义的 scope 值 |
+| message 末尾加 `Co-Authored-By: Claude ...` | 不加任何 AI 署名 trailer |
+| `🤖 Generated with Claude Code` | 不加任何生成声明 |
+
+## 正确示例
+
+- `feat(eui): 添加 Image 组件，支持懒加载`
+- `fix: 修复 token 刷新竞态条件`
+- `refactor(backend): 提取分页逻辑为共享工具`
+- `chore: 升级 Vite 至 8.x`
+- `feat(eui)!: 重命名 EDialog open 属性为 v-model:open`
+  - body：`BREAKING CHANGE: EDialog 不再接受 visible 属性，请改用 v-model:open`

package/templates/claude-global/skills/dwy-publish/SKILL.md

@@ -103,7 +103,7 @@ description: "发布版本：测试 → bump → changelog → build → publish
 # 暂存变更（version + changelog）
 git add <changed-files>
 
-# 提交（遵循 dwy-git-commit-convention）
+# 提交（遵循 dwy-git-commit）
 git commit -m "chore(<scope>): release v<version>"
 
 # 打 tag（按 Release 配置的命名规则）

package/templates/claude-global/{rules/dwy-tech-stack.md → skills/dwy-tech-stack/SKILL.md}

@@ -1,10 +1,11 @@
 ---
-description: 跨栈技术选型强制约束(FastAPI/Vue3/Flutter/UV/pnpm/Docker/S3 等,全局加载)
+name: dwy-tech-stack
+description: 跨栈技术选型强制约束（FastAPI / Vue 3 / Flutter / UV / pnpm / Docker / S3 / DolphinDB 等）。触发场景：用户提到「用什么 ORM / 缓存 / 状态管理 / 路由 / 包管理 / 组件库」/ 引入新依赖 / 替换现有库 / 调研选型 / 新项目初始化 / 架构评估；AI 准备执行 `pnpm add` / `uv add` / `pip install` / `flutter pub add` / `npm install` 前；讨论涉及后端 Web 框架、ORM、关系数据库、缓存、消息队列、异步任务、JWT / 密码哈希、Linter；前端 Vue 框架、构建工具、组件库、状态管理、样式方案、表单校验、测试；移动端 Flutter、状态管理、HTTP 客户端、路由、本地存储、代码生成；容器化、对象存储、时序数据库时。强制：每个领域只有唯一方案，AI 不得选替代，不得「建议改用 XX」。
 ---
 
 # 跨栈技术选型强制约束
 
-每个领域只有一个方案,AI 不得选替代,不得"建议改用 XX"。
+每个领域只有一个方案，AI 不得选替代，不得「建议改用 XX」。
 
 ## 后端
 
@@ -23,7 +24,7 @@ description: 跨栈技术选型强制约束(FastAPI/Vue3/Flutter/UV/pnpm/Docker/
 | 基础设施层 | dwyeapi | 自造框架、手写基础设施 |
 | Linter/Formatter | Ruff | Black, isort, flake8, pylint |
 
-## 前端(Web)
+## 前端（Web）
 
 | 领域 | 唯一方案 | 禁止替代 |
 |------|---------|---------|

package/templates/project/fullstack-monorepo/CLAUDE.md.hbs

@@ -0,0 +1,81 @@
+# {{projectName}}
+
+{{projectDescription}}
+
+## 架构
+
+Monorepo 全栈骨架：
+
+```
+{{projectName}}/
+├── backend/                # FastAPI 后端（uv workspace + 域分包）
+├── frontend/               # Vue 3 前端（pnpm workspace + catalog）
+├── docker-compose.dev.yml  # PostgreSQL + Redis 基础设施
+├── dev.sh                  # 一键启动脚本
+└── .env.example
+```
+
+详细约束见各子目录的 `CLAUDE.md`。
+
+## 端口约定
+
+本项目用 `{{portPrefix}}xxxx` 万位前缀避免与其他项目冲突：
+
+| 服务 | 端口 |
+|------|------|
+| Backend | `127.0.0.1:{{portPrefix}}8001` |
+| Frontend | `127.0.0.1:{{portPrefix}}5173` |
+| PostgreSQL | `127.0.0.1:{{portPrefix}}5432` |
+| Redis | `127.0.0.1:{{portPrefix}}6379` |
+
+## 启动
+
+```bash
+# 1. 复制环境变量
+cp .env.example .env
+
+# 2. 安装依赖
+cd backend && uv sync --dev && cd ..
+cd frontend && pnpm install && cd ..
+
+# 3. 一键启动（Docker + backend + frontend）
+./dev.sh
+```
+
+## 常用命令
+
+```bash
+# Backend
+cd backend
+uv sync --dev                              # 安装依赖
+uv run uvicorn app.main:app --reload       # 单独启 backend
+uv run pytest tests/ -v                    # 测试
+uv run ruff check src/ && uv run ruff format src/
+
+# Frontend
+cd frontend
+pnpm install
+pnpm dev                                    # 单独启 frontend
+pnpm build
+pnpm typecheck
+
+# 数据库迁移
+cd backend
+uv run alembic revision --autogenerate -m "msg"
+uv run alembic upgrade head
+```
+
+## 核心架构模式
+
+1. **单一版本中心**：backend `pyproject.toml` 集中管理外部依赖版本；frontend `pnpm-workspace.yaml` 的 `catalog:` 集中管理 npm 依赖版本。子包只写包名不写版本。
+2. **装配层**：`backend/src/app/main.py` 只做装配，业务逻辑在 `backend/packages/{{scopePrefix}}-<domain>/` 内。
+3. **域分包**：每个业务包按域子目录，域内分 router / service / schemas / models / protocols 五件套。
+4. **Provider 模式**：外部服务（DB / Redis / SMS / OSS / 第三方 API）抽象为 Protocol，`factories.py` 按 settings 选具体实现。
+5. **dwy- vs 业务-前缀**：`packages/dwy-*` 是跨项目可复用 kernel；`packages/{{scopePrefix}}-*` 是项目业务专属。
+6. **dwyeapi 优先**：后端基础设施先用 dwyeapi（配置/异常/分页/缓存），不重复实现。
+
+## 加新业务
+
+**Backend**：复制 `backend/packages/{{scopePrefix}}-{{initialDomain}}/` 整体改名 → 改 `pyproject.toml` 的 `name` → 改 `src/<scope_domain>/__init__.py` 的 `register()` → 在 `src/app/main.py` 装载。
+
+**Frontend**：复制 `frontend/packages/features/{{initialDomain}}/` 改名 → 在 `frontend/apps/web/src/router/index.ts` 注册路由。

package/templates/project/fullstack-monorepo/backend/.python-version

@@ -0,0 +1 @@
+3.11