@hupan56/wlkj 2.0.0

package/templates/qoder/skills/prd-generator/SKILL.md

@@ -0,0 +1,180 @@
+---
+name: prd-generator
+description: "生成 PRD + 平台匹配的原型。Generate PRD with platform-aware prototype. 用户说'写个需求''生成PRD''做个原型''保单这块加个功能''写个产品需求文档'时触发。"
+trigger: "user describes a requirement, asks for PRD, mockup, or invokes /wl-prd"
+---
+
+# PRD Generator Skill
+
+## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
+
+会话开始时先读这 3 个文件（不存在就跳过，不要报错中断）：
+- `.qoder/.developer` — 当前开发者名（key=value 格式，用于产出存到 `workspace/members/{dev}/drafts/`）
+- `.qoder/.current-task` — 当前活动任务（决定 PRD 关联哪个 task）
+- `data/index/.index-meta.json` — 知识图谱新鲜度（过期要提示先 `/wl-init` 重建）
+
+读完后再判断是否要问平台（见 Step 0）。如果 `.developer` 不存在，先提示用户
+"还没初始化，建议先说'初始化'（/wl-init）注册开发者身份"，但不要阻塞。
+
+---
+
+## ⚠️ STEP 0: MANDATORY PLATFORM SELECTION (MUST DO FIRST!)
+
+**CRITICAL: You MUST ask this question BEFORE doing ANYTHING else.**
+**NEVER auto-detect. NEVER assume. NEVER skip. ALWAYS ASK.**
+
+**Copy and ask this exact question:**
+
+```
+这个需求是针对哪个平台？
+
+1. **Web 管理端** (fywl-ui) - Ant Design Vue + VxeGrid 风格
+2. **APP 移动端** (Carmg-H5) - Vant 风格  
+3. **两端都要**
+
+请选择 (1/2/3):
+```
+
+**Then WAIT for user answer before proceeding.**
+
+### Platform → Project Mapping
+
+| User Answer | Platform | Project | Component Library | Template |
+|-------------|----------|---------|-------------------|----------|
+| 1 或 Web/PC/管理端 | Web | fywl-ui | Ant Design Vue + VxeGrid | prototype-web.html |
+| 2 或 APP/H5/移动端 | APP | Carmg-H5 | Vant 3 + Element Plus | prototype-app.html |
+| 3 或 都要/两端 | Both | Both | Generate 2 prototypes | Both templates |
+
+### Search Command
+
+After user selects platform, use:
+```bash
+/wl-search <keyword> --platform web   # For Web
+/wl-search <keyword> --platform app   # For APP
+/wl-search <keyword>                  # For Both
+```
+
+---
+
+## How Each Mode Reads Data
+
+### Reference Mode (DEFAULT)
+1. **ASK PLATFORM FIRST** (Step 0 above)
+2. search_index.py <keyword> --platform <web|app>
+3. search_index.py --style <type> --platform <web|app>
+4. search_index.py --field <name>
+5. Read data/docs/prd/ for historical PRDs
+6. Read data/docs/drafts/ for business context
+7. Style tokens: Web -> data/index/vben-style-reference.json, APP -> Vant
+   variables. Only open data/style/ PDFs if a token is missing from JSON.
+8. Read top 2-3 similar Vue files from CORRECT project
+9. Present ALL findings as ONE numbered list, confirm in a single round
+   (batch, not one question per finding)
+10. Generate PRD with product-type template
+11. Generate interactive HTML prototype matching TARGET platform style
+
+### Brainstorm Mode
+1. **ASK PLATFORM FIRST** (Step 0 above)
+2. SCAMPER 7 dimensions
+3. 5-Why root cause analysis
+4. Dispatch N sub-agents (web search only)
+5. Read existing code from TARGET platform for style extraction
+6. Generate PRD + prototype (platform-specific)
+
+### Planning Mode
+1. **ASK PLATFORM FIRST** (Step 0 above)
+2. search_index.py for current implementation (platform-aware)
+3. Web search for ideal state
+4. Gap analysis table
+5. Generate PRD + prototype (platform-specific)
+
+### Quick Mode
+1. **ASK PLATFORM FIRST** (Step 0 above)
+2. search_index.py to locate code (platform-aware)
+3. Generate Mini-PRD + quick prototype (platform-specific)
+
+---
+
+## Platform-Specific Style Sources
+
+### Web 管理端 (fywl-ui)
+```
+样式来源: data/index/vben-style-reference.json
+组件库: Ant Design Vue + VxeGrid
+设计 Token: Vben Admin HSL 变量
+关键文件: data/code/fywl-ui/apps/xxx/index.vue
+原型模板: .qoder/templates/prototype-web.html
+```
+
+**CSS Variables (Web):**
+```css
+--primary: 212 100% 45%;        /* 蓝色 */
+--destructive: 359.33 100% 65.1%; /* 红色 */
+--success: 144 57% 58%;         /* 绿色 */
+--background-deep: 216 20.11% 95.47%; /* 灰底 */
+```
+
+### APP 移动端 (Carmg-H5)
+```
+样式来源: data/code/Carmg-H5/src/
+组件库: Vant 3 + Element Plus
+适配: postcss-px-to-viewport (vw) + lib-flexible (rem)
+关键文件: data/code/Carmg-H5/src/modules/xxx/index.vue
+原型模板: .qoder/templates/prototype-app.html
+```
+
+**Design Tokens (APP):**
+```css
+--van-primary-color: #1989fa;
+--van-success-color: #07c160;
+--van-warning-color: #ff976a;
+--van-danger-color: #ee0a24;
+max-width: 375px; /* 移动端基准 */
+```
+
+---
+
+## Prototype Generation Rules
+
+### Required Features
+- Style matches TARGET platform EXACTLY
+- Changed/new elements highlighted with subtle border
+- Interactive: clickable buttons, fillable forms
+- Single HTML file, self-contained
+- **Web**: Desktop layout, sidebar navigation
+- **APP**: Mobile layout, bottom tab bar, 375px width
+
+### Style Priority (when conflicts)
+1. Real .vue files in project (HIGHEST)
+2. data/style/ PDF specs
+3. vben-style-reference.json (framework default)
+4. If PDF vs Code conflict → **Code wins**
+
+---
+
+## PRD Templates (团队标准, MUST USE)
+
+Distilled from data/docs/constitution/prdtemplate/*.docx (团队章程源文件):
+
+| Mode | Template | Rule |
+|------|----------|------|
+| Reference / Brainstorm / Planning | .qoder/templates/prd-full-template.md | 所有章节必须保留（不适用写"无"） |
+| Quick | .qoder/templates/prd-quick-template.md | 改动要素涉及则填，章节标题保留 |
+
+Read the template file, fill it with the findings. The 10-point quality
+check below maps to the template's 自检 section. If the .docx 源文件更新了,
+re-distill the .md templates (wl-init doctor 会提示).
+
+---
+
+## Quality Self-Check (10 Items)
+1. Background answers "why"
+2. Goals are quantifiable
+3. User personas specific
+4. Business rules exhaustive
+5. Exceptions covered (2+ per feature)
+6. AC testable (Given-When-Then)
+7. Data events complete
+8. No tech implementation in PRD
+9. Priority tagged (P0/P1/P2)
+10. Schedule grounded

package/templates/qoder/skills/prd-review/SKILL.md

@@ -0,0 +1,36 @@
+---
+name: prd-review
+description: "评审 PRD 完整性与质量。Review PRD for completeness and quality. 用户说'评审PRD''PRD质量怎么样''检查一下这个需求文档'时触发。"
+trigger: "user invokes /review prd, asks to review/check PRD quality, or PM submits PRD"
+---
+
+# PRD Review Skill
+
+## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
+
+- `.qoder/.developer` — 当前评审人
+- `data/index/.index-meta.json` — 图谱新鲜度（影响"现实锚定"能否校验）
+- 评审的 PRD 文件路径由用户指定；若用户没给路径，扫 `data/docs/prd/` 和
+  `workspace/members/{dev}/drafts/` 列出最近的 PRD 让用户选
+
+## 评审检查项 (Checklist)
+- [ ] 用户故事清晰
+- [ ] 验收标准可测（Given-When-Then）
+- [ ] 优先级已标（P0/P1/P2/P3）
+- [ ] 模块/领域已识别
+- [ ] 非功能性需求已列
+- [ ] 边界情况已考虑（每个功能 ≥2 个异常场景）
+- [ ] 依赖已识别
+
+## 评审输出
+
+报告：PASS 或 列出需修复的问题清单
+若 PASS：更新任务状态为 prd_review passed
+
+## 自动化校验（推荐）
+
+跑一次 EVA 门禁给出客观分数：
+```bash
+python .qoder/scripts/eval_prd.py <PRD路径> [原型HTML路径]
+```
+分数 ≥80% 才能发布。低于 80% 把 EVA 报告的问题合并进上面的清单。

package/templates/qoder/skills/prototype-generator/SKILL.md

@@ -0,0 +1,141 @@
+---
+name: prototype-generator
+description: "生成匹配项目 UI 风格的交互式 HTML 原型（Web 端 fywl-ui 用 Vben Admin + Ant Design Vue；APP 端 Carmg-H5 用 Vant 3）。Generate interactive HTML prototypes matching project UI style. 用户说'做个原型''画个 mockup''看看效果''出个界面预览'时触发。"
+trigger: "user asks for prototype, mockup, UI preview, or when PRD needs visual illustration"
+---
+
+# Prototype Generator
+
+Generate production-ready HTML prototypes that match the project's actual UI style.
+
+## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
+
+- `.qoder/.developer` — 决定产出存到 `workspace/members/{dev}/drafts/`
+- 若 `.qoder/.current-task` 存在，原型命名带上任务关键词
+- 平台（Web/APP/Both）必须明确；如未指定，先问用户（见 prd-generator Step 0）
+
+## Step 0: Know the Platform
+
+The platform MUST already be decided (asked by /wl-prd Step 0).
+If you don't know it, STOP and ask the user (Web 管理端 / APP 移动端 / 两端都要).
+
+| Platform | Project | Template | Design Tokens |
+|----------|---------|----------|---------------|
+| Web | fywl-ui | .qoder/templates/prototype-web.html | data/index/vben-style-reference.json (HSL) |
+| APP | Carmg-H5 | .qoder/templates/prototype-app.html | Vant 3 variables (in template) |
+| Both | both | both templates | generate 2 files: -web.html and -app.html |
+
+## Style Sources (Priority Order)
+
+1. **data/code/** - Existing Vue code from the TARGET project (HIGHEST priority)
+2. **data/index/vben-style-reference.json** - Vben design tokens (Web)
+   / Vant variables baked into prototype-app.html (APP)
+3. **data/index/chart-style-reference.json** - Dashboard/big-screen/chart
+   idioms (REQUIRED for dashboard/看板/大屏/统计类原型)
+4. **data/style/** - PDF design specs (only if a token is missing above)
+
+If code conflicts with PDF, CODE WINS. The templates already contain the
+correct tokens — do NOT invent colors or copy Ant Design defaults
+(#1890ff is NOT this project's primary).
+
+## ⚠️ NEW-FEATURE prototypes MUST also anchor to real pages
+
+For a feature with NO existing page (e.g. brainstorm/new dashboard), the
+style must STILL come from the system, never from generic admin templates:
+
+1. Find the closest in-system page family:
+   `search_index.py --style <type> --platform <p>` + read 1-2 real pages
+2. Dashboard/看板/大屏类: read data/index/chart-style-reference.json and
+   choose the idiom — 大屏深蓝风 (dashboard/monitor 先例: 全国地图/驾驶舱)
+   or 浅色卡片风 (dashboard/workbench 先例: 工作台统计卡)
+3. Use REAL business vocabulary from the index (e.g. 异常三分类
+   人员作业异常/车辆异常/费用异常 comes from workbench/components/abnormal.vue)
+4. In the prototype header comment, cite which real files the style came from
+   — if you cannot name a source file, you have NOT done step 1.
+
+## Step 1: Determine Prototype Type
+
+Read the requirement to decide:
+- **Table page**: List with search form + data grid + actions
+- **Form page**: Create/edit form with validation
+- **Detail page**: Read-only data display
+- **Modal/Drawer**: Popup form
+- **Dashboard**: Charts + summary cards
+
+## Step 2: Load Style Context
+
+```bash
+# Find real example pages of this type in the target project
+python .qoder/scripts/search_index.py --style <table|form|detail|modal|dashboard> --platform <web|app>
+
+# Find similar existing pages by business keyword
+python .qoder/scripts/search_index.py <keyword> --platform <web|app>
+
+# Find field definitions (real field names + Chinese labels)
+python .qoder/scripts/search_index.py --field <field_name>
+```
+
+Then read the TOP 2-3 most similar existing Vue files to extract:
+- Table column titles/fields and widths
+- Form field layouts and component types
+- Button styles and positions
+
+## Step 3: Fill the Template
+
+Read the platform template and replace its placeholders:
+
+**prototype-web.html** (Web, Vben Admin HSL variables, sidebar layout, VxeGrid table):
+- `{{TITLE}}` - browser tab title
+- `{{MODULE_NAME}}` - sidebar/breadcrumb module name
+- `{{PAGE_NAME}}` - page name in breadcrumb
+- `{{SEARCH_FORM_FIELDS}}` - search form items (label + input/select)
+- `{{TABLE_HEADERS}}` - `<th>` cells using REAL column titles from code
+- `{{TABLE_ROWS}}` - `<tr>` rows with realistic sample data
+
+**prototype-app.html** (APP, Vant 3 variables, 375px, NavBar + TabBar):
+- `{{TITLE}}` - browser tab title
+- `{{PAGE_TITLE}}` - NavBar title
+- `{{LIST_ITEMS}}` - list cells (van-cell style)
+- `{{ITEM_TITLE}}` / `{{ITEM_DESC}}` - cell content
+
+Key design tokens already in the templates (do not override):
+- Web primary: `hsl(212 100% 45%)` via `--primary` (from vben-style-reference.json)
+- APP primary: `--van-primary-color: #1989fa`
+
+## ⚠️ Icons: NEVER emoji, ALWAYS the project's real icon system
+
+Source of truth: **data/index/icon-reference.json** (real usage counts +
+ready-to-paste SVGs extracted from the actual projects).
+
+- **Web (fywl-ui)**: Ant Design icons. Inline the SVG from icon-reference.json:
+  ```html
+  <span class="anticon">{svg from icon-reference.json web.svg.outlined[...]}</span>
+  <style>.anticon svg{width:1em;height:1em;fill:currentColor}</style>
+  ```
+  Most-used in the real app: Download(303x), Plus(171x), Delete, Search, Edit...
+- **APP (Carmg-H5)**: Vant font icons:
+  ```html
+  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/vant@4/lib/index.css">
+  <i class="van-icon van-icon-search"></i>
+  ```
+  Most-used: arrow-down, arrow, plus, cross, search...
+- An emoji (👤🚛💰⚠️...) anywhere in a prototype = automatic style FAIL.
+
+## Step 4: Highlight Changes + Interactivity
+
+- Mark NEW/CHANGED elements with the template's `highlight-new` class
+  (subtle border + legend), so reviewers see the diff at a glance
+- Minimal JavaScript: row click highlight, form expand/collapse,
+  tab switching, modal open/close, validation hints
+- Single self-contained HTML file, no external dependencies
+
+## Rules
+
+1. **ALWAYS match the TARGET platform style** - colors, spacing, fonts come
+   from the template + real code, never from memory
+2. **NEVER invent new patterns** - if the project uses VxeGrid, mimic VxeGrid
+3. **Use REAL fields** - column titles and field names must come from the
+   actual code found in Step 2, not made up
+4. **Prototype must be interactive** - clickable buttons, fillable forms, hover states
+5. **Save to** `workspace/members/{developer}/drafts/prototype-{feature}.html`
+   (Both platforms -> `prototype-{feature}-web.html` + `prototype-{feature}-app.html`)

package/templates/qoder/skills/spec-coder/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: spec-coder
+description: "严格按开发 Spec 实现代码。Implement code strictly following development Spec. 用户说'开始写代码''按规格实现''实现这个接口''把这个需求做出来'时触发。需用户确认（DANGEROUS）。"
+trigger: "Spec 已确认待实现时；用户说'开始写代码''按spec实现''/wl-code'"
+---
+
+# Spec Coder
+
+严格按开发 Spec 实现代码，生成符合团队规范的代码。
+
+> ⚠️ 这是 DANGEROUS 操作（会写源码）。执行前必须向用户确认。
+
+## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
+
+- `.qoder/.developer` — 当前开发者
+- `.qoder/.current-task` — 当前任务（含任务相关的 Spec 路径）
+- Spec 文件位置：`workspace/specs/REQ-{ID}-*.spec.md` 或 `workspace/tasks/{task-id}/spec.md`
+- 目标代码库：`data/code/`（fywl-ics 后端 / fywl-ui 前端 / Carmg-H5 移动端）
+
+## Step 1: 定位 Spec
+
+```bash
+ls workspace/specs/           # 全局 specs
+ls workspace/tasks/           # 任务内的 specs
+```
+
+如有多份 Spec，问用户现在实现哪一份。
+
+## Step 2: 读取上下文
+
+1. **Spec 文件**（必需）：开发规格
+2. **PRD 文件**（推荐）：原始需求，理解业务背景
+3. **现有代码风格**（必需）：用 search_index.py 找相关模块真实代码作参考
+   ```bash
+   python .qoder/scripts/search_index.py <模块关键词>
+   ```
+   读 top 2-3 个相似文件，照着它们的命名/结构/异常处理写
+4. **架构/数据字典**（如存在）：`.qoder/context/architecture.md`、`data-dictionary.md`
+   不存在就跳过，从现有代码推断
+
+## Step 3: 按 Spec 实现
+
+严格按 Spec 规格编码：
+- **数据层**: Entity → Mapper → Service → Controller
+- **接口层**: RESTful API，参数校验（JSR-303），统一 `Result<T>` 返回格式
+- **业务层**: 按 Spec 业务逻辑实现
+- **异常处理**: 按 Spec 定义的异常场景
+- **金额**: 一律 `BigDecimal`，不用 double/float
+
+## Step 4: 自检
+
+- 所有 Spec 定义的接口都已实现
+- 数据库字段与 Spec 一致
+- 命名/结构跟现有同类代码一致（不另起炉灶）
+- 无 TODO/FIXME 残留
+
+## Step 5: 提示生成测试
+
+实现完成后提示：
+```
+代码实现完成。说"写单元测试"可生成单元测试；说"提交"可走 commit 流程。
+```
+
+## 编码原则
+
+1. 先读后写（读现有代码再动手）
+2. Spec 是契约，严格实现
+3. 发现 Spec 问题提出建议，不自行修改
+4. 命名/风格跟周围代码走，不引入新范式

package/templates/qoder/skills/spec-generator/SKILL.md

@@ -0,0 +1,67 @@
+---
+name: spec-generator
+description: "从已确认的 PRD 自动生成开发 Spec 文档（技术规格说明）。Auto-generate development Spec documents from confirmed PRDs. 用户说'生成规格''写spec''出技术方案''把PRD转成开发文档'时触发。"
+trigger: "PRD 被确认/发布后自动触发；或用户说'生成Spec''写技术规格''/wl-spec'"
+---
+
+# Spec Generator
+
+从已确认的 PRD 生成开发 Spec 文档，遵循团队技术规范。
+
+## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
+
+- `.qoder/.developer` — 当前开发者
+- `.qoder/.current-task` — 当前任务（决定 spec 存到哪个 task 目录）
+- 扫描 PRD 来源目录：`data/docs/prd/`（已发布）+ `workspace/members/{dev}/drafts/REQ-*.md`（草稿）
+  找出还没有对应 Spec 的 PRD
+- 风格/字段参考：`python .qoder/scripts/search_index.py --field <字段名>` 查现有字段命名约定
+- 团队 Java 约定（MyBatis Plus + RESTful + BigDecimal 金额）写在本 skill 的 Step 3
+
+## Step 1: 定位 PRD
+
+```bash
+# 列出已发布的 PRD
+ls data/docs/prd/REQ-*.md
+# 列出当前开发者的草稿 PRD
+ls workspace/members/{developer}/drafts/REQ-*.md
+```
+
+找出"有 PRD 但无 Spec"的需求。如果有多份，问用户先做哪个。
+
+## Step 2: 读取上下文
+
+按优先级读取：
+1. **PRD 文件**（必需）：需求源
+2. **历史 Spec**（推荐）：扫 `workspace/specs/` 看同类需求的写法，照着写
+3. **现有代码风格**（推荐）：用 search_index.py 找相关模块的真实代码做参考
+4. **数据字典**（如有）：`.qoder/context/data-dictionary.md`（不存在则跳过，从现有 Entity 类推断）
+
+## Step 3: 分析并生成
+
+从 PRD 提取：
+- 每个用户故事 → 一个或多个 API 接口
+- 验收标准 → 接口入参/出参/错误场景
+- 数据需求 → 数据库表设计
+- 非功能性需求 → 约束章节
+
+## Step 4: 输出
+
+写到 `workspace/specs/REQ-{ID}-{module}.spec.md`（或 task 目录 `workspace/tasks/{task-id}/spec.md`）
+
+规则：
+- 每条 PRD 验收标准都映射到一个 Spec 测试用例
+- API 路径遵循 RESTful 约定
+- 表名遵循 `t_{module}_{entity}`
+- 金额字段必须用 `BigDecimal`
+- 不写 PRD 未定义的功能
+- Entity → Mapper → Service → Controller 全栈结构
+
+## Step 5: 通知
+
+报告给被分配的开发者评审。
+
+## 触发条件
+
+- 手动：用户说"生成 Spec"、"写技术规格"、"/wl-spec"
+- 任务驱动：PRD 评审通过后，下一步通常就是生成 Spec
+- 子 agent：可被 prd-generator 在 PRD 确认后调度

package/templates/qoder/skills/test-generator/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: test-generator
+description: "从已实现代码和 Spec 自动生成单元测试。Auto-generate unit tests from implemented code and Spec. 用户说'写单元测试''补测试''覆盖一下''写个test'时触发。需用户确认（DANGEROUS）。"
+trigger: "代码实现完成后；用户说'写测试''补单测''生成test''/wl-test'"
+---
+
+# Test Generator
+
+按团队规范，基于已实现代码和 Spec 生成单元测试。
+
+> ⚠️ 这是 DANGEROUS 操作（会写源码）。执行前必须向用户确认。
+
+## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
+
+- `.qoder/.developer` — 当前开发者
+- `.qoder/.current-task` — 当前任务
+- Spec 文件：`workspace/specs/REQ-{ID}-*.spec.md` 或 `workspace/tasks/{task-id}/spec.md`
+- 已实现代码：用 search_index.py 定位
+  ```bash
+  python .qoder/scripts/search_index.py <类名或模块关键词>
+  ```
+
+## Step 1: 定位待测代码
+
+```bash
+ls workspace/specs/REQ-{ID}-*.md  # Spec 文件（测试用例映射源）
+ls data/code/                     # 已实现代码库
+```
+
+把 Spec 匹配到对应的实现文件。
+
+## Step 2: 读取上下文
+
+1. **实现代码**（必需）：当前需求相关的 `data/code/` 文件
+2. **Spec 文件**（推荐）：测试用例映射来源
+3. **现有测试代码**（推荐）：用 search_index.py 找同类 Test 类，照着写
+   ```bash
+   python .qoder/scripts/search_index.py Test
+   ```
+
+## Step 3: 生成测试
+
+参照现有 Test 类的写法（命名、断言库、Mock 方式），不另起炉灶：
+
+### Service 层测试
+- 每个公开方法组一个测试类
+- Mock 所有外部依赖（Mapper、外部 Service、Redis 等）
+- 覆盖：正常路径、错误路径、边界条件
+
+### Controller 层测试
+- MockMvc 测端点
+- 校验参数校验
+- 校验返回格式
+
+### 测试方法约定
+- Given-When-Then 模式
+- `@DisplayName` 中文描述
+- 断言用 AssertJ（若现有代码用 JUnit 断言则跟随）
+- 测试数据用 Builder 模式
+
+## Step 4: 输出
+
+- 路径：`tests/{package-path}/{ClassName}Test.java`（跟随现有 test 目录结构）
+- 命名：`{TestedClassName}Test.java`
+- 每个测试方法独立（无执行顺序依赖）
+
+## 测试原则
+
+1. 正常路径 100%，错误路径 100%
+2. 核心业务边界条件全覆盖
+3. 无外部系统依赖（全 Mock）
+4. 测试方法之间无相互依赖

package/templates/qoder/skills/wl-commit/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: wl-commit
+description: "代码提交 + push + 同步，带质量门禁。Git commit + push + sync with pre-commit quality gate. 用户说'提交代码''commit''推上去''保存代码''提交一下'时触发。需用户确认（DANGERONS）。"
+trigger: "用户说'提交''commit''推上去''保存代码''提交一下''/wl-commit'"
+---
+
+# wl-commit — 代码提交 + 质量门禁 + 同步
+
+> ⚠️ DANGEROUS 操作（推代码到远端）。**执行前必须向用户确认提交信息。**
+> 注意区分：用户说"同步/保存产出"通常指 team_sync（推 PRD/任务/索引）；
+> 用户说"提交/commit 代码"才是本 skill（推源码改动）。
+
+## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
+
+- `.qoder/.developer` — 当前开发者（提交作者）
+- 当前工作目录的 `git status` 和 `git diff --stat` 看改了什么
+- `.qoder/.current-task` — 若有活动任务，提交信息关联任务 ID
+
+## 执行流程
+
+### Step 1: 看改动
+```bash
+git status
+git diff --stat
+git diff --cached --stat
+```
+
+### Step 2: 质量门禁（提交前自检）
+
+逐项检查，任何一项不过都暂停问用户：
+- [ ] 无 TODO / FIXME 残留（grep 一下）
+- [ ] 金额字段用了 BigDecimal（不出现 double/float 存钱）
+- [ ] 命名/风格跟周围代码一致
+- [ ] 若有对应 Spec：Spec 要求的接口/字段都覆盖了
+- [ ] 测试通过（如有测试）
+
+### Step 3: 生成提交信息
+
+按团队约定：
+```
+[ai-generated] <type>: <简述>
+
+<body 说明动机和关键改动>
+```
+type 选 feat / fix / refactor / docs / test / chore。
+
+### Step 4: 用户确认
+
+把"将要提交的文件 + 生成的 commit message"展示给用户，等确认。
+**用户没明确说"提交/确认"之前，不要真的 commit。**
+
+### Step 5: 提交 + 推送
+```bash
+git add <相关文件>            # 精确 add，不用 git add .
+git commit -m "<确认后的信息>"
+git pull --rebase             # 先拉远端
+git push
+```
+
+### Step 6: 记录学习
+
+把本次提交记入 `.qoder/learning/`（用于 /wl-report 和 /wl-status 统计）。
+
+## 与 team_sync 的区别（重要）
+
+| 场景 | 用什么 |
+|------|--------|
+| 提交**源码**改动（data/code/ 下的代码） | **wl-commit**（本 skill） |
+| 提交**产出**（PRD/任务/索引/原型） | `team_sync.py push` |
+| 两个都改了 | 先 wl-commit 推代码，再 team_sync push 推产出 |
+
+## 失败处理
+
+- `git push` 被拒（远端有新提交）→ `git pull --rebase` 解决后再推
+- 冲突 → 列出冲突文件，问用户怎么解决（不擅自改业务代码）
+- 质量门禁不过 → 列出问题，问用户是修复后提交还是强制提交（默认修复）