sdd-flow-kit 1.0.6 → 1.0.8

package/README.md

@@ -14,14 +14,13 @@
 #### 安装教程
 
 1.  进入你要开发的项目目录
-2.  安装：`pnpm add -D sdd-flow-kit && pnpm rebuild sdd-flow-kit`
-    - 安装后会自动执行一次初始化（postinstall）
-    - 交互终端下会提示选择项目类型（OMS / ADI / 欢盟 / AD Tools，默认 OMS）
-    - 非交互环境自动使用默认值（agent=claude-code, project=OMS）
-3.  安装流程（安装即用，默认 `claude-code`）：`npx sdd-flow-kit install`
-    - 会自动安装对应 AI 环境并写入项目级触发 Skill（仅在“开发 <产品> <版本> 需求/版本/PRD”场景触发）
-    - 会在项目根目录生成 `docs/<项目>-doc-skill/`（用于 PRD 下载脚本与说明），可通过 `--project` 选择：`OMS` / `ADI` / `欢盟` / `AD Tools`（默认 `OMS`）
-    - 会自动注入 `.opsx/config.json`（按所选工具写入 editor/skillsDir/commandsDir）
+2.  安装：`pnpm add -D sdd-flow-kit `
+    检查是否安装  - `ls .cursor/skills/sdd-flow-kit/SKILL.md`
+    - `ls .claude/skills/sdd-flow-kit/SKILL.md`
+    - `ls docs/*-doc-skill/SKILL.md`
+3.  若仍未生成，执行手动兜底（100%触发初始化）：
+    - `node ./node_modules/sdd-flow-kit/dist/postinstall.js`
+    
 4.  （可选）预演安装：`npx sdd-flow-kit install --dry-run --plan-json`
 5.  （可选）环境健检：`npx sdd-flow-kit doctor --agent claude-code`
 6.  完成后，直接在 Cursor / Claude Code / Codex / OpenClaw 中用自然语言发起需求，例如：`开发 ADI 2.3.2 需求`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sdd-flow-kit",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "private": false,
   "description": "Cross-agent SDD automated development workflow kit (ADI/ADI-like).",
   "license": "MIT",

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

@@ -1,23 +1,5 @@
 #!/usr/bin/env python3
-"""
-Confluence 需求文档获取脚本（Playwright）
-
-用法:
-  python3 confluence-doc.py <版本号>
-
-环境变量:
-  CONFLUENCE_BASE_URL      例如 https://confluence.huan.tv
-  CONFLUENCE_SEARCH_URL    例如 https://confluence.huan.tv/dosearchsite.action?includeArchivedSpaces=false
-  CONFLUENCE_USERNAME
-  CONFLUENCE_PASSWORD
-  DOC_PRODUCT_PREFIX       例如 ADI / OMS / HUAN / ADTOOLS
-  DOC_DOWNLOAD_DIR         输出目录（默认当前脚本所在目录的上级 docs/）
-
-注意:
-  - 为安全起见，本模板不包含任何默认账号密码
-  - 你需要先安装 playwright:
-      pip install playwright && playwright install chromium
-"""
+"""Confluence 需求文档获取脚本（Playwright - 通用版）"""
 
 import sys
 import os
@@ -34,9 +16,9 @@ except ImportError:
 
 def env(name: str, default: str | None = None) -> str:
     v = os.environ.get(name, default)
-    if v is None or str(v).strip() == "":
-        raise RuntimeError(f"缺少环境变量: {name}")
-    return str(v)
+    if v is None:
+        return ""
+    return str(v).strip()
 
 
 def load_env_file(file_path: Path) -> None:
@@ -72,7 +54,11 @@ def version_slug(prefix: str, version: str) -> str:
 
 
 def search_keywords(prefix: str, version: str) -> list[str]:
-    return [f"{prefix}-V{version}", f"{prefix}_V{version}"]
+    # 搜索时强制带 V，并增加不带前缀的 V 兜底项：
+    # 1) ADI-V2.3.3
+    # 2) ADI_V2.3.3
+    # 3) V2.3.3
+    return [f"{prefix}-V{version}", f"{prefix}_V{version}", f"V{version}"]
 
 
 def sanitize_filename(name: str) -> str:
@@ -89,6 +75,11 @@ def parse_html_to_markdown(html_content: str) -> str:
     md = re.sub(r"<li[^>]*>(.*?)</li>", r"- \1\n", md, flags=re.DOTALL | re.IGNORECASE)
     md = re.sub(r'<a[^>]*href="([^"]+)"[^>]*>(.*?)</a>', r"[\2](\1)", md, flags=re.DOTALL | re.IGNORECASE)
     md = re.sub(r'<img[^>]*src="([^"]+)"[^>]*>', r"![](\1)", md, flags=re.DOTALL | re.IGNORECASE)
+    md = re.sub(r"<table[^>]*>", r"\n", md, flags=re.DOTALL | re.IGNORECASE)
+    md = re.sub(r"</table>", r"\n", md, flags=re.DOTALL | re.IGNORECASE)
+    md = re.sub(r"<tr[^>]*>", r"|", md, flags=re.DOTALL | re.IGNORECASE)
+    md = re.sub(r"</tr>", r"\n", md, flags=re.DOTALL | re.IGNORECASE)
+    md = re.sub(r"<t[dh][^>]*>(.*?)</t[dh]>", r"|\1", md, flags=re.DOTALL | re.IGNORECASE)
     md = re.sub(r"<p[^>]*>(.*?)</p>", r"\1\n\n", md, flags=re.DOTALL | re.IGNORECASE)
     md = re.sub(r"<br[^>]*>", r"\n", md, flags=re.DOTALL | re.IGNORECASE)
     md = re.sub(r"<strong[^>]*>(.*?)</strong>", r"**\1**", md, flags=re.DOTALL | re.IGNORECASE)
@@ -167,20 +158,20 @@ def find_search_result(page, base_url: str, keyword: str):
     return best
 
 
-def run_search(page, base_url: str, keyword: str, search_url: str) -> str | None:
-    page.goto(search_url, wait_until="networkidle", timeout=60000)
-    page.wait_for_timeout(800)
+def run_search(page, base_url: str, keyword: str) -> str | None:
     search_selector = None
     for selector in ["#search-query-input", "input[name='search-query']", "input.search-query", "input[id*='search']"]:
         if page.locator(selector).count() > 0:
             search_selector = selector
             break
     if not search_selector:
+        if page.locator("input[type='text']").count() == 0:
+            return None
         search_selector = "input[type='text']"
-    page.fill(search_selector, keyword)
+    page.fill(search_selector, keyword, timeout=8000)
     page.keyboard.press("Enter")
     page.wait_for_load_state("networkidle", timeout=30000)
-    page.wait_for_timeout(1500)
+    page.wait_for_timeout(2000)
     return find_search_result(page, base_url, keyword)
 
 
@@ -195,10 +186,10 @@ def main():
     for env_name in [".env.pre", ".env", ".env.local", ".env.development", ".env.test"]:
         load_env_file(repo_root / env_name)
 
-    base_url = env("CONFLUENCE_BASE_URL")
-    search_url = env("CONFLUENCE_SEARCH_URL", base_url.rstrip("/") + "/dosearchsite.action?includeArchivedSpaces=false")
-    username = env("CONFLUENCE_USERNAME")
-    password = env("CONFLUENCE_PASSWORD")
+    base_url = env("CONFLUENCE_BASE_URL", "https://confluence.huan.tv") or "https://confluence.huan.tv"
+    search_url = env("CONFLUENCE_SEARCH_URL") or f"{base_url.rstrip('/')}/dosearchsite.action?includeArchivedSpaces=false"
+    username = env("CONFLUENCE_USERNAME") or env("CONFLUENCE_USER")
+    password = env("CONFLUENCE_PASSWORD") or env("CONFLUENCE_PASS")
     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)
@@ -221,23 +212,34 @@ def main():
 
     with sync_playwright() as p:
         browser = p.chromium.launch(headless=True)
-        context = browser.new_context()
+        context = browser.new_context(
+            user_agent=(
+                "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) "
+                "AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
+            )
+        )
         page = context.new_page()
         try:
-            # 登录（如需要）
-            page.goto(search_url, wait_until="networkidle", timeout=60000)
+            print("\n📄 访问搜索页面...")
+            response = page.goto(search_url, wait_until="networkidle", timeout=60000)
+            if response:
+                print(f"   状态码: {response.status}")
             if "login" in page.url.lower():
+                if not username or not password:
+                    raise RuntimeError("检测到登录页但未提供 CONFLUENCE_USERNAME / CONFLUENCE_PASSWORD")
+                print("🔐 检测到需要登录，开始自动登录...")
                 page.wait_for_selector("#username-field", timeout=10000)
                 page.fill("#username-field", username)
                 page.fill("#password-field", password)
                 page.click("#login-button")
                 page.wait_for_load_state("networkidle", timeout=30000)
+                print("✅ 登录完成")
 
             target_url = None
             matched_keyword = None
             for kw in keywords:
                 print(f"\n🔍 搜索关键词: {kw}")
-                found = run_search(page, base_url, kw, search_url)
+                found = run_search(page, base_url, kw)
                 if found:
                     target_url = found
                     matched_keyword = kw
@@ -260,6 +262,8 @@ def main():
             content_elem = page.locator("#main-content")
             if not content_elem.count():
                 content_elem = page.locator(".wiki-content")
+            if not content_elem.count():
+                content_elem = page.locator(".content-body")
             content_html = content_elem.inner_html() if content_elem.count() else ""
 
             img_urls = re.findall(r'<img[^>]*src="([^"]+)"', content_html)
@@ -304,6 +308,9 @@ def main():
             print("\n✅ 获取完成！")
             print(f"📄 主文档: {md_path}")
             print(f"🖼️ 图片目录: {version_dir}")
+        except Exception as e:
+            print(f"\n❌ 获取失败: {e}")
+            raise
         finally:
             browser.close()
 

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

@@ -21,7 +21,6 @@ description: |
 
 ```bash
 cd docs/{{SKILL_DIR}}
-export CONFLUENCE_BASE_URL="https://confluence.huan.tv"
 export CONFLUENCE_USERNAME="<你的账号>"
 export CONFLUENCE_PASSWORD="<你的密码>"
 export DOC_PRODUCT_PREFIX="{{PRODUCT_PREFIX}}"
@@ -37,6 +36,12 @@ python3 confluence-doc.py {{PRODUCT_PREFIX}}-V1.2.3
 python3 confluence-doc.py {{PRODUCT_PREFIX}}_V1.2.3
 ```
 
+脚本搜索顺序（强制带 `V`）：
+
+1. `{{PRODUCT_PREFIX}}-V<版本>`
+2. `{{PRODUCT_PREFIX}}_V<版本>`
+3. `V<版本>`（兜底）
+
 ## 输出结构
 
 ```
@@ -52,5 +57,6 @@ python3 confluence-doc.py {{PRODUCT_PREFIX}}_V1.2.3
 - 依赖 Playwright：`pip install playwright && playwright install chromium`
 - 脚本：`docs/{{SKILL_DIR}}/confluence-doc.py`
 - 为安全起见，脚本不包含默认账号密码，请用环境变量注入
-- 脚本会自动尝试读取仓库根目录的 `.env.pre` / `.env` / `.env.local`（若其中存在 `CONFLUENCE_*` 配置可直接复用）
+- 默认 Confluence 地址为 `https://confluence.huan.tv`（可用 `CONFLUENCE_BASE_URL` 覆盖）
+- 脚本会自动尝试读取仓库根目录的 `.env.pre` / `.env` / `.env.local` / `.env.development` / `.env.test`（若其中存在 `CONFLUENCE_*` 配置可直接复用）