sdd-flow-kit 1.0.22 → 1.0.27

package/dist/core/templates.js

@@ -4,16 +4,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadTemplateText = loadTemplateText;
-const node_path_1 = __importDefault(require("node:path"));
+const path_1 = __importDefault(require("path"));
 const fs_1 = require("./fs");
 function resolveCandidatePaths(relPathFromPackageRoot) {
     // 在 TS 开发态：<pkg>/src/templates/xxx
     // 在编译态：<pkg>/dist/cli.js -> __dirname=<pkg>/dist，所以 src/templates 要向上找两级
     const here = __dirname; // src/core/* 或 dist/*
-    const pkgRoot = node_path_1.default.resolve(here, "../.."); // 兼容 src/ 与 dist/
+    const pkgRoot = path_1.default.resolve(here, "../.."); // 兼容 src/ 与 dist/
     return [
-        node_path_1.default.join(pkgRoot, "src", "templates", relPathFromPackageRoot),
-        node_path_1.default.join(pkgRoot, "dist", "templates", relPathFromPackageRoot),
+        path_1.default.join(pkgRoot, "src", "templates", relPathFromPackageRoot),
+        path_1.default.join(pkgRoot, "dist", "templates", relPathFromPackageRoot),
     ];
 }
 async function loadTemplateText(relPathFromPackageRoot) {

package/dist/core/utils.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatYYYYMMDD = formatYYYYMMDD;
+exports.replaceAllStr = replaceAllStr;
 exports.ensurePosixRelativePath = ensurePosixRelativePath;
 /**
  * 生成 YYYYMMDD 字符串，用于 openspec/PRD 目录命名。
@@ -11,7 +12,13 @@ function formatYYYYMMDD(d) {
     const dd = String(d.getDate()).padStart(2, "0");
     return `${yyyy}${mm}${dd}`;
 }
+/** Node 14 无 String.prototype.replaceAll（需 Node 15+） */
+function replaceAllStr(text, search, replacement) {
+    if (!search)
+        return text;
+    return text.split(search).join(replacement);
+}
 function ensurePosixRelativePath(p) {
     // 用于模板占位符中展示，避免反斜杠导致工具误解析。
-    return p.replaceAll("\\", "/");
+    return replaceAllStr(p, "\\", "/");
 }

package/dist/postinstall.js

@@ -36,20 +36,21 @@ 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 path_1 = __importDefault(require("path"));
+const process_1 = __importDefault(require("process"));
 const inferProject_1 = require("./core/inferProject");
 const opsxDelivery_1 = require("./core/opsxDelivery");
 const setupProject_1 = require("./steps/setupProject");
 async function inferAgent(projectRoot) {
-    const fromEnv = (node_process_1.default.env.SDD_FLOW_KIT_AGENT ?? "").trim();
+    var _a;
+    const fromEnv = ((_a = process_1.default.env.SDD_FLOW_KIT_AGENT) !== null && _a !== void 0 ? _a : "").trim();
     const allowed = ["cursor", "claude-code", "codex", "openclaw"];
     if (allowed.includes(fromEnv))
         return fromEnv;
-    const fs = await Promise.resolve().then(() => __importStar(require("node:fs/promises")));
+    const fs = await Promise.resolve().then(() => __importStar(require("fs/promises")));
     const exists = async (rel) => {
         try {
-            await fs.access(node_path_1.default.join(projectRoot, rel));
+            await fs.access(path_1.default.join(projectRoot, rel));
             return true;
         }
         catch {
@@ -67,12 +68,12 @@ async function inferAgent(projectRoot) {
     return "cursor";
 }
 async function main() {
-    if (node_process_1.default.env.SDD_FLOW_KIT_SKIP_POSTINSTALL === "1") {
+    if (process_1.default.env.SDD_FLOW_KIT_SKIP_POSTINSTALL === "1") {
         return;
     }
-    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();
+    const initCwd = process_1.default.env.INIT_CWD ? path_1.default.resolve(process_1.default.env.INIT_CWD) : null;
+    const pkgDir = path_1.default.resolve(__dirname, "..");
+    const projectRoot = initCwd !== null && initCwd !== void 0 ? initCwd : process_1.default.cwd();
     if (projectRoot === pkgDir)
         return;
     const projectKind = await (0, inferProject_1.inferProjectKind)(projectRoot);

package/dist/steps/doctor.js

@@ -4,12 +4,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runDoctor = runDoctor;
-const node_child_process_1 = require("node:child_process");
-const promises_1 = __importDefault(require("node:fs/promises"));
-const node_path_1 = __importDefault(require("node:path"));
+const child_process_1 = require("child_process");
+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 opsxDelivery_1 = require("../core/opsxDelivery");
 function hasCommand(cmd) {
-    const out = (0, node_child_process_1.spawnSync)("which", [cmd], { stdio: "ignore" });
+    const out = (0, child_process_1.spawnSync)("which", [cmd], { stdio: "ignore" });
     return out.status === 0;
 }
 async function hasPath(filePath) {
@@ -34,6 +36,11 @@ function agentBin(agent) {
 }
 async function runDoctor(options) {
     const checks = [];
+    checks.push({
+        name: "node-version",
+        ok: (0, nodeCompat_1.isNodeVersionSupported)(),
+        detail: `Node ${process_1.default.version}（要求 ${(0, nodeCompat_1.nodeVersionRequirementLabel)()}，推荐 18/20 LTS）`,
+    });
     checks.push({
         name: "git",
         ok: hasCommand("git"),
@@ -54,7 +61,7 @@ async function runDoctor(options) {
     }
     checks.push({
         name: "openspec-dir",
-        ok: await hasPath(node_path_1.default.join(options.projectRoot, "openspec")),
+        ok: await hasPath(path_1.default.join(options.projectRoot, "openspec")),
         detail: "openspec 目录存在性",
     });
     const toolDirMap = {
@@ -68,7 +75,7 @@ async function runDoctor(options) {
     if (expectedDir) {
         checks.push({
             name: `${options.agent}-dir`,
-            ok: await hasPath(node_path_1.default.join(options.projectRoot, expectedDir)),
+            ok: await hasPath(path_1.default.join(options.projectRoot, expectedDir)),
             detail: `${expectedDir} 目录存在性`,
         });
     }

package/dist/steps/invokeFlow.js

@@ -17,6 +17,7 @@ function parseInvokeText(text) {
     return { product, version };
 }
 function toRunOptions(args) {
+    var _a, _b;
     return {
         product: args.parsed.product,
         version: args.parsed.version,
@@ -24,6 +25,6 @@ function toRunOptions(args) {
         branch: args.branch,
         yes: args.yes,
         dryRun: args.dryRun,
-        agent: args.agent ?? args.parsed.agent ?? "claude-code",
+        agent: (_b = (_a = args.agent) !== null && _a !== void 0 ? _a : args.parsed.agent) !== null && _b !== void 0 ? _b : "claude-code",
     };
 }

package/dist/steps/runFlow.js

@@ -4,7 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runFlow = runFlow;
-const node_path_1 = __importDefault(require("node:path"));
+const path_1 = __importDefault(require("path"));
 const adapters_1 = require("../adapters");
 const fs_1 = require("../core/fs");
 const startFlow_1 = require("./startFlow");
@@ -41,7 +41,7 @@ async function runFlow(options) {
     const scaffold = options.dryRun
         ? {
             runId: "dry-run-no-files-generated",
-            outputRoot: node_path_1.default.join(options.projectRoot, "openspec", "PRD"),
+            outputRoot: path_1.default.join(options.projectRoot, "openspec", "PRD"),
         }
         : await (0, startFlow_1.startFlowScaffold)(options);
     const adapter = (0, adapters_1.getAdapter)(setup.agent);
@@ -63,7 +63,7 @@ async function runFlow(options) {
         version: options.version,
     });
     if (!options.dryRun) {
-        await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(scaffold.outputRoot, "AUTO-RUN-CHECKLIST.md"), checklist);
+        await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(scaffold.outputRoot, "AUTO-RUN-CHECKLIST.md"), checklist);
     }
     return {
         ...scaffold,

package/dist/steps/setupProject.js

@@ -4,19 +4,21 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setupProject = setupProject;
-const node_child_process_1 = require("node:child_process");
-const node_path_1 = __importDefault(require("node:path"));
-const promises_1 = require("node:readline/promises");
-const node_process_1 = __importDefault(require("node:process"));
+const child_process_1 = require("child_process");
+const path_1 = __importDefault(require("path"));
+const process_1 = __importDefault(require("process"));
 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 templates_1 = require("../core/templates");
 const EDITOR_CHOICES = ["claude-code", "cursor", "codex", "openclaw"];
 const PROJECT_CHOICES = ["OMS", "ADI", "欢盟", "AD Tools"];
 function runGit(args, cwd) {
-    const out = (0, node_child_process_1.spawnSync)("git", args, { cwd, encoding: "utf8" });
+    var _a, _b;
+    const out = (0, child_process_1.spawnSync)("git", args, { cwd, encoding: "utf8" });
     if (out.status !== 0) {
-        const err = out.stderr?.trim() || out.stdout?.trim() || `git ${args.join(" ")} failed`;
+        const err = ((_a = out.stderr) === null || _a === void 0 ? void 0 : _a.trim()) || ((_b = out.stdout) === null || _b === void 0 ? void 0 : _b.trim()) || `git ${args.join(" ")} failed`;
         throw new Error(err);
     }
     return out.stdout.trim();
@@ -45,9 +47,9 @@ function listLocalBranches(projectRoot) {
     }
 }
 async function askAgent(defaultAgent) {
-    if (!node_process_1.default.stdin.isTTY)
+    if (!process_1.default.stdin.isTTY)
         return defaultAgent;
-    const rl = (0, promises_1.createInterface)({ input: node_process_1.default.stdin, output: node_process_1.default.stdout });
+    const rl = (0, readlinePrompt_1.createPromptInterface)();
     const prompt = [
         "请选择开发环境：",
         "1) claude-code (default)",
@@ -56,7 +58,7 @@ async function askAgent(defaultAgent) {
         "4) openclaw",
         "输入编号（回车默认 1）：",
     ].join("\n");
-    const answer = (await rl.question(`${prompt}\n`)).trim();
+    const answer = (await (0, readlinePrompt_1.promptLine)(rl, `${prompt}\n`)).trim();
     rl.close();
     if (!answer)
         return defaultAgent;
@@ -66,17 +68,17 @@ async function askAgent(defaultAgent) {
     return EDITOR_CHOICES[idx - 1];
 }
 async function askBranch(defaultBranch) {
-    if (!node_process_1.default.stdin.isTTY)
+    if (!process_1.default.stdin.isTTY)
         return defaultBranch;
-    const rl = (0, promises_1.createInterface)({ input: node_process_1.default.stdin, output: node_process_1.default.stdout });
-    const answer = (await rl.question(`请输入开发分支（默认 ${defaultBranch}）：\n`)).trim();
+    const rl = (0, readlinePrompt_1.createPromptInterface)();
+    const answer = (await (0, readlinePrompt_1.promptLine)(rl, `请输入开发分支（默认 ${defaultBranch}）：\n`)).trim();
     rl.close();
     return answer || defaultBranch;
 }
 async function askProjectKind(defaultKind) {
-    if (!node_process_1.default.stdin.isTTY)
+    if (!process_1.default.stdin.isTTY)
         return defaultKind;
-    const rl = (0, promises_1.createInterface)({ input: node_process_1.default.stdin, output: node_process_1.default.stdout });
+    const rl = (0, readlinePrompt_1.createPromptInterface)();
     const prompt = [
         "请选择当前项目类型（用于生成 PRD 下载 skill）：",
         "1) OMS (default)",
@@ -85,7 +87,7 @@ async function askProjectKind(defaultKind) {
         "4) AD Tools",
         "输入编号（回车默认 1）：",
     ].join("\n");
-    const answer = (await rl.question(`${prompt}\n`)).trim();
+    const answer = (await (0, readlinePrompt_1.promptLine)(rl, `${prompt}\n`)).trim();
     rl.close();
     if (!answer)
         return defaultKind;
@@ -114,7 +116,7 @@ function skillInstallPath(projectRoot, agent) {
     const rel = relMap[agent];
     if (!rel)
         return null;
-    return node_path_1.default.join(projectRoot, rel);
+    return path_1.default.join(projectRoot, rel);
 }
 function allSkillInstallPaths(projectRoot) {
     const agents = ["cursor", "claude-code", "codex", "openclaw"];
@@ -135,19 +137,19 @@ async function installAgentSkill(projectRoot) {
                 : target.includes("/.codex/")
                     ? "codex"
                     : "openclaw";
-        const content = template.replaceAll("{{AGENT_NAME}}", agentName);
+        const content = (0, utils_1.replaceAllStr)(template, "{{AGENT_NAME}}", agentName);
         await (0, fs_1.writeTextFileEnsuredDir)(target, content);
     }
 }
 async function installSddCursorRule(projectRoot) {
-    const rulePath = node_path_1.default.join(projectRoot, ".cursor", "rules", "sdd-flow-kit-gates.mdc");
+    const rulePath = path_1.default.join(projectRoot, ".cursor", "rules", "sdd-flow-kit-gates.mdc");
     const template = await (0, templates_1.loadTemplateText)("rules/sdd-no-implement-until-apply.mdc.template");
     await (0, fs_1.writeTextFileEnsuredDir)(rulePath, template);
 }
 function renderVars(template, vars) {
     let out = template;
     for (const [k, v] of Object.entries(vars)) {
-        out = out.replaceAll(`{{${k}}}`, v);
+        out = (0, utils_1.replaceAllStr)(out, `{{${k}}}`, v);
     }
     return out;
 }
@@ -166,7 +168,7 @@ function docSkillDirName(kind) {
 }
 async function installDocsSkill(projectRoot, kind) {
     const { dir, prefix } = docSkillDirName(kind);
-    const docsDir = node_path_1.default.join(projectRoot, "docs", dir);
+    const docsDir = path_1.default.join(projectRoot, "docs", dir);
     const pyTemplate = await (0, templates_1.loadTemplateText)("skills/confluence-doc.py.template");
     const mdTemplate = await (0, templates_1.loadTemplateText)("skills/doc-skill.SKILL.md.template");
     const md = renderVars(mdTemplate, {
@@ -176,9 +178,9 @@ async function installDocsSkill(projectRoot, kind) {
         PRODUCT_PREFIX_LOWER: prefix.toLowerCase(),
         SKILL_DIR: dir,
     });
-    const py = pyTemplate.replaceAll("{{DOC_PRODUCT_PREFIX}}", prefix);
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(docsDir, "SKILL.md"), md);
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(docsDir, "confluence-doc.py"), py);
+    const py = (0, utils_1.replaceAllStr)(pyTemplate, "{{DOC_PRODUCT_PREFIX}}", prefix);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(docsDir, "SKILL.md"), md);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(docsDir, "confluence-doc.py"), py);
     return { dirPath: docsDir };
 }
 function getOpsxPathsByAgent(agent) {
@@ -196,7 +198,7 @@ function getOpsxPathsByAgent(agent) {
     }
 }
 async function installOpsxConfig(projectRoot, agent) {
-    const target = node_path_1.default.join(projectRoot, ".opsx", "config.json");
+    const target = path_1.default.join(projectRoot, ".opsx", "config.json");
     const resolvedAgent = await (0, opsxDelivery_1.resolveOpsxAgent)(projectRoot, agent);
     const paths = getOpsxPathsByAgent(resolvedAgent);
     const config = {
@@ -216,11 +218,12 @@ async function installOpsxConfig(projectRoot, agent) {
     await (0, fs_1.writeTextFileEnsuredDir)(target, JSON.stringify(config, null, 2));
 }
 async function setupProject(options) {
-    const defaultAgent = options.agent ?? "claude-code";
+    var _a, _b, _c;
+    const defaultAgent = (_a = options.agent) !== null && _a !== void 0 ? _a : "claude-code";
     const selectedAgent = options.yes ? defaultAgent : await askAgent(defaultAgent);
-    const defaultKind = options.projectKind ?? "OMS";
+    const defaultKind = (_b = options.projectKind) !== null && _b !== void 0 ? _b : "OMS";
     const selectedKind = options.yes ? defaultKind : await askProjectKind(defaultKind);
-    const defaultBranch = options.branch ?? pickDefaultBranch(options.projectRoot);
+    const defaultBranch = (_c = options.branch) !== null && _c !== void 0 ? _c : pickDefaultBranch(options.projectRoot);
     const selectedBranch = options.yes ? defaultBranch : await askBranch(defaultBranch);
     const plannedActions = [];
     const branches = listLocalBranches(options.projectRoot);
@@ -268,9 +271,9 @@ async function setupProject(options) {
             plannedActions.push(`would install skill: ${skillPath}`);
         }
         const { dir } = docSkillDirName(selectedKind);
-        plannedActions.push(`would install docs skill: ${node_path_1.default.join(options.projectRoot, "docs", dir)}`);
-        plannedActions.push(`would install opsx config: ${node_path_1.default.join(options.projectRoot, ".opsx", "config.json")}`);
-        plannedActions.push(`would install cursor rule: ${node_path_1.default.join(options.projectRoot, ".cursor", "rules", "sdd-flow-kit-gates.mdc")}`);
+        plannedActions.push(`would install docs skill: ${path_1.default.join(options.projectRoot, "docs", dir)}`);
+        plannedActions.push(`would install opsx config: ${path_1.default.join(options.projectRoot, ".opsx", "config.json")}`);
+        plannedActions.push(`would install cursor rule: ${path_1.default.join(options.projectRoot, ".cursor", "rules", "sdd-flow-kit-gates.mdc")}`);
     }
     else {
         await installAgentSkill(options.projectRoot);
@@ -304,7 +307,7 @@ async function setupProject(options) {
         ...plannedActions.map((x) => `- ${x}`),
         "",
     ].join("\n");
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(options.projectRoot, ".sdd-flow-kit", "setup-summary.md"), summary);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(options.projectRoot, ".sdd-flow-kit", "setup-summary.md"), summary);
     return {
         agent: selectedAgent,
         projectKind: selectedKind,

package/dist/steps/startFlow.js

@@ -4,8 +4,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.startFlowScaffold = startFlowScaffold;
-const node_path_1 = __importDefault(require("node:path"));
-const promises_1 = __importDefault(require("node:fs/promises"));
+const path_1 = __importDefault(require("path"));
+const promises_1 = __importDefault(require("fs/promises"));
 const utils_1 = require("../core/utils");
 const fs_1 = require("../core/fs");
 const templates_1 = require("../core/templates");
@@ -13,15 +13,15 @@ const inferProject_1 = require("../core/inferProject");
 function renderTemplate(template, vars) {
     let out = template;
     for (const [k, v] of Object.entries(vars)) {
-        out = out.replaceAll(`{{${k}}}`, v);
+        out = (0, utils_1.replaceAllStr)(out, `{{${k}}}`, v);
     }
     return out;
 }
 async function startFlowScaffold(options) {
     const now = new Date();
     const runId = `${(0, utils_1.formatYYYYMMDD)(now)}-${options.product}-${options.version}`;
-    const outputRoot = node_path_1.default.join(options.projectRoot, "openspec", "PRD", runId);
-    const sourceDir = node_path_1.default.join(outputRoot, "source");
+    const outputRoot = path_1.default.join(options.projectRoot, "openspec", "PRD", runId);
+    const sourceDir = path_1.default.join(outputRoot, "source");
     await promises_1.default.mkdir(sourceDir, { recursive: true });
     // 1) Step1: doc-skill 指引（按产品解析脚本路径，支持 monorepo frontend）
     const kind = (0, inferProject_1.productToKind)(options.product);
@@ -33,23 +33,23 @@ async function startFlowScaffold(options) {
         DOC_SKILL_REL: docSkill.relFromRoot.replace(/\\/g, "/"),
         VERSION_EXAMPLE: options.version,
     });
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, "01-获取需求文档指引.md"), step1);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "01-获取需求文档指引.md"), step1);
     // source 占位：让第 2 步提示词在任何工具里都能直接读
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(sourceDir, "PRD.md"), [
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(sourceDir, "PRD.md"), [
         "# source/PRD.md",
         "",
         "请把《PRD》markdown 内容粘贴到这里（由 `adi-doc-skill` 下载并回填）。",
         "",
         "- 建议：保持原有标题层级与编号。",
     ].join("\n"));
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(sourceDir, "接口文档.md"), [
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(sourceDir, "接口文档.md"), [
         "# source/接口文档.md",
         "",
         "（可选）如果你已经有接口文档，请粘贴到这里；没有也不影响后续 SDD 循环。",
         "",
         "- 注意：接口文档中的字段/示例越完整，分析报告越贴近落地。",
     ].join("\n"));
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(sourceDir, "openspec-knowledge-base-summary.md"), [
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(sourceDir, "openspec-knowledge-base-summary.md"), [
         "# source/openspec-knowledge-base-summary.md",
         "",
         "（可选）现有知识库摘要/快速索引，建议由你在执行第 2 步前手动整理。",
@@ -60,32 +60,35 @@ async function startFlowScaffold(options) {
     const sddLoopPrompt = await (0, templates_1.loadTemplateText)("prompts/02-sdd-loop-prompt.md");
     const step2PromptTemplate = await (0, templates_1.loadTemplateText)("artifacts/02-需求分析提示词.template.md");
     const step2Prompt = renderTemplate(step2PromptTemplate, { SDD_LOOP_PROMPT: sddLoopPrompt });
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, "02-需求分析提示词.md"), step2Prompt);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "02-需求分析提示词.md"), step2Prompt);
     // 3) Step2 输出文件占位（由 AI 工具生成并覆盖）
     const file01Template = await (0, templates_1.loadTemplateText)("artifacts/01-需求分析报告.template.md");
     const file02Template = await (0, templates_1.loadTemplateText)("artifacts/02-改动点清单.template.md");
     const file03Template = await (0, templates_1.loadTemplateText)("artifacts/03-待确认问题清单.template.md");
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, "01-需求分析报告.md"), file01Template);
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, "02-改动点清单.md"), file02Template);
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, "03-待确认问题清单.md"), file03Template);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "01-需求分析报告.md"), file01Template);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "02-改动点清单.md"), file02Template);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "03-待确认问题清单.md"), file03Template);
     // 4) Step4 技术文档入口（草稿）
     const techDocTemplate = await (0, templates_1.loadTemplateText)("artifacts/04-技术文档.template.md");
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, "04-技术文档草稿.md"), techDocTemplate);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "04-技术文档草稿.md"), techDocTemplate);
     // 5) Step5 openspec 提案入口（草稿）
     const openspecEntryTemplate = await (0, templates_1.loadTemplateText)("artifacts/05-openspec-提案草稿.template.md");
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, "05-openspec-提案草稿.md"), openspecEntryTemplate);
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, ".session-state.json"), JSON.stringify({
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "05-openspec-提案草稿.md"), openspecEntryTemplate);
+    const opsxAutoChainTemplate = await (0, templates_1.loadTemplateText)("artifacts/06-opsx-auto-chain.template.md");
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "06-opsx-自动串联指引.md"), opsxAutoChainTemplate);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, ".session-state.json"), JSON.stringify({
         product: options.product,
         version: options.version,
         runId,
         outputRoot,
         status: "awaiting_user_confirmation",
         docModeOnly: true,
+        autoChainOpsx: true,
         phase: "A_or_B",
         createdAtISO: new Date().toISOString(),
     }, null, 2));
     // runDir 自述
-    await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(outputRoot, "RUNME.md"), [
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(outputRoot, "RUNME.md"), [
         "# RUNME（SDD 流程执行说明）",
         "",
         `本次 runId: \`${runId}\``,
@@ -110,12 +113,13 @@ async function startFlowScaffold(options) {
         "- `02-改动点清单.md`",
         "- `04-技术文档草稿.md`",
         "",
-        "## Step 5：/opsx-propose 生成提案",
-        "基于 `01`、`02` 与用户提供的 UI 参考，执行 `/opsx-propose`。",
-        "产出在 `openspec/changes/<change-name>/`；在 `05-openspec-提案草稿.md` 记录 change 名称。",
-        "门禁：仅当 03 已闭环且 01/02/04 完成后执行。",
+        "## Step 5–6：自动串联 OPSX（默认）",
+        "03 闭环且 01/02/04 完成后，**同一 AI 回合**读 `06-opsx-自动串联指引.md`：",
+        "1. `/opsx-propose`（输入 01、02、UI；UI 默认读 `source/PRD.md` 原型目录）",
+        "2. 提案 apply-ready 后立即 `/opsx-apply` + `pnpm run opsx:delivery-pipeline`（exit 0）",
+        "勿停下来问「是否继续」。仅当用户说「只提案」或 `.session-state.json` 中 `autoChainOpsx: false` 时暂停。",
         "",
-        "## Step 6：Apply + TDD + Playwright（阶段 D）",
+        "## Step 6 明细：Apply + TDD + Playwright（阶段 D）",
         "依次执行 skill：`openspec-apply-change` → `tdd-script` → `openspec-superpowers-pipeline` → `opsx-dev-delivery-pipeline`。",
         "仓库根执行：`pnpm run opsx:delivery-pipeline -- <change-name>`（须 exit 0）。",
         "禁止跳过 TDD / Playwright 裸写代码收尾。详见 `.cursor/skills/sdd-flow-kit/SKILL.md` 阶段 D。",

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "sdd-flow-kit",
-  "version": "1.0.22",
+  "version": "1.0.27",
   "private": false,
   "description": "Cross-agent SDD automated development workflow kit (ADI/ADI-like).",
   "license": "MIT",
+  "engines": {
+    "node": ">=14.16.0"
+  },
   "type": "commonjs",
   "main": "dist/index.js",
   "files": [

package/src/templates/artifacts/05-openspec-/346/217/220/346/241/210/350/215/211/347/250/277.template.md

@@ -6,7 +6,8 @@
 ## 前置条件（必须全部满足）
 - [ ] `03-待确认问题清单.md` 已标注 **矛盾点池状态：已闭合**
 - [ ] `01-需求分析报告.md`、`02-改动点清单.md`、`04-技术文档草稿.md` 已生成
-- [ ] 用户已确认可进入提案阶段
+- [ ] 用户已确认可进入提案阶段（阶段 B 闭环）
+- [ ] `autoChainOpsx` 为 true（默认）→ 与用户确认后**同一回合**自动 propose，无需再等「继续」
 
 ## /opsx-propose 输入清单
 - 需求分析：`01-需求分析报告.md`

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

@@ -1,6 +1,6 @@
 ---
 name: sdd-flow-kit-trigger
-description: 开发某版本需求、SDD 流程、待确认问题澄清、用户回复确认点/矛盾点结论时触发。澄清与确认阶段仅改 openspec/PRD 文档，禁止写 src 等业务代码；仅 /opsx-apply 后可实现。
+description: 开发某版本需求、SDD 流程、待确认问题澄清、用户回复确认点/矛盾点结论时触发。阶段 A/B 仅文档；阶段 B 闭环后**自动** /opsx-propose → /opsx-apply（除非用户说只提案或 autoChainOpsx=false）。
 ---
 
 # SDD Flow Trigger Skill
@@ -20,16 +20,18 @@ description: 开发某版本需求、SDD 流程、待确认问题澄清、用户
 | 模式 | 何时 | 允许改动的路径 | 禁止 |
 |------|------|----------------|------|
 | **文档模式** | 阶段 A/B/C，含「用户发来确认点」 | 仅 `openspec/PRD/**`（及阶段 C 的 `openspec/changes/**`） | 任何 `src/`、`pages/`、`components/` 等业务代码 |
-| **实现模式** | 仅阶段 D，且用户同意 `/opsx-apply` | 按 openspec change 与 pipeline 要求 | 跳过 propose |
+| **实现模式** | 阶段 D（提案 apply-ready 后**自动进入**，无需用户再说「开始 apply」） | 按 openspec change 与 pipeline 要求 | 跳过 propose / 跳过 pipeline |
 
 **常见错误**：用户粘贴确认点后，你一边更新 `03` 一边改 `.tsx` —— **绝对禁止**。确认回复 = 只做文档，同一回合不得 touch 业务代码。
 
 ### 用户侧：零口令（不要要求加前缀）
 - 用户**直接粘贴**确认点、编号结论、「按 1/2/3 继续」即可；**禁止**要求用户输入【仅文档模式】等固定话术。
 - 你须在收到后**自动**判定为阶段 B 的文档模式；先读 `openspec/PRD/<runId>/.session-state.json`（`docModeOnly: true` 时严禁写业务代码）与 `03-待确认问题清单.md`。
-- 阶段切换口语即可，无需背提示词：
-  - 提案：`继续` / `做提案` / `propose`（执行 `/opsx-propose`）
-  - 实现：`开始 apply` / `执行 apply`（且 change 已 apply-ready）
+- **默认自动串联**（`openspec/PRD/<runId>/.session-state.json` 中 `autoChainOpsx !== false`）：
+  - 阶段 B 产出 01/02/闭环03/04 后，**同一回合**继续阶段 C→D，**不要**停下来问「是否继续」。
+  - 读 `06-opsx-自动串联指引.md` 与 `.cursor/skills/opsx-superpowers-workflow/SKILL.md`。
+- **仅当用户说**「只提案」「先别写代码」时：阶段 C 结束后停止，等待 `/opsx-apply`。
+- 口语仍可用：`继续` / `做提案` / `开始 apply`（用于断点续跑）。
 
 ## 触发后执行规则（分阶段，禁止跳步）
 
@@ -64,7 +66,9 @@ description: 开发某版本需求、SDD 流程、待确认问题澄清、用户
 2. 将状态改为 **矛盾点池状态：已闭合**。
 3. 再生成 `01`、`02`、`04`（路径均在 `openspec/PRD/<runId>/`）。
 4. **本回合禁止**：`StrReplace`/`Write` 任何业务源码；禁止「顺手实现一版」。
-5. 结束语简短即可（例：「已更新 01/02/03/04，未改业务代码。有 UI 参考请发路径，或回复继续做提案。」）——**不要**要求用户背固定口令。
+5. 更新 `.session-state.json`：`status: ready_for_propose`，`phase: B_done`。
+6. **若 `autoChainOpsx !== false` 且用户未说「只提案」**：**不要结束回合**——立即打开 `06-opsx-自动串联指引.md` 执行阶段 C→D（见下文）。
+7. 若 `autoChainOpsx === false`：简短说明 01/02/03/04 已就绪，等待用户说「继续」。
 
 **本阶段只允许产出：**
 1. 更新 `03-待确认问题清单.md`（标注 **矛盾点池状态：已闭合**，写入用户确认结论）
@@ -74,34 +78,34 @@ description: 开发某版本需求、SDD 流程、待确认问题澄清、用户
 
 **本阶段禁止：**
 - 修改 `src/`、`pages/`、`components/`、`api/` 等实现代码（`02-改动点清单` 只是**计划**，不是实施许可）
-- 执行 `/opsx-propose` 或 `/opsx-apply`
-- 生成 openspec change 目录或宣称“开发完成”
-
-完成后告知用户：“01/02/03/04 已就绪。发 UI 参考路径，或回复「继续」我将执行 /opsx-propose。”
+- 在 **未闭合 03** 时执行 `/opsx-propose` 或 `/opsx-apply`
+- 在 `autoChainOpsx === false` 时未经用户同意就进入阶段 C/D
 
 ---
 
-### 阶段 C — `/opsx-propose`（生成提案，对应你说的「05」）
-**触发条件**：阶段 B 已完成，且用户确认可进入提案（可提供 UI 参考路径，如原型页面文件）。
+### 阶段 C — `/opsx-propose`（生成提案，对应 Step5）
+**触发条件**：
+- 阶段 B 已完成（03 已闭合，01/02/04 已生成），**且**
+- `autoChainOpsx !== false`（默认）→ **与用户确认同一回合内自动执行**；或用户说「继续/做提案」；或 `status` 为 `ready_for_propose` 且用户未说「只提案」。
 
 **必须执行：**
 1. 先读当前仓库 `.opsx/config.json` 与本地 OPSX skills（禁止跨项目 fallback）
-2. 执行 **`/opsx-propose`**，输入至少包含：
-   - `01-需求分析报告.md`
-   - `02-改动点清单.md`
-   - **UI 图/交互参考**（用户指定路径；无则说明缺失并继续文字 spec）
+2. 执行 **`/opsx-propose`**（遵循 `.cursor/commands/opsx-propose.md` 与 `openspec-propose` skill），输入至少包含：
+   - `openspec/PRD/<runId>/01-需求分析报告.md`
+   - `openspec/PRD/<runId>/02-改动点清单.md`
+   - **UI 图/交互参考**（按 `06-opsx-自动串联指引.md` 解析；无则注明缺失并继续）
 3. 一次性生成 openspec change（`proposal.md`、`design.md`、`specs/`、`tasks.md` 等）
+4. 更新 `05-openspec-提案草稿.md`；`.session-state.json` → `status: propose_done`
 
-**本阶段交付物 = openspec 提案产物**（即手动流程里的 Step5 结果）。  
-可在 `openspec/PRD/<runId>/05-openspec-提案草稿.md` 记录 change 名称与路径索引。
+**本阶段交付物 = openspec 提案产物**。  
+**本阶段禁止**：写 `src/`、跑 delivery-pipeline。
 
-**本阶段禁止：**
-- 执行 `/opsx-apply`（留给阶段 D）
+**默认**：提案 apply-ready 后 **立即** 进入阶段 D（勿问用户「是否 apply」），除非用户说了「只提案」。
 
 ---
 
 ### 阶段 D — Apply + TDD + Playwright 交付（禁止裸写代码收尾）
-**触发条件**：阶段 C 的 openspec 提案已 apply-ready，且用户同意实现（如「开始 apply」）。
+**触发条件**：阶段 C 的 openspec 提案已 apply-ready（`autoChainOpsx` 默认下与阶段 C **同一连续执行**）。
 
 **严禁**：跳过 skill 链、不按 `tasks.md` TDD、不跑 delivery-pipeline 就改 `src/` 并宣称完成。