@hupan56/wlkj 2.0.0

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

@@ -0,0 +1,67 @@
+---
+name: wl-init
+description: "初始化/切换开发者身份 + 环境体检。Initialize/switch developer identity + environment health check. 用户说'初始化''我是谁''换开发者''环境检查''/wl-init''设置一下''开始用'时触发。"
+trigger: "首次使用、换人、或遇到环境问题时；用户说'初始化''换开发者''环境检查''体检'"
+---
+
+# wl-init — 开发者身份 + 环境体检
+
+幂等、增量。**绝不删除 workspace**，绝不覆盖 member.json / task.json。
+
+## 触发场景
+
+1. **首次使用本工具**：注册身份 + 全套体检 + 自愈
+2. **换人/切换开发者**：写 `.qoder/.developer`，重定向 workspace 到新成员目录
+3. **环境出问题**（索引不对、搜不到、脚本报错）：体检 + `--fix` 自愈
+4. **拉取团队最新**：体检时自动 `team_sync.py pull`
+
+## 执行
+
+### 无参数（仅体检）
+```bash
+python .qoder/scripts/init_doctor.py
+```
+输出 8 段体检报告，每行 `[OK]/[WARN]/[FIX]/[MISS]` 标注。
+
+### 带名字（注册 + 自愈）
+```bash
+python .qoder/scripts/init_doctor.py --fix <名字> [角色]
+# 例：python .qoder/scripts/init_doctor.py --fix 小王 pm
+```
+做 3 件事：
+1. 写 `.qoder/.developer`（key=value 格式）
+2. `team_sync.py pull` 拉团队最新（图谱/PRD/任务）
+3. 按 WARN 清单逐项 `--fix`（缺索引就建、缺模板就拷、git user.name 不一致就改）
+
+### 仅自愈（不换人）
+```bash
+python .qoder/scripts/init_doctor.py --fix
+```
+
+## 体检覆盖的 8 段
+
+| 段 | 检查内容 | 出问题的后果 |
+|----|---------|------------|
+| 1 基础环境 | Python 3 / git 可用 | 全部脚本跑不了 |
+| 2 开发者身份 | `.developer` 存在且与 git user.name 一致 | /wl-report 统计丢 |
+| 3 团队同步 | 是否 >24h 未 pull | 拿不到队友 PRD/任务 |
+| 4 源码仓库 | `data/code/` 三个项目在 | 搜不到代码 |
+| 5 知识图谱 | `data/index/*.json` 新鲜（≤7 天） | 搜索结果过期 |
+| 6 风格约束 | vben/chart/icon/style JSON + 原型模板 | 原型风格跑偏 |
+| 7 PRD 模板 | prd-full/quick 模板 + rules + AGENTS.md | PRD 生成不规范 |
+| 8 周五任务 | 本机是否设了 cron | 图谱是否自动保鲜 |
+
+## 输出规则
+
+- 体检完打印一句总结：「环境健康，可以开始工作：/wl-prd <需求>」或「N 个问题待修，加 --fix 自愈」
+- 如果用户没给名字但 `.developer` 不存在：先问"你叫什么名字？角色是 pm/dev/design？"
+- 如果 git user.name 与开发者名不一致：在体检里 `[WARN]` 提示，`--fix` 会自动改
+
+## 完成后
+
+体检/注册本身不需要 push（只改本地 `.developer`）。但若 `--fix` 触发了图谱重建，
+完成后建议跑一次：
+```bash
+python .qoder/scripts/team_sync.py push
+```
+让队友拿到刷新后的索引。

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

@@ -0,0 +1,81 @@
+---
+name: wl-insight
+description: "反馈分析 + 数据指标复盘。Feedback analysis + metrics review. 用户说'用户反馈''数据怎么样''转化漏斗''留存分析''痛点''北欧星指标''A/B 结果'时触发。"
+trigger: "用户说'用户反馈''数据怎么样''转化''留存''痛点''指标''洞察''/wl-insight'"
+---
+
+# wl-insight — 反馈分析 + 指标复盘
+
+两类分析（用户没指定就问要做哪种）：
+
+## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
+
+- `.qoder/.developer` — 当前分析师
+- `.qoder/learning/feedback.jsonl` — 历史反馈记录（可能为空）
+- 用户需提供：反馈原文 / 指标数据（CSV、表格、口述均可）
+- 若用户既没给反馈也没给数据：先问"你是要分析用户反馈，还是看业务指标？数据在哪？"
+
+## 类型 1：feedback（反馈分析）
+
+输入：用户反馈原文（一条或多条）
+
+分析步骤：
+1. **分类**：feature_request / bug / UX / performance / praise / question
+2. **情感**：正面 / 中性 / 负面
+3. **痛点提取**：频率 × 严重度 排序，Top 10 带原文引用
+4. **建议**：每个高频痛点对应一个改进方向（可挂到 /wl-task）
+
+输出结构：
+```
+# 反馈分析报告 - <日期>
+
+## 概览
+- 总条数 / 正负比 / Top3 分类
+
+## 痛点 Top 10
+| 排名 | 痛点 | 频次 | 严重度 | 代表原文 | 建议动作 |
+|------|------|------|--------|---------|---------|
+
+## 可落地改进
+- 建议 A → 可建任务（说"建任务"触发 /wl-task）
+- 建议 B → ...
+```
+
+## 类型 2：metrics（指标复盘）
+
+输入：业务指标数据
+
+分析维度：
+- **北极星指标**：当前值 + 趋势 + 分解（拆到可执行子指标）
+- **留存**：D1 / D7 / D30，与行业基准对比
+- **漏斗**：每步转化率，找最大流失点
+- **A/B 实验**：显著性 + 效果量 + 结论
+- **OKR 对齐**：当前进度 vs 目标
+- **异常归因**：突增/突降的可能原因
+
+输出结构：
+```
+# 指标复盘 - <日期/周期>
+
+## 北极星
+值 / 趋势 / 距目标差距
+
+## 关键漏斗
+各步转化 + 瓶颈标注
+
+## 留存
+D1/D7/D30 + 同比
+
+## 结论与建议
+- 加速 X / 止血 Y / 实验 Z
+```
+
+## 类型 3：all（综合）
+
+交叉引用 feedback + metrics：反馈里的痛点是否反映在指标异动上。
+
+## 输出 + 保存
+
+保存到 `workspace/members/{dev}/drafts/wl-insight-{type}-{YYYY-MM-DD}.md`。
+
+> insight 报告默认不 push（属于个人分析草稿）。用户说"发出去/同步"才跑 team_sync push。

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

@@ -0,0 +1,87 @@
+---
+name: wl-report
+description: "生成日报/周报，严格按当前开发者隔离。Generate daily/weekly work report, isolated by current developer. 用户说'写日报''周报''我今天干了啥''这周做了什么''出个报告'时触发。"
+trigger: "用户说'日报''周报''我干了啥''今天做了什么''本周工作''出报告''/wl-report'"
+---
+
+# wl-report — 日报 / 周报（按开发者隔离）
+
+> ⚠️ 所有数据严格按当前开发者过滤。`.developer` 未设置 → 拒绝并提示先 `/wl-init`。
+
+## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
+
+- `.qoder/.developer` — **必需**。未设置则停止，提示用户先初始化
+- `.qoder/.current-task` — 当前任务
+- `workspace/members/{dev}/journal/` — 历史日报/周报
+- `workspace/members/{dev}/drafts/` — 今日/本周产出的 PRD/原型草稿
+
+## 模式自动判断
+
+- **周五**（周一=1，周五=5）→ 周报模式
+- 其他工作日 → 日报模式
+- 用户明说"周报/日报" → 覆盖自动判断
+
+## 数据采集（全部按当前开发者过滤）
+
+```bash
+# 1. 我的任务
+python .qoder/scripts/task.py list --mine
+
+# 2. 我的提交（按 git author 过滤）
+git log --author=<开发者名> --since="<时间范围>" --pretty=format:"%h %s (%ar)" --no-merges
+
+# 3. 我的产出（drafts 目录按时间筛）
+# 读 workspace/members/{dev}/drafts/ 下今日/本周改动的文件
+```
+
+## 报告结构（中文）
+
+### 日报
+```
+# 工作日报 - <开发者> - <日期>
+
+## 今日完成
+- [任务名] 具体做了什么（基于 git commit + task finish）
+
+## 进行中
+- [任务名] 当前进度
+
+## 明日计划
+- （从 in_progress 任务 + roadmap 推断）
+
+## 阻塞/风险
+- （如有）
+```
+
+### 周报
+```
+# 周报 - <开发者> - <周范围>
+
+## 本周完成
+- 按任务/需求维度汇总，不按天
+
+## 关键产出
+- PRD: REQ-XXX
+- 原型: prototype-xxx.html
+- 提交数: N
+
+## 下周计划
+- （从 roadmap Next 段取）
+
+## 反思/改进
+- （可选，从 learning/feedback 推）
+```
+
+## 输出 + 同步
+
+保存到 `workspace/members/{dev}/journal/{YYYY-MM-DD}-{daily|weekly}.md`，然后：
+```bash
+python .qoder/scripts/team_sync.py push
+```
+让团队/上级看到。
+
+## 输出规则
+
+- 报告是中文，简洁（日报 ≤20 行，周报 ≤40 行）
+- 不要把 git log 原文贴进去，提炼成"做了什么"
+- 如果某天没提交也没 finish 任务，如实写"今日主要在调研/评审，无代码产出"，不编造

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

@@ -0,0 +1,75 @@
+---
+name: wl-search
+description: "查代码/业务/API/字段/PRD 的唯一入口。Search code index by keyword, API, style, field, PRD. 用户说'查一下''代码在哪''搜保险''考勤API''字段含义''帮我找''有哪些''哪些文件'时触发。"
+trigger: "用户问代码/业务/API/字段/页面在哪，或说'查''搜''找''有哪些文件''定位'"
+---
+
+# wl-search — 代码/知识图谱搜索
+
+> ⚠️ 这是查代码/业务/API 的**唯一入口**。禁止直接 grep `data/code/` 全库。
+
+## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
+
+- `data/index/.index-meta.json` — 图谱新鲜度；若 >7 天或不存在，提示用户
+  "知识图谱可能过期，建议先说'初始化'（/wl-init）刷新"，但不要阻塞本次搜索
+- 平台意图：用户提到"Web/PC/管理端"→ `--platform web`；
+  "APP/H5/移动端"→ `--platform app`；不明确就不加该 flag
+
+## 执行
+
+直接把用户的查询关键词传给脚本（脚本自带中文扩展 + 平台过滤）：
+
+```bash
+# 关键词搜代码（最常用）
+python .qoder/scripts/search_index.py <关键词> [--platform web|app]
+
+# 搜 PRD
+python .qoder/scripts/search_index.py --prd <关键词>
+
+# 搜 API 路径
+python .qoder/scripts/search_index.py --api <关键词>
+
+# 搜字段用法（返回字段标签 + 使用文件）
+python .qoder/scripts/search_index.py --field <字段名>
+
+# 搜同类页面示例（table/form/detail/modal/dashboard）
+python .qoder/scripts/search_index.py --style <类型> [--platform web|app]
+
+# 浏览所有关键词 Top50
+python .qoder/scripts/search_index.py --list
+
+# 项目模块概览
+python .qoder/scripts/search_index.py --modules
+
+# 组件使用统计
+python .qoder/scripts/search_index.py --components
+```
+
+如果用户没给关键词，跑 `--list` 列出热门关键词让用户选。
+
+## 结果使用规则
+
+脚本返回的是**紧凑结果**（每组最多 5 个文件，路径已缩短）：
+1. 从结果里挑最相关的 2-3 个文件
+2. **只读这几个文件**（用 Read 工具）
+3. 基于读到的真实代码回答用户问题
+4. 不要把脚本原始输出整个贴给用户 —— 提炼后再回答
+
+## 高频场景对照
+
+| 用户问法 | 该跑的命令 |
+|---------|-----------|
+| "考勤代码在哪" | `search_index.py 考勤` 或 `attendance` |
+| "保险定时任务" | `search_index.py 保险` |
+| "薪资 API" | `search_index.py --api salary` |
+| "nickName 字段在哪用" | `search_index.py --field nickName` |
+| "列表页有哪些例子（Web）" | `search_index.py --style table --platform web` |
+| "保险相关的 PRD" | `search_index.py --prd 保险` |
+
+## 一次取全（推荐用于写 PRD/Spec 前）
+
+如果要一次性拿到代码+页面+字段+PRD+API+样式+图标，用 Fast Path：
+```bash
+python .qoder/scripts/context_pack.py <业务词> --platform <web|app>
+```
+返回 7 个章节的 markdown，比逐个 search 更省轮次。

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

@@ -0,0 +1,61 @@
+---
+name: wl-status
+description: "项目状态/路线图/健康度。Project status: current sprint / roadmap / health score. 用户说'项目怎么样''进度''健康度''路线图''现在在做什么''整体情况'时触发。"
+trigger: "用户说'项目怎么样''进度''健康度''路线图''整体情况''/wl-status'"
+---
+
+# wl-status — 项目状态总览
+
+三个维度，用户没指定就全展示：
+
+## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
+
+- `.qoder/.developer` — 当前开发者
+- `data/index/.index-meta.json` — 图谱新鲜度（健康度计算用）
+- `.qoder/learning/eval-history.jsonl` — EVA 评估历史（健康度趋势用，可能不存在）
+- `workspace/tasks/*/task.json` — 全部任务（current 维度用）
+
+## 维度 1：current（当前迭代）
+
+```bash
+python .qoder/scripts/task.py list
+```
+展示：
+- 当前活动任务（标 `*` 的那条）
+- 进行中任务清单 + 各自进度
+- 最近 5 个动作（建任务/finish/PRD 发布等，从 task.json 的 status 历史推）
+
+## 维度 2：roadmap（路线图）
+
+从任务的优先级 + 依赖关系（parent/child）整理：
+- **Now**：当前迭代（in_progress 任务）
+- **Next**：P1/P2 且依赖已就绪的任务
+- **Later**：P3 或依赖未就绪的任务
+- 阻塞项单独标出
+
+## 维度 3：health（健康度）
+
+加权评分（满分 5）：
+
+| 指标 | 权重 | 数据源 |
+|------|------|--------|
+| EVA PRD 合格率 | 25% | eval-history.jsonl 最近 10 次 PASS 比例 |
+| 索引新鲜度 | 20% | .index-meta.json 的 last_sync 距今天数 |
+| 按时交付 | 20% | 近期 task finish 是否在计划期内 |
+| 团队同步 | 15% | `team_sync.py status` 的 ahead/behind |
+| 流水线流转 | 10% | task 在各阶段的停留时长 |
+| 学习成长 | 10% | learning 记录条数 |
+
+判定：≥4 健康 / 3–4 有风险 / <3 需关注。
+
+## 团队同步健康（必跑）
+
+```bash
+python .qoder/scripts/team_sync.py status
+```
+看 ahead/behind 是否对齐，未同步产出有几个。
+
+## 输出规则
+
+一段总览 + 三个分维度小节。健康度分数醒目显示。发现问题（如索引过期、
+未同步堆积、EVA 合格率低）在结尾列"建议动作"清单。

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

@@ -0,0 +1,58 @@
+---
+name: wl-task
+description: "任务管理 + RICE 优先级排序。Task management with RICE prioritization. 用户说'建任务''排优先级''开始做这个''任务做完了''列一下任务''归档'时触发。"
+trigger: "用户说'建任务''排优先级''开始做''做完了''看任务''归档''/wl-task'"
+---
+
+# wl-task — 任务管理 + RICE 排序
+
+任务存在 `workspace/tasks/{MM-DD-slug}/`，含 `task.json` + `prd.md` + `implement.jsonl` + `check.jsonl`。
+
+## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
+
+- `.qoder/.developer` — 当前开发者（assignee 默认值）
+- `.qoder/.current-task` — 当前活动任务（如有，"开始做"默认对它操作）
+- 列出已有任务：`python .qoder/scripts/task.py list`
+
+## 子命令对照
+
+| 用户说什么 | 跑什么 |
+|-----------|--------|
+| "建个任务 XXX" | `task.py create "XXX" [--slug ...] [--priority P0\|P1\|P2\|P3]` |
+| "列一下任务" / "我的任务" | `task.py list [--mine] [--status in_progress]` |
+| "看下 XXX 任务" | `task.py show <task-dir>` |
+| "开始做 XXX" | `task.py start <task-dir>` |
+| "这个任务做完了" | `task.py finish` |
+| "归档 XXX" | `task.py archive <task-dir>` |
+| "把 A 拆成子任务 B" | `task.py add-subtask <parent> <child>` |
+
+完整用法：
+```bash
+python .qoder/scripts/task.py create "登录优化" --slug login-fix --priority P1
+python .qoder/scripts/task.py start 06-13-login-fix
+python .qoder/scripts/task.py current --source      # 看当前活动任务
+python .qoder/scripts/task.py list --mine --status in_progress
+python .qoder/scripts/task.py finish
+python .qoder/scripts/task.py archive 06-13-login-fix
+python .qoder/scripts/task.py add-subtask 06-13-parent 06-13-child
+```
+
+## RICE 优先级（建/排时自动算）
+
+RICE = Reach × Impact × Confidence ÷ Effort
+- 建任务时若给了 `--priority`，写入 task.json
+- "排优先级"指令：扫所有任务，让用户给每个 R/I/C/E 打分（或从 task.json 读已有值），重算排序
+
+## 完成后同步
+
+`create` 和 `finish` 改了任务状态，要推给团队：
+```bash
+python .qoder/scripts/team_sync.py push
+```
+（脚本会自动 stage workspace/tasks/ 并提交）
+
+## 输出规则
+
+- `list` 结果用表格呈现（任务名 | 状态 | 优先级 | 负责人），当前任务标 `*`
+- `create` 后告诉用户任务目录路径 + 下一步建议（"接 /wl-prd 写需求" 或 "/wl-spec 写规格"）
+- `finish` 后提示是否归档 + 跑 `/wl-report` 出日报

package/templates/qoder/templates/prd-full-template.md

@@ -0,0 +1,103 @@
+# PRD 完整模板（团队标准）
+
+> 来源: data/docs/constitution/prdtemplate/PRD通用模板-纯框架版.docx（团队章程）
+> 适用: Reference / Brainstorm / Planning 模式生成的正式 PRD
+> 规则: 以下章节为团队标准结构，生成 PRD 时**必须全部包含**（不适用的章节写"无"，不可省略标题）。
+> 在此基础上保留 QODER 的增强项：平台标注、原型链接、10项质量自检。
+
+---
+
+# REQ-{YYYY}-{NNN} {需求标题}
+
+## 前言
+
+### 版本信息
+| 版本号 | 创建日期 | 审核人 |
+|--------|---------|--------|
+| V1.0 | {YYYY.MM.DD} | {审核人} |
+
+### 变更日志
+| 时间 | 版本号 | 状态 | 变更人 | 主要变更内容 |
+|------|--------|------|--------|-------------|
+| {YYYY.MM.DD} | V1.0 | 新增 | {姓名} | 初版 |
+
+### 文档说明
+{编写目的、适用范围、关联文档链接。注明涉及端: Web 管理端 (fywl-ui) / APP 移动端 (Carmg-H5) / 两端}
+
+## 名词解释
+| 术语/缩略词 | 说明 |
+|------------|------|
+| {术语} | {定义} |
+
+## 需求背景
+
+### 需求来源
+{由谁提出、因何驱动: 业务投标/客户反馈/友商对标/数据分析发现等}
+
+### 产品现状
+{当前系统相关功能现状。引用 /wl-search 的发现: 现有页面、API、字段。无则写"无"}
+
+## 需求范围
+{涉及哪些端 (APP/PC/Web/API)、包含哪些功能点、边界。}
+
+## 功能详细说明
+
+### 涉及功能清单
+| 功能点 | 涉及渠道 | 改动类型 | 改动描述 |
+|--------|---------|---------|---------|
+| {功能1} | PC/APP | 新增/修改/优化 | {一句话} |
+
+### {N}. {功能名称}-{端}
+
+#### 总体说明
+{入口路径【XX模块】-【XX菜单】、页面区域组成、刷新方式和频率}
+
+#### 功能说明
+{排序规则、筛选条件及交互方式、列表展示字段}
+
+#### 字段规格说明
+| 字段 | 是否必填 | 列表显示 | 说明 |
+|------|---------|---------|------|
+| {字段1} | 是/否 | 是/否 | {最大长度/类型/数据来源等约束} |
+
+#### 操作与校验说明
+| 操作 | 场景 | 提示/二次确认说明 |
+|------|------|------------------|
+| {操作1} | {场景} | {最终文案，不写"提示用户XX"} |
+
+#### 状态机说明（如适用）
+{状态分类、映射关系、各状态下的展示与可用操作}
+
+#### 导出说明（如适用）
+{文件命名规则（含变量）、导出数据模板}
+
+#### 原型地址
+{prototype-{feature}.html 的路径；两端需求分别给 -web/-app 两个文件}
+
+## 非功能性需求
+{性能（响应时间/并发）、安全（权限）、兼容性（浏览器/系统版本）、可用性}
+
+## 埋点
+| 参数名 | 参数说明 | 参数值 |
+|--------|---------|--------|
+| {事件} | {含义} | {取值} |
+
+## 版本计划
+{目标版本号或上线日期}
+
+## 附录
+{原型链接汇总、竞品截图、接口文档引用、验收标准清单}
+
+---
+
+## 质量自检（QODER 10 项，发布前逐项确认）
+1. 需求背景回答了"为什么做"
+2. 目标可量化
+3. 用户画像具体
+4. 业务规则穷尽（含字段规格表）
+5. 每个功能至少 2 个异常场景（操作与校验表）
+6. 验收标准可测试（Given-When-Then）
+7. 埋点事件完整
+8. PRD 中无技术实现细节
+9. 功能点标注优先级 (P0/P1/P2)
+10. 版本计划落地

package/templates/qoder/templates/prd-quick-template.md

@@ -0,0 +1,69 @@
+# 零星需求 Mini-PRD 模板（团队标准）
+
+> 来源: data/docs/constitution/prdtemplate/零星需求PRD简易模板.docx（团队章程）
+> 适用: Quick 模式 / 小改动需求
+> 规则: 改动要素"涉及则填，不涉及则跳过"，但章节标题必须保留。
+
+---
+
+# {功能模块} - {改动摘要}
+
+> 标题让读者一眼知道改了什么，避免"XX功能修改"这类模糊表述。
+
+## 功能入口
+- 菜单路径：【XX模块】-【XX菜单】-【XX页面】
+- 涉及端：PC / APP / 后端 / 全端（纯后端写"后端，无前端入口"；APP 注明具体 APP）
+
+## 需求背景
+{1-2 句：为什么做？解决什么问题？谁提出的？}
+
+## 需求说明
+根据实际改动类型，从以下要素中选取相关项填写（涉及则填，不涉及跳过）：
+
+- **页面/入口调整**：新增/修改/移除的页面路径、按钮位置、tab、菜单项
+- **字段调整**：字段名、类型、最大长度、必填/选填、默认值、显示位置、显隐条件
+- **筛选/搜索调整**：筛选项、交互方式（单选/多选/模糊/日期）、数据源、默认值、防抖时长
+- **列表/表格调整**：列、排序规则、分页逻辑
+- **操作/按钮调整**：位置、启用/禁用条件、交互流程、二次确认文案、状态变更、反馈文案
+- **校验规则调整**：校验时机、条件、不通过提示文案
+- **业务规则/计算逻辑调整**：调整前后规则/公式对比、历史数据是否受影响
+- **流程/节点调整**：调整前后流程链、分支条件
+- **权限控制调整**：角色、粒度（菜单/页面/字段/按钮）、有无权限的表现差异
+- **数据/接口调整**：入参出参、数据来源、是否影响现有接口
+- **报表/看板调整**：统计维度、聚合公式、同比环比口径、导出模板、端侧差异
+- **附件/导出调整**：文件命名规则、导出模板列、图片命名存储规则
+- **文案/提示调整**：页面位置、修改前后文案对比
+
+填写格式示例（新增筛选项）：
+1. 新增内容：在［页面］的［位置］增加［筛选名称］筛选项
+2. 数据源：［字典接口/列表已有字段/其他］
+3. 交互方式：［单选/多选/模糊］，［默认值］
+4. 前端：［组件位置、与现有筛选的关系、防抖时长］
+5. 后端：［入参字段名、查询逻辑、是否影响现有接口］
+6. 其他约束：［切换时保留/清空筛选等］
+
+## 影响范围
+{可能受影响的功能、页面、接口 —— 用 /wl-search 验证后列出}
+
+## 验收标准
+- [ ] 在［条件］下，执行［操作］，预期结果为［描述］
+
+## 不在本次范围
+{显式排除易歧义内容，防止范围蔓延。无则留空}
+
+## 原型
+{prototype-{feature}.html 路径（只画 diff 部分）}
+
+---
+
+## 提交前自检（来自团队章程）
+- [ ] 功能入口路径完整可操作
+- [ ] 需求背景说清了"为什么做"
+- [ ] 涉及字段有完整规格（名称、类型、长度、必填）
+- [ ] 涉及交互有完整描述（正常流程和异常流程）
+- [ ] 涉及规则有调整前后对比
+- [ ] 所有弹窗/提示写了最终文案，而非"提示用户XX"
+- [ ] 状态变更描述了从什么状态到什么状态
+- [ ] 涉及端标注清楚
+- [ ] 影响范围无遗漏
+- [ ] 不在本次范围的内容已显式排除