create-dwy 0.5.0 → 0.6.0

package/templates/claude-global/rules/agent-team-patterns.md

@@ -1,157 +0,0 @@
-# Agent 并行模式速查表
-
-常见任务的 Agent 并行分工模板。执行前对照此表选择合适的模式。
-
-## 一、任务级并行模式
-
-### 模式 1：批量创建（N 路并行）
-
-**场景：** 创建多个独立的组件/页面/测试/demo
-
-```
-示例："给 5 个组件写 demo 页面"
-
-Agent-1 (worktree) → ComponentA demo
-Agent-2 (worktree) → ComponentB demo
-Agent-3 (worktree) → ComponentC demo
-Agent-4 (worktree) → ComponentD demo
-Agent-5 (worktree) → ComponentE demo
-→ 全部完成后 code-reviewer 审查
-```
-
-**要点：**
-- 每个 Agent 使用 `isolation: "worktree"`
-- 每个 Agent 的 prompt 包含组件的 API 说明和 demo 规范
-- 风险等级：低，直接执行
-
-### 模式 2：研究 + 实现（2 阶段流水线）
-
-**场景：** 需要先了解代码再动手修改
-
-```
-示例："修复 EForm 组件的验证 bug"
-
-阶段 1（并行研究）：
-  Agent-Explore → 分析 EForm 组件代码结构和数据流
-  Agent-Explore → 搜索相关测试和使用示例
-  Agent-Explore → 查看 git 历史和相关 issue
-
-阶段 2（串行实现）：
-  基于研究结果，主线程或单 Agent 实现修复
-
-阶段 3（并行验证）：
-  Agent → 运行测试
-  Agent → code-review 变更
-```
-
-**要点：**
-- 阶段 1 的 Agent 全部用 `subagent_type: "Explore"`
-- 阶段 2 必须等阶段 1 全部完成
-- 风险等级：中，阶段 2 前需确认方案
-
-### 模式 3：多模块同步修改
-
-**场景：** 一个功能涉及多个独立模块的修改
-
-```
-示例："给所有 API 模块添加分页参数"
-
-Agent-1 (worktree) → 修改 user API 模块
-Agent-2 (worktree) → 修改 order API 模块
-Agent-3 (worktree) → 修改 product API 模块
-→ code-reviewer 审查一致性
-```
-
-**要点：**
-- 每个 Agent 必须收到统一的修改规范（参数命名、类型定义）
-- 使用 worktree 隔离
-- 风险等级：中，执行前确认修改规范
-
-### 模式 4：前后端同步开发
-
-**场景：** 接口契约已定，前后端可以同时写
-
-```
-示例："新增用户导出功能"
-
-Agent-1 (worktree) → 后端 API + service 实现
-Agent-2 (worktree) → 前端页面 + API 调用
-→ code-reviewer 审查接口契约一致性
-```
-
-**要点：**
-- 两个 Agent 必须收到相同的接口契约定义（URL、参数、响应格式）
-- 风险等级：中，确认接口契约后执行
-
-## 二、步骤级并行模式
-
-### 模式 A：并行信息收集
-
-在执行任何任务前，将独立的信息收集步骤并行化：
-
-```
-同一消息中发起：
-  Grep → 搜索相关代码引用
-  Glob → 查找相关文件
-  Read → 读取配置文件
-  Agent(Explore) → 分析依赖关系
-```
-
-### 模式 B：并行验证
-
-修改完成后，将独立的验证步骤并行化：
-
-```
-同一消息中发起：
-  Bash → 运行单元测试
-  Bash → 运行 lint 检查
-  Bash → 运行类型检查
-  Bash → 运行构建
-```
-
-### 模式 C：并行文档/测试补充
-
-主要代码完成后，并行补充配套文件：
-
-```
-同一消息中发起：
-  Agent → 写单元测试
-  Agent → 更新相关文档
-  Agent → 更新 changelog
-```
-
-## 三、反模式（禁止使用）
-
-| 反模式 | 问题 | 正确做法 |
-|--------|------|---------|
-| 多 Agent 改同一文件 | 冲突、覆盖 | 串行修改或拆分文件职责 |
-| 无上下文的 Agent | 产出质量差 | prompt 必须自包含 |
-| 链式依赖硬并行 | B 依赖 A 的输出却并行 | 识别依赖，串行执行 |
-| 10+ Agent 同时派出 | 难以管理、context 爆炸 | 单批最多 5 个 Agent |
-| 跳过 review 直接提交 | 质量无保障 | 遵循 review 闭环 |
-
-## 四、Agent 数量指南
-
-| 场景 | 建议 Agent 数 |
-|------|-------------|
-| 批量创建同质文件 | 每个文件 1 个，上限 5 个/批 |
-| 并行研究 | 2-3 个 Explore Agent |
-| 多模块修改 | 每个模块 1 个，上限 4 个/批 |
-| 前后端同步 | 2 个 |
-| 步骤级并行工具调用 | 不限（Grep/Glob/Read 等轻量调用尽量并行） |
-
-超过 5 个 Agent 的任务，分批执行：先派第一批，完成后再派第二批。
-
-## 五、Worktree 使用指南
-
-以下场景**必须**使用 `isolation: "worktree"`：
-
-- 多个 Agent 各自创建/修改不同文件
-- Agent 的修改可能与当前工作区冲突
-- 需要保持主工作区干净（如正在进行其他工作）
-
-以下场景**不需要** worktree：
-
-- 纯只读的 Explore Agent
-- 步骤级并行的工具调用（Grep/Glob/Read/Bash）
-- 单个 Agent 执行（无冲突风险）

package/templates/claude-global/rules/git-security.md

@@ -1,144 +0,0 @@
----
-name: git-security
-description: Git 提交安全规则
-type: claude-rule
-tags: [security, git]
-version: 1.0.0
-author: chances
----
-
-# Git 提交安全规则
-
-每次执行 `git add` 或 `git commit` 前必须遵循以下规则。违反时必须**立即停止并提示用户确认**。
-
-## 一、禁止提交的文件
-
-### 绝对禁止（无论任何理由）
-以下文件**永远不得**被 `git add`：
-
-| 文件类型 | 示例 |
-|---|---|
-| 环境变量文件 | `.env`、`.env.local`、`.env.production`、`*.env` |
-| SSH 密钥 | `id_rsa`、`id_ed25519`、`*.pem`、`*.key` |
-| 证书文件 | `*.p12`、`*.pfx`、`*.jks`、`*.keystore` |
-| 数据库文件 | `*.sql`（含真实数据的）、`*.dump`、`*.sqlite` |
-| 原始数据 | `*.xlsx`、`*.csv`（含用户/学生等敏感数据的） |
-| 日志文件 | `*.log` |
-| Docker 卷数据 | `pgdata/`、`cache/*.json` |
-
-### 检测方法
-在执行 `git add` 前，检查暂存区是否包含上述文件：
-```bash
-git diff --cached --name-only | grep -iE '\.(env|pem|key|p12|pfx|jks|dump|sqlite|log)$'
-```
-
-## 二、禁止提交的内容
-
-### 总则：所有示例必须使用假值
-**禁止在代码、文档、规则文件、注释中出现任何真实的 API Key、Token、密码、IP 地址等敏感信息，即使是作为"示例"也不允许。** 所有示例必须使用明显的假值/脱敏值（如 `sk-xxxxxxxxxxxx`、`your-key-here`、`192.168.x.x`）。GitHub Secret Scanning 不区分上下文，真实格式的 key 即使写在文档示例中也会触发泄露告警。
-
-### 必须扫描的敏感模式
-对每个将要提交的文件内容，检查是否包含以下模式：
-
-| 类型 | 匹配模式 | 示例（均为假值） |
-|---|---|---|
-| API Key | `sk-[a-zA-Z0-9]{20,}` | `sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
-| AWS Key | `AKIA[0-9A-Z]{16}` | `AKIAIOSFODNN7EXAMPLE` |
-| 密码赋值 | `password\s*[:=]\s*["'][^"']{4,}` | `password = "abc123"` |
-| 数据库连接串 | `://\w+:[^@\s]+@` | `postgresql://user:pass@host` |
-| 私钥内容 | `-----BEGIN (RSA |EC )?PRIVATE KEY-----` | PEM 私钥 |
-| Token | `token\s*[:=]\s*["'][a-zA-Z0-9_\-]{20,}` | `token = "ghp_xxxx"` |
-| Secret | `secret\s*[:=]\s*["'][^"']{8,}` | `secret = "my-secret"` |
-| 服务器 IP+端口 | `\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}:\d+` | `192.168.1.1:8080` |
-| SSH 连接 | `ssh\s+.*@\d{1,3}\.\d{1,3}` | `ssh user@192.168.1.1` |
-
-### 例外：允许的模式
-以下情况**不算**违规：
-- `.env.example` 中的占位符（如 `DEEPSEEK_API_KEY=your-key-here`）
-- 代码中从环境变量读取的引用（如 `os.getenv("API_KEY")`）
-- `localhost` 或 `127.0.0.1` 的连接串
-- 文档中的示例/假数据（如 `sk-xxxxxxxxxxxx`）
-- 配置文件中的空字符串默认值（如 `api_key: str = ""`）
-
-## 三、提交前检查流程
-
-每次 `git commit` 前必须执行：
-
-```
-1. 检查暂存文件列表 → 是否包含禁止文件类型？
-2. 检查文件内容差异 → 是否包含敏感模式？
-3. 检查 .gitignore → 是否已排除敏感目录？
-4. 通过 → 执行提交
-5. 未通过 → 停止，提示用户具体违规项
-```
-
-### 自动检查命令
-```bash
-# 检查暂存区的敏感文件
-git diff --cached --name-only | grep -iE '\.(env|pem|key|log|dump|sqlite)$'
-
-# 检查暂存区内容中的敏感信息
-git diff --cached -U0 | grep -iE '(sk-[a-zA-Z0-9]{20}|AKIA[0-9A-Z]{16}|-----BEGIN.*PRIVATE KEY|password\s*[:=]\s*"[^"]{4,}"|://\w+:[^@\s]+@[^l])'
-```
-
-## 四、.gitignore 最低要求
-
-每个项目的 `.gitignore` 必须至少包含：
-
-```gitignore
-# 环境变量
-.env
-*.env
-.env.*
-
-# 密钥
-*.pem
-*.key
-*.p12
-
-# 缓存与编译
-__pycache__/
-*.pyc
-node_modules/
-dist/
-
-# 日志
-*.log
-
-# 数据库
-*.sqlite
-*.dump
-```
-
-如果项目的 `.gitignore` 缺少以上条目，提交前必须先补全。
-
-## 五、已提交敏感数据的处理
-
-如果发现敏感数据已存在于 git 历史中：
-
-1. **立即通知用户**，说明哪些数据已泄露
-2. **建议轮换凭证**（API Key、密码等）
-3. **提供清理命令**（但不自动执行，等用户确认）：
-```bash
-# 从所有历史中删除文件
-git filter-repo --path <file> --invert-paths --force
-
-# 或使用 BFG
-bfg --delete-files <filename>
-```
-
-## 六、违规处理流程
-
-当检测到提交操作包含敏感数据时：
-
-1. **立即停止** `git add` 或 `git commit`
-2. **列出具体违规项**：
-   - 文件名和行号
-   - 匹配到的敏感模式类型
-   - 敏感内容的部分摘要（如 `sk-5522****dc3`，脱敏显示）
-3. **提供建议**：
-   - 将文件加入 `.gitignore`
-   - 将敏感值移到 `.env`
-   - 使用环境变量替代硬编码
-4. **等待用户明确确认**后才能继续
-5. 如用户确认提交，添加注释：`# GIT-SECURITY: 用户已确认提交此内容`

package/templates/claude-global/skills/dwy-auto-sync/SKILL.md

@@ -1,52 +0,0 @@
----
-name: dwy-auto-sync
-description: "create-dwy 发版后自动更新本地 CLI 并同步 Claude Code 配置。触发条件：执行了 npm publish create-dwy、pnpm publish:cli、或用户要求同步 dwy 配置时。"
----
-
-# DWY 发版后自动同步
-
-当 `create-dwy` 发布新版本后，必须执行以下步骤确保本地 Claude Code 配置与最新版本同步。
-
-## 触发时机
-
-以下任一情况发生时，执行同步流程：
-
-1. 执行了 `npm publish`（在 claude-cli 目录下）
-2. 执行了 `pnpm publish:cli`
-3. 用户要求"同步 dwy"或"更新配置"
-
-## 同步流程
-
-发版成功后，按顺序执行：
-
-```bash
-# 1. 更新全局 CLI 到最新版
-npm i -g create-dwy@latest
-
-# 2. 验证版本
-dwy --version
-
-# 3. 同步 Claude Code 配置（skills/rules/hooks/commands/settings）
-dwy sync claude
-
-# 4. 验证同步结果
-ls ~/.claude/skills/
-```
-
-## 同步了什么
-
-`dwy sync claude` 会将以下内容从 CLI 模板同步到 `~/.claude/`：
-
-| 目录 | 内容 | 同步方式 |
-|------|------|---------|
-| `~/.claude/skills/` | AI 速查文档 (dwy-frontend-eui, dwy-frontend-core, dwy-backend-base) | 覆盖同名，保留已有 |
-| `~/.claude/rules/` | 编码规范 (python-code-style, vue-code-style, 安全规则等) | 覆盖同名，保留已有 |
-| `~/.claude/hooks/` | 自动化脚本 (pre-git-commit 检查) | 覆盖同名，保留已有 |
-| `~/.claude/commands/` | 自定义命令 | 覆盖同名，保留已有 |
-| `~/.claude/settings.json` | Claude Code 设置 | 浅合并（新 key 加入，同名覆盖，已有独有 key 保留） |
-
-## 注意事项
-
-- npm 注册表有传播延迟（~1 分钟），如果 `npm i -g create-dwy@latest` 安装的不是刚发布的版本，等待后重试
-- `dwy sync claude` 从 Gitee 仓库拉取模板，确保代码已 push 到 Gitee 后再执行
-- 同步不会删除用户手动添加的 skills/rules，只覆盖同名文件

package/templates/claude-global/skills/dwy-backend-base/SKILL.md

@@ -1,279 +0,0 @@
----
-name: dwy-backend-base
-description: "danweiyuan-base FastAPI 后端基础设施速查。触发条件：使用 FastAPI 构建后端、配置数据库/Redis/JWT/异常处理时。"
----
-
-# danweiyuan-base 后端基础设施速查
-
-FastAPI 项目基础设施包，Python 3.11+，全异步。8 个扁平模块，无子包。
-
-## 安装
-
-```bash
-pip install danweiyuan-base
-# 或
-uv add danweiyuan-base
-```
-
-```python
-from danweiyuan_base.config import BaseSettings
-from danweiyuan_base.database import Base, TimestampMixin, create_async_engine_factory, create_session_factory
-from danweiyuan_base.security import hash_password, verify_password, create_token, decode_token
-from danweiyuan_base.exceptions import NotFoundError, BusinessError, register_exception_handlers
-from danweiyuan_base.response import success, fail, paginated
-from danweiyuan_base.pagination import PaginationParams, paginate
-from danweiyuan_base.cache import configure as configure_redis, get_redis, close_redis
-from danweiyuan_base.dependencies import create_get_db
-```
-
-## 查阅源码
-
-每个模块在 `backend/src/danweiyuan_base/{module}.py`，单文件设计可直接阅读。
-
----
-
-## config — Pydantic Settings
-
-```python
-from danweiyuan_base.config import BaseSettings
-```
-
-子类化后使用，从 `.env` 或环境变量读取配置。
-
-```python
-class Settings(BaseSettings):
-    app_name: str = "My API"
-    # 继承的必填字段：database_url, redis_url, secret_key
-```
-
-| 字段 | 类型 | 默认值 | 说明 |
-|------|------|--------|------|
-| database_url | str | **必填** | 异步数据库 URL |
-| redis_url | str | **必填** | Redis URL |
-| secret_key | str | **必填** | JWT 签名密钥 |
-| jwt_algorithm | str | `"HS256"` | JWT 算法 |
-| access_token_expire_minutes | int | `30` | Token 过期分钟 |
-| debug | bool | `False` | 调试模式 |
-| allowed_origins | list[str] | `[]` | CORS 允许域名 |
-
----
-
-## database — 异步 SQLAlchemy
-
-```python
-from danweiyuan_base.database import Base, TimestampMixin, create_async_engine_factory, create_session_factory
-```
-
-### 模型定义
-
-```python
-from sqlalchemy.orm import Mapped, mapped_column
-from sqlalchemy import String
-
-class User(Base, TimestampMixin):
-    __tablename__ = "users"
-    id: Mapped[int] = mapped_column(primary_key=True)
-    name: Mapped[str] = mapped_column(String(50))
-    # TimestampMixin 自动添加 created_at, updated_at
-```
-
-### 引擎和会话
-
-```python
-engine = create_async_engine_factory(settings.database_url, echo=settings.debug)
-# 参数: database_url, pool_size=5, max_overflow=10, echo=False
-# SQLite 自动跳过连接池参数
-
-session_factory = create_session_factory(engine)
-# 返回 async_sessionmaker[AsyncSession]，expire_on_commit=False
-```
-
----
-
-## dependencies — FastAPI 依赖注入
-
-```python
-from danweiyuan_base.dependencies import create_get_db
-```
-
-### create_get_db(session_factory)
-
-生成 `get_db` FastAPI Depends 函数，自动管理会话生命周期。
-
-```python
-get_db = create_get_db(session_factory)
-
-@router.get("/users/{user_id}")
-async def get_user(user_id: int, db: AsyncSession = Depends(get_db)):
-    ...
-```
-
----
-
-## security — JWT + bcrypt
-
-```python
-from danweiyuan_base.security import hash_password, verify_password, create_token, decode_token
-```
-
-所有函数无状态，密钥通过参数传入。
-
-| 函数 | 签名 | 说明 |
-|------|------|------|
-| hash_password | `(password: str) -> str` | bcrypt 哈希 |
-| verify_password | `(plain: str, hashed: str) -> bool` | 验证密码 |
-| create_token | `(data: dict, secret: str, expires_minutes: int, algorithm="HS256") -> str` | 创建 JWT，自动添加 exp |
-| decode_token | `(token: str, secret: str, algorithm="HS256") -> dict \| None` | 解码 JWT，失败返回 None |
-
-```python
-hashed = hash_password("my-password")
-is_valid = verify_password("my-password", hashed)
-
-token = create_token({"sub": str(user.id)}, settings.secret_key, settings.access_token_expire_minutes)
-payload = decode_token(token, settings.secret_key)  # {"sub": "1", "exp": ...} 或 None
-```
-
----
-
-## exceptions — 异常体系
-
-```python
-from danweiyuan_base.exceptions import (
-    AppError, NotFoundError, BusinessError, PermissionDeniedError, AuthenticationError,
-    register_exception_handlers,
-)
-```
-
-### 异常层级
-
-| 异常类 | HTTP 状态码 | code | message |
-|--------|-----------|------|---------|
-| AppError(message, code) | — | 自定义 | 自定义 |
-| NotFoundError(resource) | 404 | `NOT_FOUND` | `{resource}不存在` |
-| BusinessError(message, code) | 422 | 自定义 | 自定义 |
-| PermissionDeniedError() | 403 | `PERMISSION_DENIED` | `权限不足` |
-| AuthenticationError() | 401 | `AUTHENTICATION_FAILED` | `认证失败` |
-
-### 注册到 FastAPI
-
-```python
-app = FastAPI()
-register_exception_handlers(app)
-# 之后在 service 层直接 raise NotFoundError("用户") 即可返回 404
-```
-
-响应格式统一为 `{"code": "ERROR_CODE", "message": "描述"}`。
-
-### 使用原则
-
-- **service 层**抛业务异常（NotFoundError, BusinessError 等）
-- **router 层**不写 try/except，由 register_exception_handlers 统一处理
-- **禁止**在 service 层抛 HTTPException
-
----
-
-## response — 统一响应
-
-```python
-from danweiyuan_base.response import success, fail, paginated
-```
-
-| 函数 | 签名 | 返回结构 |
-|------|------|---------|
-| success | `(data=None, message="success") -> dict` | `{"code": 200, "message": ..., "data": ..., "timestamp": ...}` |
-| fail | `(code=400, message="fail") -> dict` | `{"code": ..., "message": ..., "data": None, "timestamp": ...}` |
-| paginated | `(items, total, page, page_size) -> dict` | success 包装 `{"items": [...], "total": N, "page": N, "page_size": N}` |
-
-```python
-@router.get("/users/{user_id}")
-async def get_user(user_id: int, service=Depends(get_user_service)):
-    user = await service.get_by_id(user_id)
-    return success(data=UserResponse.model_validate(user))
-
-@router.get("/users")
-async def list_users(params: PaginationParams = Depends(), service=Depends(get_user_service)):
-    items, total = await service.list(params)
-    return paginated(items, total, params.page, params.page_size)
-```
-
----
-
-## pagination — 分页工具
-
-```python
-from danweiyuan_base.pagination import PaginationParams, paginate, OffsetLimit
-```
-
-### PaginationParams
-
-FastAPI Depends 注入的查询参数模型。
-
-| 字段 | 类型 | 默认 | 约束 |
-|------|------|------|------|
-| page | int | 1 | >= 1 |
-| page_size | int | 20 | 1 ~ 100 |
-
-### paginate(page, page_size) -> OffsetLimit
-
-```python
-offset_limit = paginate(params.page, params.page_size)
-# OffsetLimit(offset=0, limit=20) — 可直接用于 SQLAlchemy .offset().limit()
-stmt = select(User).offset(offset_limit.offset).limit(offset_limit.limit)
-```
-
----
-
-## cache — 异步 Redis
-
-```python
-from danweiyuan_base import cache
-```
-
-| 函数 | 签名 | 说明 |
-|------|------|------|
-| cache.configure | `(redis_url: str) -> None` | 设置 Redis URL（启动时调用一次） |
-| cache.get_redis | `async () -> Redis` | 获取/创建共享连接（未 configure 时抛 RuntimeError） |
-| cache.close_redis | `async () -> None` | 关闭连接（安全幂等） |
-
-```python
-# lifespan 中初始化
-@asynccontextmanager
-async def lifespan(app: FastAPI):
-    cache.configure(settings.redis_url)
-    yield
-    await cache.close_redis()
-
-# 业务中使用
-redis = await cache.get_redis()
-await redis.set("key", "value", ex=3600)
-val = await redis.get("key")
-```
-
----
-
-## 典型项目接入流程
-
-```python
-# config.py
-from danweiyuan_base.config import BaseSettings
-
-class Settings(BaseSettings):
-    app_name: str = "My API"
-
-settings = Settings()
-
-# database.py
-from danweiyuan_base.database import Base, create_async_engine_factory, create_session_factory
-from danweiyuan_base.dependencies import create_get_db
-
-engine = create_async_engine_factory(settings.database_url)
-session_factory = create_session_factory(engine)
-get_db = create_get_db(session_factory)
-
-# main.py
-from danweiyuan_base.exceptions import register_exception_handlers
-from danweiyuan_base import cache
-
-app = FastAPI(lifespan=lifespan)
-register_exception_handlers(app)
-```