sdd-flow-kit 1.2.3 → 1.3.1

package/src/templates/skills/confluence-doc.py.template

@@ -61,14 +61,52 @@ def version_slug(prefix: str, version: str) -> str:
     return prefix.lower() + "-v" + version.replace(".", "")
 
 
-def search_keywords(prefix: str, version: str) -> list[str]:
-    """固定顺序（与用户 Confluence 全局搜索习惯一致）。无论用户输入 ADI 2.3.2 还是 ADI_V2.3.2 都走这一套。"""
-    return [
-        f"{prefix}_V{version}",
-        f"{prefix}-V{version}",
-        f"{prefix}_{version}",
-        f"{prefix}-{version}",
-    ]
+def dedupe_keywords(items: list[str]) -> list[str]:
+    """去重并保持顺序。"""
+    seen: set[str] = set()
+    out: list[str] = []
+    for item in items:
+        key = item.strip()
+        if not key or key in seen:
+            continue
+        seen.add(key)
+        out.append(key)
+    return out
+
+
+def search_keywords(prefix: str, version: str, raw_input: str | None = None) -> list[str]:
+    """固定顺序（与用户 Confluence 全局搜索习惯一致）。
+
+    ADI 等产品的典型降级链：
+    用户原样输入 → ADI_V2.3.4 → ADI-V2.3.4 → ADI_2.3.4 → ADI-2.3.4
+    → ADI_v2.3.4 → ADI-v2.3.4 → ADI V2.3.4 → V2.3.4
+    """
+    p = prefix.strip()
+    # BreakX（破圈引擎）PRD 在 xhs 空间，页面标题多为 V1.0.2 xxx，而非 BreakX_V1.0.2
+    if p.upper() in ("BREAKX", "BX"):
+        return dedupe_keywords(
+            [
+                *( [raw_input.strip()] if raw_input and raw_input.strip() else [] ),
+                f"V{version}",
+                f"BreakX V{version}",
+                f"BreakX_V{version}",
+                f"BreakX-V{version}",
+                f"xhs V{version}",
+            ]
+        )
+    return dedupe_keywords(
+        [
+            *( [raw_input.strip()] if raw_input and raw_input.strip() else [] ),
+            f"{prefix}_V{version}",
+            f"{prefix}-V{version}",
+            f"{prefix}_{version}",
+            f"{prefix}-{version}",
+            f"{prefix}_v{version}",
+            f"{prefix}-v{version}",
+            f"{prefix} V{version}",
+            f"V{version}",
+        ]
+    )
 
 
 def sanitize_filename(name: str) -> str:
@@ -147,6 +185,12 @@ def score_link_match(text: str, href: str, prefix: str, version: str, keyword: s
     slug = f"{p}v{v_compact}"
     if slug in path_compact or f"{p}-v{v_compact}" in path or f"{p}_v{v_compact}" in path:
         score += 4
+    # BreakX：标题以 V1.0.2 开头时加分
+    if p in ("breakx", "bx") and (t.startswith(f"v{version}") or f"v{version}" in t[:12]):
+        score += 5
+    space = env("CONFLUENCE_SPACE", "").lower()
+    if space and f"/spaces/{space}/" in href.lower():
+        score += 5
     return score
 
 
@@ -215,6 +259,12 @@ def is_prd_page(page, page_url: str) -> bool:
 
     crumbs = read_breadcrumb_text(page)
     crumbs_upper = crumbs.upper()
+    prefix = env("DOC_PRODUCT_PREFIX", "").upper()
+    # BreakX：xhs 空间 PRD 挂在「产品设计」下，不一定有 PRD 字样
+    if prefix in ("BREAKX", "BX") and "/spaces/xhs/" in page_url.lower():
+        if "产品设计" in crumbs or "BREAKX" in crumbs_upper or "破圈" in crumbs:
+            print(f"      ✓ BreakX/xhs 产品设计命中: {crumbs[:120]}")
+            return True
     if re.search(r"\bPRD\b", crumbs_upper) or "需求" in crumbs or "PRD" in crumbs_upper:
         print(f"      ✓ PRD 父级命中: {crumbs[:120]}")
         return True
@@ -374,8 +424,11 @@ def main():
         or DEFAULT_CONFLUENCE_PASSWORD
     )
     prefix = os.environ.get("DOC_PRODUCT_PREFIX", "{{DOC_PRODUCT_PREFIX}}").strip() or "{{DOC_PRODUCT_PREFIX}}"
-    version = normalize_version(sys.argv[1])
-    keywords = search_keywords(prefix, version)
+    if prefix.upper() in ("BREAKX", "BX") and not os.environ.get("CONFLUENCE_SPACE"):
+        os.environ["CONFLUENCE_SPACE"] = "xhs"
+    raw_arg = sys.argv[1].strip()
+    version = normalize_version(raw_arg)
+    keywords = search_keywords(prefix, version, raw_input=raw_arg)
 
     # 输出目录默认为仓库 docs/ 下
     default_download = os.environ.get("DOC_DOWNLOAD_DIR")
@@ -439,7 +492,8 @@ def main():
                     pass
                 print(f"❌ 未找到 {prefix} {version} 的需求文档。")
                 print(
-                    "   排查：1) 是否存在 PRD 父级页面  2) 依次尝试 ADI_V2.3.2 / ADI-V2.3.2 / ADI_2.3.2 / ADI-2.3.2"
+                    "   排查：1) 是否存在 PRD 父级页面  2) 依次尝试 "
+                    "ADI_V2.3.4 / ADI-V2.3.4 / ADI_2.3.4 / ADI-2.3.4 / ADI_v2.3.4 / V2.3.4"
                 )
                 print("   3) 或设置 CONFLUENCE_PAGE_URL=<页面完整URL> 直接下载")
                 sys.exit(1)

package/src/templates/skills/doc-skill.SKILL.md.template

@@ -63,6 +63,8 @@ python3 confluence-doc.py {{PRODUCT_PREFIX}}_V1.2.3
 
 ## 注意事项
 
+{{CONFLUENCE_SPACE_NOTE}}
+
 - 依赖 Playwright：`pip install playwright && playwright install chromium`
 - 脚本：`docs/{{SKILL_DIR}}/confluence-doc.py`
 - 脚本已内置默认账号密码；如需使用其他账号可用环境变量覆盖

package/src/templates/skills/layered-testing-strategy.md

@@ -0,0 +1,35 @@
+# 分层测试策略（SDD / OpenSpec 强制）
+
+> 由 `sdd-flow-kit` 安装到目标项目时，应合并进 `tdd-script` 与 `playwright-e2e-dev-server` skill 的「验收层级」章节。
+
+## 四层模型
+
+| 层级 | 覆盖范围 | 典型断言 | 缺失风险 |
+|------|---------|---------|---------|
+| **L1 能力** | API、状态机、mapper、脏数据 | 接口封装、枚举映射、mutation 参数 | 主流程不通 |
+| **L2 交互契约** | 列序、disabled、toast、tooltip、placeholder | **完整字符串**（禁止 `toContain('成功')`） | PRD 细节漏项 |
+| **L3 路径** | 每页面/每主链路一条 E2E | 登录 → 设规则 → 结果页重审 | 只 smoke 一条路径 |
+| **L4 视觉** | 原型图 / Figma / `playwright-pic` | 列位置、紫色摘要、布局两行限制 | UI 与原型偏差 |
+
+## 与 05-验收清单的绑定
+
+1. 每条 AC 的「测试类型」列决定最低层级（`unit`→L1/L2，`e2e`→L3，`visual`→L4）。
+2. `tasks.md` 的 Red task 标题须含 `[AC-XX]`，断言文案从 05「验收标准」列复制。
+3. P0 AC 至少一条自动化测试（unit/component/e2e）；纯 `manual` 的 P0 须在 deliver 前在 05 标 `已验收` 并注明证据路径。
+
+## UI 类 change 强制规则
+
+- **每个受影响页面**至少 **1 条 E2E**（非单点 smoke）。
+- **列表/表格类**：断言列顺序（`nth-child`、`data-column-index` 或表头文案顺序）。
+- **文案类**：断言 PRD/05 中的**完整** toast、tooltip、placeholder。
+- **弹窗类**：单条/批量模式、保存成功/失败分支均须有 L2 或 L3 覆盖。
+
+## Playwright
+
+- 默认无头；每用例结束截图到 `playwright-pic/<module>/<change>/`。
+- change 级 scope 须覆盖 05 中所有 `e2e` 类型 AC。
+
+## TDD Red 阶段
+
+- 先写失败测试，断言来自 `05-验收清单.md`，再写实现。
+- 禁止「规则列展示」类模糊断言；须写清「第 N 列」「文案为 XXX」。