create-dwy 0.5.1 → 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 的输出却并行 | 识别依赖，串行执行 |
-| 超过 5 个 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-commit-convention.md

@@ -1,106 +0,0 @@
-# Git Commit 强制规范
-
-**每次 `git commit` 前必须完整执行以下检查流程，不可跳过任何步骤。**
-
-## 提交前强制检查流程
-
-执行 `git commit` 前，按顺序完成以下 4 步。任何一步未通过则 **STOP，不得提交**。
-
-### Step 1: 分析变更内容
-
-运行 `git diff --cached` 查看暂存区，回答以下问题：
-
-- 这次变更做了几件事？
-- 涉及哪些模块/目录？
-
-**如果做了多件事** → STOP，必须拆成多个 commit。判断标准：能否用一个 ≤ 72 字符的 subject 清晰描述？不能就必须拆。
-
-### Step 2: 确定 scope
-
-读取当前项目 CLAUDE.md，查找 `## Git Commit Scope` 段落：
-
-- **找到了** → scope 必须从其中定义的枚举值中选取，不得自造
-- **没找到** → 提醒用户：「当前项目 CLAUDE.md 未定义 Git Commit Scope，建议添加。需要我帮你加吗？」，然后 scope 可省略
-
-scope 使用规则：
-- 变更仅涉及单个模块 → **必须**带 scope
-- 变更跨多个模块 → 省略 scope
-
-### Step 3: 生成 commit 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:` 前缀
-
-### Step 4: 自检验证
-
-生成 commit message 后，逐条验证：
-
-- [ ] type 在枚举表中？
-- [ ] scope 符合项目 CLAUDE.md 定义（或正确省略）？
-- [ ] subject 是中文、无句号、≤ 72 字符、简洁动宾短语？
-- [ ] 一个 commit 只做一件事，没有混合不同 type 的变更？
-- [ ] 没有混合不同 scope 的独立变更？
-
-**全部通过 → 执行 commit。任何一条未通过 → 修正后重新验证。**
-
-## 常见错误（必须避免）
-
-| 错误 | 正确 |
-|------|------|
-| `feat: add user login`（英文） | `feat: 添加用户登录功能`（中文） |
-| `fix(eui): 修复了按钮样式。` | `fix(eui): 修复按钮样式`（无句号、不用「了」） |
-| `feat: 添加登录功能并修复登出 bug` | 拆成两个 commit |
-| `update: 修改配置` | `update` 不在 type 枚举中，应为 `chore` |
-| `feat(auth): 添加 JWT 刷新`（项目 scope 枚举无 auth） | 使用项目定义的 scope 值 |
-
-## 正确示例
-
-```
-feat(eui): 添加 Image 组件，支持懒加载
-
-fix: 修复 token 刷新竞态条件
-
-refactor(backend): 提取分页逻辑为共享工具
-
-chore: 升级 Vite 至 8.x
-
-feat(eui)!: 重命名 EDialog open 属性为 v-model:open
-
-BREAKING CHANGE: EDialog 不再接受 `visible` 属性，请改用 `v-model:open`。
-```

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