create-dwy 0.19.1 → 0.21.0

package/templates/ai-tools/rules/Python/dwy-python-layering.md

@@ -0,0 +1,169 @@
+---
+description: Python 后端四层分包与依赖方向（Assembly / Features / BizFoundation / Foundation）；uv workspace 根锁定第三方版本
+paths:
+  - "**/*.py"
+  - "**/pyproject.toml"
+---
+
+# Python 四层架构与依赖
+
+适用于 uv workspace 的 Python 后端。路由 / Schema / ORM / 安全编码见 `dwy-python-backend`。本文件只管**层、引用边、版本写在哪**。
+
+单壳项目**不建** PlatformFoundation。
+
+---
+
+## 一、层名（冻结）
+
+正式层名只有下表四个。目录 / 包可以叫 `app`、`biz_foundation`，文档可写「本仓包名 X = Foundation」。**禁止**把 `Domain` / `infra` / `core` 当层名。
+
+| 层 | 判定（只用这一条） | 禁止 |
+|---|---|---|
+| **Foundation** | 换一个完全不同的产品仍原样拿走 | 出现本业务名词 |
+| **BizFoundation** | 本产品才有，但跨多个 Feature 都要用 | 页面、导航、某一端壳状态 |
+| **Features** | 可整包删/裁剪的业务域 | 被其他 Feature 直接引用 |
+| **Assembly** | 生命周期、DI、路由挂载、把实现插进 Protocol | 业务规则、业务计算 |
+
+升层：第二个 Feature 或第二个产品**真在用**，才升到 BizFoundation / Foundation。禁止「可能复用」提前抽。
+
+业务内聚：一个业务域 = `features/` 下的一个包。域内 `router.py` / `service.py` / `schemas.py` / `models.py` 聚在一起。禁止全局 `routers/` `services/` `models/`。
+
+---
+
+## 二、依赖边（强制）
+
+```
+app → features/* → biz_foundation → foundation
+         ✕ 互引
+```
+
+| 谁 | 允许依赖 | 禁止 |
+|---|---|---|
+| `app/` | `features/*`、`biz_foundation`、`foundation`（仅 factories） | 业务计算 |
+| `features/orders` | 仅 `biz_foundation` | `app`、`features/inventory`、`foundation` |
+| `biz_foundation` | 仅 `foundation` | `app`、任何 Feature |
+| `foundation` | 第三方库 | 任何本仓业务包 |
+
+**Feature 互引为零。** 跨域只许三种：升到 `biz_foundation`；Feature 只依赖 Protocol，由 `app/factories.py` / `app/hooks.py` 注入实现；`app` 编排两次调用。
+
+依赖倒置原则：Feature 依赖 Protocol，不依赖 Doris/Http 具体类。具体实现只出现在 `app/`。
+
+声明与源码两道都查：
+
+- `features/orders/pyproject.toml` 的 `dependencies` 只许出现 `biz_foundation` 与无版本第三方名
+- 源码禁止 `from app.`、`from features.inventory`、`from foundation.`
+
+```python
+# 合法：只认抽象，实现由装配层注入
+class StockPort(Protocol):
+    """扣库存端口。orders 不 import inventory 包。"""
+
+    async def deduct(self, sku: str, qty: int) -> None: ...
+
+
+class OrderService:
+    """下单。stock 由 app/factories.py 注入。"""
+
+    def __init__(self, stock: StockPort) -> None:
+        self._stock = stock
+```
+
+```python
+# 禁止
+from app.main import settings                    # Feature → Assembly
+from features.inventory.service import deduct    # Feature → Feature
+from foundation.db import get_session            # Feature 越层
+```
+
+---
+
+## 三、分包树
+
+打开 `backend/` 必须能数出四层。业务词只出现在 `features/` 下。
+
+```
+backend/
+  app/                            # Assembly
+    main.py                       # 注册 router、lifespan
+    factories.py                  # 唯一实例化具体实现的地方
+    hooks.py                      # 跨 Feature 桥
+  features/                       # Features
+    orders/
+      pyproject.toml
+      src/orders/
+        router.py
+        service.py
+        schemas.py
+        models.py
+    inventory/
+      pyproject.toml
+      src/inventory/
+        router.py
+        service.py
+        schemas.py
+        models.py
+  biz_foundation/                 # BizFoundation
+    pyproject.toml
+    src/biz_foundation/
+      auth/                       # 内容：跨 Feature 鉴权，不是一层
+      protocols.py
+  foundation/                     # Foundation
+    pyproject.toml
+    src/foundation/
+      db.py
+      redis.py
+      signing.py
+  pyproject.toml                  # workspace + 第三方版本只在这
+  uv.lock
+```
+
+```toml
+# 根 pyproject.toml
+[tool.uv.workspace]
+members = ["features/*", "biz_foundation", "foundation"]
+```
+
+`app/` 是根应用，不是 workspace member。测试镜像层：`tests/features/orders/`、`tests/biz_foundation/`。
+
+---
+
+## 四、Monorepo 版本（强制）
+
+第三方版本号**只**出现在仓库根 `pyproject.toml` 的 `constraint-dependencies`。成员包只写包名。内部包用 uv workspace，不写版本。一把锁：根 `uv.lock`。选哪个版本走 skill `dwy-dependency-choice`。
+
+```toml
+# 根 pyproject.toml
+[tool.uv.sources]
+biz_foundation = { workspace = true }
+foundation = { workspace = true }
+
+[tool.uv]
+constraint-dependencies = [
+  "fastapi==0.115.6",
+  "sqlalchemy==2.0.36",
+]
+```
+
+```toml
+# features/orders/pyproject.toml
+[project]
+dependencies = [
+  "fastapi",           # 无版本
+  "biz_foundation",
+]
+```
+
+禁止成员 `pyproject.toml` 写 `fastapi==0.115.6`。禁止每个包自己 `uv lock`。
+
+---
+
+## 五、检查清单
+
+| 检查项 | 严重 |
+|---|---|
+| 顶层不是 `app` / `features` / `biz_foundation` / `foundation` 四层 | 高 |
+| Feature `from app.` 或 pyproject 依赖 `app` | 高 |
+| Feature import 另一 Feature | 高 |
+| Feature 源码 `from foundation.` | 高 |
+| 成员包写死第三方版本 | 高 |
+| `Domain` / `infra` / `core` 当层名 | 中 |

package/templates/ai-tools/rules/Vue/dwy-vue-core.md

@@ -1,5 +1,5 @@
 ---
-description: Vue 3 + TS + Vite + Tailwind 应用层通用规范（业务聚合结构、组件 / TS / 路由 / API / 模板 / 样式 / 错误处理 / 注释）
+description: Vue 3 + TS + Vite + Tailwind 应用层通用规范（组件 / TS / 路由 / API / 模板 / 样式 / 错误处理 / 注释；仓库分层见 dwy-vue-layering）
 paths:
   - "**/*.vue"
   - "**/*.ts"
@@ -14,57 +14,11 @@ paths:
 
 ## 一、项目结构与业务聚合（强制）
 
-### 核心原则
+**仓库四层（`apps/web` / `packages/features` / `packages/biz-foundation` / `packages/foundation`）、Feature 互不依赖、pnpm catalog → 见 `dwy-vue-layering`。** 本节只约定 Feature **域内**文件名。
 
-**按功能模块（feature / domain）聚合，禁止按技术层散落。** 同一业务功能的 view / components / store / api / types 必须集中在同一个功能目录下；**禁止**全局存在 `views/` / `components/` / `stores/` / `api/` 等顶级"技术层"目录把不同功能的同类文件混放。
-
-### 为什么
-
-- **跨项目迁移**：复制单个功能目录即可携带该功能全部代码；技术层散落需在 5+ 目录里翻找
-- **可读性**：阅读功能时所有相关代码在同一目录，无需跨目录跳转
-- **变更影响域清晰**：一次改动 diff 集中，code review 更高效
-- **删除友好**：删功能时整个目录删掉即可，不会留下孤儿文件
-
-### 标准结构（参考）
-
-```
-src/
-├── features/                   # 业务功能根目录
-│   ├── users/                  # 用户功能
-│   │   ├── api.ts              # 该业务的 API（用全局 HTTP 客户端）
-│   │   ├── store.ts            # 该业务的 Pinia store
-│   │   ├── types.ts            # 该业务的类型
-│   │   ├── views/              # 该业务的页面组件
-│   │   │   ├── UserListView.vue
-│   │   │   └── UserDetailView.vue
-│   │   ├── components/         # 该业务的内部组件
-│   │   │   └── UserCard.vue
-│   │   └── route.ts            # 该业务的路由片段
-│   └── orders/
-│       ├── api.ts
-│       ├── store.ts
-│       └── views/
-├── shared/                     # 跨业务真正复用：UI 子组件 / composables / 常量
-│   ├── components/
-│   ├── composables/
-│   └── constants/
-├── core/                       # 全局基础设施：HTTP client / 路由根 / 主题 / 启动
-│   ├── http.ts                 # 全局唯一 HTTP 客户端实例
-│   ├── router.ts
-│   └── main.ts
-├── App.vue
-└── style.css
-```
-
-> 测试目录与 `src/` 并列、镜像业务聚合结构（详见 `dwy-vue-testing` rule）。
-
-### 强制规则
-
-- **禁止**顶级 `views/` / `components/` / `stores/` / `api/` / `types/` 把不同功能的同类文件混放
 - 一个功能目录内文件名固定：`api.ts` / `store.ts` / `types.ts` / `route.ts`（单数、不带功能前缀）
-- 跨业务真正共享的代码放 `shared/` 或 `core/`，**禁止**为"可能复用"把单一功能逻辑提前抽离
 - 单文件超过约 400 行时再考虑拆分，**禁止**未到规模就预拆分
-- 模块间引用通过明确 import，**禁止**循环依赖
+- 测试目录与源码并列、镜像业务聚合（详见 `dwy-vue-testing`）
 
 ## 二、组件规范
 
@@ -313,6 +267,14 @@ export function createUser(data: UserCreate) {
 - 模板中复杂表达式 / 内联多语句
 - `kebab-case` 组件名 / 模板中写 `.value`
 
+### 用户输入限长
+
+业务页里接收用户输入的控件（`input` / `textarea` / 富文本 / 文件 / 批量项）要有长度或大小上限，并用该页的 schema 再校验一次，防止粘贴绕过 `maxlength`。
+
+上限按字段语义定：用户名几十字符、描述几百、正文几千、图片几 MB。组件库的 Input 只提供 `maxlength` 这类 prop，不在组件内部写死业务上限。
+
+后端校验见 `dwy-python-backend`。只改组件库、没有业务表单时，不要给每个控件塞一套 schema。
+
 ---
 
 ## 八、样式规范

package/templates/ai-tools/rules/Vue/dwy-vue-layering.md

@@ -0,0 +1,153 @@
+---
+description: Vue 四层分包与依赖方向（Assembly / Features / BizFoundation / Foundation）；pnpm catalog 根锁定第三方版本
+paths:
+  - "**/*.vue"
+  - "**/*.ts"
+  - "**/package.json"
+  - "**/pnpm-workspace.yaml"
+---
+
+# Vue 四层架构与依赖
+
+适用于 pnpm workspace 的 Vue 3 应用。组件 / 路由 / Pinia 写法见 `dwy-vue-core` / `dwy-vue-pinia`。本文件只管**层、引用边、版本写在哪**。
+
+单壳项目**不建** PlatformFoundation。
+
+---
+
+## 一、层名（冻结）
+
+正式层名只有下表四个。目录 / 包可以叫 `apps/web`、`packages/biz-foundation`，文档可写「本仓包名 X = Foundation」。**禁止**把 `Domain` / `infra` / `core` 当层名。
+
+| 层 | 判定（只用这一条） | 禁止 |
+|---|---|---|
+| **Foundation** | 换一个完全不同的产品仍原样拿走 | 出现本业务名词 |
+| **BizFoundation** | 本产品才有，但跨多个 Feature 都要用 | 页面、导航、某一端壳状态 |
+| **Features** | 可整包删/裁剪的业务域 | 被其他 Feature 直接引用 |
+| **Assembly** | 生命周期、DI、路由挂载、把实现插进 Protocol | 业务规则、业务计算 |
+
+升层：第二个 Feature 或第二个产品**真在用**，才升到 BizFoundation / Foundation。禁止「可能复用」提前抽。
+
+业务内聚：一个业务域 = `packages/features/` 下的一个包。域内 `api.ts` / `store.ts` / `types.ts` / `route.ts` / `views/` 聚在一起。禁止全局 `views/` `stores/` `api/`。
+
+项目专用、绝不跨项目的页面可放 `apps/web/src/features/`，**依赖边与 `packages/features/*` 相同**：禁止互引、禁止 import `packages/foundation`。
+
+---
+
+## 二、依赖边（强制）
+
+```
+apps/web → packages/features/* → packages/biz-foundation → packages/foundation
+                  ✕ 互引
+```
+
+| 谁 | 允许依赖 | 禁止 |
+|---|---|---|
+| `apps/web` | `features/*`、`biz-foundation`、`foundation`（仅装配 http 单例） | 业务计算写在壳里 |
+| `@acme/orders` | 仅 `@acme/biz-foundation` + catalog 第三方 | `@acme/inventory`、`@/` 宿主路径、`@acme/foundation` |
+| `@acme/biz-foundation` | 仅 `@acme/foundation` | `apps/web`、任何 Feature |
+| `@acme/foundation` | catalog 第三方 | 任何业务包、Vue Router 业务路由 |
+
+**Feature 互引为零。** 跨域只许三种：升到 `biz-foundation`；Feature 导出工厂 / Options，由 `apps/web` 注入回调；壳编排两个页面。
+
+可复用 Feature **禁止** `import { useXxxStore } from '@/stores/...'`。宿主 store 由 `apps/web` 经 Options 传入。
+
+```ts
+// 合法：packages/features/orders 只认端口，不 import inventory
+export interface StockPort {
+  /** 扣库存。实现由 apps/web 注入。 */
+  deduct(sku: string, qty: number): Promise<void>
+}
+```
+
+```ts
+// 禁止
+import { useInventoryStore } from '@acme/inventory'  // Feature → Feature
+import { useAuthStore } from '@/stores/auth'         // 可复用 Feature → 宿主
+import { http } from '@acme/foundation'              // 越层；经 biz-foundation 门面
+```
+
+---
+
+## 三、分包树
+
+打开仓库必须能数出四层。业务词只出现在 `packages/features/`（或壳内 `apps/web/src/features/`）。
+
+```
+apps/
+  web/                            # Assembly
+    src/
+      main.ts
+      router.ts
+      stores/                     # 宿主 session，不放业务规则
+packages/
+  features/                       # Features
+    orders/
+      package.json
+      src/
+        api.ts
+        store.ts
+        types.ts
+        route.ts
+        views/
+    inventory/
+  biz-foundation/                 # BizFoundation
+    src/
+      auth/                       # 内容：跨 Feature 鉴权，不是一层
+      protocols.ts
+  foundation/                     # Foundation
+    src/
+      http.ts
+      format.ts
+pnpm-workspace.yaml               # catalog 只在这
+pnpm-lock.yaml
+```
+
+禁止把 `orders`、鉴权、http 工厂平铺在 `packages/` 根上，否则层不可见。
+
+```yaml
+# pnpm-workspace.yaml
+packages:
+  - apps/*
+  - packages/features/*
+  - packages/biz-foundation
+  - packages/foundation
+```
+
+---
+
+## 四、Monorepo 版本（强制）
+
+第三方版本号**只**出现在 `pnpm-workspace.yaml` 的 `catalog`。子包用 `"catalog:"`。内部包 `"workspace:*"`。选哪个版本走 skill `dwy-dependency-choice`。
+
+```yaml
+# pnpm-workspace.yaml
+catalog:
+  vue: 3.5.13
+  axios: 1.7.9
+```
+
+```json
+{
+  "name": "@acme/orders",
+  "dependencies": {
+    "vue": "catalog:",
+    "@acme/biz-foundation": "workspace:*"
+  }
+}
+```
+
+禁止子包 `"vue": "^3.5.13"`。禁止每个 Feature 各自锁 axios 版本。
+
+---
+
+## 五、检查清单
+
+| 检查项 | 严重 |
+|---|---|
+| `packages/` 根平铺业务包，看不出 `features` / `biz-foundation` / `foundation` | 高 |
+| Feature `package.json` 依赖另一 Feature | 高 |
+| 可复用 Feature import `@/stores/*` | 高 |
+| Feature 直接依赖 `@acme/foundation` | 高 |
+| 子包写死第三方版本（不用 `catalog:`） | 高 |
+| `Domain` / `infra` / `core` 当层名 | 中 |

package/templates/ai-tools/rules/iOS/dwy-apple-layering.md

@@ -0,0 +1,133 @@
+---
+description: iOS / macOS 四层分包与依赖方向（双壳 Assembly + Features / BizFoundation / Foundation）；根 Package.swift 锁定第三方版本
+paths:
+  - "**/*.swift"
+  - "**/Package.swift"
+  - "**/project.yml"
+---
+
+# Apple 四层架构与依赖
+
+适用于 iOS 17+ / macOS 14+ 的 SwiftUI 双端或单端应用。风格 / 安全区 / 国际化见 `dwy-swift-core`。本文件只管**层、引用边、版本写在哪**。
+
+单壳（只有 iPhone 或只有 Mac）**不建** PlatformFoundation。双壳且某端领域字节级不同时才加 `DesktopKit`。
+
+系统框架就叫 `Foundation`。SPM **target 禁止叫 `Foundation`**，层目录可以用这个名字。
+
+---
+
+## 一、层名（冻结）
+
+正式层名只有下表四个。目录 / target 可以叫 `AppPhone`、`BizFoundation`，文档可写「本仓 LogKit = Foundation 层的日志」。**禁止**把 `Domain` / `infra` / `core` 当层名。
+
+| 层 | 判定（只用这一条） | 禁止 |
+|---|---|---|
+| **Foundation** | 换一个完全不同的产品仍原样拿走 | 出现本业务名词 |
+| **BizFoundation** | 本产品才有，但跨多个 Feature 都要用 | 页面、导航、某一端壳状态 |
+| **Features** | 可整包删/裁剪的业务域 | 被其他 Feature 直接引用 |
+| **Assembly** | 生命周期、DI、路由挂载、把实现插进 Protocol | 业务规则、业务计算 |
+
+可选第五盒，**仅多壳**时出现：
+
+| **PlatformFoundation** | 同一业务多个壳，且某端领域字节级不同 | 被其他壳 import；塞回 BizFoundation |
+
+升层：第二个 Feature 或第二个产品**真在用**，才升到 BizFoundation / Foundation。禁止「可能复用」提前抽。禁止为了共用而抽 `AppShared` 把壳状态（Store / Session）塞进 BizFoundation。
+
+业务内聚：一个业务域 = 壳内 `Features/<Name>/`。禁止按 `Views/` `ViewModels/` 横切。目录不等于层：Features 若与壳同一 target，仍遵守互不 import 的源码边界。
+
+---
+
+## 二、依赖边（强制）
+
+```
+AppPhone  ──► Features/* ──► BizFoundation ──► Foundation 层目录（LogKit / DesignKit）
+AppDesktop ─┬► Features/*
+            ├► DesktopKit ──► BizFoundation ──► Foundation 层目录
+            └► BizFoundation
+```
+
+| 谁 | 允许 | 禁止 |
+|---|---|---|
+| `AppPhone` | `BizFoundation`、Foundation 层 target、本壳 Features | `DesktopKit`、另一壳源码 |
+| `AppDesktop` | `BizFoundation`、`DesktopKit`、Foundation 层 target、本壳 Features | `AppPhone/**/*.swift` |
+| 本壳 `Features/Orders` | `BizFoundation`、本壳 App 装配类型 | `Features/Inventory`、另一壳 |
+| `BizFoundation` | Foundation 层 target（日志 / 工具，**禁止** DesignKit） | 任一壳、DesktopKit |
+| Foundation 层 target | 系统框架、风格无关工具 | 业务类型、壳 |
+| `DesktopKit` | `BizFoundation`、Foundation 层 target | `AppPhone`、DesignKit（几何数字用测试锁同值，或升到壳） |
+
+**Feature 互引为零。** 跨域走 BizFoundation Protocol，或壳编排。
+
+`AppPhone` 禁止 `import DesktopKit`。不要抽 `AppShared`。
+
+```swift
+// Package.swift：BizFoundation 不依赖壳
+.target(
+    name: "BizFoundation",
+    dependencies: ["LogKit"]  // Foundation 层 target，不是系统 Foundation
+)
+```
+
+```swift
+// 禁止
+import DesktopKit    // 写在 AppPhone
+import AppPhone      // 写在 BizFoundation
+```
+
+---
+
+## 三、分包树
+
+打开工程必须能数出：两个壳（或一个壳）+ `Features` + `BizFoundation` + Foundation 层目录。
+
+```
+AppPhone/                         # Assembly 壳
+  App/                            # 装配：路由、DI、生命周期
+  Features/
+    Orders/
+    Inventory/
+AppDesktop/                       # 另一个 Assembly 壳（单壳则省略）
+  App/
+  Features/
+    Orders/
+    Inventory/
+Sources/
+  BizFoundation/                  # target: BizFoundation
+  Foundation/                     # 层目录；target 用 LogKit / DesignKit
+  DesktopKit/                     # PlatformFoundation，仅 AppDesktop 依赖
+Package.swift                     # from: 只在这
+project.yml                       # 壳引用这一份 package，不重复 from:
+```
+
+---
+
+## 四、Monorepo 版本（强制）
+
+第三方版本号**只**出现在根 `Package.swift` 的 `.package(..., from:)`。target 只写 product / 本地 target 名。`project.yml` 引用这一份 package，不重复版本。选哪个版本走 skill `dwy-dependency-choice`。
+
+```swift
+dependencies: [
+    .package(url: "https://github.com/apple/swift-log.git", from: "1.5.0"),
+]
+targets: [
+    .target(name: "LogKit", dependencies: [
+        .product(name: "Logging", package: "swift-log"),
+    ]),
+    .target(name: "BizFoundation", dependencies: ["LogKit"]),
+]
+```
+
+禁止第二个 `Package.swift` 再写同一依赖的 `from:`。禁止 target 注释里另写版本。
+
+---
+
+## 五、检查清单
+
+| 检查项 | 严重 |
+|---|---|
+| `AppPhone` import `DesktopKit` 或编译另一壳 `.swift` | 高 |
+| `BizFoundation` import 壳类型 / DesignKit | 高 |
+| 壳内 Features 互相 import | 高 |
+| SPM target 名为 `Foundation`（与系统框架撞名） | 高 |
+| 第二个 Package.swift / project.yml 重复 `from:` | 高 |
+| 抽 `AppShared` 把 Store / Session 塞进 BizFoundation | 高 |
+| `Domain` / `infra` / `core` 当层名 | 中 |

package/templates/ai-tools/rules/iOS/dwy-swift-core.md

@@ -4,6 +4,8 @@ paths:
   - "**/*.swift"
 ---
 
+分层、双壳依赖、Package.swift 版本锁定见 `dwy-apple-layering`。本文件只管写法与体验基线。
+
 ## iOS 目标与写法
 
 - iOS 最低版本 17.0+，不为 16 及以下做兼容分支。

package/templates/ai-tools/rules//345/274/200/345/217/221/346/265/201/347/250/213/dwy-code-craft.md

@@ -0,0 +1,83 @@
+---
+description: 编码大局观与行文准则（动笔前四问、第二次才抽、扩展靠加文件、反屎山、行为变更先写失败测试）。编辑源码时注入。
+paths:
+  - "**/*.{py,ts,tsx,vue,js,jsx,kt,kts,swift,ets,dart}"
+---
+
+# 编码大局观
+
+写代码不是完成这个函数，是让这个 Feature 六个月后还能改。
+可维护 = 改一处全处对，不是提前设计未来。可扩展 = 新需求落成新文件，不是到处留钩子。
+
+分层规则管包边界；本文件管「这一份代码怎么长」。
+
+## 一、动笔前四问
+
+写之前在思考里过完，不必问用户。答不出 → 先搜再写。
+
+1. 这段代码属于哪一层、哪个 Feature？
+2. 同 Feature 里有没有同类页 / 同类接口？
+3. 这次需求会让哪几处**一起变**？
+4. 同类需求再来一次：是**加新文件**，还是给这堆 `if` 加分支？
+
+## 二、五条行文
+
+| 原则 | 判定 | 禁止的误读 |
+|---|---|---|
+| **第二次才抽** | 同一 UI 骨架 / 同一业务规则出现 ≥2 次才抽；1 次保持原地 | 第一份就抽 `BaseXxx`、`useCommon` |
+| **扩展 = 加新文件，不改旧文件** | 新页面、新字段、新状态应能新增，不必改已有页面 | 预留 `options` / plugin / `if type ===` 大开关 |
+| **先找同类，再写这一份** | 写前同 Feature 内搜列表/表单/详情，对齐结构；80% 相同抽组件或 composable，20% 用参数/slot | 每页从零写一套表格+筛选+分页 |
+| **按「为什么会改」拆** | 筛选条件变了不该动列定义；权限变了不该动请求封装 | 一个文件里塞请求、表格、弹窗、权限、格式化 |
+| **复制允许，分叉必须收口** | 第一份可以照着抄；第二份会出现且会一起改 → 本轮就抽 | 「先复制五份以后再整理」 |
+
+## 三、屎山预警
+
+出现任一条：**停手拆，不准继续往上堆。**
+
+- 第三份复制
+- 一个文件混了 ≥3 种变化原因（请求 / 表格 / 弹窗 / 权限搅在一起）
+- 用 `type` / `flag` 区分本该是新文件的行为
+- 在已经难读的文件末尾再追加大段逻辑
+- 跨 Feature 直接 import「图省事」（升层 / Protocol / 壳编排，见对应 `dwy-*-layering`）
+
+## 四、自进化
+
+两环，**不改本文件**。项目私货写 `project-rules`，不往全局准则里追加。
+
+| 环 | 何时 | 做什么 | 不做什么 |
+|---|---|---|---|
+| **任务内收口** | 本轮会变成第 2 份重复，或正在改的文件因本次变更更乱 | 本轮抽/拆完才能说做完 | 不顺手重构无关文件 |
+| **仓库自成长** | 同类屎山/坑 ≥2 次 | 写入 `project-rules`（现象 / 根因 / 怎么避免） | 一次性问题不立条 |
+
+发现本 Feature 已有更好结构：新代码跟那个结构；抽出时把旧的那份一并收口。禁止发明第三套风格。
+
+## 五、和「简单优先 / 精准改动」共存
+
+| 借口 | 现实 |
+|---|---|
+| 「先写完以后再抽」 | 第 2 份出现就是抽的时机，本轮做完 |
+| 「用户只要这个页面」 | 要的是可维护的页，不是又一座孤岛 |
+| 「和精准改动冲突」 | 为消灭重复而改第一份，算本需求，不算「改进相邻代码」 |
+| 「先留 options 方便扩展」 | 扩展靠加文件，不靠预留钩子 |
+| 「这是简单优先」 | 简单 = 少概念、短路径；不是复制五份 |
+
+红线仍在：大重构、换架构、清理无关死代码，仍须用户明确要求。
+
+## 六、行为变更与测试位置
+
+行为变更（新功能、修 bug、会改变可观察行为的重构）先写失败测试，再写实现。文案、注释、Markdown、CI 配置直接改。
+
+- 测试放独立目录并镜像源码：`src/foo/bar.ts` → `tests/foo/bar.test.ts`；Python 用 `tests/test_*.py`。禁止把测试和 fixture 写进业务 `src/`。
+- Android 用 Gradle 测试源集 `src/test/`、`src/androidTest/`，与 `src/main` 分开，这是合规写法。
+- 上面没覆盖的栈：独立测试目录 + 镜像源码 + 该生态主流 runner。栈内目录细则见对应 `dwy-*-testing`。
+- 改完只跑受影响的测试。改了公共 fixture 或 `conftest.py` 就全量。提交前不要求全量，全量留给 CI。
+- 基础库的 `TEST_CASES.md` 跟测试目录走（`tests/TEST_CASES.md`），和测试文件一起改。
+
+## 七、提交前检查
+
+- [ ] 四问过完，同类已搜过
+- [ ] 没有新增第 2 份未抽取的重复
+- [ ] 没有用 flag/type 把本该新文件的行为塞进旧文件
+- [ ] 正在改的文件没有因本次变更更难拆
+- [ ] 踩同类坑 ≥2 次已写入 `project-rules`
+- [ ] 行为变更先有失败测试，测试不在业务 `src/` 里