sdd-flow-kit 1.0.2 → 1.0.4

package/README.md

@@ -14,7 +14,10 @@
 #### 安装教程
 
 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）
 3.  安装流程（安装即用，默认 `claude-code`）：`npx sdd-flow-kit install`
     - 会自动安装对应 AI 环境并写入项目级触发 Skill（仅在“开发 <产品> <版本> 需求/版本/PRD”场景触发）
     - 会在项目根目录生成 `docs/<项目>-doc-skill/`（用于 PRD 下载脚本与说明），可通过 `--project` 选择：`OMS` / `ADI` / `欢盟` / `AD Tools`（默认 `OMS`）
@@ -22,6 +25,27 @@
 5.  （可选）环境健检：`npx sdd-flow-kit doctor --agent claude-code`
 6.  完成后，直接在 Cursor / Claude Code / Codex / OpenClaw 中用自然语言发起需求，例如：`开发 ADI 2.3.2 需求`
 
+> 可通过环境变量覆盖安装时默认项目类型：`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/postinstall.js

@@ -0,0 +1,46 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_path_1 = __importDefault(require("node:path"));
+const node_process_1 = __importDefault(require("node:process"));
+const setupProject_1 = require("./steps/setupProject");
+const ALLOWED_PROJECTS = ["OMS", "ADI", "欢盟", "AD Tools"];
+function resolveProjectKindFromEnv() {
+    const raw = (node_process_1.default.env.SDD_FLOW_KIT_PROJECT ?? "").trim();
+    if (ALLOWED_PROJECTS.includes(raw)) {
+        return raw;
+    }
+    return "OMS";
+}
+async function main() {
+    // npm/pnpm 安装依赖时，INIT_CWD 指向用户项目根目录。
+    const initCwd = node_process_1.default.env.INIT_CWD ? node_path_1.default.resolve(node_process_1.default.env.INIT_CWD) : null;
+    const pkgDir = node_path_1.default.resolve(__dirname, "..");
+    const projectRoot = initCwd ?? node_process_1.default.cwd();
+    // 避免在本包自身仓库开发安装依赖时重复触发自动初始化。
+    if (projectRoot === pkgDir)
+        return;
+    const isInteractive = Boolean(node_process_1.default.stdin.isTTY && node_process_1.default.stdout.isTTY);
+    const projectKind = resolveProjectKindFromEnv();
+    // eslint-disable-next-line no-console
+    console.log(`[sdd-flow-kit] postinstall bootstrap at: ${projectRoot}`);
+    // eslint-disable-next-line no-console
+    console.log(`[sdd-flow-kit] interactive=${isInteractive}, defaultProject=${projectKind}`);
+    await (0, setupProject_1.setupProject)({
+        projectRoot,
+        agent: "claude-code",
+        // 交互安装允许用户在 setupProject 内选择 agent/project/branch
+        yes: !isInteractive,
+        dryRun: false,
+        projectKind,
+    });
+    // eslint-disable-next-line no-console
+    console.log("[sdd-flow-kit] setup completed");
+}
+main().catch((err) => {
+    // 不阻断依赖安装，仅告警
+    // eslint-disable-next-line no-console
+    console.warn("[sdd-flow-kit] postinstall setup skipped:", err instanceof Error ? err.message : err);
+});

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sdd-flow-kit",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "private": false,
   "description": "Cross-agent SDD automated development workflow kit (ADI/ADI-like).",
   "license": "MIT",
@@ -17,7 +17,8 @@
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "start": "node dist/cli.js",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "postinstall": "node dist/postinstall.js"
   },
   "devDependencies": {
     "@types/node": "^20.14.10",

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 流程”推进某版本需求
 
 ## 触发后必须执行