@hupan56/wlkj 3.1.31 → 3.2.0

package/templates/qoder/scripts/foundation/core/paths.py

@@ -640,6 +640,108 @@ def get_module_spec_dir(module: Optional[str] = None) -> Path:
     return spec_dir
 
 
+# ── spec 检测 (v3.x wl-code 门禁依据) ──────────────────────────
+# 设计原则: 纯读函数, 不写文件不改状态, 任何调用都安全。
+# spec 只存 2 处: workspace/specs/REQ-{ID}-*.spec.md (全局) + 当前任务目录 spec.md。
+# status 从契约头读 (@contract spec v1 / status: draft|confirmed), 无头视同 draft。
+# ─────────────────────────────────────────────────────────────
+
+def get_spec_status(spec_path) -> str:
+    """读 spec 文件契约头的 status 字段。
+
+    返回: 'draft' | 'confirmed' | None(文件不存在/无法解析)
+    - 无 status 字段 或 无契约头 → 视同 'draft' (wl-code 走确认环节, 不直接写码)
+    - 文件不存在 → None (wl-code 视为无 spec, 触发生成)
+    """
+    import re
+    try:
+        text = open(spec_path, encoding="utf-8").read()
+    except (OSError, IOError, TypeError):
+        return None
+    # 直接正则取 @contract spec 头里的 status (不依赖 contract.py, 避免循环 import)
+    m = re.search(r"<!--\s*@contract\s+spec(?:\s+v\d+)?\s*(.*?)-->", text, re.S)
+    if not m:
+        return "draft"  # 无契约头 → 视同 draft (安全: 走确认环节)
+    body = m.group(1)
+    sm = re.search(r"^\s*status\s*:\s*(\S+)\s*$", body, re.M)
+    if not sm:
+        return "draft"  # 有头但无 status 字段 → draft
+    val = sm.group(1).strip().lower()
+    return val if val in ("draft", "confirmed") else "draft"
+
+
+def find_spec(req_id=None, developer_name=None, repo_root=None) -> list:
+    """按 REQ-ID 或当前任务找 spec 文件 (wl-code gate 的核心检测)。
+
+    查 2 处 (spec 不存时间桶):
+      A. workspace/specs/REQ-{ID}-*.spec.md  (全局 specs, glob 前缀匹配)
+      B. 当前任务目录的 spec.md             (无 req_id 时, 读 .current-task)
+
+    Args:
+        req_id: REQ-YYYY-NNN 形式。传了就只查 A; 不传则查 B (当前任务)。
+    Returns:
+        [{path, status, source-req}, ...] 按优先级 (confirmed 优先)
+        status: 'draft' | 'confirmed' (从契约头读, 无头=draft)
+    """
+    import re
+    if repo_root is None:
+        repo_root = PROJECT_ROOT
+    results = []
+
+    def _inspect(p):
+        """读一个 spec 文件, 返回它的元信息 dict 或 None。"""
+        try:
+            text = open(p, encoding="utf-8").read()
+        except (OSError, IOError):
+            return None
+        m = re.search(r"<!--\s*@contract\s+spec(?:\s+v\d+)?\s*(.*?)-->", text, re.S)
+        body = m.group(1) if m else ""
+        status_m = re.search(r"^\s*status\s*:\s*(\S+)\s*$", body, re.M)
+        status = status_m.group(1).strip().lower() if status_m else "draft"
+        status = status if status in ("draft", "confirmed") else "draft"
+        sreq_m = re.search(r"^\s*source-req\s*:\s*(\S+)\s*$", body, re.M)
+        source_req = sreq_m.group(1).strip() if sreq_m else None
+        return {"path": str(p), "status": status, "source-req": source_req}
+
+    # A. 时间桶 REQ-ID 容器 (spec-generator 主写入位置, 优先查)
+    #    复用 find_req_dirs 跨桶找到容器, 再在容器里找 *.spec.md
+    if req_id:
+        clean_m = re.match(r"(REQ-\d{4}-\d{3,})", str(req_id))
+        clean = clean_m.group(1) if clean_m else str(req_id)
+        # A1. 时间桶容器 (members/{dev}/{drafts|outputs}/{桶}/{REQ-ID}/)
+        for hit in find_req_dirs(clean, developer_name=developer_name, repo_root=repo_root):
+            for f in sorted(Path(hit["path"]).glob("*.spec.md")):
+                info = _inspect(f)
+                if info:
+                    results.append(info)
+        # A2. 兜底: 全局 .qoder/workspace/specs/ (老 spec 或不在桶里的)
+        specs_root = QODER_DIR / "workspace" / "specs"
+        if specs_root.is_dir():
+            for f in sorted(specs_root.glob("%s-*.spec.md" % clean)):
+                info = _inspect(f)
+                if info:
+                    results.append(info)
+            for f in sorted(specs_root.glob("*.spec.md")):
+                info = _inspect(f)
+                if info and info not in results and info.get("source-req") == clean:
+                    results.append(info)
+
+    # B. 当前任务目录的 spec.md (无 req_id 时主路径)
+    if not results:
+        ct = get_current_task()
+        if ct:
+            # ct 是相对 repo_root 的路径(如 workspace/tasks/xx), 但实际在 .qoder/ 下
+            task_spec = QODER_DIR / ct / "spec.md"
+            if task_spec.is_file():
+                info = _inspect(task_spec)
+                if info:
+                    results.append(info)
+
+    # 排序: confirmed 优先 (让 wl-code gate 先看到可放行的)
+    results.sort(key=lambda x: 0 if x["status"] == "confirmed" else 1)
+    return results
+
+
 def get_task_dir(slug: str) -> Path:
     """Get task directory by slug."""
     from datetime import datetime

package/templates/qoder/scripts/protocol/mcp/zentao_mcp_server.py

@@ -691,13 +691,23 @@ class ZentaoMCPServer(BaseMCPServer):
             pid = args.get('product_id', 1)
             path = '/products/%s/builds' % pid
             scope = '产品 %s' % pid
-        return self._safe_get(
-            path, None,
-            '%s 的版本 (%%d 个):' % scope,
-            lambda b: '  [%s] %s (date=%s)' % (
-                b.get('id'), str(b.get('name', ''))[:20], b.get('date', '')),
-            empty_msg='%s 暂无版本(build)。' % scope,
-        )
+        r = _api('GET', path, None)
+        # 禅道部分维度可能不支持 builds 端点(404 not found) → 给明确引导而非裸"查询失败"
+        if r.status_code == 404 and not (args.get('project_id') or args.get('execution_id') or args.get('product_id')):
+            return ('⚠️ 查版本需要指定维度(禅道无"全量版本"端点)。\n'
+                    '  常用: list_builds(project_id=N) 看项目级按周版本\n'
+                    '  或: list_builds(product_id=N) / list_builds(execution_id=N)')
+        if r.status_code not in (200, 201):
+            return '查询失败: %s (该维度可能无版本)' % r.status_code
+        data = r.json()
+        items = data.get('builds') if isinstance(data, dict) else None
+        if not isinstance(items, list) or not items:
+            return '%s 暂无版本(build)。' % scope
+        lines = ['%s 的版本 (%d 个):' % (scope, len(items))]
+        for b in items:
+            lines.append('  [%s] %s (date=%s)' % (
+                b.get('id'), str(b.get('name', ''))[:20], b.get('date', '')))
+        return '\n'.join(lines)
 
     @tool("get_build",
           "查版本/构建详情。例: get_build(build_id=8)",
@@ -1288,7 +1298,9 @@ class ZentaoMCPServer(BaseMCPServer):
             '可能权限不足或字段缺失')
 
     @tool("update_task",
-          "修改任务(名称/指派/工时/截止等)。权限不足返回提示不报错。例: update_task(task_id=301, name='导出PDF接口(改)', left=3)",
+          "修改任务(名称/指派/工时/截止/描述等)。权限不足返回提示不报错。"
+          "★spec 回填: 确认后的 spec 摘要可通过 desc 写入任务描述, 让禅道里能看到开发规格要点。"
+          "例: update_task(task_id=301, name='导出PDF接口(改)', left=3, desc='spec摘要...')",
           {"type": "object", "properties": {
               "task_id": {"type": "integer", "description": "任务ID"},
               "name": {"type": "string", "description": "新名称(可选)"},
@@ -1296,6 +1308,7 @@ class ZentaoMCPServer(BaseMCPServer):
               "estimate": {"type": "number", "description": "预计工时(可选)"},
               "left": {"type": "number", "description": "剩余工时(可选)"},
               "deadline": {"type": "string", "description": "截止日期(可选)"},
+              "desc": {"type": "string", "description": "任务描述(可选)。spec 回填用: 写 spec 摘要(接口清单/关键表/异常/AC映射) + 本地 spec 路径"},
           }, "required": ["task_id"]})
     def _t_update_task(self, args):
         tid = args.get('task_id', 0)
@@ -1303,11 +1316,11 @@ class ZentaoMCPServer(BaseMCPServer):
         if guard:
             return guard
         payload = {}
-        for k in ('name', 'assignedTo', 'estimate', 'left', 'deadline'):
+        for k in ('name', 'assignedTo', 'estimate', 'left', 'deadline', 'desc'):
             if args.get(k) is not None:
                 payload[k] = args[k]
         if not payload:
-            return '⚠️ 没有要更新的字段(可选: name/assignedTo/estimate/left/deadline)。'
+            return '⚠️ 没有要更新的字段(可选: name/assignedTo/estimate/left/deadline/desc)。'
         return self._safe_write(
             'PUT', '/tasks/%s' % tid, payload,
             '✅ 任务 #%s 已更新' % tid,

package/templates/qoder/scripts/validation/eval/qwork_harness.py

@@ -15,7 +15,7 @@ qwork_harness.py — QoderWork 命令自动化测试框架 (P2)
   python qwork_harness.py "/wl-search 考勤"
   python qwork_harness.py "/wl-search 考勤" --auto-answer=0   # 选第1个
   python qwork_harness.py "/wl-search 考勤" --no-answer        # 只跑不等答
-  python qwork_harness.py "/wl-prd-full 用户管理" --auto-answer=1
+  python qwork_harness.py "/wl-prd 用户管理" --auto-answer=1
 
 依赖: websocket-client (pip install websocket-client)
 """

package/templates/qoder/scripts/validation/eval/report-commands.md

@@ -143,7 +143,7 @@ AskUserQuestion 在 transcript 里的真实生命周期:
 python qwork_harness.py "/wl-search 考勤"
 
 # 强制选项序号(0-based)
-python qwork_harness.py "/wl-prd-full 用户管理" --auto-answer=0
+python qwork_harness.py "/wl-prd 用户管理" --auto-answer=0
 
 # 只跑不代答(遇到提问就停)
 python qwork_harness.py "/wl-search 考勤" --no-answer
@@ -214,7 +214,7 @@ python qwork_harness.py "/wl-search 考勤" --json
 # 或直接 python qwork_harness.py "/wl-search 考勤" (注意 / 在 bash 下的转义)
 
 python qwork_harness.py "/wl-search 考勤"
-python qwork_harness.py "/wl-prd-full 用户管理" --auto-answer=0   # 强制选项序号
+python qwork_harness.py "/wl-prd 用户管理" --auto-answer=0   # 强制选项序号
 python qwork_harness.py "/wl-search 考勤" --no-answer              # 不代答
 python qwork_harness.py "/wl-search 考勤" --json                   # JSON 输出
 ```

package/templates/qoder/settings.json

@@ -1,15 +1,33 @@
 {
   "permissions": {
+    "defaultMode": "acceptEdits",
     "allow": [
-      "Bash(*)",
-      "Read(*)",
-      "Write(*)",
-      "Edit(*)",
-      "Glob(*)",
-      "Grep(*)",
-      "WebFetch(*)",
-      "WebSearch(*)",
-      "mcp__*"
+      "Read",
+      "Write",
+      "Edit",
+      "Glob",
+      "Grep",
+      "WebFetch",
+      "WebSearch",
+      "mcp__*",
+      "Bash(python:*)",
+      "Bash(python3:*)",
+      "Bash(py:*)",
+      "Bash(git:*)",
+      "Bash(npm:*)",
+      "Bash(npx:*)",
+      "Bash(node:*)",
+      "Bash(ls:*)",
+      "Bash(cat:*)",
+      "Bash(echo:*)",
+      "Bash(test:*)",
+      "Bash(mkdir:*)",
+      "Bash(cp:*)",
+      "Bash(mv:*)",
+      "Bash(find:*)",
+      "Bash(grep:*)",
+      "Bash(sed:*)",
+      "Bash(cd:*)"
     ],
     "deny": []
   },

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

@@ -1,7 +1,7 @@
 ---
 name: design-import
-description: "把设计师的 Figma/Axure 设计稿录入工作流，生成设计规范 spec.json 并存入知识图谱。Import designer's Figma/Axure design into the pipeline as a style spec. "
-trigger: "user invokes /wl-* command explicitly"
+description: "把设计师的设计稿录入工作流，生成设计规范 spec.json 并存入知识图谱。蓝湖链接直读为主(精确提取颜色/尺寸/字体/切图)，无蓝湖可截图口述降级。/wl-design 预览模式走这里。"
+trigger: "被 /wl-design 预览模式内部调用(实现层)"
 ---
 
 
@@ -48,7 +48,7 @@ ls "$R/data/style/"*-design-spec.json 2>/dev/null   # 列所有 spec
 
 ## Step 0: 确认平台
 
-跟 /wl-prd-full 一样，先问：Web 管理端 / APP 移动端 / 两端都要？
+跟 /wl-prd 一样，先问：Web 管理端 / APP 移动端 / 两端都要？
 **问了就停，等设计师回答。**
 
 ## Step 1: 收集设计信息

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

@@ -1,7 +1,7 @@
 ---
 name: design-review
 description: "评审设计交付物的完整性。Review design artifacts for completeness. "
-trigger: "user invokes /wl-* command explicitly"
+trigger: "被 /wl-design 评审模式内部调用(实现层)"
 ---
 
 

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

@@ -1,7 +1,7 @@
 ---
 name: prd-generator
-description: "生成 PRD + 平台匹配的原型。Generate PRD with platform-aware prototype. "
-trigger: "user invokes /wl-* command explicitly"
+description: "/wl-prd 完整档/快速档的实现层。生成 PRD + 平台匹配的原型,带 EVA 质量门禁。"
+trigger: "被 /wl-prd 完整/快速模式内部调用(实现层,不直接响应自然语言)"
 ---
 
 
@@ -16,8 +16,8 @@ PY=$(python --version >/dev/null 2>&1 && echo python || echo python3)
 
 # PRD Generator Skill
 
-> 📌 **主入口：`/wl-prd-full`（正经需求）/ `/wl-prd-quick`（小改动）命令。** 本 skill 是它们的实现层 + Quest/QoderWork 自然语言路由。
-> 两者功能等价，优先用 `/wl-prd-full` 或 `/wl-prd-quick`（参数提示更全、更稳定）。
+> 📌 **主入口：`/wl-prd` 命令（完整档 / 快速档 / 评审 三模式）。** 本 skill 是完整/快速模式的实现层 + Quest/QoderWork 自然语言路由。
+> 命令见 `.qoder/commands/wl-prd.md`（参数提示更全、更稳定）。
 > **模块契约**（输入/输出/校验）：`.qoder/contracts/prd.md`
 > **第一性原理：又快又准**（快=并行+砍模式，准=语义归档+质量锁）
 > **定位：专注"已确定需求"的落地。** 探索/调研/规划/对标已移交 `/wl-insight`，

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

@@ -1,7 +1,7 @@
 ---
 name: prd-review
 description: "评审 PRD 完整性与质量。Review PRD for completeness and quality. "
-trigger: "user invokes /wl-* command explicitly"
+trigger: "被 /wl-prd 评审模式内部调用(实现层)"
 ---
 
 

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

@@ -1,7 +1,7 @@
 ---
 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. "
-trigger: "user invokes /wl-* command explicitly"
+trigger: "被 /wl-prd 或 /wl-design 原型生成内部调用(实现层)"
 ---
 
 
@@ -37,7 +37,7 @@ Generate production-ready HTML prototypes that match the project's actual UI sty
 
 本 skill **只在用户明确选择"画原型"后才进入**。
 
-- 如果上游 `/wl-prd-full` 或 `/wl-prd` 在「批量确认」环节已决定**不画**（PRD 第 1 行
+- 如果上游 `/wl-prd` 在「批量确认」环节已决定**不画**（PRD 第 1 行
   `@contract` 头标记 `prototype: none`），**立即退出本 skill**，不生成任何 HTML。
 - 如果上游没有 contract 头（独立调用本 skill），**先问用户**：
   `这个需求要画原型吗？(画 / 不画)`
@@ -50,7 +50,7 @@ Generate production-ready HTML prototypes that match the project's actual UI sty
 ---
 ## Step 0: Know the Platform
 
-The platform MUST already be decided (asked by /wl-prd-full Step 0).
+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 |

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

@@ -1,7 +1,7 @@
 ---
 name: spec-coder
 description: "严格按开发 Spec 实现代码。Implement code strictly following development Spec. 需用户确认（DANGEROUS）。"
-trigger: "user invokes /wl-* command explicitly"
+trigger: "被 /wl-code 内部调用(实现层)"
 ---
 
 

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

@@ -1,7 +1,7 @@
 ---
 name: spec-generator
 description: "从已确认的 PRD 自动生成开发 Spec 文档（技术规格说明）。Auto-generate development Spec documents from confirmed PRDs. "
-trigger: "user invokes /wl-* command explicitly"
+trigger: "被 /wl-spec 内部调用(实现层)"
 ---
 
 
@@ -28,21 +28,46 @@ PY=$(python --version >/dev/null 2>&1 && echo python || echo python3)
   再 `$PY "$R/.qoder/scripts/foundation/core/paths.py" whoami`（输出开发者名；空=未初始化）。
   ⚠️ 勿用裸相对路径 `.qoder/.developer`（QoderWork 桌面端 cwd 不在仓库根，会读不到而误报未初始化）。
 - **活动任务**：当前任务（决定 spec 存到哪个 task 目录）。读法 `$PY "$R/.qoder/scripts/foundation/core/paths.py" current-task`（输出任务路径；空=无活动任务）。
-- 扫描 PRD 来源目录：`data/docs/prd/`（已发布）+ `workspace/members/{dev}/drafts/REQ-*.md`（草稿）
+- 扫描 PRD 来源目录：`data/docs/prd/`（已发布）+ PRD 所在的 REQ-ID 容器
+  （`workspace/members/{dev}/{drafts|outputs}/{YYYY}/{MM}/{Ww}/{REQ-ID}/`，用 `find_req_dirs` 跨桶查找）
   找出还没有对应 Spec 的 PRD
 - 风格/字段参考：`$PY "$R/.qoder/scripts/orchestration/wlkj.py" search --field <字段名>` 查现有字段命名约定
 - 团队 Java 约定（MyBatis Plus + RESTful + BigDecimal 金额）写在本 skill 的 Step 3
 
-## Step 1: 定位 PRD
+## Step 1: 定位 PRD（优先禅道 task，本地兜底）
+
+**核心：1 禅道 task ↔ 1 spec。PRD 真源是 task 关联的 story**（本地找不到别人提的 PRD 时，从禅道 story 读）。
+
+### 优先级 1：从禅道 task 读（解决"别人提的 PRD 本地没有"）
 
 ```bash
-# 列出已发布的 PRD
-ls data/docs/prd/REQ-*.md
-# 列出当前开发者的草稿 PRD
-ls workspace/members/{developer}/drafts/REQ-*.md
+# 当前活动任务（panel / /wl-task 指向的禅道 task）
+TASK=$($PY "$R/.qoder/scripts/foundation/core/paths.py" current-task)   # 或直接给 task_id
+```
+
+走 MCP 读 task → story：
+```python
+cap.mcp.call("get_task", {"task_id": 1453})          # 拿 task 详情，取 story 字段
+cap.mcp.call("get_story_detail", {"story_id": 761})   # 读 story.spec 字段 = PRD 数据源
 ```
+story.spec 即 PRD 正文（验收标准/字段/操作）。**本地无该 PRD 文件也能生成 spec。**
 
-找出"有 PRD 但无 Spec"的需求。如果有多份，问用户先做哪个。
+### 优先级 2：本地 PRD 兜底
+
+```bash
+# task 无 story 关联，或禅道不可达 → 扫本地
+ls data/docs/prd/REQ-*.md                                          # 已发布
+$PY "$R/.qoder/scripts/foundation/core/paths.py" whoami            # 取开发者
+# 草稿在 REQ-ID 容器: workspace/members/{DEV}/{drafts|outputs}/{桶}/{REQ-ID}/
+```
+跨桶找某 REQ：复用 `paths.find_req_dirs(req_id, DEV)`。
+
+### 决定
+
+找出"要生成 spec 的目标"后：
+- **禅道 task 来的**：spec 主标识用 `task_id`，契约头写 `zentao: task=X story=Y`，第 0 章"禅道关联"填实。
+- **本地 PRD 来的**：用 REQ-ID，`zentao:` 留空（后续 panel 回填 task 时补）。
+- 多份候选时问用户先做哪个。
 
 ## Step 2: 读取上下文
 
@@ -57,41 +82,73 @@ cap.mcp.call("context_pack", {"keyword": "..."}) <PRD里的模块关键词> --pl
 
 ### 同时并发补这几项（与 context_pack 无依赖，同回合并发）
 
-1. **PRD 文件**（必需）：需求源
-2. **历史 Spec**（推荐）：扫 `workspace/specs/` 看同类需求的写法，照着写
-3. **真实表结构**（强烈推荐）：context_pack 不含 DB schema，写 API 字段前单独查
+1. **PRD 数据源**（必需）：禅道 task 来的 = Step 1 读到的 story.spec；本地来的 = PRD 文件
+2. **spec 模板**（必需）：`$R/.qoder/templates/spec-template.md` —— **必须读它，照它的 6 章骨架逐节填，不自由发挥结构**
+3. **历史 Spec**（推荐）：扫 PRD 同容器或历史 REQ-ID 容器看同类需求的写法，照着写
+4. **真实表结构**（强烈推荐）：context_pack 不含 DB schema，写 API 字段前单独查
    - 先 `cap.mcp.call("list_envs", {})` 问环境，再 `query_schema(table='quality_case', db='fywl_ics_quality')`
    - 拿到真实列名/类型/注释（注释里常含枚举定义，如"0=小时,1=工作日"）
 
 > 数据字典 `data/docs/constitution/` 如存在顺手读，不存在跳过。
-> 以上 PRD/历史Spec/query_schema 三项相互独立 → **同一条消息并发发**，不要逐个等。
+> 以上 PRD源/模板/历史Spec/query_schema 四项相互独立 → **同一条消息并发发**，不要逐个等。
+
+## Step 3: 照模板分析（不自由发挥结构）
 
-## Step 3: 分析并生成
+**核心：读 `templates/spec-template.md` 的 6 章骨架，逐章节填空。** 不是从零生成结构。
 
-从 PRD 提取：
-- 每个用户故事 → 一个或多个 API 接口
-- 验收标准 → 接口入参/出参/错误场景
-- 数据需求 → 数据库表设计
-- 非功能性需求 → 约束章节
+从 PRD 提取并填入对应章节：
+- 每个用户故事 → 第 1 章一个或多个 API 接口
+- 验收标准 → 第 1 章入参/出参 + 第 3 章异常场景 + 第 5 章测试用例
+- 数据需求 → 第 2 章表设计（表名 `t_{module}_{entity}`，金额 BigDecimal）
+- **第 3 章异常矩阵 ★强制**：每个操作**系统性枚举所有失败场景**（参数/业务/权限/并发/外部依赖/数据不存在/边界值），这是写代码前必须想清楚的，不可遗漏
+- **第 4 章 AI 边界 ★强制**：明确划分 ✅可自动 / ⚠️必须人工确认 / 🚫禁止AI做
+- **第 5 章测试用例 ★强制**：每条 PRD 验收标准 ≥1 个用例，输入/预期/断言齐全
+- 第 6 章映射表：每条 PRD acceptance → 对应接口/数据/异常/用例，保证可追溯不漏
+
+★强制章节不适用时写"无"并附原因（例：纯查询页异常章写"无（仅查询，校验由前端处理）"）。
 
 ## Step 4: 输出
 
-写到 `workspace/specs/REQ-{ID}-{module}.spec.md`（或 task 目录 `workspace/tasks/{task-id}/spec.md`）
+**存储位置（按来源二选一）**：
+
+- **禅道 task 来的**（1 task ↔ 1 spec）：`workspace/tasks/{task_id}/spec.md`（复用现有 task 目录，task_id 即禅道 task id）
+- **本地 PRD 来的**：跟着 PRD 同容器，`workspace/members/{dev}/{drafts|outputs}/{YYYY}/{MM}/{Ww}/{REQ-ID}/REQ-{ID}-{module}.spec.md`
+  （复用 `paths.get_req_dir` / `find_req_dirs`，跨时间桶可查）
+
+**契约头**（status 初始为 draft；禅道来的带 zentao 字段）：
+```markdown
+<!-- @contract spec v1
+source-req: REQ-2025-0042
+platform: web
+module: policy
+endpoints: [POST /api/policy/amend, GET /api/policy/amend/{id}]
+status: draft
+zentao: task=1453 story=761
+-->
+```
+> `zentao:` 字段：禅道 task 来的必须填（task+story）；本地来的留空，待 panel 回填 task 时补。
+
+> 兜底：若本地 PRD 不在时间桶容器（老 PRD 在 `data/docs/prd/`），spec 写到 `workspace/specs/REQ-{ID}-{module}.spec.md`（向后兼容）。
 
-规则：
-- 每条 PRD 验收标准都映射到一个 Spec 测试用例
+规则（模板已固化，这里只强调重点）：
+- 每条 PRD 验收标准都映射到一个 Spec 测试用例（第 6 章）
 - API 路径遵循 RESTful 约定
 - 表名遵循 `t_{module}_{entity}`
 - 金额字段必须用 `BigDecimal`
 - 不写 PRD 未定义的功能
 - Entity → Mapper → Service → Controller 全栈结构
 
-## Step 5: 通知
+## Step 5: 通知并提交确认
 
-报告给被分配的开发者评审。
+生成后 `status: draft`。报告给被分配的开发者评审：
+1. 展示 spec 全文 + 列出关键决策点（接口设计 / 表结构 / 异常枚举 / AI 边界）
+2. 提示：可直接修改 spec 文件（路径见输出），改完告知
+3. **⚠️ status 保持 draft，不要自动改 confirmed** —— 用户在 `/wl-code` 的 spec gate 确认后才升级
+4. **不在此回填禅道** —— spec 回填禅道 task 的 `desc` 由 `/wl-code` 在用户确认后做（见 wl-code Step 1），本 skill 只负责生成
 
 ## 触发条件
 
 - 手动：用户说"生成 Spec"、"写技术规格"、"/wl-spec"
 - 任务驱动：PRD 评审通过后，下一步通常就是生成 Spec
+- `/wl-code` gate：无 spec 或 status≠confirmed 时，`/wl-code` 自动调本 skill 生成 draft
 - 子 agent：可被 prd-generator 在 PRD 确认后调度

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

@@ -1,7 +1,7 @@
 ---
 name: test-generator
 description: "从已实现代码和 Spec 自动生成单元测试。Auto-generate unit tests from implemented code and Spec. 需用户确认（DANGEROUS）。"
-trigger: "user invokes /wl-* command explicitly"
+trigger: "被 /wl-test quick模式内部调用(实现层)"
 ---
 
 

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

@@ -1,7 +1,7 @@
 ---
 name: wl-code
 description: "按开发 Spec 严格实现代码（/wl-code 命令入口）。Implement code following a Spec strictly. 需用户确认（DANGEROUS）。"
-trigger: "user invokes /wl-* command explicitly"
+trigger: "用户显式打 /wl-code; 或自然语言"写代码""实现这个功能""按spec开发"。需确认"
 ---
 
 
@@ -53,6 +53,18 @@ cap.mcp.call("context_pack", {"keyword": "..."}) <模块关键词> --platform <w
    - 拿真实列名/类型/注释（含枚举定义），别靠推断。
    - [QAS环境] 表结构与生产一致可放心用。
 
+### 排查/修 bug 类先对齐链路（kg 取证，1-2 步定位，禁止空转假设）
+
+> 遵守 wl-pipeline 规则 2.6：取证优先用 kg（`cap.mcp.call`），**不许"假设A→假设B→假设C"连环空转**。
+
+| 场景 | 对齐链路 | kg 先取证 | 最常见根因 |
+|------|---------|----------|-----------|
+| 后端报错/类型异常 | 前端格式→BO→Entity→DB列 | `query_schema`(DB列类型) + `context_pack`(BO/Entity文件) | String/Date/Long 不一致 |
+| 接口不通/400 | 路由→Controller→Service→Mapper→SQL | `code-api`(路由/参数) + `table_impact`(影响面) | 参数名不匹配/缺@RequestBody |
+| 前端白屏/NaN | 组件→API→响应→字段映射 | `context_pack`(组件/API) + `field_map`(字段映射) | null未处理/字段名拼错 |
+
+kg 取证后 Read 命中文件找**不一致点**，定位即动手，**别发散推理**。
+
 ## 执行
 
 1. **加载 Spec**：按 REQ-ID 找 spec；没参数就读 `.qoder/.current-task`

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. 需用户确认（DANGEROUS）。"
-trigger: "user invokes /wl-* command explicitly"
+trigger: "用户显式打 /wl-commit; 或自然语言"提交代码""commit"。需确认"
 ---
 
 

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

@@ -1,7 +1,7 @@
 ---
 name: wl-design
-description: "设计工序入口: import 录入设计稿→spec.json(默认) / generate 按设计spec出原型 / review 评审原型。"
-trigger: "user invokes /wl-* command explicitly"
+description: "设计工序站: 预览(蓝湖稿→HTML预览,默认) / 扫描(看现有系统页面组件风格) / 评审(检查原型是否用系统真源)。"
+trigger: "用户显式打 /wl-design; 或自然语言"出原型""设计稿""预览设计""扫描页面风格""
 ---
 
 
@@ -28,12 +28,12 @@ PY=$(python --version >/dev/null 2>&1 && echo python || echo python3)
 
 | 用户说 | 模式 | 走哪个 skill |
 |--------|------|-------------|
-| "录入设计稿""Figma稿录入""把这个设计录入" | **import**（默认） | design-import |
-| "按设计出原型""按设计师规范出原型" | **generate** | prototype-generator |
-| "评审原型""设计稿看一下""检查交互稿" | **review** | design-review |
+| "预览""出预览""蓝湖链接""看看设计稿" 或 含 lanhuapp.com | **预览**（默认） | design-import |
+| "扫描""看系统""有哪些页面""什么风格" | **扫描** | 看现有系统页面/组件/风格 |
+| "评审""检查""合规""颜色对不对" | **评审** | design-review |
 | 模糊 | 先问意图 | — |
 
-默认 import（最常见入口）。
+默认 预览（最常见入口）。
 
 ## ⚙️ 自取上下文（Quest / QoderWork 无 hook 注入，必须自读）
 

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

@@ -1,7 +1,7 @@
 ---
 name: wl-init
 description: "初始化/切换开发者身份 + 环境体检。Initialize/switch developer identity + environment health check. "
-trigger: "user invokes /wl-* command explicitly"
+trigger: "用户显式打 /wl-init; 身份初始化"
 ---
 
 
@@ -63,7 +63,7 @@ $PY "$R/.qoder/scripts/orchestration/wlkj.py" doctor --fix
 
 ## 输出规则
 
-- 体检完打印一句总结：「环境健康，可以开始工作：/wl-prd-full <需求>」或「N 个问题待修，加 --fix 自愈」
+- 体检完打印一句总结：「环境健康，可以开始工作：/wl-prd <需求>」或「N 个问题待修，加 --fix 自愈」
 - 如果用户没给名字但 `.developer` 不存在：先问"你叫什么名字？角色是 pm/dev/design？"
 - 如果 git user.name 与开发者名不一致：在体检里 `[WARN]` 提示，`--fix` 会自动改
 

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

@@ -1,7 +1,7 @@
 ---
 name: wl-insight
-description: "需求探索 + 外部调研 + 未来规划。流水线的'上游探索站'，负责发现需求、对标竞品、做 Gap 分析和 roadmap。把'该做什么、为什么做'想清楚，结论交给 /wl-prd-full 落地。"
-trigger: "user invokes /wl-* command explicitly"
+description: "需求上游探索站。默认澄清(产品听不懂时对焦,必要时出原型帮理解); discover(发现机会) / research(调研竞品) / plan(规划roadmap)。说'转PRD'落地。"
+trigger: "用户显式打 /wl-insight; 或自然语言需求澄清(产品听不懂时)"
 ---
 
 
@@ -38,7 +38,7 @@ insight（探索/调研/规划）→ [用户确认转PRD] → prd（落地）→
 ```
 
 **insight 不产 PRD，不画原型，不分配 REQ-ID。** insight 的产出是**洞察报告**（.md）。
-报告写完，提示用户"要把某个机会转成 PRD 吗？" → 是 → 自动进 `/wl-prd-full` 参考模式（mode: reference）。
+报告写完，提示用户"要把某个机会转成 PRD 吗？" → 是 → 自动进 `/wl-prd` 参考模式（mode: reference）。
 
 ---
 
@@ -154,12 +154,12 @@ OST     ├─ Opportunity（用户机会/痛点）─ discover ──┤  → i
 insight 报告末尾**永远**给一句：
 
 ```
-要把握住哪个机会？说"转 PRD"我把它作为现状输入，进 /wl-prd-full 参考模式落地成可执行 PRD。
+要把握住哪个机会？说"转 PRD"我把它作为现状输入，进 /wl-prd 参考模式落地成可执行 PRD。
 ```
 
 用户说"转 PRD"或指定某个机会 → 触发：
 ```
-/wl-prd-full 参考：{报告路径}#{机会编号}
+/wl-prd 参考：{报告路径}#{机会编号}
 ```
 prd 以 reference 模式（mode: reference）承接，读取 insight 报告作为现状背景，走"轻反思+批量确认"流程落地。