@hupan56/wlkj 2.6.0 → 2.7.1

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

@@ -1,107 +1,131 @@
----
-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
-```
-让团队/上级看到。
-
-## 推送通知（可选，二选一）
-
-生成报告后，如果用户要求"发到飞书/钉钉/群里"，按环境选：
-
-### 方式 A: QoderWork 连接器（QoderWork 桌面端，交互式）
-如果你在 **QoderWork** 里运行（有连接器）：
-1. 检查用户是否装了飞书/钉钉连接器（Settings → Connectors & MCP）
-2. 用连接器把报告发到指定群/个人
-3. 这是最自然的方式（富文本卡片、@提及、审批流转都支持）
-> 提示用户: "要我发到飞书吗？先在 QoderWork Settings → Connectors 装飞书连接器"
-
-### 方式 B: webhook（任何环境，脚本化）
-如果没有连接器，用引擎自带的 webhook 推送：
-```bash
-python .qoder/scripts/report.py daily --push-feishu
-python .qoder/scripts/report.py weekly --push-feishu
-```
-这会通过 config.yaml 里配的飞书 bot webhook 发卡片通知。
-两种方式不冲突，连接器更富交互，webhook 更可靠无依赖。
-
-## 输出规则
-
-- 报告是中文，简洁（日报 ≤20 行，周报 ≤40 行）
-- 不要把 git log 原文贴进去，提炼成"做了什么"
-- 如果某天没提交也没 finish 任务，如实写"今日主要在调研/评审，无代码产出"，不编造
+---
+name: wl-report
+description: "生成日报/周报，严格按当前开发者隔离。Generate daily/weekly work report, isolated by current developer. 用户说'写日报''周报''我今天干了啥''这周做了什么''出个报告'时触发。"
+trigger: "用户说'日报''周报''我干了啥''今天做了什么''本周工作''出报告''/wl-report'"
+---
+
+
+## 🔧 仓库根定位（QoderWork 桌面端 vs Qoder IDE/CLI）
+
+**后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
+```bash
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+```
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/install_qoderwork.py`。
+
+# 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 "$R/.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/ 下今日/本周改动的文件
+```
+
+## 🧩 QoderWork 增强：日历补数据（可选 · 无连接器则自动回退）
+
+> 依赖 **QoderWork 桌面端连接器**（Settings → Connectors，授权 Microsoft 365 或 macOS）。
+> **纯 Qoder IDE / CLI 没有连接器 → 本段不生效，日报照常只用上面 3 个数据源，功能完全不受影响。**
+> 探测方式：仅当运行环境提供了「日历/会议」工具可直接读取时才用；看不到这些工具就跳过。
+
+PM / 设计岗常一天在开会、评审，没有 git 提交，纯靠 commit 的日报会很空。
+若日历连接器可用，把它当作**第 4 个数据源**追加进来：
+- 读取当天 / 本周已发生的日历事件（评审、站会、需求对齐、客户沟通等）
+- 把"参加 XXX 评审 / 与 XX 对齐需求"补进「今日完成」或「进行中」
+- 全天事件（请假 / 外出 / 培训）如实标进「阻塞/风险」
+
+> 只增不减：会议信息是**追加**到报告，绝不替代上面的任务 / 提交 / 产出数据。
+> 回退保证：读取失败或无连接器，只输出一句 `[日历数据未启用：非 QoderWork 或未授权连接器]` 即可，不报错、不阻塞出报告。
+
+## 报告结构（中文）
+
+### 日报
+```
+# 工作日报 - <开发者> - <日期>
+
+## 今日完成
+- [任务名] 具体做了什么（基于 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 "$R/.qoder/scripts/team_sync.py" push
+```
+让团队/上级看到。
+
+## 推送通知（可选，二选一）
+
+生成报告后，如果用户要求"发到飞书/钉钉/群里"，按环境选：
+
+### 方式 A: QoderWork 连接器（QoderWork 桌面端，交互式）
+如果你在 **QoderWork** 里运行（有连接器）：
+1. 检查用户是否装了飞书/钉钉连接器（Settings → Connectors & MCP）
+2. 用连接器把报告发到指定群/个人
+3. 这是最自然的方式（富文本卡片、@提及、审批流转都支持）
+> 提示用户: "要我发到飞书吗？先在 QoderWork Settings → Connectors 装飞书连接器"
+
+### 方式 B: webhook（任何环境，脚本化）
+如果没有连接器，用引擎自带的 webhook 推送：
+```bash
+python "$R/.qoder/scripts/report.py" daily --push-feishu
+python "$R/.qoder/scripts/report.py" weekly --push-feishu
+```
+这会通过 config.yaml 里配的飞书 bot webhook 发卡片通知。
+两种方式不冲突，连接器更富交互，webhook 更可靠无依赖。
+
+## 输出规则
+
+- 报告是中文，简洁（日报 ≤20 行，周报 ≤40 行）
+- 不要把 git log 原文贴进去，提炼成"做了什么"
+- 如果某天没提交也没 finish 任务，如实写"今日主要在调研/评审，无代码产出"，不编造

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

@@ -1,75 +1,141 @@
----
-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 更省轮次。
+---
+name: wl-search
+description: "查代码/业务/API/字段/PRD + 知识图谱(影响分析/覆盖矩阵/功能画像/业务流程/多跳遍历)的唯一入口。用户说'查一下''代码在哪''搜保险''考勤API''字段含义''改这个影响谁''哪些功能没测试''资产盘点有几步''XX功能画像'时触发。"
+trigger: "用户问代码/业务/API/字段/页面在哪，或说'查''搜''找''有哪些文件''定位''影响''覆盖''功能画像''业务流程''调用链'"
+---
+
+
+# wl-search — 代码 / 知识图谱搜索
+
+## 🔧 仓库根定位（QoderWork 桌面端 vs Qoder IDE/CLI）
+
+**后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
+```bash
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+```
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/install_qoderwork.py`。
+
+> ⚠️ 这是查代码、业务、知识图谱的**唯一入口**。禁止直接 grep `data/code/` 全库。
+
+## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
+
+- `data/index/.index-meta.json` — 图谱新鲜度；若 >7 天或不存在，提示用户
+  "知识图谱可能过期，建议先说'初始化'（/wl-init）刷新"，但不要阻塞本次搜索
+- 平台意图：用户提到"Web/PC/管理端"→ `--platform web`；
+  "APP/H5/移动端"→ `--platform app`；不明确就不加该 flag
+
+## 双轨执行：kg.py（全系列通用） / MCP（仅 QoderWork）
+
+**所有能力都有两条路，功能等价：**
+
+- **QoderWork 环境**（有 `mcp__qoder-knowledge-graph` 工具）：AI 直接调 MCP 工具，更快
+- **Qoder IDE / Quest / CLI**（无 MCP）：一律跑 `python "$R/.qoder/scripts/kg.py" <子命令>`
+
+> 不确定在哪个环境？优先试 MCP 工具；MCP 工具不存在就用 kg.py。两条路返回的数据一致。
+
+## 能力总表（自然语言 → 命令）
+
+### A. 基础搜索（找文件/接口/需求）
+
+| 用户问法 | kg.py 命令 | MCP 工具 |
+|---------|-----------|---------|
+| "考勤代码在哪""搜保险" | `kg.py search <关键词> [--platform web\|app]` | search_code |
+| "薪资 API""有哪些接口" | `kg.py api <关键词>` | search_api |
+| "保险相关的 PRD"（防重复造轮子） | `kg.py prd <关键词>` | search_prd |
+
+### B. 知识图谱高级能力（PM/开发/测试最常用）
+
+| 用户问法 | kg.py 命令 | MCP 工具 | 谁最该用 |
+|---------|-----------|---------|---------|
+| "改 /asset 影响哪些页面" | `kg.py impact <端点>` | get_impact | 开发改接口前 |
+| "handleExport 的完整关联" | `kg.py context360 <符号>` | context_360 | 开发/测试 |
+| "哪些功能没测试""回归盲区" | `kg.py coverage` | coverage_matrix | **PM/测试/管理** |
+| "资产管理功能画像"（几端点几按钮几测试） | `kg.py feature <功能名>` | feature_overview | **PM 写 PRD 前** |
+| "资产盘点有几步"（业务流程链） | `kg.py workflow <模块名>` | get_workflow | **PM/测试** |
+| "从资产管理能到哪些实体"（多跳遍历） | `kg.py hop <符号> [--depth 1-5]` | multi_hop | 开发/架构 |
+| "考勤的 Wiki 文档"（比读源码省 token） | `kg.py wiki <关键词>` | search_wiki | 所有人 |
+
+### C. 设计/原型辅助（设计师/PM 出原型前）
+
+| 用户问法 | kg.py 命令 | MCP 工具 |
+|---------|-----------|---------|
+| "用真实数据预填原型" | `kg.py fill-prototype <关键词> [--platform]` | fill_prototype |
+| "项目设计规范"（布局/配色/组件） | `kg.py design-system [--platform]` | get_design_system |
+
+### D. 字段 / 页面风格 / 组件（写 PRD/原型参考）
+
+这些仍走 search_index.py（kg.py 未单独封装，直接用）：
+
+```bash
+# 搜字段用法（返回字段标签 + 使用文件）
+python "$R/.qoder/scripts/search_index.py" --field <字段名>
+
+# 搜同类页面示例（table/form/detail/modal/dashboard）
+python "$R/.qoder/scripts/search_index.py" --style <类型> [--platform web|app]
+
+# 浏览所有关键词 Top50
+python "$R/.qoder/scripts/search_index.py" --list
+
+# 项目模块概览
+python "$R/.qoder/scripts/search_index.py" --modules
+
+# 组件使用统计
+python "$R/.qoder/scripts/search_index.py" --components
+```
+
+## 一次取全（推荐写 PRD/Spec 前）
+
+要一次性拿到代码+页面+字段+PRD+API+样式+图标，用上下文打包，支持**角色裁剪**只看相关部分：
+
+```bash
+python "$R/.qoder/scripts/kg.py" context <业务词> --platform <web|app> --role <pm|design|dev|test|admin>
+```
+
+角色裁剪说明：
+- `--role pm`：只看字段+PRD+API，不看代码噪音（**PM 首选**）
+- `--role design`：只看页面示例+布局指纹+风格速查
+- `--role dev`：只看代码+字段+API+Wiki
+- `--role test`：只看代码+PRD+API
+
+> 等价旧命令：`python "$R/.qoder/scripts/context_pack.py" <业务词> --platform <web|app>`
+
+## 决策树：该用哪个能力？
+
+```
+用户想查什么？
+├─ "这个东西有了吗/在哪" → search（找文件）/ prd（找需求）/ api（找接口）
+├─ "这个功能现在啥样" → feature（画像）+ context --role pm
+├─ "改这个会影响谁" → impact
+├─ "这个流程有几步" → workflow
+├─ "哪些功能缺测试" → coverage
+├─ "XX 谁调用/调用链" → context360 或 hop
+└─ 要出原型/查风格 → design-system + fill-prototype
+```
+
+## 结果使用规则
+
+1. 从结果里挑最相关的 2-3 个文件
+2. **只读这几个文件**（用 Read 工具）
+3. 基于读到的真实代码/数据回答用户问题
+4. 不要把脚本原始输出整个贴给用户 —— 提炼后再回答
+
+## 索引/图谱缺失怎么办
+
+kg.py 全容错，索引缺失会给出友好提示。遇到"知识图谱未构建"类提示：
+- 对 AI 说「初始化」（/wl-init）自动刷新
+- 或 `python "$R/.qoder/scripts/kg_build.py"` 手动构建
+- 或 `python "$R/.qoder/scripts/init_doctor.py" --fix` 自检修复
+
+## 高频场景对照
+
+| 用户问法 | 该跑的命令 |
+|---------|-----------|
+| "考勤代码在哪" | `kg.py search 考勤` |
+| "改 /asset 接口影响谁" | `kg.py impact /asset` |
+| "哪些功能没测试覆盖" | `kg.py coverage` |
+| "资产管理功能完整吗" | `kg.py feature 资产管理` |
+| "资产盘点业务流程" | `kg.py workflow assets` |
+| "从资产管理关联到哪些" | `kg.py hop 资产管理 --depth 3` |
+| "nickName 字段在哪用" | `search_index.py --field nickName` |
+| "列表页有哪些例子（Web）" | `search_index.py --style table --platform web` |
+| "写 PRD 前一次取全" | `kg.py context 车辆 --role pm` |

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

@@ -1,39 +1,49 @@
----
-name: wl-spec
-description: "从已确认 PRD 生成开发 Spec 文档（/wl-spec 命令入口）。Generate or review technical Spec from PRD + Design. 用户说'生成规格''写spec''出技术方案''把PRD转开发文档'或输入 /wl-spec 时触发。"
-trigger: "PRD 确认/发布后；用户说'生成Spec''写技术规格''/wl-spec'"
----
-
-# wl-spec — 生成开发 Spec（/wl-spec 命令入口）
-
-> 这是 `/wl-spec` 命令的 skill 入口。让 QoderWork 的 `/` 列表也能用 `/wl-spec`。
-> 完整规则见功能型 skill `.qoder/skills/spec-generator/SKILL.md`
-> 和命令 `.qoder/commands/wl-spec.md`。
-
-## ⚙️ 自取上下文（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 金额）见
-  `.qoder/skills/spec-generator/SKILL.md` 的 Step 3
-
-## 执行
-
-1. 定位 PRD（按 REQ-ID 或最新发布的）
-2. 读 PRD + 相关代码（用 search_index.py 找现有实现模式）
-3. 按 spec-generator skill 生成 spec.md（接口/字段/数据模型/验收标准）
-4. 存到 `workspace/specs/spec-{REQ-ID}-{desc}.md`
-5. 通知开发评审
-6. 发布后自动同步：
-   ```bash
-   python .qoder/scripts/team_sync.py push
-   ```
-
-## Review 模式
-
-带 `review` 参数 → 读现有 spec 做评审，给出改进建议，不重新生成。
-
-详细生成规则见 `.qoder/skills/spec-generator/SKILL.md`。
+---
+name: wl-spec
+description: "从已确认 PRD 生成开发 Spec 文档（/wl-spec 命令入口）。Generate or review technical Spec from PRD + Design. 用户说'生成规格''写spec''出技术方案''把PRD转开发文档'或输入 /wl-spec 时触发。"
+trigger: "PRD 确认/发布后；用户说'生成Spec''写技术规格''/wl-spec'"
+---
+
+
+## 🔧 仓库根定位（QoderWork 桌面端 vs Qoder IDE/CLI）
+
+**后续脚本里的 `$R` 代表仓库根**，先确定它（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
+```bash
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+```
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/install_qoderwork.py`。
+
+# wl-spec — 生成开发 Spec（/wl-spec 命令入口）
+
+> 这是 `/wl-spec` 命令的 skill 入口。让 QoderWork 的 `/` 列表也能用 `/wl-spec`。
+> 完整规则见功能型 skill `.qoder/skills/spec-generator/SKILL.md`
+> 和命令 `.qoder/commands/wl-spec.md`。
+> **模块契约**（输入/输出/校验）：`.qoder/contracts/spec.md`
+
+## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
+
+- `.qoder/.developer` — 当前开发者
+- `.qoder/.current-task` — 当前任务（决定 spec 存哪个 task 目录）
+- 扫描 PRD 来源：`data/docs/prd/`（已发布）+
+  `workspace/members/{dev}/drafts/REQ-*.md`（草稿），找出还没 Spec 的 PRD
+- 字段命名约定：`python "$R/.qoder/scripts/search_index.py" --field <字段名>`
+- 团队 Java 约定（MyBatis Plus + RESTful + BigDecimal 金额）见
+  `.qoder/skills/spec-generator/SKILL.md` 的 Step 3
+
+## 执行
+
+1. 定位 PRD（按 REQ-ID 或最新发布的）
+2. 读 PRD + 相关代码（用 search_index.py 找现有实现模式）
+3. 按 spec-generator skill 生成 spec.md（接口/字段/数据模型/验收标准）
+4. 存到 `workspace/specs/REQ-{ID}-{module}.spec.md`（命名与 PRD 的 REQ-ID 一致，便于贯穿检索）
+5. 通知开发评审
+6. 发布后自动同步：
+   ```bash
+   python "$R/.qoder/scripts/team_sync.py" push
+   ```
+
+## Review 模式
+
+带 `review` 参数 → 读现有 spec 做评审，给出改进建议，不重新生成。
+
+详细生成规则见 `.qoder/skills/spec-generator/SKILL.md`。