sdd-flow-kit 1.1.1 → 1.2.1

package/README.md

@@ -71,6 +71,22 @@ npx sdd-flow-kit doctor --agent cursor
 > 完整环境（分支切换 + opsx-workflow）请另执行：`npx sdd-flow-kit install -y`  
 > 跳过 postinstall：`SDD_FLOW_KIT_SKIP_POSTINSTALL=1 pnpm add -D sdd-flow-kit`
 
+##### `pnpm add` 后依赖全被删掉（`Packages: +1 -932`）
+
+**原因**：`pnpm` 会按当前 `package.json` **同步** `node_modules`。若 manifest 里只剩 `sdd-flow-kit`（或文件被误保存成几行空壳），就会卸载其它所有包——**不是** `pnpm add` 单独删包，而是 manifest 已不完整。
+
+**恢复**（在业务仓如 `adInsight-web/frontend`）：
+
+1. 用 Git 恢复完整 `package.json`：`git checkout -- package.json`
+2. 重装：`pnpm install`
+3. 再装 kit（建议 **≥ 1.1.2**，且必须在有完整 `package.json` 的目录执行）：
+   - `cd frontend && pnpm add -D sdd-flow-kit@1.1.2`
+   - 或本地联调：`pnpm add -D file:../../sdd-flow-kit`
+
+**v1.1.2+ 防护**：`repairOpsxDeliveryScripts` 仅合并 `scripts`，写入前检查依赖条数与文件体积；`postinstall` 不再改 `package.json`，且必须有 `INIT_CWD` 才运行。
+
+**pnpm v10 构建脚本**：若出现 `Ignored build scripts: sdd-flow-kit`，执行 `pnpm approve-builds` 选中 `sdd-flow-kit`，或安装后手动：`node ./node_modules/sdd-flow-kit/dist/postinstall.js`
+
 #### 使用说明
 
 ##### 安装根：cd 到哪，装到哪（v1.2+）

package/dist/cli.js

@@ -16,6 +16,7 @@ const runGate_1 = require("./steps/runGate");
 const runPhaseAdvance_1 = require("./steps/runPhaseAdvance");
 const runPropose_1 = require("./steps/runPropose");
 const runDeliver_1 = require("./steps/runDeliver");
+const bootstrap_1 = require("./core/bootstrap");
 const projectRoots_1 = require("./core/projectRoots");
 const ALLOWED_AGENTS = ["cursor", "claude-code", "codex", "openclaw", "custom"];
 function getArgValue(flag) {
@@ -35,9 +36,11 @@ function printHelp() {
         "1) 生成流程产物骨架：",
         "   npx sdd-flow-kit start --product ADI --version 2.3.2",
         "",
-        "2) 安装流程到当前项目（推荐，安装即用）：",
-        "   npx sdd-flow-kit install",
-        "   (等价于: npx sdd-flow-kit setup)",
+        "2) 安装到当前目录（全量：SDD + OPSX + Superpowers，推荐）：",
+        "   cd <你的项目目录>   # 如 adInsight-web/frontend",
+        "   pnpm add -D sdd-flow-kit",
+        "   npx sdd-flow-kit install --project ADI -y",
+        "   本地 OPSX: SDD_OPSX_WORKFLOW_PACKAGE=file:../../opsx-workflow npx sdd-flow-kit install -y",
         "",
         "3) 生成骨架并进入可执行模式（推荐）：",
         "   npx sdd-flow-kit run --product ADI --version 2.3.2 --agent claude-code",
@@ -141,6 +144,26 @@ async function main() {
         process_1.default.exitCode = 1;
         return;
     }
+    const skipBootstrap = process_1.default.env.SDD_FLOW_KIT_SKIP_BOOTSTRAP === "1";
+    const bootstrapCommands = new Set([
+        "doctor",
+        "ensure-opsx",
+        "run",
+        "invoke",
+        "install",
+        "setup",
+        "gate",
+        "phase",
+        "propose",
+        "deliver",
+    ]);
+    if (!skipBootstrap && !dryRun && bootstrapCommands.has(cmd)) {
+        await (0, bootstrap_1.bootstrapProjectIfNeeded)({
+            projectRoot,
+            agent,
+            projectKind: projectKind,
+        });
+    }
     if (cmd === "gate") {
         const expect = getArgValue("--expect");
         if (!expect || !GATE_EXPECTS.includes(expect)) {
@@ -245,15 +268,6 @@ async function main() {
             // eslint-disable-next-line no-console
             console.log(JSON.stringify({ command: "doctor", projectRoot: path_1.default.resolve(projectRoot), result: doctor }, null, 2));
         }
-        if (cmd === "ensure-opsx" && !dryRun) {
-            await (0, setupProject_1.setupProject)({
-                projectRoot,
-                agent,
-                yes: true,
-                light: true,
-                projectKind: projectKind,
-            });
-        }
         if (!doctor.ok)
             process_1.default.exitCode = 1;
         return;
@@ -297,7 +311,7 @@ async function main() {
             const text = (fromFlag !== null && fromFlag !== void 0 ? fromFlag : raw).trim();
             const parsed = (0, invokeFlow_1.parseInvokeText)(text);
             if (!parsed) {
-                throw new Error("invoke 解析失败，请使用：开发 ADI 2.3.2 需求");
+                throw new Error("invoke 解析失败，示例：开发 ADI 2.3.2 需求 | 进行ADI_2.3.2版本开发");
             }
             const options = (0, invokeFlow_1.toRunOptions)({
                 parsed,
@@ -349,7 +363,7 @@ async function main() {
     // eslint-disable-next-line no-console
     console.log(`流程已初始化：openspec/PRD/${result.runId}/`);
     // eslint-disable-next-line no-console
-    console.log(`请打开 openspec/PRD/${result.runId}/NEXT.md，按脚本顺序执行 gate / phase / propose / deliver。`);
+    console.log(`请打开 openspec/PRD/${result.runId}/NEXT.md，严格按 gate→phase→propose→deliver 执行；确认点前禁止改 src/。`);
     // eslint-disable-next-line no-console
     console.log(`agent=${result.adapterName}, cli=${result.adapterAvailable ? "detected" : "missing"}, autoExecute=${result.executed ? "yes" : "manual"}`);
     // eslint-disable-next-line no-console

package/dist/core/bootstrap.js

@@ -0,0 +1,58 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bootstrapProjectIfNeeded = bootstrapProjectIfNeeded;
+const path_1 = __importDefault(require("path"));
+const inferProject_1 = require("./inferProject");
+const packageJsonPatch_1 = require("./packageJsonPatch");
+const opsxDelivery_1 = require("./opsxDelivery");
+const projectRoots_1 = require("./projectRoots");
+const setupProject_1 = require("../steps/setupProject");
+/**
+ * pnpm v10 常拦截 postinstall；首次跑 CLI 时补全 SDD + OPSX 全栈（不切分支）。
+ */
+async function bootstrapProjectIfNeeded(options) {
+    var _a;
+    const installRoot = (0, projectRoots_1.resolveInstallRoot)(options.projectRoot);
+    if (await (0, opsxDelivery_1.isOpsxApplyReady)(installRoot)) {
+        return false;
+    }
+    if (options.dryRun) {
+        return true;
+    }
+    const kind = (_a = options.projectKind) !== null && _a !== void 0 ? _a : (await (0, inferProject_1.inferProjectKind)(installRoot));
+    // eslint-disable-next-line no-console
+    console.log("[sdd-flow-kit] 检测到 OPSX 未就绪，正在自动 bootstrap（等价 install -y）…");
+    const pkgRoot = await (0, projectRoots_1.resolvePackageRoot)(installRoot);
+    const pnpmPatched = await (0, packageJsonPatch_1.ensurePnpmAllowSddFlowKitBuild)(path_1.default.join(pkgRoot, "package.json"));
+    if (pnpmPatched) {
+        // eslint-disable-next-line no-console
+        console.log("[sdd-flow-kit] 已写入 pnpm.onlyBuiltDependencies: sdd-flow-kit；下次 pnpm install 将执行 postinstall");
+    }
+    await (0, setupProject_1.setupProject)({
+        projectRoot: installRoot,
+        agent: options.agent,
+        yes: true,
+        light: false,
+        skipGit: true,
+        projectKind: kind !== null && kind !== void 0 ? kind : "ADI",
+    });
+    if (!(await (0, opsxDelivery_1.isOpsxApplyReady)(installRoot))) {
+        await (0, opsxDelivery_1.ensureOpsxWorkflow)({
+            projectRoot: installRoot,
+            agent: options.agent,
+        });
+    }
+    const ready = await (0, opsxDelivery_1.isOpsxApplyReady)(installRoot);
+    if (ready) {
+        // eslint-disable-next-line no-console
+        console.log("[sdd-flow-kit] bootstrap 完成：SDD + OPSX 已就绪");
+    }
+    else {
+        // eslint-disable-next-line no-console
+        console.warn("[sdd-flow-kit] bootstrap 后仍有检查未通过，请执行: npx sdd-flow-kit doctor --agent cursor");
+    }
+    return true;
+}

package/dist/core/opsxDelivery.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveOpsxWorkflowPackage = resolveOpsxWorkflowPackage;
 exports.deliveryPipelineNpmScripts = deliveryPipelineNpmScripts;
 exports.pathExists = pathExists;
 exports.resolveOpsxAgent = resolveOpsxAgent;
@@ -14,8 +15,12 @@ exports.collectDeliverySetupChecks = collectDeliverySetupChecks;
 const child_process_1 = require("child_process");
 const promises_1 = __importDefault(require("fs/promises"));
 const path_1 = __importDefault(require("path"));
-const fs_1 = require("./fs");
+const packageJsonPatch_1 = require("./packageJsonPatch");
 const projectRoots_1 = require("./projectRoots");
+const opsxWorkflowPackage_1 = require("./opsxWorkflowPackage");
+function resolveOpsxWorkflowPackage() {
+    return (0, opsxWorkflowPackage_1.resolveOpsxWorkflowPackageForCwd)(process.cwd());
+}
 const DELIVERY_SCRIPT_REL = ".cursor/skills/opsx-dev-delivery-pipeline/scripts/opsx-delivery-pipeline.sh";
 function deliveryPipelineNpmScripts() {
     const full = `bash ${DELIVERY_SCRIPT_REL}`;
@@ -45,7 +50,7 @@ async function resolveOpsxAgent(projectRoot, preferred) {
         return "claude-code";
     return preferred;
 }
-/** 将 package.json 中过期的 poquan-delivery-pipeline 脚本修正为 opsx-dev-delivery-pipeline */
+/** 将 package.json 中过期的 poquan 脚本修正为 opsx-dev-delivery-pipeline（仅合并 scripts） */
 async function repairOpsxDeliveryScripts(projectRoot) {
     const pkgPath = path_1.default.join(projectRoot, "package.json");
     if (!(await pathExists(pkgPath)))
@@ -55,29 +60,35 @@ async function repairOpsxDeliveryScripts(projectRoot) {
         return false;
     const { full, short } = deliveryPipelineNpmScripts();
     const text = await promises_1.default.readFile(pkgPath, "utf8");
-    const pkg = JSON.parse(text);
+    let pkg;
+    try {
+        pkg = JSON.parse(text);
+    }
+    catch {
+        return false;
+    }
     if (!pkg.scripts)
         pkg.scripts = {};
-    let changed = false;
     const needsFix = (v) => !v || v.includes("poquan-dev-delivery-pipeline") || v.includes("poquan-delivery-pipeline");
-    if (needsFix(pkg.scripts["opsx:delivery-pipeline"])) {
-        pkg.scripts["opsx:delivery-pipeline"] = full;
-        changed = true;
-    }
+    const updates = {};
+    if (needsFix(pkg.scripts["opsx:delivery-pipeline"]))
+        updates["opsx:delivery-pipeline"] = full;
     if (needsFix(pkg.scripts["opsx:delivery-pipeline:short"])) {
-        pkg.scripts["opsx:delivery-pipeline:short"] = short;
-        changed = true;
+        updates["opsx:delivery-pipeline:short"] = short;
     }
-    if (!changed)
+    if (Object.keys(updates).length === 0)
         return false;
-    await (0, fs_1.writeTextFileEnsuredDir)(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`);
-    return true;
+    const result = await (0, packageJsonPatch_1.patchPackageJsonScripts)(pkgPath, updates, {
+        minDependencyCount: 2,
+        minBytes: 120,
+    });
+    return result.ok && result.changed;
 }
 function hasCommand(cmd) {
     return (0, child_process_1.spawnSync)("which", [cmd], { stdio: "ignore" }).status === 0;
 }
 function buildOpsxWorkflowSetupCommand(projectRoot, agent) {
-    const baseArgs = ["@lixin5257xxx/opsx-workflow", "setup"];
+    const baseArgs = [resolveOpsxWorkflowPackage(), "setup"];
     if (agent === "cursor") {
         return {
             cmd: "npx",
@@ -99,6 +110,7 @@ async function isOpsxApplyReady(projectRoot) {
 }
 /** 缺 openspec/TDD/Playwright 工作流时安装 @lixin5257xxx/opsx-workflow，并修复 delivery 脚本 */
 async function ensureOpsxWorkflow(options) {
+    var _a;
     const installRoot = await (0, projectRoots_1.resolvePackageRoot)((0, projectRoots_1.resolveInstallRoot)(options.projectRoot));
     const plannedActions = [];
     let checks = await collectDeliverySetupChecks(installRoot);
@@ -129,7 +141,10 @@ async function ensureOpsxWorkflow(options) {
         env: process.env,
     });
     if (ret.status !== 0) {
-        throw new Error(`opsx-workflow 安装失败：${cmd} ${args.join(" ")}`);
+        const hint = ((_a = process.env.SDD_OPSX_WORKFLOW_PACKAGE) === null || _a === void 0 ? void 0 : _a.trim()) ?
+            ""
+            : " 本地 OPSX 可设: SDD_OPSX_WORKFLOW_PACKAGE=file:../../opsx-workflow";
+        throw new Error(`opsx-workflow 安装失败：${cmd} ${args.join(" ")}${hint}`);
     }
     const repairedScripts = await repairOpsxDeliveryScripts(installRoot);
     if (repairedScripts) {
@@ -159,10 +174,12 @@ async function collectDeliverySetupChecks(installRoot) {
         ok: await pathExists(path_1.default.join(openspecRoot, "openspec")),
         detail: openspecRoot === root ? "openspec/ 目录（安装根）" : `openspec/ 目录（上级 ${openspecRoot}）`,
     });
+    const openspecOk = hasCommand("openspec") ||
+        (0, child_process_1.spawnSync)("npx", ["openspec", "--version"], { stdio: "ignore", cwd: root }).status === 0;
     checks.push({
         name: "openspec-cli",
-        ok: hasCommand("openspec"),
-        detail: "openspec CLI（npx openspec 或全局安装）",
+        ok: openspecOk,
+        detail: openspecOk ? "openspec CLI 可用" : "请安装 openspec CLI 或执行 opsx-workflow setup",
     });
     const skillPath = path_1.default.join(root, ".cursor", "skills", "opsx-dev-delivery-pipeline", "SKILL.md");
     checks.push({

package/dist/core/opsxWorkflowPackage.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveOpsxWorkflowPackageForCwd = resolveOpsxWorkflowPackageForCwd;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+/** 本地联调 SDD_OPSX_WORKFLOW_PACKAGE=file:../../opsx-workflow；不存在则回退 npm 包 */
+function resolveOpsxWorkflowPackageForCwd(cwd) {
+    var _a;
+    const fromEnv = (_a = process.env.SDD_OPSX_WORKFLOW_PACKAGE) === null || _a === void 0 ? void 0 : _a.trim();
+    if (fromEnv === null || fromEnv === void 0 ? void 0 : fromEnv.startsWith("file:")) {
+        const localPath = path_1.default.resolve(cwd, fromEnv.slice("file:".length));
+        if (fs_1.default.existsSync(localPath)) {
+            return fromEnv;
+        }
+        // eslint-disable-next-line no-console
+        console.warn(`[sdd-flow-kit] SDD_OPSX_WORKFLOW_PACKAGE=${fromEnv} 不存在 (${localPath})，改用 @lixin5257xxx/opsx-workflow`);
+        return "@lixin5257xxx/opsx-workflow";
+    }
+    return fromEnv || "@lixin5257xxx/opsx-workflow";
+}

package/dist/core/packageJsonPatch.js

@@ -0,0 +1,89 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.countPackageDependencies = countPackageDependencies;
+exports.patchPackageJsonScripts = patchPackageJsonScripts;
+exports.ensurePnpmAllowSddFlowKitBuild = ensurePnpmAllowSddFlowKitBuild;
+const promises_1 = __importDefault(require("fs/promises"));
+const fs_1 = require("./fs");
+function countPackageDependencies(pkg) {
+    const deps = pkg.dependencies;
+    const devDeps = pkg.devDependencies;
+    return Object.keys(deps !== null && deps !== void 0 ? deps : {}).length + Object.keys(devDeps !== null && devDeps !== void 0 ? devDeps : {}).length;
+}
+async function patchPackageJsonScripts(pkgPath, scriptUpdates, options = {}) {
+    var _a, _b, _c, _d;
+    const minDependencyCount = (_a = options.minDependencyCount) !== null && _a !== void 0 ? _a : 1;
+    const minBytes = (_b = options.minBytes) !== null && _b !== void 0 ? _b : 80;
+    const minSizeRatio = (_c = options.minSizeRatio) !== null && _c !== void 0 ? _c : 0.5;
+    let text;
+    try {
+        text = await promises_1.default.readFile(pkgPath, "utf8");
+    }
+    catch {
+        return { ok: false, reason: "package.json 不存在或不可读" };
+    }
+    if (text.length < minBytes) {
+        return { ok: false, reason: `package.json 过小（${text.length} 字节）` };
+    }
+    let pkg;
+    try {
+        pkg = JSON.parse(text);
+    }
+    catch {
+        return { ok: false, reason: "package.json 不是合法 JSON" };
+    }
+    if (countPackageDependencies(pkg) < minDependencyCount) {
+        return { ok: false, reason: "dependencies 过少" };
+    }
+    const beforeKeys = Object.keys(pkg);
+    const scripts = (_d = pkg.scripts) !== null && _d !== void 0 ? _d : {};
+    let changed = false;
+    for (const [key, value] of Object.entries(scriptUpdates)) {
+        if (scripts[key] !== value) {
+            scripts[key] = value;
+            changed = true;
+        }
+    }
+    if (!changed)
+        return { ok: true, changed: false };
+    pkg.scripts = scripts;
+    for (const key of beforeKeys) {
+        if (!Object.keys(pkg).includes(key)) {
+            return { ok: false, reason: `会丢失字段: ${key}` };
+        }
+    }
+    const out = `${JSON.stringify(pkg, null, 2)}\n`;
+    if (out.length < text.length * minSizeRatio) {
+        return { ok: false, reason: "写入后体积异常缩小" };
+    }
+    await (0, fs_1.writeTextFileEnsuredDir)(pkgPath, out);
+    return { ok: true, changed: true };
+}
+async function ensurePnpmAllowSddFlowKitBuild(pkgPath) {
+    var _a, _b;
+    let text;
+    try {
+        text = await promises_1.default.readFile(pkgPath, "utf8");
+    }
+    catch {
+        return false;
+    }
+    let pkg;
+    try {
+        pkg = JSON.parse(text);
+    }
+    catch {
+        return false;
+    }
+    const pnpm = (_a = pkg.pnpm) !== null && _a !== void 0 ? _a : {};
+    const list = (_b = pnpm.onlyBuiltDependencies) !== null && _b !== void 0 ? _b : [];
+    if (list.includes("sdd-flow-kit"))
+        return false;
+    pnpm.onlyBuiltDependencies = [...list, "sdd-flow-kit"];
+    pkg.pnpm = pnpm;
+    await (0, fs_1.writeTextFileEnsuredDir)(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`);
+    return true;
+}

package/dist/postinstall.js

@@ -40,6 +40,7 @@ const path_1 = __importDefault(require("path"));
 const process_1 = __importDefault(require("process"));
 const inferProject_1 = require("./core/inferProject");
 const opsxDelivery_1 = require("./core/opsxDelivery");
+const projectRoots_1 = require("./core/projectRoots");
 const setupProject_1 = require("./steps/setupProject");
 async function inferAgent(projectRoot) {
     var _a;
@@ -68,50 +69,53 @@ async function inferAgent(projectRoot) {
     return "cursor";
 }
 async function main() {
+    var _a;
     if (process_1.default.env.SDD_FLOW_KIT_SKIP_POSTINSTALL === "1") {
         return;
     }
-    const initCwd = process_1.default.env.INIT_CWD ? path_1.default.resolve(process_1.default.env.INIT_CWD) : null;
+    const initCwd = (_a = process_1.default.env.INIT_CWD) === null || _a === void 0 ? void 0 : _a.trim();
     const pkgDir = path_1.default.resolve(__dirname, "..");
-    const projectRoot = initCwd !== null && initCwd !== void 0 ? initCwd : process_1.default.cwd();
+    if (!initCwd) {
+        // eslint-disable-next-line no-console
+        console.warn("[sdd-flow-kit] postinstall: 缺少 INIT_CWD，已跳过。请执行: npx sdd-flow-kit install --project ADI -y");
+        return;
+    }
+    const projectRoot = (0, projectRoots_1.resolveInstallRoot)(initCwd);
     if (projectRoot === pkgDir)
         return;
     const projectKind = await (0, inferProject_1.inferProjectKind)(projectRoot);
     const agent = await inferAgent(projectRoot);
+    const light = process_1.default.env.SDD_FLOW_KIT_POSTINSTALL_LIGHT === "1";
     // eslint-disable-next-line no-console
-    console.log(`[sdd-flow-kit] postinstall (light) at: ${projectRoot}`);
+    console.log(`[sdd-flow-kit] postinstall (${light ? "light" : "full"}) at: ${projectRoot}`);
     // eslint-disable-next-line no-console
     console.log(`[sdd-flow-kit] agent=${agent}, project=${projectKind}`);
-    await (0, setupProject_1.setupProject)({
+    const result = await (0, setupProject_1.setupProject)({
         projectRoot,
         agent,
         yes: true,
-        light: true,
+        light,
+        skipGit: true,
         dryRun: false,
         projectKind,
     });
-    const repaired = await (0, opsxDelivery_1.repairOpsxDeliveryScripts)(projectRoot);
-    if (repaired) {
-        // eslint-disable-next-line no-console
-        console.log("[sdd-flow-kit] repaired package.json opsx:delivery-pipeline scripts");
-    }
     const ready = await (0, opsxDelivery_1.isOpsxApplyReady)(projectRoot);
     if (!ready) {
         // eslint-disable-next-line no-console
-        console.warn("[sdd-flow-kit] OPSX/TDD/Playwright 工作流未就绪。/opsx-apply 前请执行: npx sdd-flow-kit ensure-opsx -y");
+        console.warn("[sdd-flow-kit] OPSX 未完全就绪。请执行: npx sdd-flow-kit install --project " +
+            `${projectKind} -y` +
+            (process_1.default.env.SDD_OPSX_WORKFLOW_PACKAGE ? "" : "（或设 SDD_OPSX_WORKFLOW_PACKAGE 指向本地 opsx-workflow）"));
     }
     else {
         // eslint-disable-next-line no-console
-        console.log("[sdd-flow-kit] opsx apply stack ready");
+        console.log("[sdd-flow-kit] 安装完成：SDD + OPSX + Superpowers 已就绪");
     }
     // eslint-disable-next-line no-console
-    console.log("[sdd-flow-kit] light setup done (skills/rules). Full install: npx sdd-flow-kit install --project ADI -y");
-    if (agent === "cursor") {
-        // eslint-disable-next-line no-console
-        console.log("[sdd-flow-kit] Cursor skill: .cursor/skills/sdd-flow-kit/SKILL.md");
-    }
+    console.log(`[sdd-flow-kit] 开发需求: npx sdd-flow-kit invoke "开发 ${projectKind} x.x.x 需求" -y`);
+    // eslint-disable-next-line no-console
+    console.log(`[sdd-flow-kit] environmentReady=${result.environmentReady}, setupExecuted=${result.setupExecuted}`);
 }
 main().catch((err) => {
     // eslint-disable-next-line no-console
-    console.warn("[sdd-flow-kit] postinstall setup skipped:", err instanceof Error ? err.message : err);
+    console.warn("[sdd-flow-kit] postinstall skipped:", err instanceof Error ? err.message : err);
 });

package/dist/steps/doctor.js

@@ -9,6 +9,7 @@ const promises_1 = __importDefault(require("fs/promises"));
 const path_1 = __importDefault(require("path"));
 const process_1 = __importDefault(require("process"));
 const nodeCompat_1 = require("../core/nodeCompat");
+const bootstrap_1 = require("../core/bootstrap");
 const opsxDelivery_1 = require("../core/opsxDelivery");
 function hasCommand(cmd) {
     const out = (0, child_process_1.spawnSync)("which", [cmd], { stdio: "ignore" });
@@ -83,6 +84,24 @@ async function runDoctor(options) {
         checks.push(c);
     }
     let ok = checks.every((c) => c.ok);
+    const opsxStackFailed = checks.some((c) => !c.ok &&
+        [
+            "opsx-dev-delivery-pipeline-skill",
+            "opsx-config",
+            "delivery-pipeline-script",
+            "package-json-delivery-script",
+        ].includes(c.name));
+    if (!ok && opsxStackFailed && !options.fix && !options.dryRun) {
+        await (0, bootstrap_1.bootstrapProjectIfNeeded)({
+            projectRoot: options.projectRoot,
+            agent: options.agent,
+        });
+        checks.length = 0;
+        for (const c of await (0, opsxDelivery_1.collectDeliverySetupChecks)(options.projectRoot)) {
+            checks.push(c);
+        }
+        ok = checks.every((c) => c.ok);
+    }
     if (!ok && options.fix) {
         const ensured = await (0, opsxDelivery_1.ensureOpsxWorkflow)({
             projectRoot: options.projectRoot,

package/dist/steps/invokeFlow.js

@@ -4,17 +4,24 @@ exports.parseInvokeText = parseInvokeText;
 exports.toRunOptions = toRunOptions;
 function parseInvokeText(text) {
     const normalized = text.trim();
-    // 兼容以下常见表达：
-    // - 开发 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].replace(/[-_\s]+$/g, "").toUpperCase();
-    const version = match[2];
-    return { product, version };
+    const patterns = [
+        /(?:开发|进行)\s*(.+?)(?:[-_\s]*)V?([0-9]+(?:\.[0-9]+){1,3})\s*(?:版本)?\s*(?:需求|PRD)?/i,
+        /([A-Za-z\u4e00-\u9fa5]+)[_\s-]?V?([0-9]+(?:\.[0-9]+){1,3})\s*版本/i,
+        /([A-Za-z]+)[_\s-]([0-9]+(?:\.[0-9]+){2,3})(?:\s|$)/i,
+    ];
+    for (const re of patterns) {
+        const match = normalized.match(re);
+        if (!match)
+            continue;
+        let product = match[1].replace(/[-_\s]+$/g, "").trim();
+        product = product.replace(/^进行/, "").trim();
+        if (/^adi$/i.test(product) || product.toUpperCase() === "ADI")
+            product = "ADI";
+        if (/^oms$/i.test(product))
+            product = "OMS";
+        return { product: product.toUpperCase(), version: match[2] };
+    }
+    return null;
 }
 function toRunOptions(args) {
     var _a, _b;

package/dist/steps/runFlow.js

@@ -7,6 +7,7 @@ exports.runFlow = runFlow;
 const path_1 = __importDefault(require("path"));
 const adapters_1 = require("../adapters");
 const fs_1 = require("../core/fs");
+const inferProject_1 = require("../core/inferProject");
 const startFlow_1 = require("./startFlow");
 const setupProject_1 = require("./setupProject");
 function buildChecklist(args) {
@@ -37,6 +38,7 @@ async function runFlow(options) {
         branch: options.branch,
         yes: options.yes,
         dryRun: options.dryRun,
+        projectKind: (0, inferProject_1.productToKind)(options.product),
     });
     const scaffold = options.dryRun
         ? {

package/dist/steps/setupProject.js

@@ -11,6 +11,7 @@ const fs_1 = require("../core/fs");
 const readlinePrompt_1 = require("../core/readlinePrompt");
 const utils_1 = require("../core/utils");
 const opsxDelivery_1 = require("../core/opsxDelivery");
+const packageJsonPatch_1 = require("../core/packageJsonPatch");
 const projectRoots_1 = require("../core/projectRoots");
 const templates_1 = require("../core/templates");
 const EDITOR_CHOICES = ["claude-code", "cursor", "codex", "openclaw"];
@@ -125,7 +126,7 @@ function allSkillInstallPaths(projectRoot) {
         .map((agent) => skillInstallPath(projectRoot, agent))
         .filter((p) => Boolean(p));
 }
-async function installAgentSkill(projectRoot) {
+async function installAgentSkill(projectRoot, projectKind) {
     const targets = allSkillInstallPaths(projectRoot);
     if (targets.length === 0)
         return;
@@ -138,7 +139,11 @@ async function installAgentSkill(projectRoot) {
                 : target.includes("/.codex/")
                     ? "codex"
                     : "openclaw";
-        const content = (0, utils_1.replaceAllStr)(template, "{{AGENT_NAME}}", agentName);
+        const content = renderVars(template, {
+            AGENT_NAME: agentName,
+            PROJECT_KIND: projectKind,
+            DEFAULT_PRODUCT: projectKind === "AD Tools" ? "AD Tools" : projectKind,
+        });
         await (0, fs_1.writeTextFileEnsuredDir)(target, content);
     }
 }
@@ -231,9 +236,9 @@ async function setupProject(options) {
     const branches = listLocalBranches(installRoot);
     const branchExists = branches.includes(selectedBranch);
     let branchResult;
-    if (options.light) {
+    if (options.light || options.skipGit) {
         branchResult = { branch: selectedBranch, created: false };
-        plannedActions.push("light mode: skipped git branch checkout");
+        plannedActions.push(options.skipGit ? "skipGit: skipped git branch checkout" : "light mode: skipped git branch checkout");
     }
     else if (options.dryRun) {
         branchResult = { branch: selectedBranch, created: !branchExists };
@@ -278,14 +283,18 @@ async function setupProject(options) {
         plannedActions.push(`would install cursor rule: ${path_1.default.join(installRoot, ".cursor", "rules", "sdd-flow-kit-gates.mdc")}`);
     }
     else {
-        await installAgentSkill(installRoot);
+        const pkgRoot = await (0, projectRoots_1.resolvePackageRoot)(installRoot);
+        const pnpmPatched = await (0, packageJsonPatch_1.ensurePnpmAllowSddFlowKitBuild)(path_1.default.join(pkgRoot, "package.json"));
+        if (pnpmPatched) {
+            plannedActions.push("added pnpm.onlyBuiltDependencies: sdd-flow-kit");
+        }
+        await installAgentSkill(installRoot, selectedKind);
         await installSddCursorRule(installRoot);
         skillInstalled = true;
         await installDocsSkill(installRoot, selectedKind);
         docsSkillInstalled = true;
         await installOpsxConfig(installRoot, selectedAgent);
         opsxConfigInstalled = true;
-        const pkgRoot = await (0, projectRoots_1.resolvePackageRoot)(installRoot);
         const repaired = await (0, opsxDelivery_1.repairOpsxDeliveryScripts)(pkgRoot);
         if (repaired) {
             plannedActions.push("repaired package.json opsx:delivery-pipeline scripts (poquan → opsx)");

package/package.json

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

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

@@ -1,73 +1,52 @@
 ---
-name: sdd-flow-kit-trigger
-description: 开发某版本需求、SDD 流程、用户回复确认点时触发。**必须**按 openspec/PRD/<runId>/NEXT.md 执行 `npx sdd-flow-kit gate|phase|propose|deliver`；命令 exit≠0 时禁止进入下一阶段或改 src/。
+name: sdd-flow-kit
+description: 用户说「开发/进行 {{DEFAULT_PRODUCT}} x.x.x 版本/需求」「ADI_2.3.2」等时触发。**禁止**未过 gate 直接改 src。必须先 invoke/run，确认点闭合后走 OpenSpec+Superpowers（gate→propose→apply→deliver）。
 ---
 
-# SDD Flow（脚本门禁版 — 不依赖自然语言跳步）
+# SDD Flow Kit（{{PROJECT_KIND}} — 脚本门禁）
 
-## 铁律
+## 触发即执行（第一步，禁止跳过）
 
-1. 每步开始前读 `openspec/PRD/<runId>/NEXT.md` 与 `.session-state.json`。
-2. **必须**在终端执行其中的 `npx sdd-flow-kit ...`；根据 **exit code** 判断是否可继续（0=通过，非0=停止）。
-3. `docModeOnly: true` 时 **禁止** 修改 `src/`、`e2e/`、`frontend/src/` 等实现路径。
-4. 只有 `gate --expect impl-allowed` 通过后才允许改业务代码。
-5. 只有 `deliver` 成功且 `phase advance --to shipped` 通过后才可宣称「开发完成」。
-
-## 准备
+用户一旦表达版本开发意图，**在本回合终端执行**（项目根 = 安装 sdd-flow-kit 的目录，如 `frontend/`）：
 
 ```bash
-npx sdd-flow-kit run --product <PRODUCT> --version <VERSION> -y
+npx sdd-flow-kit invoke "开发 {{DEFAULT_PRODUCT}} <版本号> 需求" -y --agent {{AGENT_NAME}}
 ```
 
-工作目录：`openspec/PRD/<runId>/`（已生成 `NEXT.md`）。
-
-## 标准命令序列（复制 NEXT.md，按序执行）
-
-| 阶段 | 门禁 / 推进 |
-|------|-------------|
-| PRD 已拉取 | `gate --expect prd-fetched` → `phase advance --to after-prd` |
-| 提问模式 | `gate --expect questions-open` |
-| 用户确认后（仅文档） | 更新 01/02/03/04 → `gate --expect docs-closed` → `phase advance --to docs-done` |
-| 提案 | `propose --change <name>` →（AI 生成 openspec artifacts）→ `gate --expect propose-ready` → `phase advance --to propose-done` |
-| 实现 | `phase advance --to impl --change <name>` → `gate --expect impl-allowed` → 按 tasks 改代码 |
-| 交付 | `deliver --change <name>` → `phase advance --to shipped` |
-
-统一参数（示例）：
+或：
 
 ```bash
-export PR=<项目根目录>
-export RID=<runId>
-export CH=<change-name>
-
-npx sdd-flow-kit gate --project-root "$PR" --run-id "$RID" --expect docs-closed
-npx sdd-flow-kit phase advance --project-root "$PR" --run-id "$RID" --to docs-done
+npx sdd-flow-kit run --product {{DEFAULT_PRODUCT}} --version <版本号> -y --agent {{AGENT_NAME}}
 ```
 
-## 各阶段说明（辅助，不可替代脚本）
-
-### 阶段 A
-- Step1：`01-获取需求文档指引.md` → 回填 `source/PRD.md`
-- Step2：`02-需求分析提示词.md`；未闭合时 **只** 改 `03`
-
-### 阶段 B
-- 用户确认后：生成 01/02/04，**然后必须** `gate docs-closed`（会检测 git 是否误改 src）
+然后 **只读** `openspec/PRD/<runId>/NEXT.md` 与 `.session-state.json`，按其中命令顺序执行；**exit code ≠ 0 必须停止**。
 
-### 阶段 C
-- `propose` 创建 change；AI 按 openspec-propose 写 artifacts；`gate propose-ready` 校验 apply-ready
+## 铁律（防 vibe coding）
 
-### 阶段 D
-- `phase advance --to impl` 将 `docModeOnly` 设为 false
-- 实现后 `deliver` 跑 `ensure-opsx` + `pnpm run opsx:delivery-pipeline`
+1. `docModeOnly: true` 时 **禁止** 修改 `src/`、`frontend/src/`、`e2e/`。
+2. 用户粘贴确认点、更新 03 后：先产出 01/02/04，再 **必须**：
+   ```bash
+   npx sdd-flow-kit gate --project-root <安装根> --run-id <runId> --expect docs-closed
+   npx sdd-flow-kit phase advance --project-root <安装根> --run-id <runId> --to docs-done
+   ```
+3. **仅当** `gate --expect impl-allowed` 通过后，才允许按 `openspec/changes/<change>/tasks.md` 改业务代码。
+4. 提案/实现 **必须** 读并执行：
+   - `.cursor/skills/opsx-superpowers-workflow/SKILL.md`（总编排）
+   - `openspec-propose` → `openspec-apply-change` → `pnpm run opsx:delivery-pipeline -- <change>`
+5. **禁止** 跳过 `propose` / `deliver` 或手写 tasks 全勾 `[x]` 宣称完成。
 
-## 严禁
+## 阶段摘要
 
-- 跳过 `gate` / `phase` 直接改代码或宣称完成
-- `docs-closed` 未通过时修改 `src/`
-- 手写 `tasks.md` 全勾 `[x]` 而不跑 `deliver`
-- 用自然语言代替 exit code 判断
+| 阶段 | 动作 |
+|------|------|
+| A | Step1 PRD → `gate prd-fetched` → `phase after-prd` |
+| A2 | 提问模式仅 03 → `gate questions-open` |
+| B | 用户确认后 01/02/04 → `gate docs-closed` → `phase docs-done` |
+| C | `propose` + OpenSpec artifacts → `gate propose-ready` → `phase propose-done` |
+| D | `phase impl` → `gate impl-allowed` → 改代码 → `deliver` → `phase shipped` |
 
 ## 环境
 
 - agent: {{AGENT_NAME}}
-- 安装: `npx sdd-flow-kit install -y`
-- 脚本帮助: `npx sdd-flow-kit --help`
+- 全量安装: `npx sdd-flow-kit install --project {{PROJECT_KIND}} -y`
+- 本地 OPSX: `SDD_OPSX_WORKFLOW_PACKAGE=file:../../opsx-workflow`

package/src/templates/rules/sdd-no-implement-until-apply.mdc.template

@@ -22,6 +22,13 @@ alwaysApply: true
 - **禁止** 修改 `src/`、`e2e/`、`frontend/src/` 等
 - 用户粘贴确认点后：先 `gate docs-closed`，通过后再 `phase advance --to docs-done`；**不得**同回合改 ts/vue
 
+## 自然语言触发（ADI / OMS 等）
+
+用户说「开发/进行 ADI 2.3.2 版本」「ADI_2.3.2」等时：
+
+1. **先** 在终端执行：`npx sdd-flow-kit invoke "开发 ADI 2.3.2 需求" -y`
+2. 打开 `openspec/PRD/<runId>/NEXT.md`，**禁止**直接改 `src/`
+
 ## 用户确认点（无需口令）
 
 1. 更新 `03` → 生成 `01/02/04`