sdd-flow-kit 1.2.3 → 1.3.0

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

@@ -62,7 +62,17 @@ def version_slug(prefix: str, version: str) -> str:
 
 
 def search_keywords(prefix: str, version: str) -> list[str]:
-    """固定顺序（与用户 Confluence 全局搜索习惯一致）。无论用户输入 ADI 2.3.2 还是 ADI_V2.3.2 都走这一套。"""
+    """固定顺序（与用户 Confluence 全局搜索习惯一致）。"""
+    p = prefix.strip()
+    # BreakX（破圈引擎）PRD 在 xhs 空间，页面标题多为 V1.0.2 xxx，而非 BreakX_V1.0.2
+    if p.upper() in ("BREAKX", "BX"):
+        return [
+            f"V{version}",
+            f"BreakX V{version}",
+            f"BreakX_V{version}",
+            f"BreakX-V{version}",
+            f"xhs V{version}",
+        ]
     return [
         f"{prefix}_V{version}",
         f"{prefix}-V{version}",
@@ -147,6 +157,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 +231,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,6 +396,8 @@ def main():
         or DEFAULT_CONFLUENCE_PASSWORD
     )
     prefix = os.environ.get("DOC_PRODUCT_PREFIX", "{{DOC_PRODUCT_PREFIX}}").strip() or "{{DOC_PRODUCT_PREFIX}}"
+    if prefix.upper() in ("BREAKX", "BX") and not os.environ.get("CONFLUENCE_SPACE"):
+        os.environ["CONFLUENCE_SPACE"] = "xhs"
     version = normalize_version(sys.argv[1])
     keywords = search_keywords(prefix, version)
 

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」。