@hupan56/wlkj 2.2.3 → 2.2.5

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

@@ -1,141 +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`)
+---
+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

@@ -1,69 +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 问题提出建议，不自行修改
+---
+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

@@ -1,67 +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
+---
+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 确认后调度