@hupan56/wlkj 2.5.0 → 2.7.0

package/templates/qoder/commands/optional/wl-insight.md

@@ -0,0 +1,275 @@
+---
+name: wl-insight
+description: "需求探索 + 外部调研 + 未来规划。流水线的'上游探索站'，负责发现需求、对标竞品、做 Gap 分析和 roadmap。把'该做什么、为什么做'想清楚，结论交给 /wl-prd-full 落地。"
+argument-hint: "[type: discover/research/plan] [主题]"
+auto-approve: true
+allowed-tools: [Read, Glob, Grep, Bash, Write, Edit, Agent, WebSearch]
+---
+
+# /wl-insight - 需求探索（发现/调研/规划）
+
+User input: $ARGUMENTS
+
+> **流水线的上游探索站**：负责发现需求、对标外部、规划未来。
+> 产出是**洞察报告**（不是 PRD），写完提示用户转 PRD。
+> **第一性原理：看未来，不编造。** 探索有方法论（OST/JTBD/Gap），结论必须锚定现状（context_pack）。
+
+---
+
+## 🔧 环境自检（QoderWork 桌面端 vs Qoder IDE/CLI）
+
+**先确定仓库根 R**（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
+```bash
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+```
+> 后续脚本统一用 `python "$R/.qoder/scripts/xxx.py"`。
+
+---
+
+## 🔒 语言锁（最高优先级）
+
+**全部输出必须简体中文。** 含报告标题、章节名、字段名、结论、建议。
+禁止任何英文句子（技术专有名词如 MCP/API/JTBD/OST 可保留英文缩写）。
+
+---
+
+## STEP 0: 路由类型（看 $ARGUMENTS / 用户说了什么）
+
+| 信号 | 类型 | 走哪段 |
+|------|------|--------|
+| "我发现个机会""现状痛点""能不能做 XX""用户老抱怨 XX" | **discover** | 需求发现（JTBD + OST 前两层） |
+| "调研竞品""对标 XX""行业都怎么做""XX 怎么实现的" | **research** | 外部调研（多 agent + web 搜索） |
+| "接下来做什么""下个版本""路线图""MVP 范围""规划" | **plan** | 未来规划（Gap + roadmap） |
+| 模糊 / 拿不准 | **先问** | "你是想发现新需求、调研外部、还是规划未来？" |
+
+### 无主题降级（用户什么都没说）
+
+```
+想做哪种探索？
+1. 需求发现 —— 从现状痛点/竞品空白找新机会（"我发现 XX 不好用"这类）
+2. 外部调研 —— 对标竞品/行业趋势/技术方案（"看看别人怎么做"）
+3. 未来规划 —— Gap 分析 + MVP 范围 + 路线图（"下个版本做什么"）
+
+告诉我主题或想法，我来锚定现状做探索。
+```
+
+---
+
+## 🔒 通用前置（所有类型必做）
+
+1. **身份**：读 `.qoder/.developer`，缺失 → 停下提示 `/wl-init`
+2. **现状锚点**：`python "$R/.qoder/scripts/context_pack.py" <关键词> --platform <web|app>`（必跑）
+3. **历史参考**：扫 `data/docs/prd/` 看已做过的（避免重复造），扫历史 insight 报告看是否聊过
+
+---
+
+## 类型 1：discover（需求发现）—— JTBD + OST 前两层
+
+**目标**：从一个模糊想法/痛点，挖出"用户真正要完成的 job"和对应的业务机会。
+
+### 流程（目标 3-4 轮）
+
+**第 1 步｜锚定现状**
+```bash
+python "$R/.qoder/scripts/context_pack.py" <关键词> --platform <web|app>
+```
+读懂：现状怎么做的、涉及哪些页面/字段/接口、有什么已知限制。
+
+**第 2 步｜JTBD 还原（核心）**
+把用户的"想法/痛点"用 JTBD 视角还原：
+- 不要问"加什么功能"，要问"用户在完成什么 job"
+- 句式：`当 {情境}，我想要 {做某事}，以便 {达成某个目的}`
+- 一个想法往往对应多个 job，都列出来
+
+**第 3 步｜OST 前两层（outcome + opportunity）**
+- 第 1 层 Outcome：这些 job 服务于哪个**业务目标**？（北极星指标/季度 OKR/痛点指标）
+- 第 2 层 Opportunity：每个 job 对应的**用户机会/痛点**（OST 的 opportunity 节点）
+
+**第 4 步｜与用户确认 + 出报告**
+1. 把 outcome + opportunity 清单**一次性编号列清**
+2. 问："这个分析对吗？哪个 job 要深入？"
+3. 确认后写报告，末尾提示出口衔接
+
+### 输出结构
+```markdown
+# 需求发现 - {主题}（{date}）
+
+## 现状锚定
+- 当前实现：...（context_pack 命中：{文件清单}）
+- 已知限制：...
+
+## 用户要完成的 Job（JTBD）
+1. 当 {情境}，我想要 {...}，以便 {...}
+2. ...
+
+## 业务机会（OST：Outcome → Opportunity）
+| 业务目标(Outcome) | 用户机会(Opportunity) | 现状满足度 | 证据来源 |
+|------------------|----------------------|-----------|---------|
+
+## 下一步
+要把握哪个机会？说"转 PRD"我把它作为现状输入，进 /wl-prd-full 参考模式落地。
+```
+
+---
+
+## 类型 2：research（外部调研）—— 多 agent + web 搜索
+
+**目标**：对标竞品、行业趋势、技术方案，给 discover/plan 提供外部证据。
+
+### 流程（目标 4-6 轮）
+
+**第 1 步｜锚定现状 + 确定调研视角**
+- 跑 context_pack 知道现状
+- 确定 2-4 个调研视角（按主题选）：竞品对标 / 行业趋势 / 技术方案 / 用户场景
+
+**第 2 步｜并行派多 agent（核心）**
+**同一条消息**派 2-4 个 Agent，每个一个视角，并发跑：
+```
+每个 Agent 的任务：
+  - 视角：{竞品对标/行业趋势/技术方案/用户场景}
+  - 用 WebSearch 搜 3-5 个权威源（官方文档/行业报告/技术博客）
+  - 写中间产物：workspace/members/{dev}/drafts/research-agent-{N}-{视角}.md
+  - 含：关键发现 / 对本项目的启发 / 风险 / 来源链接
+```
+> 派 Agent 时给**具体的视角描述**和**本项目的现状摘要**，让 agent 调研有针对性，不泛泛而谈。
+
+**第 3 步｜合并 + Gap 提取**
+1. 读所有 `research-agent-*.md`
+2. 合并成一份调研报告，按视角组织
+3. 对每个发现标：**本项目现状 vs 外部做法 → Gap**
+4. 列"机会信号"（外部做得好而我们没做的）
+
+**第 4 步｜清理中间产物 + 与用户确认 + 出报告**
+```bash
+# 合并后必须删中间产物（team_sync staging allowlist 也拒绝这类文件）
+rm -f workspace/members/{dev}/drafts/research-agent-*.md
+```
+1. 把调研发现 + Gap + 机会信号**一次性编号列清**
+2. 问："这个调研对吗？哪个机会值得跟进？"
+3. 确认后写报告，末尾提示出口衔接
+
+### 输出结构
+```markdown
+# 外部调研 - {主题}（{date}）
+
+## 调研视角
+{本次派了哪几个视角的 agent}
+
+## 现状锚定
+{context_pack 摘要：我们当前怎么做}
+
+## 调研发现（按视角）
+### 视角 1：竞品对标
+| 竞品 | 做法摘要 | 我们的 Gap | 来源 |
+### 视角 2：行业趋势
+...
+
+## 机会信号
+1. {外部做得好而我们没做的}
+2. ...
+
+## 下一步
+要跟进哪个机会？说"转 PRD"我把它作为现状输入，进 /wl-prd-full 参考模式落地。
+```
+
+---
+
+## 类型 3：plan（未来规划）—— Gap 分析 + OST 第 3 层
+
+**目标**：把"未来想做成什么样"拆成 MVP + roadmap，输出方案候选。
+
+### 流程（目标 4-5 轮）
+
+**第 1 步｜现状 vs 理想态（Gap 分析核心）**
+1. 现状：context_pack 取真实代码/页面/字段
+2. 理想态：用户描述 / 最近一份 research 报告的结论 / 行业基准
+3. 建 Gap 表：
+
+| 维度 | 现状 | 理想态 | Gap | 证据来源 |
+|------|------|--------|-----|---------|
+
+**第 2 步｜Gap 排优先级**
+按**业务价值 × 可行性**打分（不照搬 RICE，探索阶段粒度粗点就行）：
+- 业务价值：1=锦上添花 / 2=提效 / 3=解锁核心场景 / 4=不做会丢市场
+- 可行性：看 context_pack 的现状，改动量大不大、有没有先例可复用
+- 分 = 价值 × 可行性，取 Top N
+
+**第 3 步｜拆 MVP + roadmap（OST 第 3 层 Solution）**
+- **MVP（本期）**：高价值高可行性的 Gap，**当前人力能做完的**
+- **Roadmap（后续）**：按版本分组，标依赖关系（A 依赖 B 先做）
+
+**第 4 步｜与用户确认 + 出报告**
+1. 把 Gap 表 + MVP + roadmap **一次性编号列清**
+2. 问："这个规划对吗？MVP 范围合理吗？"
+3. 确认后写报告，末尾提示出口衔接
+
+### 输出结构
+```markdown
+# 未来规划 - {主题}（{date}）
+
+## 现状 vs 理想态（Gap 分析）
+| 维度 | 现状 | 理想态 | Gap | 价值 | 可行性 | 分 |
+
+## MVP（本期建议）
+- {该做的 Gap} —— 理由：{价值×可行性}
+- ...
+
+## Roadmap（后续版本）
+- V{N+1}：{...}（依赖：{...}）
+- V{N+2}：{...}
+
+## 下一步
+要落地哪个？说"转 PRD"我把它作为现状输入，进 /wl-prd-full 参考模式落地。
+```
+
+---
+
+## 出口衔接：报告 → PRD（所有类型都要做）
+
+报告写完，**永远**给这句提示：
+
+```
+要把握住哪个机会？说"转 PRD"我把它作为现状输入，进 /wl-prd-full 参考模式落地成可执行 PRD。
+```
+
+用户说"转 PRD"或指定 `{报告路径}#{机会编号}` → 触发：
+```
+/wl-prd-full 参考：{报告路径}#{机会编号}
+```
+- prd 以 **reference 模式**（mode: reference）承接
+- prd 读取 insight 报告作为**现状背景输入**
+- prd 走"轻反思 + 批量确认 + 3 道质量锁"落地成 PRD + 原型
+- **insight 不直接生成 PRD**，探索和落地是两道工序
+
+---
+
+## 🛡️ 故障降级表（探索不因工具崩而卡住）
+
+| 故障现象 | 检测信号 | 降级动作 | 绝不能 |
+|---------|---------|---------|--------|
+| **context_pack 零命中**（全新领域） | 返回"(无命中)" | 照常探索，现状段标"索引无先例，基于用户口述/历史 PRD"；discover/plan 仍可做 | ❌ 编现状细节充数 |
+| **web 搜索无结果/失败** | Agent 返回空 | 改用 context_pack + 历史 PRD + 用户口述做调研；标"外部调研暂不可用，基于内部信息" | ❌ 凭训练记忆编竞品数据 |
+| **多 agent 派发失败** | Agent 工具不可用 | 改单线程串行调研（主 agent 自己跑 WebSearch），不阻塞 | ❌ 因此中断 research |
+| **research-agent-*.md 清理失败** | rm 报错 | 记一句"中间产物未清理，下次 push 前 team_sync 会拦"，继续 | ❌ 让脏文件进团队仓库 |
+| **平台没指定** | 用户没说 web/app | **不强制问平台**（探索阶段平台不关键），context_pack 用 `--platform web` 兜底或两平台都跑 | ❌ 像 prd 那样卡在问平台 |
+| **写入失败** | Write 报错 | 报告直接贴对话里，不崩 | ❌ 丢探索结论 |
+| **用户对结论全盘否定** | 用户说"不对" | 回到第 1 步重新锚定现状，问"哪里理解偏了"，最多 2 轮重做 | ❌ 无限循环 / ❌ 强行写报告 |
+
+---
+
+## 鲁棒性清单（出报告前自检）
+
+- [ ] 每个发现/机会/Gap 都附了**证据来源**？（context_pack 命中文件 / web 链接 / 用户口述）
+- [ ] 没有凭空编的数据？（没有证据的标"【待验证】"）
+- [ ] 现状锚定跑了吗？（context_pack 必跑，纯凭空的探索是臆想）
+- [ ] 跟用户确认了吗？（探索结论不能 AI 单方面拍板）
+- [ ] research 的中间产物 `research-agent-*.md` 清理了吗？
+- [ ] 报告末尾给了"转 PRD"提示吗？
+
+---
+
+## How to Use Results
+
+洞察报告可流转：**说"转 PRD" → /wl-prd-full 参考模式**（把机会作为现状输入落地）→ 后续走 task → code → test 流水线。
+
+> insight 是探索站，prd 是落地站。两者分开，思路才不混。

package/templates/qoder/commands/{wl-report.md → optional/wl-report.md}

@@ -1,6 +1,6 @@
 ---
 name: wl-report
-description: "Generate daily or weekly work report. Auto-isolates by current developer."
+description: "生成日报/周报，严格按当前开发者隔离。Generate daily/weekly work report, isolated by current developer. "
 argument-hint: "[daily/weekly] or empty for auto-detect"
 auto-approve: true
 allowed-tools: [Read, Bash]
@@ -10,6 +10,14 @@ allowed-tools: [Read, Bash]
 
 User input: $ARGUMENTS
 
+## 🔧 环境自检（QoderWork 桌面端 vs Qoder IDE/CLI）
+
+**先确定仓库根 R**（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
+```bash
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+```
+> 后续脚本统一用 `python "$R/.qoder/scripts/xxx.py"`；所有仓库内相对路径（workspace/、data/code/）都前置 `"$R/"`。
+
 ## CRITICAL: Data Isolation
 
 This report ONLY shows data for the CURRENT developer.
@@ -36,7 +44,7 @@ This name is used to filter ALL data below.
 ### 2. My Tasks (workspace/tasks/)
 ```bash
 # Find tasks where creator OR assignee = current developer
-python .qoder/scripts/task.py list --mine
+python "$R/.qoder/scripts/task.py" list --mine
 ```
 Only show tasks where task.json has:
 - `creator` == current developer, OR
@@ -51,7 +59,7 @@ Only files in THIS developer's journal directory.
 ### 4. My Git Commits
 ```bash
 # For each project in data/code/:
-cd data/code/{project}
+cd "$R/data/code/{project}"
 git log --author="{current_developer}" --since="{date}" --oneline
 ```
 Filter by git author matching current developer name.
@@ -94,7 +102,7 @@ Output:
 ```
 
 Save to: workspace/members/{developer}/journal/daily-{date}.md
-Then auto-sync (user never touches git): `python .qoder/scripts/team_sync.py push`
+Then auto-sync (user never touches git): `python "$R/.qoder/scripts/team_sync.py" push`
 
 ---
 
@@ -143,7 +151,7 @@ Output:
 ```
 
 Save to: workspace/members/{developer}/journal/weekly-{week}.md
-Then auto-sync (user never touches git): `python .qoder/scripts/team_sync.py push`
+Then auto-sync (user never touches git): `python "$R/.qoder/scripts/team_sync.py" push`
 
 ---
 

package/templates/qoder/commands/{wl-spec.md → optional/wl-spec.md}

@@ -1,6 +1,6 @@
 ---
 name: wl-spec
-description: "Generate or review Spec from PRD + Design"
+description: "从已确认 PRD 生成开发 Spec 文档（/wl-spec 命令入口）。Generate or review technical Spec from PRD + Design. "
 argument-hint: "[review]"
 auto-approve: true
 allowed-tools: [Read, Glob, Grep, Bash, Write, Edit]

package/templates/qoder/commands/{wl-status.md → optional/wl-status.md}

@@ -1,6 +1,6 @@
 ---
 name: wl-status
-description: "Project status with roadmap, milestones, dependency tracking, and health score"
+description: "项目状态/路线图/健康度。Project status: current sprint / roadmap / health score. "
 argument-hint: "[scope: current/roadmap/health]"
 auto-approve: true
 allowed-tools: [Read, Glob, Grep, Bash]
@@ -10,10 +10,36 @@ allowed-tools: [Read, Glob, Grep, Bash]
 
 User input: $ARGUMENTS (default: show current status)
 
+## 🔧 环境自检（QoderWork 桌面端 vs Qoder IDE/CLI）
+
+**先确定仓库根 R**（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
+```bash
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+```
+> 后续脚本统一用 `python "$R/.qoder/scripts/xxx.py"`；仓库内相对路径都前置 `"$R/"`。
+
 ## Scopes
 - (no arg or "current") -> Current sprint status
 - "roadmap" -> Now/Next/Later roadmap view
 - "health" -> Health score assessment
+- **功能名(如"资产管理") -> 功能完整画像**
+
+## 功能画像 (Feature Overview)
+
+用户说 `/wl-status 资产管理` 或 "XX功能怎么样"时：
+
+**PREFERRED: MCP 工具：**
+```
+mcp__qoder-knowledge-graph__feature_overview(feature='资产管理')
+```
+
+返回：该功能的完整画像——后端端点 + 前端按钮 + 测试用例 + 关联页面 + PRD。
+AI 据此判断"这个功能完整吗？还缺什么？"
+
+**FALLBACK: 直接读索引：**
+```bash
+python -c "import json; d=json.load(open('$R/data/index/prd-features.json')); print(json.dumps(d,ensure_ascii=False,indent=2))"
+```
 
 ## Current Status (DEFAULT)
 Show:
@@ -43,7 +69,7 @@ Calculate from:
 | EVA quality trend | 25% | tail .qoder/learning/eval-history.jsonl (avg score_pct, target >=80) |
 | Index freshness | 20% | data/index/.index-meta.json last_sync (<=7 days) + verify checks |
 | On-time delivery | 20% | task completion dates |
-| Sync health | 15% | python .qoder/scripts/team_sync.py status (ahead/behind/dirty) |
+| Sync health | 15% | python "$R/.qoder/scripts/team_sync.py" status (ahead/behind/dirty) |
 | Pipeline flow | 10% | PRD->Spec->Code conversion |
 | Learning growth | 10% | learning/patterns/ entries |
 

package/templates/qoder/commands/wl-code.md

@@ -1,6 +1,6 @@
 ---
 name: wl-code
-description: "Implement code following a Spec strictly. Needs confirmation."
+description: "按开发 Spec 严格实现代码（/wl-code 命令入口）。Implement code following a Spec strictly. "
 argument-hint: "[REQ-ID or spec-filename]"
 auto-approve: false
 allowed-tools: [Read, Glob, Grep, Bash, Write, Edit]
@@ -10,6 +10,14 @@ allowed-tools: [Read, Glob, Grep, Bash, Write, Edit]
 
 User input: $ARGUMENTS
 
+## 🔧 环境自检（QoderWork 桌面端 vs Qoder IDE/CLI）
+
+**先确定仓库根 R**（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
+```bash
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+```
+> 后续脚本统一用 `python "$R/.qoder/scripts/xxx.py"`。
+
 ## Step 1: Load Spec
 
 If REQ-ID provided, search workspace/specs/ for matching spec.
@@ -18,7 +26,7 @@ Read the spec file to understand requirements.
 
 ## Step 2: Search Related Code
 
-Run: python .qoder/scripts/search_index.py <keyword>
+Run: python "$R/.qoder/scripts/search_index.py" <keyword>
 Find existing code that this implementation relates to.
 Read relevant files for context.
 

package/templates/qoder/commands/wl-commit.md

@@ -1,6 +1,6 @@
 ---
 name: wl-commit
-description: "Git commit, push, and sync. Includes pre-commit quality check."
+description: "代码提交 + push + 同步，带质量门禁。Git commit + push + sync with pre-commit quality gate. "
 argument-hint: "[commit message]"
 auto-approve: false
 allowed-tools: [Read, Glob, Grep, Bash, Write, Edit]

package/templates/qoder/commands/wl-design-draw.md

@@ -0,0 +1,78 @@
+---
+name: wl-design-draw
+description: "画界面/原型。说你要什么，AI 画出来。新页面、改页面、参考竞品都行。"
+argument-hint: "<你要画什么>"
+auto-approve: true
+allowed-tools: [Read, Glob, Grep, Bash, Write, Edit, mcp__qoder-knowledge-graph, mcp__lanhu]
+---
+
+# /wl-design-draw - 画界面
+
+User input: $ARGUMENTS
+
+> 用户说"画什么"，AI 画出来。就这么简单。
+
+## 🔧 环境自检（QoderWork 桌面端 vs Qoder IDE/CLI）
+
+**先确定仓库根 R**（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
+```bash
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+```
+> 后续脚本统一用 `python "$R/.qoder/scripts/xxx.py"`。
+
+## Step 1: 平台（问了就停）
+
+```
+这个界面是针对哪个平台？
+1. Web 管理端 (fywl-ui)
+2. APP 移动端 (Carmg-H5)
+3. 两端都要
+请选择 (1/2/3):
+```
+
+## Step 2: 如果输入是大板块，先缩小到具体页面
+
+"资产"有 38 个页面，不能直接画。调 `mcp__qoder-knowledge-graph__feature_overview(feature='资产')`，
+列出页面问用户选哪个（**问了就停**）。
+
+具体功能（如"营业外合同筛选"）跳过这步。
+
+## Step 3: 画
+
+**先拿设计约束 + 真实数据（不许跳过，不许手写 HTML）：**
+
+```
+mcp__qoder-knowledge-graph__get_design_system(platform='web')                         → 颜色/布局/按钮/组件
+mcp__qoder-knowledge-graph__fill_prototype(keyword='营业外合同', platform='web')        → 80% 草稿
+```
+
+FALLBACK（无 MCP 时）：
+```bash
+python "$R/.qoder/scripts/gen_design_doc.py"
+python "$R/.qoder/scripts/fill_prototype.py" 营业外合同 --platform web
+```
+
+**拿到草稿后微调：**
+- 按钮用真实文案（数据清单里的，不是编的"新增/编辑"）
+- 补交互细节（弹窗/Tab/折叠）
+- 画完整状态（有数据 + 空状态 + 加载中）
+- **颜色/宽度/间距不许改**（来自真实系统，AI 猜的一定不对）
+
+## 铁律
+
+1. **必须先调 get_design_system + fill_prototype**，不许跳过直接手写
+2. **若设计师录入了蓝湖 spec，fill_prototype 会自动注入**——先确认 `data/style/{关键词}-design-spec.json` 是否存在。若有，fill_prototype 会把蓝湖的真实 `design_tokens`（如 `rgba(255,115,10,1)`）原样注入原型 `:root`，**这一步全自动，不用手动调蓝湖**。验证：看输出原型 `:root` 里有没有 `/* design-import spec tokens (优先级最高) */`
+3. **颜色只用真源**（蓝湖 spec 注入值 > get_design_system 的 HSL，不是 #1890ff）
+4. **按钮用真实文案**（entity-registry 的，不是编的）
+5. **布局参数不猜**（蓝湖 spec 的 width 或 layout_fingerprint 的 160px）
+6. **图标禁 emoji**（Web 用 Ant Design SVG，APP 用 Vant 字体图标）
+7. **画完整状态**（不只画"有数据"，还要画空状态/加载中/错误）
+
+> 蓝湖与画图的关系：**蓝湖在录入环节（/wl-design-spec）发力**，读出的 CSS 值存进 spec.json；
+> 画图时 fill_prototype 自动消费 spec.json，不需要 draw 再调蓝湖。蓝湖没起/没录入？不影响 draw，
+> fill_prototype 降级用 layout_fingerprint + 代码风格，照样出原型（只是不如蓝湖精确）。
+
+## 存储与 Figma
+
+存到 `workspace/members/{developer}/drafts/prototype-{feature}.html`。
+设计师可在 Figma 用 html.to.design 插件导入精修。

package/templates/qoder/commands/wl-design-scan.md

@@ -0,0 +1,108 @@
+---
+name: wl-design-scan
+description: "扫描/审视系统现状。看功能模块有哪些页面/按钮/流程/风格/测试覆盖。画原型前必做。"
+argument-hint: "<功能模块名或关键词>"
+auto-approve: true
+allowed-tools: [Read, Glob, Grep, Bash, mcp__qoder-knowledge-graph]
+---
+
+# /wl-design-scan - 审视系统现状
+
+User input: $ARGUMENTS
+
+> 画之前先看。设计师/PM 需要理解"系统现在长什么样"才能动手。
+> 这是业界 Discover 阶段的工具——understand before you design。
+
+## 🔧 环境自检（QoderWork 桌面端 vs Qoder IDE/CLI）
+
+**先确定仓库根 R**（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
+```bash
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+```
+> 后续脚本统一用 `python "$R/.qoder/scripts/xxx.py"`。
+
+## 第一步：判断用户想看什么
+
+| 用户说什么 | 调什么 | 返回什么 |
+|-----------|--------|---------|
+| "XX 有哪些页面""XX 功能模块" | `feature_overview(feature='XX')` | 页面列表 + 端点数 + 按钮数 + 测试数 |
+| "XX 的操作流程""XX 业务流程" | `get_workflow(module='XX')` | 操作链（查询→新增→审批→...） |
+| "XX 用什么风格""系统主色" | `get_design_system(platform='web')` | token + 布局指纹 + 组件表 + 真实按钮 |
+| "XX 有没有测试""XX 测试覆盖" | `coverage_matrix()` | 17 个功能的测试覆盖红黄绿 |
+| "改 XX 影响什么" | `get_impact(endpoint='XX')` | 影响页面数 + 操作数 + 可回归测试 |
+| "XX 按钮 调什么接口" | `context_360(symbol='handleXX')` | 按钮关联的 API + Controller + 调用链 |
+| 模糊 | 先问 | "你想看功能模块、操作流程、设计风格、测试覆盖、还是影响分析？" |
+
+## 第二步：执行查询
+
+**PREFERRED: MCP 工具**（QoderWork 有 MCP 时直接调）
+```
+mcp__qoder-knowledge-graph__feature_overview(feature='资产管理')
+mcp__qoder-knowledge-graph__get_workflow(module='资产')
+mcp__qoder-knowledge-graph__get_design_system(platform='web')
+```
+
+**FALLBACK: Python 脚本**
+```bash
+python "$R/.qoder/scripts/search_index.py" 资产 --platform web
+python "$R/.qoder/scripts/search_index.py" --style table --platform web
+python "$R/.qoder/scripts/search_index.py" --field assetName
+```
+
+## 第三步：结构化输出
+
+不是简单返回数据，而是**帮用户理解**：
+
+### 功能模块视图（用户说"XX 有哪些页面"时）
+```
+📊 资产管理 (assets) 模块全景
+   页面: 38 个
+   API: 12 个端点
+   按钮: 108 个操作
+   测试: 3 个测试用例 (覆盖率偏低 ⚠️)
+
+   主要页面类型:
+   - table-page: 20 个 (异常申请/记录/分析...)
+   - form-page: 12 个 (新增/编辑/审批...)
+   - dashboard: 3 个 (资产看板)
+   - detail-page: 3 个
+
+   标杆页面 (最适合做参考的):
+   1. assets/abnormal/apply/index.vue (异常申请, 19个字段)
+   2. assets/abnormalManage/abnormalAnalysis/index.vue (分析看板)
+```
+
+### 操作流程视图（用户说"XX 流程"时）
+```
+🔄 资产管理操作链 (7 步)
+   查询 → 新增 → 提交 → 审批 → 归档 → 导出 → 删除
+
+   ⚠️ 步骤较多 (7步), 考虑优化:
+   - 第3步"提交"和第4步"审批"可能合并
+   - 第6步"导出"可放到工具栏, 不算独立步骤
+```
+
+### 设计风格视图（用户说"XX 风格"时）
+```
+🎨 fywl-ui 设计指纹
+   主色: hsl(214.58, 86.34%, 59.8%) (Vben 蓝)
+   侧边栏: 160px, 浅色, mixed-nav 布局
+   顶栏: 深色, 含 logo + 通知 + 头像
+   圆角: 0.25rem
+   字体: -apple-system, BlinkMacSystemFont, ...
+
+   真实按钮文案示例: 添加反馈资产, 导出Excel, 批量导入, ...
+   常用组件: Modal(273次), Input(135次), FormItem(95次), ...
+```
+
+## 使用示例
+
+```
+/wl-design-scan 资产管理         → 功能模块全景
+/wl-design-scan 资产的操作流程    → 操作链分析
+/wl-design-scan 系统设计风格      → 设计 token + 布局指纹
+/wl-design-scan 哪些功能没测试    → 覆盖矩阵
+/wl-design-scan 改 /asset 影响    → 影响分析
+```
+
+> scan 不产出文件，只返回结构化分析。帮设计师/PM"看清楚"再动手。