sdd-flow-kit 1.0.3 → 1.0.5

package/README.md

@@ -14,7 +14,7 @@
 #### 安装教程
 
 1.  进入你要开发的项目目录
-2.  安装：`npm i -D sdd-flow-kit`
+2.  安装：`pnpm add -D sdd-flow-kit && pnpm rebuild sdd-flow-kit`
     - 安装后会自动执行一次初始化（postinstall）
     - 交互终端下会提示选择项目类型（OMS / ADI / 欢盟 / AD Tools，默认 OMS）
     - 非交互环境自动使用默认值（agent=claude-code, project=OMS）
@@ -27,6 +27,25 @@
 
 > 可通过环境变量覆盖安装时默认项目类型：`SDD_FLOW_KIT_PROJECT=ADI npm i -D sdd-flow-kit`
 
+#### 安装失败排查（推荐复制执行）
+
+当安装后没有生成 `.cursor/skills/sdd-flow-kit/SKILL.md` 时，按以下顺序处理：
+
+1.  检查包是否已安装：`pnpm list sdd-flow-kit --depth 0`
+2.  若出现 `ERR_PNPM_UNEXPECTED_STORE`，先对齐 store（示例）：
+    - `pnpm config set store-dir /Users/<your-user>/Library/pnpm/store/v10 --global`
+3.  重新触发脚本：`pnpm rebuild sdd-flow-kit`
+4.  若仍未生成，执行手动兜底（100%触发初始化）：
+    - `node ./node_modules/sdd-flow-kit/dist/postinstall.js`
+5.  验证产物：
+    - `ls .cursor/skills/sdd-flow-kit/SKILL.md`
+    - `ls .claude/skills/sdd-flow-kit/SKILL.md`
+    - `ls docs/*-doc-skill/SKILL.md`
+
+团队推荐安装命令（稳妥）：
+
+`pnpm add -D sdd-flow-kit && pnpm rebuild sdd-flow-kit`
+
 #### 使用说明
 
 1.  `install`（等价 `setup`）：提示选择开发环境（cursor/claude-code/codex/openclaw，默认 claude-code）与开发分支（无则自动创建），并检测/安装 openspec+superpower 基础环境，同时写入项目级 Skill

package/dist/steps/invokeFlow.js

@@ -4,10 +4,15 @@ exports.parseInvokeText = parseInvokeText;
 exports.toRunOptions = toRunOptions;
 function parseInvokeText(text) {
     const normalized = text.trim();
-    const match = normalized.match(/开发\s*([A-Za-z][A-Za-z0-9_-]*)\s*([0-9]+(?:\.[0-9]+){1,3})\s*需求?/i);
+    // 兼容以下常见表达：
+    // - 开发 OMS 1.24.4 需求
+    // - 开发 OMS-V1.24.4 版本
+    // - 开发OMS-V1.24.4版本
+    // - 开发 AD Tools V1.2.3 PRD
+    const match = normalized.match(/开发\s*(.+?)(?:[-_\s]*)V?([0-9]+(?:\.[0-9]+){1,3})\s*(?:需求|版本|PRD)?/i);
     if (!match)
         return null;
-    const product = match[1].toUpperCase();
+    const product = match[1].replace(/[-_\s]+$/g, "").toUpperCase();
     const version = match[2];
     return { product, version };
 }

package/dist/steps/startFlow.js

@@ -79,7 +79,7 @@ async function startFlowScaffold(options) {
         "",
         `本次 runId: \`${runId}\``,
         "",
-        "## Step 1：获取需求文档（adi-doc-skill）",
+        "## Step 1：获取需求文档（docs/<project>-doc-skill）",
         "请打开 `01-获取需求文档指引.md`，并使用你的 AI 工具执行相应动作，把 PRD/接口文档回填到 `source/`。",
         "",
         "## Step 2：执行 SDD 循环并生成 01/02/03 文件",

package/package.json

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

package/src/templates/artifacts/06-agent-skill.template.md

@@ -6,7 +6,12 @@ description: 当用户说“开发 <产品> <版本> 需求/版本/PRD”或类
 # SDD Flow Trigger Skill
 
 ## 触发条件（仅这些场景触发）
-- 用户说法包含类似：`开发 XXX 1.2 需求`、`开发 XXX 1.2.3 版本`、`开发 XXX PRD`
+- 用户说法包含类似：
+  - `开发 XXX 1.2 需求`
+  - `开发 XXX 1.2.3 版本`
+  - `开发 XXX-V1.2.3 版本`
+  - `开发XXX-V1.2.3版本`（无空格连写）
+  - `开发 XXX PRD`
 - 或明确要求“按 SDD 流程”推进某版本需求
 
 ## 触发后必须执行

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

@@ -39,6 +39,25 @@ def env(name: str, default: str | None = None) -> str:
     return str(v)
 
 
+def load_env_file(file_path: Path) -> None:
+    """轻量加载 .env 文件（不依赖 python-dotenv）。"""
+    if not file_path.exists() or not file_path.is_file():
+        return
+    try:
+        for raw in file_path.read_text(encoding="utf-8").splitlines():
+            line = raw.strip()
+            if not line or line.startswith("#") or "=" not in line:
+                continue
+            key, value = line.split("=", 1)
+            key = key.strip()
+            value = value.strip().strip('"').strip("'")
+            if key and key not in os.environ:
+                os.environ[key] = value
+    except Exception:
+        # 失败不阻断，继续走显式环境变量
+        pass
+
+
 def normalize_version(raw: str) -> str:
     """将 1.2.3 / V1.2.3 / XXX-V1.2.3 / XXX_V1.2.3 统一为 1.2.3"""
     v = raw.strip()
@@ -171,6 +190,11 @@ def main():
         print("   用法: python3 confluence-doc.py <版本号>")
         sys.exit(1)
 
+    # 自动尝试从项目常见 env 文件加载配置，降低手工配置成本
+    repo_root = Path(__file__).resolve().parents[2]
+    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")

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

@@ -52,4 +52,5 @@ 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_*` 配置可直接复用）