@hupan56/wlkj 2.7.12 → 3.0.0

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

@@ -1,7 +1,7 @@
 ---
 name: wl-commit
-description: "代码提交 + push + 同步，带质量门禁。Git commit + push + sync with pre-commit quality gate. 用户说'提交代码''commit''推上去''保存代码''提交一下'时触发。需用户确认（DANGERONS）。"
-trigger: "用户说'提交''commit''推上去''保存代码''提交一下''/wl-commit'"
+description: "代码提交 + push + 同步，带质量门禁。Git commit + push + sync with pre-commit quality gate. 需用户确认（DANGERONS）。"
+trigger: "user invokes /wl-* command explicitly"
 ---
 
 
@@ -11,7 +11,7 @@ trigger: "用户说'提交''commit''推上去''保存代码''提交一下''/wl-c
 ```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`。
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/setup/install_qoderwork.py`。
 
 # wl-commit — 代码提交 + 质量门禁 + 同步
 
@@ -70,7 +70,7 @@ git push
 
 提交成功后埋点（写当前开发者的 journal，供 /wl-status 健康度统计）：
 ```bash
-python "$R/.qoder/scripts/learn.py" record commit_done "{\"files\": <改动文件数>, \"task\": \"<关联任务ID或空>\"}"
+python "$R/.qoder/scripts/report/learn.py" record commit_done "{\"files\": <改动文件数>, \"task\": \"<关联任务ID或空>\"}"
 ```
 > 失败静默忽略，绝不阻塞提交流程。
 

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

@@ -1,7 +1,7 @@
 ---
 name: wl-design
-description: "设计工序入口: import 录入设计稿→spec.json(默认) / generate 按设计spec出原型 / review 评审原型。用户说'录入设计稿''按设计出原型''评审原型'或输入 /wl-design 时触发。"
-trigger: "用户说'录入设计稿''Figma稿录入''按设计出原型''评审原型''/wl-design'"
+description: "设计工序入口: import 录入设计稿→spec.json(默认) / generate 按设计spec出原型 / review 评审原型。"
+trigger: "user invokes /wl-* command explicitly"
 ---
 
 
@@ -11,7 +11,7 @@ trigger: "用户说'录入设计稿''Figma稿录入''按设计出原型''评审
 ```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`。
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/setup/install_qoderwork.py`。
 
 # wl-design — 设计工序入口（/wl-design 命令入口）
 

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

@@ -1,7 +1,7 @@
 ---
 name: wl-init
-description: "初始化/切换开发者身份 + 环境体检。Initialize/switch developer identity + environment health check. 用户说'初始化''我是谁''换开发者''环境检查''/wl-init''设置一下''开始用'时触发。"
-trigger: "首次使用、换人、或遇到环境问题时；用户说'初始化''换开发者''环境检查''体检'"
+description: "初始化/切换开发者身份 + 环境体检。Initialize/switch developer identity + environment health check. "
+trigger: "user invokes /wl-* command explicitly"
 ---
 
 
@@ -11,7 +11,7 @@ trigger: "首次使用、换人、或遇到环境问题时；用户说'初始化
 ```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`。
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/setup/install_qoderwork.py`。
 
 # wl-init — 开发者身份 + 环境体检
 
@@ -28,14 +28,14 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 
 ### 无参数（仅体检）
 ```bash
-python "$R/.qoder/scripts/init_doctor.py"
+python "$R/.qoder/scripts/setup/init_doctor.py"
 ```
 输出 8 段体检报告，每行 `[OK]/[WARN]/[FIX]/[MISS]` 标注。
 
 ### 带名字（注册 + 自愈）
 ```bash
-python "$R/.qoder/scripts/init_doctor.py" --fix <名字> [角色]
-# 例：python "$R/.qoder/scripts/init_doctor.py" --fix 小王 pm
+python "$R/.qoder/scripts/setup/init_doctor.py" --fix <名字> [角色]
+# 例：python "$R/.qoder/scripts/setup/init_doctor.py" --fix 小王 pm
 ```
 做 3 件事：
 1. 写 `.qoder/.developer`（key=value 格式）
@@ -44,7 +44,7 @@ python "$R/.qoder/scripts/init_doctor.py" --fix <名字> [角色]
 
 ### 仅自愈（不换人）
 ```bash
-python "$R/.qoder/scripts/init_doctor.py" --fix
+python "$R/.qoder/scripts/setup/init_doctor.py" --fix
 ```
 
 ## 体检覆盖的 8 段
@@ -71,6 +71,6 @@ python "$R/.qoder/scripts/init_doctor.py" --fix
 体检/注册本身不需要 push（只改本地 `.developer`）。但若 `--fix` 触发了图谱重建，
 完成后建议跑一次：
 ```bash
-python "$R/.qoder/scripts/team_sync.py" push
+python "$R/.qoder/scripts/task/team_sync.py" push
 ```
 让队友拿到刷新后的索引。

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

@@ -1,7 +1,7 @@
 ---
 name: wl-insight
-description: "需求探索 + 外部调研 + 未来规划。流水线的'上游探索站'，负责发现需求、对标竞品、做 Gap 分析和 roadmap。把'该做什么、为什么做'想清楚，结论交给 /wl-prd-full 落地。用户说'调研一下''竞品分析''接下来做什么''路线图''探讨一下需求''我发现个机会''规划下个版本'时触发。"
-trigger: "用户说'调研''竞品''对标''规划''路线图''roadmap''探讨需求''接下来做什么''发现个机会''下个版本做什么''/wl-insight'"
+description: "需求探索 + 外部调研 + 未来规划。流水线的'上游探索站'，负责发现需求、对标竞品、做 Gap 分析和 roadmap。把'该做什么、为什么做'想清楚，结论交给 /wl-prd-full 落地。"
+trigger: "user invokes /wl-* command explicitly"
 ---
 
 
@@ -11,7 +11,7 @@ trigger: "用户说'调研''竞品''对标''规划''路线图''roadmap''探讨
 ```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`。
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/setup/install_qoderwork.py`。
 
 # wl-insight — 需求探索（7 站之前的「探索站」· 产品工位）
 
@@ -55,7 +55,7 @@ insight（探索/调研/规划）→ [用户确认转PRD] → prd（落地）→
 ## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
 
 - `.qoder/.developer` — 当前探索者（报告归属）
-- **现状锚点**：`python "$R/.qoder/scripts/context_pack.py" <关键词> --platform <web|app>`（必跑，探索不能脱离现状凭空想）
+- **现状锚点**：`python "$R/.qoder/scripts/kg/context_pack.py" <关键词> --platform <web|app>`（必跑，探索不能脱离现状凭空想）
 - `.qoder/learning/feedback.jsonl` — 历史 insight 报告索引（可能为空）
 - 相关历史 PRD：`data/docs/prd/`（看已经做了什么，避免重复）
 
@@ -186,7 +186,7 @@ prd 以 reference 模式（mode: reference）承接，读取 insight 报告作
 
 insight 报告**默认不 push**（个人探索草稿）。用户说"发出去/同步/分享给团队"才：
 ```bash
-python "$R/.qoder/scripts/team_sync.py" push
+python "$R/.qoder/scripts/task/team_sync.py" push
 ```
 
 ---

package/templates/qoder/skills/wl-prd-full/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: wl-prd-full
-description: "完整档 PRD + 原型（13 章，正经需求）。新模块/新业务/新流程用这个。支持 参考:<insight报告> 衔接探索站。用户说'写个需求''生成PRD''做个原型''保单这块加个功能''写个产品需求文档'或输入 /wl-prd-full 时触发。先问平台！"
-trigger: "用户描述正经需求、要 PRD、要原型、要 mockup，或直接 /wl-prd-full"
+description: "完整档 PRD + 原型（13 章，正经需求）。新模块/新业务/新流程用这个。支持 参考:<insight报告> 衔接探索站。先问平台！"
+trigger: "user invokes /wl-* command explicitly"
 ---
 
 
@@ -11,7 +11,7 @@ trigger: "用户描述正经需求、要 PRD、要原型、要 mockup，或直
 ```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`。
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/setup/install_qoderwork.py`。
 
 # wl-prd-full — 完整档 PRD + 原型（/wl-prd-full 命令入口）
 
@@ -46,10 +46,10 @@ Read 指定 insight 报告 → 把现状锚定 + 选中的机会/Gap 作为 PRD
 
 ## 完整流程（详细见 command 文件）
 
-1. **并行取全上下文**：先读当前角色（`python "$R/.qoder/scripts/role.py"` 输出 pm/design/dev/test/admin 之一），按角色传 `--role`，让上下文匹配角色视角：
+1. **并行取全上下文**：先读当前角色（`python "$R/.qoder/scripts/report/role.py"` 输出 pm/design/dev/test/admin 之一），按角色传 `--role`，让上下文匹配角色视角：
    ```bash
-   ROLE=$(python "$R/.qoder/scripts/role.py" 2>/dev/null || echo pm)
-   python "$R/.qoder/scripts/kg.py" context <词> --platform <p> --role "$ROLE"
+   ROLE=$(python "$R/.qoder/scripts/report/role.py" 2>/dev/null || echo pm)
+   python "$R/.qoder/scripts/kg/kg.py" context <词> --platform <p> --role "$ROLE"
    ```
    > 不硬编码 pm：dev 写 PRD 能拿到代码视角、设计师拿到页面+风格视角，比统一 PM 视角更"准"。
 2. **轻反思 + 批量确认**：AI 自动补全背景/目标/指标，只把真缺失的 1-2 点一次性问完

package/templates/qoder/skills/wl-prd-quick/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: wl-prd-quick
-description: "小改动极速出 Mini-PRD（6 章）。加字段/加按钮/改文案/加导出等零星需求专用。用户说'加个字段''加个导出按钮''改下文案''快速出个需求'时触发。先问平台！"
-trigger: "用户说小改动/加字段/加按钮/改文案/快速出 PRD，或直接 /wl-prd-quick"
+description: "小改动极速出 Mini-PRD（6 章）。加字段/加按钮/改文案/加导出等零星需求专用。先问平台！"
+trigger: "user invokes /wl-* command explicitly"
 ---
 
 
@@ -11,7 +11,7 @@ trigger: "用户说小改动/加字段/加按钮/改文案/快速出 PRD，或
 ```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`。
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/setup/install_qoderwork.py`。
 
 # wl-prd-quick — 小改动极速出 Mini-PRD（/wl-prd-quick 命令入口）
 
@@ -38,11 +38,11 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 
 ## 3 步极速流程（详细见 command 文件）
 
-1. 先读当前角色再取上下文（不硬编码 pm，让 dev/设计师拿到匹配视角）：
+1. **先 prefetch（预测 + 批量预取，禁止串行 search）**：
    ```bash
-   ROLE=$(python "$R/.qoder/scripts/role.py" 2>/dev/null || echo pm)
-   python "$R/.qoder/scripts/kg.py" context <词> --platform <p> --role "$ROLE"
+   python "$R/.qoder/scripts/kg/prefetch.py" "<需求描述>" --platform <p>
    ```
+   prefetch 一次返回代码/字段/API/Wiki/历史PRD 的合并结果。**之后不要再用 search/find/grep 逐个查词**——那会变成 6+ 次串行往返，是轮次爆炸的根因。prefetch 不够时才补调一次。
 2. 一次 Write：Mini-PRD（prd-quick-template.md，6 章）+ 微型原型（只画 diff）
 3. "出好了，确认发布吗？" → 归档 + push
 

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

@@ -1,7 +1,7 @@
 ---
 name: wl-prd-review
-description: "评审 PRD 完整性与质量（7 项 checklist + EVA 评分）。用户说'评审PRD''检查需求文档''PRD质量怎么样''这个 PRD 合格吗''帮我看看这个需求文档'时触发。"
-trigger: "用户说要评审/检查/审核 PRD 质量，或直接 /wl-prd-review"
+description: "评审 PRD 完整性与质量（7 项 checklist + EVA 评分）。"
+trigger: "user invokes /wl-* command explicitly"
 ---
 
 
@@ -11,7 +11,7 @@ trigger: "用户说要评审/检查/审核 PRD 质量，或直接 /wl-prd-review
 ```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`。
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/setup/install_qoderwork.py`。
 
 # wl-prd-review — 评审 PRD 质量（/wl-prd-review 命令入口）
 
@@ -24,7 +24,7 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 
 拿到一份 PRD，检查它够不够格发布/交付下游：
 1. **7 项 checklist**：用户故事清晰 / 验收可测 / 优先级已标 / 模块已识别 / 非功能已列 / 边界已考虑 / 依赖已识别
-2. **EVA 客观评分**：`python "$R/.qoder/scripts/eval_prd.py" <PRD> [原型]`，≥80% 才 PASS
+2. **EVA 客观评分**：`python "$R/.qoder/scripts/report/eval_prd.py" <PRD> [原型]`，≥80% 才 PASS
 3. **合并报告**：PASS → 可发布；不 PASS → 修复清单
 
 ## 定位要评审的 PRD

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

@@ -1,7 +1,7 @@
 ---
 name: wl-report
-description: "生成日报/周报，严格按当前开发者隔离。Generate daily/weekly work report, isolated by current developer. 用户说'写日报''周报''我今天干了啥''这周做了什么''出个报告'时触发。"
-trigger: "用户说'日报''周报''我干了啥''今天做了什么''本周工作''出报告''/wl-report'"
+description: "生成日报/周报，严格按当前开发者隔离。Generate daily/weekly work report, isolated by current developer. "
+trigger: "user invokes /wl-* command explicitly"
 ---
 
 
@@ -11,7 +11,7 @@ trigger: "用户说'日报''周报''我干了啥''今天做了什么''本周工
 ```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`。
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/setup/install_qoderwork.py`。
 
 # wl-report — 日报 / 周报（按开发者隔离）
 
@@ -34,7 +34,7 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 
 ```bash
 # 1. 我的任务
-python "$R/.qoder/scripts/task.py" list --mine
+python "$R/.qoder/scripts/task/task.py" list --mine
 
 # 2. 我的提交（按 git author 过滤）
 git log --author=<开发者名> --since="<时间范围>" --pretty=format:"%h %s (%ar)" --no-merges
@@ -100,7 +100,7 @@ PM / 设计岗常一天在开会、评审，没有 git 提交，纯靠 commit
 
 保存到 `workspace/members/{dev}/journal/{YYYY-MM-DD}-{daily|weekly}.md`，然后：
 ```bash
-python "$R/.qoder/scripts/team_sync.py" push
+python "$R/.qoder/scripts/task/team_sync.py" push
 ```
 让团队/上级看到。
 
@@ -118,8 +118,8 @@ python "$R/.qoder/scripts/team_sync.py" push
 ### 方式 B: webhook（任何环境，脚本化）
 如果没有连接器，用引擎自带的 webhook 推送：
 ```bash
-python "$R/.qoder/scripts/report.py" daily --push-feishu
-python "$R/.qoder/scripts/report.py" weekly --push-feishu
+python "$R/.qoder/scripts/report/report.py" daily --push-feishu
+python "$R/.qoder/scripts/report/report.py" weekly --push-feishu
 ```
 这会通过 config.yaml 里配的飞书 bot webhook 发卡片通知。
 两种方式不冲突，连接器更富交互，webhook 更可靠无依赖。

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

@@ -1,7 +1,7 @@
 ---
 name: wl-search
-description: "查代码/业务/API/字段/PRD + 知识图谱(影响分析/覆盖矩阵/功能画像/业务流程/多跳遍历)的唯一入口。用户说'查一下''代码在哪''搜保险''考勤API''字段含义''改这个影响谁''哪些功能没测试''资产盘点有几步''XX功能画像'时触发。"
-trigger: "用户问代码/业务/API/字段/页面在哪，或说'查''搜''找''有哪些文件''定位''影响''覆盖''功能画像''业务流程''调用链'"
+description: "查代码/业务/API/字段/PRD + 知识图谱(影响分析/覆盖矩阵/功能画像/业务流程/多跳遍历)的唯一入口。"
+trigger: "user invokes /wl-* command explicitly"
 ---
 
 
@@ -13,7 +13,7 @@ trigger: "用户问代码/业务/API/字段/页面在哪，或说'查''搜''找'
 ```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`。
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/setup/install_qoderwork.py`。
 
 > ⚠️ 这是查代码、业务、知识图谱的**唯一入口**。禁止直接 grep `data/code/` 全库。
 
@@ -29,7 +29,7 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 **所有能力都有两条路，功能等价：**
 
 - **QoderWork 环境**（有 `mcp__qoder-knowledge-graph` 工具）：AI 直接调 MCP 工具，更快
-- **Qoder IDE / Quest / CLI**（无 MCP）：一律跑 `python "$R/.qoder/scripts/kg.py" <子命令>`
+- **Qoder IDE / Quest / CLI**（无 MCP）：一律跑 `python "$R/.qoder/scripts/kg/kg.py" <子命令>`
 
 > 不确定在哪个环境？优先试 MCP 工具；MCP 工具不存在就用 kg.py。两条路返回的数据一致。
 
@@ -68,19 +68,19 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 
 ```bash
 # 搜字段用法（返回字段标签 + 使用文件）
-python "$R/.qoder/scripts/search_index.py" --field <字段名>
+python "$R/.qoder/scripts/kg/search_index.py" --field <字段名>
 
 # 搜同类页面示例（table/form/detail/modal/dashboard）
-python "$R/.qoder/scripts/search_index.py" --style <类型> [--platform web|app]
+python "$R/.qoder/scripts/kg/search_index.py" --style <类型> [--platform web|app]
 
 # 浏览所有关键词 Top50
-python "$R/.qoder/scripts/search_index.py" --list
+python "$R/.qoder/scripts/kg/search_index.py" --list
 
 # 项目模块概览
-python "$R/.qoder/scripts/search_index.py" --modules
+python "$R/.qoder/scripts/kg/search_index.py" --modules
 
 # 组件使用统计
-python "$R/.qoder/scripts/search_index.py" --components
+python "$R/.qoder/scripts/kg/search_index.py" --components
 ```
 
 ## 一次取全（推荐写 PRD/Spec 前）
@@ -88,7 +88,7 @@ python "$R/.qoder/scripts/search_index.py" --components
 要一次性拿到代码+页面+字段+PRD+API+样式+图标，用上下文打包，支持**角色裁剪**只看相关部分：
 
 ```bash
-python "$R/.qoder/scripts/kg.py" context <业务词> --platform <web|app> --role <pm|design|dev|test|admin>
+python "$R/.qoder/scripts/kg/kg.py" context <业务词> --platform <web|app> --role <pm|design|dev|test|admin>
 ```
 
 角色裁剪说明：
@@ -97,7 +97,7 @@ python "$R/.qoder/scripts/kg.py" context <业务词> --platform <web|app> --role
 - `--role dev`：只看代码+字段+API+Wiki
 - `--role test`：只看代码+PRD+API
 
-> 等价旧命令：`python "$R/.qoder/scripts/context_pack.py" <业务词> --platform <web|app>`
+> 等价旧命令：`python "$R/.qoder/scripts/kg/context_pack.py" <业务词> --platform <web|app>`
 
 ## 决策树：该用哪个能力？
 
@@ -123,8 +123,8 @@ python "$R/.qoder/scripts/kg.py" context <业务词> --platform <web|app> --role
 
 kg.py 全容错，索引缺失会给出友好提示。遇到"知识图谱未构建"类提示：
 - 对 AI 说「初始化」（/wl-init）自动刷新
-- 或 `python "$R/.qoder/scripts/kg_build.py"` 手动构建
-- 或 `python "$R/.qoder/scripts/init_doctor.py" --fix` 自检修复
+- 或 `python "$R/.qoder/scripts/kg/kg_build.py"` 手动构建
+- 或 `python "$R/.qoder/scripts/setup/init_doctor.py" --fix` 自检修复
 
 ## 高频场景对照
 

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

@@ -1,7 +1,7 @@
 ---
 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'"
+description: "从已确认 PRD 生成开发 Spec 文档（/wl-spec 命令入口）。Generate or review technical Spec from PRD + Design. "
+trigger: "user invokes /wl-* command explicitly"
 ---
 
 
@@ -11,7 +11,7 @@ trigger: "PRD 确认/发布后；用户说'生成Spec''写技术规格''/wl-spec
 ```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`。
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/setup/install_qoderwork.py`。
 
 # wl-spec — 生成开发 Spec（/wl-spec 命令入口）
 
@@ -26,7 +26,7 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 - `.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 <字段名>`
+- 字段命名约定：`python "$R/.qoder/scripts/kg/search_index.py" --field <字段名>`
 - 团队 Java 约定（MyBatis Plus + RESTful + BigDecimal 金额）见
   `.qoder/skills/spec-generator/SKILL.md` 的 Step 3
 
@@ -39,7 +39,7 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 5. 通知开发评审
 6. 发布后自动同步：
    ```bash
-   python "$R/.qoder/scripts/team_sync.py" push
+   python "$R/.qoder/scripts/task/team_sync.py" push
    ```
 
 ## Review 模式

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

@@ -1,7 +1,7 @@
 ---
 name: wl-status
-description: "项目状态/路线图/健康度。Project status: current sprint / roadmap / health score. 用户说'项目怎么样''进度''健康度''路线图''现在在做什么''整体情况'时触发。"
-trigger: "用户说'项目怎么样''进度''健康度''路线图''整体情况''/wl-status'"
+description: "项目状态/路线图/健康度。Project status: current sprint / roadmap / health score. "
+trigger: "user invokes /wl-* command explicitly"
 ---
 
 
@@ -11,7 +11,7 @@ trigger: "用户说'项目怎么样''进度''健康度''路线图''整体情况'
 ```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`。
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/setup/install_qoderwork.py`。
 
 # wl-status — 项目状态总览
 
@@ -27,7 +27,7 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ## 维度 1：current（当前迭代）
 
 ```bash
-python "$R/.qoder/scripts/task.py" list
+python "$R/.qoder/scripts/task/task.py" list
 ```
 展示：
 - 当前活动任务（标 `*` 的那条）
@@ -60,7 +60,7 @@ python "$R/.qoder/scripts/task.py" list
 ## 团队同步健康（必跑）
 
 ```bash
-python "$R/.qoder/scripts/team_sync.py" status
+python "$R/.qoder/scripts/task/team_sync.py" status
 ```
 看 ahead/behind 是否对齐，未同步产出有几个。
 

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

@@ -1,7 +1,7 @@
 ---
 name: wl-task
-description: "任务管理 + RICE 优先级 + 依赖排期。7 站流水线的'任务'站，产品在这里把 PRD 落成任务。Task management with RICE prioritization. 用户说'建任务''排优先级''开始做这个''任务做完了''列一下任务''归档''排期'时触发。"
-trigger: "用户说'建任务''建个任务''排优先级''开始做''做完了''看任务''列任务''归档''排期''甘特图''/wl-task'"
+description: "任务管理 + RICE 优先级 + 依赖排期。7 站流水线的'任务'站，产品在这里把 PRD 落成任务。Task management with RICE prioritization. "
+trigger: "user invokes /wl-* command explicitly"
 ---
 
 
@@ -11,7 +11,7 @@ trigger: "用户说'建任务''建个任务''排优先级''开始做''做完了'
 ```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`。
+> `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。找不到时先跑 `python .qoder/scripts/setup/install_qoderwork.py`。
 
 # wl-task — 任务管理（7 站之「任务」站 · 产品工位）
 
@@ -40,7 +40,7 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 
 - `.qoder/.developer` — 当前开发者（assignee 默认值）
 - `.qoder/.current-task` — 当前活动任务（"开始做""完成了"默认对它操作）
-- 列出已有任务：`python "$R/.qoder/scripts/task.py" list`
+- 列出已有任务：`python "$R/.qoder/scripts/task/task.py" list`
 - 衔接 PRD：扫 `workspace/members/{dev}/drafts/REQ-*.md` + `data/docs/prd/REQ-*.md`
 
 ## 🔒 三道前置检查（任何动作前先做，保证健壮）
@@ -56,7 +56,7 @@ R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 **create（最高频）—— PRD 衔接不丢字段：**
 - 有 PRD → 从 PRD 提取标题/模块/验收点，**别让用户重述**；把 REQ-ID 记进 task.json 的 `tags`。
 - 无 PRD → 用用户给的一句话当标题。
-- 建完 push：`python "$R/.qoder/scripts/team_sync.py" push`
+- 建完 push：`python "$R/.qoder/scripts/task/team_sync.py" push`
 
 **rank（RICE）—— 一次取全，别逐个问：**
 1. `task.py list --status planning` 拿全待排任务
@@ -105,7 +105,7 @@ RICE = Reach × Impact × Confidence ÷ Effort
 
 `create` / `finish` / `archive` 改了任务状态，都要推给团队（用户永不碰 git）：
 ```bash
-python "$R/.qoder/scripts/team_sync.py" push
+python "$R/.qoder/scripts/task/team_sync.py" push
 ```
 
 ## finish 后：自动生成测试交接画像（可选增强）