sdd-flow-kit 1.0.16 → 1.0.22

package/dist/steps/setupProject.js

@@ -5,11 +5,11 @@ 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 promises_1 = __importDefault(require("node:fs/promises"));
 const node_path_1 = __importDefault(require("node:path"));
-const promises_2 = require("node:readline/promises");
+const promises_1 = require("node:readline/promises");
 const node_process_1 = __importDefault(require("node:process"));
 const fs_1 = require("../core/fs");
+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"];
@@ -47,7 +47,7 @@ function listLocalBranches(projectRoot) {
 async function askAgent(defaultAgent) {
     if (!node_process_1.default.stdin.isTTY)
         return defaultAgent;
-    const rl = (0, promises_2.createInterface)({ input: node_process_1.default.stdin, output: node_process_1.default.stdout });
+    const rl = (0, promises_1.createInterface)({ input: node_process_1.default.stdin, output: node_process_1.default.stdout });
     const prompt = [
         "请选择开发环境：",
         "1) claude-code (default)",
@@ -68,7 +68,7 @@ async function askAgent(defaultAgent) {
 async function askBranch(defaultBranch) {
     if (!node_process_1.default.stdin.isTTY)
         return defaultBranch;
-    const rl = (0, promises_2.createInterface)({ input: node_process_1.default.stdin, output: node_process_1.default.stdout });
+    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();
     rl.close();
     return answer || defaultBranch;
@@ -76,7 +76,7 @@ async function askBranch(defaultBranch) {
 async function askProjectKind(defaultKind) {
     if (!node_process_1.default.stdin.isTTY)
         return defaultKind;
-    const rl = (0, promises_2.createInterface)({ input: node_process_1.default.stdin, output: node_process_1.default.stdout });
+    const rl = (0, promises_1.createInterface)({ input: node_process_1.default.stdin, output: node_process_1.default.stdout });
     const prompt = [
         "请选择当前项目类型（用于生成 PRD 下载 skill）：",
         "1) OMS (default)",
@@ -94,50 +94,6 @@ async function askProjectKind(defaultKind) {
         return defaultKind;
     return PROJECT_CHOICES[idx - 1];
 }
-function isEditorEnvironmentReady(projectRoot, agent) {
-    const checks = {
-        cursor: ["openspec", ".cursor"],
-        "claude-code": ["openspec", ".claude"],
-        codex: ["openspec", ".codex"],
-        openclaw: ["openspec", ".openclaw"],
-        custom: ["openspec"],
-    };
-    const targetPaths = checks[agent] ?? ["openspec"];
-    return Promise.all(targetPaths.map(async (p) => {
-        try {
-            await promises_1.default.access(node_path_1.default.join(projectRoot, p));
-            return true;
-        }
-        catch {
-            return false;
-        }
-    })).then((arr) => arr.every(Boolean));
-}
-function buildSetupCommand(projectRoot, agent) {
-    const baseArgs = ["@lixin5257xxx/opsx-workflow", "setup"];
-    if (agent === "cursor") {
-        return {
-            cmd: "npx",
-            args: [...baseArgs, "--editor", "cursor", "--project", projectRoot, "-y"],
-        };
-    }
-    if (agent === "claude-code") {
-        return {
-            cmd: "npx",
-            args: [...baseArgs, "--editor", "claude-code", "-y"],
-        };
-    }
-    if (agent === "openclaw") {
-        return {
-            cmd: "npx",
-            args: [...baseArgs, "--editor", "openclaw", "-y"],
-        };
-    }
-    return {
-        cmd: "npx",
-        args: [...baseArgs, "--editor", "codex", "-y"],
-    };
-}
 function ensureBranch(projectRoot, branch) {
     const branches = listLocalBranches(projectRoot);
     if (branches.includes(branch)) {
@@ -241,7 +197,8 @@ function getOpsxPathsByAgent(agent) {
 }
 async function installOpsxConfig(projectRoot, agent) {
     const target = node_path_1.default.join(projectRoot, ".opsx", "config.json");
-    const paths = getOpsxPathsByAgent(agent);
+    const resolvedAgent = await (0, opsxDelivery_1.resolveOpsxAgent)(projectRoot, agent);
+    const paths = getOpsxPathsByAgent(resolvedAgent);
     const config = {
         version: 1,
         editor: paths.editor,
@@ -282,34 +239,29 @@ async function setupProject(options) {
     else {
         branchResult = ensureBranch(options.projectRoot, selectedBranch);
     }
-    let environmentReady = await isEditorEnvironmentReady(options.projectRoot, selectedAgent);
+    let environmentReady = await (0, opsxDelivery_1.isOpsxApplyReady)(options.projectRoot);
     let setupExecuted = false;
     let skillInstalled = false;
     let docsSkillInstalled = false;
     let opsxConfigInstalled = false;
     if (options.light) {
         plannedActions.push("light mode: skipped npx @lixin5257xxx/opsx-workflow setup");
+        if (!environmentReady) {
+            plannedActions.push("opsx apply stack incomplete → run: npx sdd-flow-kit ensure-opsx -y (before /opsx-apply)");
+        }
     }
     else if (!environmentReady) {
-        const { cmd, args } = buildSetupCommand(options.projectRoot, selectedAgent);
-        if (options.dryRun) {
-            plannedActions.push(`would run: ${cmd} ${args.join(" ")}`);
-        }
-        else {
-            const ret = (0, node_child_process_1.spawnSync)(cmd, args, {
-                cwd: options.projectRoot,
-                stdio: "inherit",
-                env: node_process_1.default.env,
-            });
-            if (ret.status !== 0) {
-                throw new Error(`环境安装失败：${cmd} ${args.join(" ")}`);
-            }
-            setupExecuted = true;
-            environmentReady = await isEditorEnvironmentReady(options.projectRoot, selectedAgent);
-        }
+        const ensured = await (0, opsxDelivery_1.ensureOpsxWorkflow)({
+            projectRoot: options.projectRoot,
+            agent: selectedAgent,
+            dryRun: options.dryRun,
+        });
+        plannedActions.push(...ensured.plannedActions);
+        setupExecuted = ensured.workflowInstalled;
+        environmentReady = ensured.ready;
     }
     else if (options.dryRun) {
-        plannedActions.push("environment already ready, no setup needed");
+        plannedActions.push("opsx apply stack already ready");
     }
     if (options.dryRun) {
         for (const skillPath of allSkillInstallPaths(options.projectRoot)) {
@@ -328,6 +280,10 @@ async function setupProject(options) {
         docsSkillInstalled = true;
         await installOpsxConfig(options.projectRoot, selectedAgent);
         opsxConfigInstalled = true;
+        const repaired = await (0, opsxDelivery_1.repairOpsxDeliveryScripts)(options.projectRoot);
+        if (repaired) {
+            plannedActions.push("repaired package.json opsx:delivery-pipeline scripts (poquan → opsx)");
+        }
     }
     const summary = [
         "# SETUP-SUMMARY",

package/dist/steps/startFlow.js

@@ -9,6 +9,7 @@ const promises_1 = __importDefault(require("node:fs/promises"));
 const utils_1 = require("../core/utils");
 const fs_1 = require("../core/fs");
 const templates_1 = require("../core/templates");
+const inferProject_1 = require("../core/inferProject");
 function renderTemplate(template, vars) {
     let out = template;
     for (const [k, v] of Object.entries(vars)) {
@@ -22,8 +23,16 @@ async function startFlowScaffold(options) {
     const outputRoot = node_path_1.default.join(options.projectRoot, "openspec", "PRD", runId);
     const sourceDir = node_path_1.default.join(outputRoot, "source");
     await promises_1.default.mkdir(sourceDir, { recursive: true });
-    // 1) Step1: adi-doc-skill 指引
-    const step1 = await (0, templates_1.loadTemplateText)("artifacts/01-adi-doc-skill-指引.template.md");
+    // 1) Step1: doc-skill 指引（按产品解析脚本路径，支持 monorepo frontend）
+    const kind = (0, inferProject_1.productToKind)(options.product);
+    const docSkill = await (0, inferProject_1.resolveDocSkillDir)(options.projectRoot, kind);
+    const step1Template = await (0, templates_1.loadTemplateText)("artifacts/01-adi-doc-skill-指引.template.md");
+    const step1 = renderTemplate(step1Template, {
+        PRODUCT: options.product,
+        PRODUCT_PREFIX: inferProject_1.PRODUCT_PREFIX_BY_KIND[kind],
+        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);
     // source 占位：让第 2 步提示词在任何工具里都能直接读
     await (0, fs_1.writeTextFileEnsuredDir)(node_path_1.default.join(sourceDir, "PRD.md"), [
@@ -106,10 +115,10 @@ async function startFlowScaffold(options) {
         "产出在 `openspec/changes/<change-name>/`；在 `05-openspec-提案草稿.md` 记录 change 名称。",
         "门禁：仅当 03 已闭环且 01/02/04 完成后执行。",
         "",
-        "## Step 6：/opsx-apply 实现收尾",
-        "提案 apply-ready 后，按 `.opsx/config.json` 执行 `/opsx-apply` 对应 change 的 apply 与 delivery-pipeline。",
-        "必须在当前仓库本地 OPSX 配置下执行，禁止跨仓 fallback。",
-        "门禁：delivery-pipeline exit 0 前禁止宣称流程结束。",
+        "## 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。",
     ].join("\n"));
     return {
         runId,

package/package.json

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

package/src/templates/artifacts/01-adi-doc-skill-/346/214/207/345/274/225.template.md

@@ -1,15 +1,29 @@
-# 01-获取需求文档（adi-doc-skill 指引）
+# 01-获取需求文档（{{PRODUCT}} / {{DOC_SKILL_REL}}）
 
-你的步骤 1 目标：从 Confluence 拉取指定需求版本的 Markdown，并落到本目录的 `source/` 下。
+## 必须执行（不要只用 AI 猜，要跑脚本）
 
-## 请执行
-1. 使用你当前 AI 工具（Cursor / Claude Code / Codex / OpenClaw）调用现有的 `adi-doc-skill`。
-2. 命令/动作建议：让工具“获取 ADI 2.3.2 需求文档”（或等价的触发词），并把下载结果写入本目录：
-   - `source/PRD.md`（PRD 主内容）
-   - `source/接口文档.md`（接口文档，如有）
+1. 在**仓库根**（当前工作目录，可能是 `frontend/` 或 monorepo 根）执行：
 
-## 成功校验
-- 你应该能在 `source/PRD.md` 看到完整 PRD markdown
+```bash
+cd {{DOC_SKILL_REL}}
+export DOC_PRODUCT_PREFIX="{{PRODUCT_PREFIX}}"
+python3 confluence-doc.py {{VERSION_EXAMPLE}}
+```
 
-（如果你希望自动回填，请在 adapter 中实现对应能力。）
+版本号可传：`2.3.2`、`V2.3.2`、`ADI_V2.3.2`、`ADI-V2.3.2`（脚本会归一化）。
 
+2. 脚本会依次搜索：`{{PRODUCT_PREFIX}}-V*`、`{{PRODUCT_PREFIX}}_V*`、`{{PRODUCT_PREFIX}} V*`、`V*` 等。
+
+3. 成功后把生成的 `docs/*.md` **主文档**复制/回填到本 run 目录：
+   - `source/PRD.md`
+
+## 路径说明
+
+- 推荐脚本目录：`{{DOC_SKILL_REL}}`（已向上解析，可能是 `docs/adi-doc-skill` 或 `../docs/adi-doc-skill`）
+- **禁止**在 ADI 需求中使用 `docs/oms-doc-skill`（会搜 OMS 文档导致「未找到」）
+
+## 失败排查
+
+- 输出 `❌ 未找到`：到 Confluence 确认页面标题是否含 `{{PRODUCT_PREFIX}}-V2.3.2` 或 `{{PRODUCT_PREFIX}}_V2.3.2`
+- `playwright` 未安装：`pip install playwright && playwright install chromium`
+- 仍失败：在仓库根执行 `npx sdd-flow-kit install --project {{PRODUCT}} -y` 后重试

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

@@ -41,7 +41,10 @@ description: 开发某版本需求、SDD 流程、待确认问题澄清、用户
 ---
 
 ### 阶段 A — Step1 + Step2（必须可停顿）
-1. **Step1**：按 `01-获取需求文档指引.md` 拉取 PRD，回填 `source/PRD.md`（及可选接口文档）
+1. **Step1**：打开 `01-获取需求文档指引.md`，**在终端执行其中的 `confluence-doc.py` 命令**（不要跳过）。
+   - ADI 必须用 `docs/adi-doc-skill` 或上级 `../docs/adi-doc-skill`，**禁止**用 `docs/oms-doc-skill`。
+   - 用户说「开发 ADI_V2.3.2」时，脚本参数传 `2.3.2` 或 `ADI_V2.3.2` 均可。
+   - 将下载的 markdown 回填 `source/PRD.md`。
 2. **Step2**：执行 `02-需求分析提示词.md`（引用 `docs/` 下已下载的 PRD）
 
 **门禁（Step2）**
@@ -97,13 +100,32 @@ description: 开发某版本需求、SDD 流程、待确认问题澄清、用户
 
 ---
 
-### 阶段 D — `/opsx-apply`（实现与交付收尾）
-**触发条件**：阶段 C 的 openspec 提案已生成且状态为 apply-ready。
-
-**必须执行：**
-1. 按总编排 skill（`.opsx/config.json` 中 `deliveryPipeline` 指向的 skill）执行 **`/opsx-apply`**
-2. 在当前仓库根目录跑 delivery-pipeline（如 `pnpm run opsx:delivery-pipeline -- <change-name>`）
-3. **仅在 pipeline 成功（exit 0）后** 才可宣称本需求开发流程结束
+### 阶段 D — Apply + TDD + Playwright 交付（禁止裸写代码收尾）
+**触发条件**：阶段 C 的 openspec 提案已 apply-ready，且用户同意实现（如「开始 apply」）。
+
+**严禁**：跳过 skill 链、不按 `tasks.md` TDD、不跑 delivery-pipeline 就改 `src/` 并宣称完成。
+
+**必须按顺序执行（以仓库根 `AGENTS.md` 与 `.cursor/skills/` 为准）：**
+
+0. **环境门禁（缺则自动安装，不可跳过）** — 在仓库根执行：
+   ```bash
+   npx sdd-flow-kit ensure-opsx --agent cursor -y
+   ```
+   - 检测：openspec、TDD/Playwright skills、`opsx:delivery-pipeline` 脚本、`AGENTS.md` 等。
+   - 若 FAIL：上述命令会运行 `npx @lixin5257xxx/opsx-workflow setup ...` 安装工作流；**exit 0 前不得开始改 `src/`**。
+1. 读取 `AGENTS.md`、`docs/agent-workflow.md`、`.opsx/config.json`。
+2. 绑定 change 名：写入 `.opsx-active-change`（一行 kebab-case），或 `export OPSX_ACTIVE_CHANGE=<name>`。
+3. **依次读取并执行**（不可省略）：
+   - `.cursor/skills/openspec-apply-change/SKILL.md` — `openspec instructions apply --change "<name>" --json`
+   - `.cursor/skills/tdd-script/SKILL.md` — **每项 task 先测后实现**，并勾选 `tasks.md` 的 `- [x]`
+   - `.cursor/skills/openspec-superpowers-pipeline/SKILL.md` — Delta Spec / 代码质量审查门控
+   - `.cursor/skills/opsx-dev-delivery-pipeline/SKILL.md` — 机械交付脚本（TDD 门禁 → validate → **Playwright** → archive）
+4. 在**仓库根**（含 `package.json` 的目录）执行：
+   ```bash
+   pnpm run opsx:delivery-pipeline -- <change-name>
+   ```
+   脚本路径须为：`.cursor/skills/opsx-dev-delivery-pipeline/scripts/opsx-delivery-pipeline.sh`（若 `package.json` 仍指向 `poquan-*`，先运行 `npx sdd-flow-kit install -y` 修复）。
+5. **完成判定**：`tasks.md` 全部 `- [x]` **且** 上一条命令 **exit 0**。否则不得宣称 SDD 流程结束。
 
 ---