sdd-flow-kit 1.2.2 → 1.3.0

package/README.md

@@ -30,46 +30,56 @@ npx sdd-flow-kit doctor --agent cursor
 
 #### 安装教程
 
-1.  进入你要开发的项目目录
-2.  安装：`pnpm add -D sdd-flow-kit `
-    检查是否安装（Cursor 用户看 `.cursor`，不是 `.claude`）：
-    - `ls .cursor/skills/sdd-flow-kit/SKILL.md`
-    - `ls docs/adi-doc-skill/SKILL.md`（adInsight 应为 **adi**，不是 oms）
-    - Claude Code 用户：`ls .claude/skills/sdd-flow-kit/SKILL.md`
-
-> 若在 `adInsight-web/frontend` 等子目录安装，工具会**向上识别**仓库名；仍不对时：`SDD_FLOW_KIT_PROJECT=ADI pnpm add -D sdd-flow-kit` 或 `npx sdd-flow-kit install --project ADI -y`
-3.  若 skill 未生成，执行手动兜底：
-    - `node ./node_modules/sdd-flow-kit/dist/postinstall.js`（轻量，秒级）
-    - 或 `npx sdd-flow-kit install -y`（完整环境）
-    
-4.  （可选）预演安装：`npx sdd-flow-kit install --dry-run --plan-json`
-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`
-
-> `postinstall` 仅做**轻量**初始化（写入 skill / Cursor 规则 / docs-skill / `.opsx/config.json`），**不会**交互提问，也**不会**跑 `npx opsx-workflow`（避免 `pnpm i` 卡住）。  
-> 完整环境（分支切换 + opsx-workflow）请另执行：`npx sdd-flow-kit install -y`  
-> 跳过 postinstall：`SDD_FLOW_KIT_SKIP_POSTINSTALL=1 pnpm add -D sdd-flow-kit`
+**推荐两步（团队标准）**：
+
+```bash
+cd <你的项目目录>                    # cd 到哪，装到哪
+pnpm add -D sdd-flow-kit             # ① postinstall 自动轻量写入 skill
+npx sdd-flow-kit install --project <类型> -y   # ② 全量 OPSX（按需）
+```
+
+`<类型>` 按项目选择：`ADI` | `OMS` | `欢盟` | `AD Tools`（工具会按目录名自动推断，不对时用 `--project` 覆盖）。
+
+| 项目示例 | `--project` | docs skill 目录 |
+|----------|-------------|-----------------|
+| adInsight-web | `ADI` | `docs/adi-doc-skill/` |
+| operation-web | `OMS` | `docs/oms-doc-skill/` |
+| 欢盟 | `欢盟` | `docs/huan-doc-skill/` |
+
+安装后验证（Cursor 用户看 `.cursor`，不是 `.claude`）：
+
+```bash
+ls .cursor/skills/sdd-flow-kit/SKILL.md
+ls docs/*-doc-skill/SKILL.md
+# Claude Code 用户：
+ls .claude/skills/sdd-flow-kit/SKILL.md
+```
+
+**postinstall 行为（v1.2.4+）**：
+
+- 默认 **light**：写入 SDD skill、Cursor 规则、docs-skill、`.opsx/config.json`；**不**跑 `opsx-workflow`（避免 `pnpm i` 卡住）
+- 自动解析项目根：`INIT_CWD`（pnpm/npm）→ 从 `node_modules` 向上找消费方 `package.json` → `process.cwd()`（手动执行时）
+- 全量 postinstall：`SDD_FLOW_KIT_POSTINSTALL_FULL=1 pnpm add -D sdd-flow-kit`
+- 跳过 postinstall：`SDD_FLOW_KIT_SKIP_POSTINSTALL=1 pnpm add -D sdd-flow-kit`
+
+> 环境变量覆盖项目类型：`SDD_FLOW_KIT_PROJECT=ADI pnpm add -D sdd-flow-kit`
+
+#### 安装失败排查
+
+当没有生成 `.cursor/skills/sdd-flow-kit/SKILL.md` 时：
+
+1. 检查包是否已安装：`pnpm list sdd-flow-kit --depth 0`
+2. **pnpm v10** 若出现 `Ignored build scripts: sdd-flow-kit`：
+   - `pnpm approve-builds` 选中 `sdd-flow-kit`，或
+   - 在 `package.json` 加 `"pnpm": { "onlyBuiltDependencies": ["sdd-flow-kit"] }` 后 `pnpm install`
+3. 若出现 `ERR_PNPM_UNEXPECTED_STORE`，对齐 store 后重装：`pnpm install`
+4. 手动触发轻量安装（任选其一，**须在项目根目录**）：
+   - `node ./node_modules/sdd-flow-kit/dist/postinstall.js`（v1.2.4+ 无需 `INIT_CWD`）
+   - `pnpm rebuild sdd-flow-kit`
+   - `npx sdd-flow-kit install --project OMS -y`（按项目改类型，全量）
+5. 验证：`ls .cursor/skills/sdd-flow-kit/SKILL.md docs/*-doc-skill/SKILL.md`
+
+首次跑任意 CLI（`doctor` / `run` / `gate` 等）也会自动 bootstrap 补装缺失的 SDD skill 或 OPSX。
 
 ##### `pnpm add` 后依赖全被删掉（`Packages: +1 -932`）
 
@@ -83,9 +93,9 @@ npx sdd-flow-kit doctor --agent cursor
    - `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` 才运行。
+**v1.1.2+ 防护**：`repairOpsxDeliveryScripts` 仅合并 `scripts`，写入前检查依赖条数与文件体积。
 
-**pnpm v10 构建脚本**：若出现 `Ignored build scripts: sdd-flow-kit`，执行 `pnpm approve-builds` 选中 `sdd-flow-kit`，或安装后手动：`node ./node_modules/sdd-flow-kit/dist/postinstall.js`
+**v1.2.4+ postinstall**：默认 light；自动解析消费方项目根（不依赖 `INIT_CWD`）；首次安装后会写入 `pnpm.onlyBuiltDependencies` 以便后续 `pnpm install` 执行脚本。
 
 #### 使用说明
 
@@ -115,9 +125,11 @@ npx sdd-flow-kit run --product ADI --version 2.3.2 -y
 ```bash
 # 门禁（失败 exit 1）
 npx sdd-flow-kit gate --project-root . --run-id <runId> --expect prd-fetched
-npx sdd-flow-kit gate --project-root . --run-id <runId> --expect docs-closed      # 检测 git 是否误改 src
+npx sdd-flow-kit gate --project-root . --run-id <runId> --expect docs-closed      # 含 05 已定义 + 无 src 改动
 npx sdd-flow-kit gate --project-root . --run-id <runId> --expect propose-ready --change <name>
+npx sdd-flow-kit gate --project-root . --run-id <runId> --expect ac-ready --change <name>
 npx sdd-flow-kit gate --project-root . --run-id <runId> --expect impl-allowed --change <name>
+npx sdd-flow-kit gate --project-root . --run-id <runId> --expect ac-signed
 npx sdd-flow-kit gate --project-root . --run-id <runId> --expect shipped --change <name>
 
 # 阶段推进（更新 .session-state.json + NEXT.md）
@@ -132,12 +144,26 @@ npx sdd-flow-kit propose --project-root . --run-id <runId> --change <name>
 npx sdd-flow-kit deliver --project-root . --run-id <runId> --change <name>
 ```
 
-`docs-closed` 会在 git 仓库中扫描 `src/`、`frontend/src/` 等路径；文档阶段若已有实现层改动，**gate 失败**。
+`docs-closed` 会在 git 仓库中扫描 `src/`、`frontend/src/` 等路径；文档阶段若已有实现层改动，**gate 失败**。同时要求 `05-验收清单.md` 已标注「定义状态：已定义」且含 P0 项。
+
+##### v1.3.0 — 验收清单（AC Matrix）流程
+
+| 文档/门禁 | 说明 |
+|-----------|------|
+| `05-验收清单.md` | 从 `source/PRD.md` 逐条抽 AC；**唯一验收 SSOT** |
+| `gate docs-closed` | 含 05 已定义 + 01/02/04 + 03 闭合 |
+| `gate ac-ready` | propose 后：每条 P0 在 `tasks.md`/`spec.md` 含 `[AC-XX]` |
+| `gate ac-signed` | deliver 前：05 中 P0 已验收 + 「签收状态：已签收」 |
+| `LAYERED-TESTING.md` | 安装到 `.cursor/skills/sdd-flow-kit/`（L1–L4 测试策略） |
+
+推荐文档顺序：**03 闭合 → 05 → 04（引用 AC）→ 01/02**。
+
+原 `05-openspec-提案草稿` / `06-opsx` 已顺延为 **`06-openspec-提案草稿`** / **`07-opsx-自动串联指引`**。
 
 ##### 需求澄清：用户无需背提示词
 
 `install` 会写入 `.cursor/rules/sdd-flow-kit-gates.mdc` 与触发 Skill（已改为**脚本优先**）。  
-用户粘贴确认点后：先更新 01/02/03/04，再执行 `gate docs-closed` → `phase advance --to docs-done`；**禁止**跳过 gate 直接改代码。
+用户粘贴确认点后：先更新 **05→04→01/02/03**，再执行 `gate docs-closed` → `phase advance --to docs-done`；propose 后 `gate ac-ready`；deliver 前 `gate ac-signed`。**禁止**跳过 gate 直接改代码。
 
 ##### `/opsx-apply` 与 TDD + Playwright 检查机制
 

package/dist/adapters/index.js

@@ -41,9 +41,9 @@ async function runClaudeFlow(args) {
         `你在项目目录内执行需求流程，runId=${args.runId}。`,
         "请按分阶段门禁执行（禁止跳步）：",
         "1) 01-获取需求文档指引：回填 source/PRD.md（及接口文档，如有）。",
-        "2) 02-需求分析：若矛盾点未闭合，仅更新 03-待确认问题清单.md 并停止；用户确认后再生成 01/02/闭环03。",
-        "3) 用户确认后补全 04-技术文档草稿.md。",
-        "4) 03 闭环后默认同一回合：/opsx-propose（01+02+UI）→ /opsx-apply → delivery-pipeline exit 0（见 06-opsx-自动串联指引.md）。",
+        "2) 02-需求分析：若矛盾点未闭合，仅更新 03-待确认问题清单.md 并停止；用户确认后生成 05→04→01/02/闭环03。",
+        "3) 用户确认后从 source/PRD.md 填写 05-验收清单.md（定义状态：已定义），再补全 04-技术文档草稿.md（引用 AC-ID）。",
+        "4) 03 闭环后默认同一回合：/opsx-propose（05+04+02+UI）→ gate ac-ready → /opsx-apply → gate ac-signed → delivery-pipeline exit 0（见 07-opsx-自动串联指引.md）。",
         "5) 仅当用户说「只提案」或 autoChainOpsx=false 时，在 propose 后暂停等待 apply。",
         "完成后输出一句：SDD flow completed",
         "",
@@ -92,12 +92,12 @@ async function runCursorFlow(args) {
         "强约束：",
         "1) 在 docs 阶段（docModeOnly=true）只允许改 openspec/PRD/**，禁止改 src/。",
         "2) 若矛盾点池未闭合：仅更新 03-待确认问题清单.md 并停止，等待用户确认点。",
-        "3) 若矛盾点池已闭合：同一回合生成 01/02/04，并自动衔接 openspec+superpowers（autoChainOpsx=true 时）。",
+        "3) 若矛盾点池已闭合：同一回合生成 05→04→01/02，并自动衔接 openspec+superpowers（autoChainOpsx=true 时）。",
         "",
         "执行顺序：",
         "A) 先按 01-获取需求文档指引.md 执行 confluence-doc.py，把 PRD 回填到 source/PRD.md。",
-        "B) 再执行 02-需求分析提示词.md（如下）生成/更新 03（必要时）或生成 01/02/04。",
-        "C) 若满足自动串联条件（autoChainOpsx!==false 且用户未说只提案）：继续按 06-opsx-自动串联指引.md 走 propose→apply→delivery-pipeline。",
+        "B) 再执行 02-需求分析提示词.md（如下）生成/更新 03（必要时）或生成 05/04/01/02。",
+        "C) 若满足自动串联条件（autoChainOpsx!==false 且用户未说只提案）：继续按 07-opsx-自动串联指引.md 走 propose→ac-ready→apply→ac-signed→delivery-pipeline。",
         "",
         "完成判定：",
         "- 若停在澄清：输出一句 `SDD_STATUS=AWAIT_CONFIRMATION`。",

package/dist/cli.js

@@ -15,6 +15,7 @@ const invokeFlow_1 = require("./steps/invokeFlow");
 const runGate_1 = require("./steps/runGate");
 const runPhaseAdvance_1 = require("./steps/runPhaseAdvance");
 const runPropose_1 = require("./steps/runPropose");
+const runValidate_1 = require("./steps/runValidate");
 const runDeliver_1 = require("./steps/runDeliver");
 const bootstrap_1 = require("./core/bootstrap");
 const projectRoots_1 = require("./core/projectRoots");
@@ -36,10 +37,10 @@ function printHelp() {
         "1) 生成流程产物骨架：",
         "   npx sdd-flow-kit start --product ADI --version 2.3.2",
         "",
-        "2) 安装到当前目录（全量：SDD + OPSX + Superpowers，推荐）：",
-        "   cd <你的项目目录>   # 如 adInsight-web/frontend",
-        "   pnpm add -D sdd-flow-kit",
-        "   npx sdd-flow-kit install --project ADI -y",
+        "2) 安装到当前目录（推荐两步）：",
+        "   cd <你的项目目录>   # 如 adInsight-web/frontend 或 operation-web",
+        "   pnpm add -D sdd-flow-kit          # postinstall 自动轻量写入 skill（pnpm v10 见 README）",
+        "   npx sdd-flow-kit install --project ADI -y   # 全量：OPSX + Superpowers（按项目改 ADI/OMS）",
         "   本地 OPSX: SDD_OPSX_WORKFLOW_PACKAGE=file:../../opsx-workflow npx sdd-flow-kit install -y",
         "",
         "3) 生成骨架并进入可执行模式（推荐）：",
@@ -57,13 +58,20 @@ function printHelp() {
         "7) 脚本门禁（失败 exit 1，不依赖自然语言）：",
         "   npx sdd-flow-kit gate --project-root . --run-id <runId> --expect prd-fetched",
         "   npx sdd-flow-kit gate --project-root . --run-id <runId> --expect docs-closed",
+        "   npx sdd-flow-kit gate --project-root . --run-id <runId> --expect ac-ready --change <name>",
+        "   npx sdd-flow-kit gate --project-root . --run-id <runId> --expect ac-signed",
         "   npx sdd-flow-kit gate --project-root . --run-id <runId> --expect impl-allowed --change <name>",
+        "   npx sdd-flow-kit gate --project-root . --run-id <runId> --expect validate-pass --change <name>",
         "",
         "8) 阶段推进（更新 session + NEXT.md）：",
-        "   npx sdd-flow-kit phase advance --project-root . --run-id <runId> --to after-prd|docs-done|propose-done|impl|shipped",
+        "   npx sdd-flow-kit phase advance --project-root . --run-id <runId> --to after-prd|docs-done|propose-done|impl|validate-done|shipped",
         "",
-        "9) 提案 / 交付：",
+        "9) 提案 / 实现 / 验收 / 交付：",
         "   npx sdd-flow-kit propose --project-root . --run-id <runId> --change <name>",
+        "   npx sdd-flow-kit phase advance --project-root . --run-id <runId> --to impl --change <name>",
+        "   # 在 AI 工具执行 /opsx-apply，按 tasks.md 逐条实现并勾选 [x]",
+        "   npx sdd-flow-kit validate --project-root . --run-id <runId> --change <name>",
+        "   npx sdd-flow-kit phase advance --project-root . --run-id <runId> --to validate-done --change <name>",
         "   npx sdd-flow-kit deliver --project-root . --run-id <runId> --change <name>",
         "",
         "可选参数：",
@@ -72,7 +80,7 @@ function printHelp() {
         "   环境变量 SDD_FLOW_KIT_LEGACY_MONOREPO=1 恢复「仓库根无 package.json 时落到 frontend/」",
         "   --agent <name>         cursor | claude-code | codex | openclaw | custom（默认 claude-code）",
         "   --branch <name>        开发分支；不存在会自动创建",
-        "   --project <name>       OMS | ADI | 欢盟 | AD Tools（默认 OMS，用于生成 docs/*-doc-skill）",
+        "   --project <name>       OMS | ADI | 欢盟 | AD Tools | BreakX（默认 OMS，用于生成 docs/*-doc-skill）",
         "   -y                     非交互模式（使用默认值）",
         "   --dry-run              预演模式：仅检测并输出计划，不执行写入/安装/切分支",
         "   --plan-json            输出机器可读 JSON 计划结果",
@@ -92,8 +100,11 @@ async function main() {
         "prd-fetched",
         "questions-open",
         "docs-closed",
+        "ac-ready",
+        "ac-signed",
         "propose-ready",
         "impl-allowed",
+        "validate-pass",
         "shipped",
     ];
     const PHASE_TARGETS = [
@@ -101,6 +112,7 @@ async function main() {
         "docs-done",
         "propose-done",
         "impl",
+        "validate-done",
         "shipped",
     ];
     if (cmd !== "start" &&
@@ -113,6 +125,7 @@ async function main() {
         cmd !== "gate" &&
         cmd !== "phase" &&
         cmd !== "propose" &&
+        cmd !== "validate" &&
         cmd !== "deliver") {
         printHelp();
         process_1.default.exitCode = 1;
@@ -137,7 +150,7 @@ async function main() {
         return;
     }
     const agent = agentValue;
-    const allowedProjects = ["OMS", "ADI", "欢盟", "AD Tools"];
+    const allowedProjects = ["OMS", "ADI", "欢盟", "AD Tools", "BreakX"];
     if (!allowedProjects.includes(projectKind)) {
         // eslint-disable-next-line no-console
         console.error(`不支持的 --project: ${projectKind}（可选：${allowedProjects.join(" / ")}）`);
@@ -155,6 +168,7 @@ async function main() {
         "gate",
         "phase",
         "propose",
+        "validate",
         "deliver",
     ]);
     if (!skipBootstrap && !dryRun && bootstrapCommands.has(cmd)) {
@@ -230,6 +244,30 @@ async function main() {
             process_1.default.exitCode = 1;
         return;
     }
+    if (cmd === "validate") {
+        if (!changeName) {
+            // eslint-disable-next-line no-console
+            console.error("validate 需要 --change <kebab-name>");
+            process_1.default.exitCode = 1;
+            return;
+        }
+        const result = await (0, runValidate_1.runValidate)({
+            projectRoot,
+            runId,
+            change: changeName,
+            agent,
+            dryRun,
+        });
+        // eslint-disable-next-line no-console
+        console.log(result.ok ? `✅ ${result.detail}` : `❌ ${result.detail}`);
+        if (result.needUserConfirm) {
+            // eslint-disable-next-line no-console
+            console.warn(`⚠️ 验收回退已达 ${result.ok ? 0 : 3} 次上限，需要用户确认后继续实现。`);
+        }
+        if (!result.ok)
+            process_1.default.exitCode = 1;
+        return;
+    }
     if (cmd === "deliver") {
         if (!changeName) {
             // eslint-disable-next-line no-console
@@ -363,7 +401,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 执行；确认点前禁止改 src/。`);
+    console.log(`请打开 openspec/PRD/${result.runId}/NEXT.md，严格按 gate→phase→propose→impl(/opsx-apply)→validate→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/acMatrix.js

@@ -0,0 +1,116 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseAcMatrix = parseAcMatrix;
+exports.areAllP0Accepted = areAllP0Accepted;
+const path_1 = __importDefault(require("path"));
+const fs_1 = require("./fs");
+const AC_ID_RE = /^AC-\d{2,}$/i;
+const P0_RE = /^P0$/i;
+/**
+ * 读取 05-验收清单.md 并解析表格中的 AC 行（支持 Markdown 表格）。
+ */
+async function parseAcMatrix(outputRoot) {
+    var _a, _b, _c, _d, _e;
+    const filePath = path_1.default.join(outputRoot, "05-验收清单.md");
+    const content = await (0, fs_1.readFileIfExists)(filePath);
+    if (!content || content.trim().length < 80) {
+        return {
+            ok: false,
+            detail: "05-验收清单.md 缺失或过短",
+            items: [],
+            p0Ids: [],
+            definitionReady: false,
+            signed: false,
+        };
+    }
+    const definitionReady = /定义状态[：:]\s*[`「]*已定义/.test(content);
+    const signed = /签收状态[：:]\s*[`「]*已签收/.test(content);
+    const items = [];
+    const lines = content.split("\n");
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith("|"))
+            continue;
+        if (/^\|\s*[-:]+/.test(trimmed))
+            continue;
+        if (/^\|\s*ID\s*\|/i.test(trimmed))
+            continue;
+        const cells = trimmed
+            .split("|")
+            .map((c) => c.trim())
+            .filter((_, i, arr) => i > 0 && i < arr.length - 1);
+        if (cells.length < 5)
+            continue;
+        const id = (_b = (_a = cells[0]) === null || _a === void 0 ? void 0 : _a.toUpperCase()) !== null && _b !== void 0 ? _b : "";
+        if (!AC_ID_RE.test(id))
+            continue;
+        const priority = (_c = cells[4]) !== null && _c !== void 0 ? _c : "";
+        const acceptanceStatus = (_e = (_d = cells[6]) !== null && _d !== void 0 ? _d : cells[cells.length - 1]) !== null && _e !== void 0 ? _e : "待验收";
+        items.push({
+            id,
+            priority,
+            acceptanceStatus,
+            prdRef: cells[1],
+            criterion: cells[2],
+            testType: cells[3],
+        });
+    }
+    const p0Ids = items.filter((i) => P0_RE.test(i.priority.trim())).map((i) => i.id);
+    if (items.length === 0) {
+        return {
+            ok: false,
+            detail: "05 中未解析到任何 AC-XX 行",
+            items,
+            p0Ids,
+            definitionReady,
+            signed,
+        };
+    }
+    if (!definitionReady) {
+        return {
+            ok: false,
+            detail: "05 未标注「定义状态：已定义」",
+            items,
+            p0Ids,
+            definitionReady: false,
+            signed,
+        };
+    }
+    if (p0Ids.length === 0) {
+        return {
+            ok: false,
+            detail: "05 中至少需 1 条 P0 验收项",
+            items,
+            p0Ids,
+            definitionReady,
+            signed,
+        };
+    }
+    return {
+        ok: true,
+        detail: `已解析 ${items.length} 条 AC（P0=${p0Ids.length}）`,
+        items,
+        p0Ids,
+        definitionReady,
+        signed,
+    };
+}
+/**
+ * 判断所有 P0 项是否已在签收清单中标记为已验收。
+ */
+function areAllP0Accepted(items, p0Ids) {
+    const pending = p0Ids.filter((id) => {
+        const row = items.find((i) => i.id === id);
+        if (!row)
+            return true;
+        const st = row.acceptanceStatus.trim();
+        return !/(已验收|\[x\])/i.test(st);
+    });
+    if (pending.length > 0) {
+        return { ok: false, detail: `P0 未全部签收: ${pending.join(", ")}` };
+    }
+    return { ok: true, detail: `全部 ${p0Ids.length} 条 P0 已验收` };
+}

package/dist/core/bootstrap.js

@@ -11,20 +11,27 @@ const opsxDelivery_1 = require("./opsxDelivery");
 const projectRoots_1 = require("./projectRoots");
 const setupProject_1 = require("../steps/setupProject");
 /**
- * pnpm v10 常拦截 postinstall；首次跑 CLI 时补全 SDD + OPSX 全栈（不切分支）。
+ * pnpm v10 常拦截 postinstall；首次跑 CLI 时补全 SDD skill 或 OPSX 全栈（不切分支）。
  */
 async function bootstrapProjectIfNeeded(options) {
     var _a;
     const installRoot = (0, projectRoots_1.resolveInstallRoot)(options.projectRoot);
-    if (await (0, opsxDelivery_1.isOpsxApplyReady)(installRoot)) {
+    const opsxReady = await (0, opsxDelivery_1.isOpsxApplyReady)(installRoot);
+    const sddReady = await (0, projectRoots_1.isSddKitSkillInstalled)(installRoot);
+    if (opsxReady && sddReady) {
         return false;
     }
     if (options.dryRun) {
         return true;
     }
     const kind = (_a = options.projectKind) !== null && _a !== void 0 ? _a : (await (0, inferProject_1.inferProjectKind)(installRoot));
+    const missing = [];
+    if (!sddReady)
+        missing.push("SDD skill");
+    if (!opsxReady)
+        missing.push("OPSX");
     // eslint-disable-next-line no-console
-    console.log("[sdd-flow-kit] 检测到 OPSX 未就绪，正在自动 bootstrap（等价 install -y）…");
+    console.log(`[sdd-flow-kit] 检测到 ${missing.join(" / ")} 未就绪，正在自动 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) {
@@ -35,9 +42,9 @@ async function bootstrapProjectIfNeeded(options) {
         projectRoot: installRoot,
         agent: options.agent,
         yes: true,
-        light: false,
+        light: opsxReady,
         skipGit: true,
-        projectKind: kind !== null && kind !== void 0 ? kind : "ADI",
+        projectKind: kind !== null && kind !== void 0 ? kind : "OMS",
     });
     if (!(await (0, opsxDelivery_1.isOpsxApplyReady)(installRoot))) {
         await (0, opsxDelivery_1.ensureOpsxWorkflow)({
@@ -46,7 +53,8 @@ async function bootstrapProjectIfNeeded(options) {
         });
     }
     const ready = await (0, opsxDelivery_1.isOpsxApplyReady)(installRoot);
-    if (ready) {
+    const skillReady = await (0, projectRoots_1.isSddKitSkillInstalled)(installRoot);
+    if (ready && skillReady) {
         // eslint-disable-next-line no-console
         console.log("[sdd-flow-kit] bootstrap 完成：SDD + OPSX 已就绪");
     }

package/dist/core/inferProject.js

@@ -9,18 +9,20 @@ exports.resolveDocSkillDir = resolveDocSkillDir;
 exports.inferProjectKind = inferProjectKind;
 const promises_1 = __importDefault(require("fs/promises"));
 const path_1 = __importDefault(require("path"));
-exports.ALLOWED_PROJECTS = ["OMS", "ADI", "欢盟", "AD Tools"];
+exports.ALLOWED_PROJECTS = ["OMS", "ADI", "欢盟", "AD Tools", "BreakX"];
 exports.DOC_SKILL_BY_KIND = {
     ADI: "adi-doc-skill",
     OMS: "oms-doc-skill",
     欢盟: "huan-doc-skill",
     "AD Tools": "ad-tools-doc-skill",
+    BreakX: "breakx-doc-skill",
 };
 exports.PRODUCT_PREFIX_BY_KIND = {
     ADI: "ADI",
     OMS: "OMS",
     欢盟: "HUAN",
     "AD Tools": "ADTOOLS",
+    BreakX: "BreakX",
 };
 function productToKind(product) {
     const p = product.trim().toUpperCase();
@@ -32,6 +34,8 @@ function productToKind(product) {
         return "欢盟";
     if (p.includes("AD TOOLS") || p === "ADTOOLS")
         return "AD Tools";
+    if (p === "BREAKX" || p.includes("POQUAN") || p.includes("破圈"))
+        return "BreakX";
     return "OMS";
 }
 /** 从 projectRoot 向上查找 docs/*-doc-skill（适配 frontend 子目录 + 根目录 docs） */
@@ -80,6 +84,9 @@ function matchKindInText(text) {
     if (t.includes("ad-tools") || t.includes("adtools")) {
         return "AD Tools";
     }
+    if (t.includes("poquan") || t.includes("breakx") || t.includes("破圈")) {
+        return "BreakX";
+    }
     return null;
 }
 /** 从 projectRoot 向上查找已存在的 docs/*-doc-skill */
@@ -124,7 +131,7 @@ async function inferFromPackageJson(dir) {
     }
 }
 /**
- * 推断 OMS / ADI / 欢盟 / AD Tools。
+ * 推断 OMS / ADI / 欢盟 / AD Tools / BreakX。
  *  monorepo 子目录（如 adInsight-web/frontend）会向上扫描路径，避免误判为 OMS。
  */
 async function inferProjectKind(projectRoot) {

package/dist/core/openspecGate.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.checkOpenspecApplyReady = checkOpenspecApplyReady;
 exports.checkTasksAllDone = checkTasksAllDone;
 exports.changeDirExists = changeDirExists;
+exports.checkP0AcMappedInChange = checkP0AcMappedInChange;
 const child_process_1 = require("child_process");
 const promises_1 = __importDefault(require("fs/promises"));
 const path_1 = __importDefault(require("path"));
@@ -81,3 +82,47 @@ async function changeDirExists(projectRoot, changeName) {
         return false;
     }
 }
+/**
+ * 递归读取 change 目录下所有 .md，检查 P0 AC-ID 是否在 spec/tasks 中有 [AC-XX] 映射。
+ */
+async function checkP0AcMappedInChange(projectRoot, changeName, p0Ids) {
+    if (p0Ids.length === 0) {
+        return { ok: false, detail: "无 P0 AC 可校验映射" };
+    }
+    const changeRoot = path_1.default.join(projectRoot, "openspec", "changes", changeName);
+    try {
+        await promises_1.default.access(changeRoot);
+    }
+    catch {
+        return { ok: false, detail: `change 目录不存在: ${changeRoot}` };
+    }
+    const mdFiles = [];
+    async function walk(dir) {
+        const entries = await promises_1.default.readdir(dir, { withFileTypes: true });
+        for (const ent of entries) {
+            const full = path_1.default.join(dir, ent.name);
+            if (ent.isDirectory()) {
+                await walk(full);
+            }
+            else if (ent.isFile() && ent.name.endsWith(".md")) {
+                mdFiles.push(full);
+            }
+        }
+    }
+    await walk(changeRoot);
+    const combined = (await Promise.all(mdFiles.map((f) => (0, fs_1.readFileIfExists)(f))))
+        .filter(Boolean)
+        .join("\n");
+    const missing = p0Ids.filter((id) => {
+        const bracket = `[${id}]`;
+        const bare = id;
+        return !combined.includes(bracket) && !combined.includes(bare);
+    });
+    if (missing.length > 0) {
+        return {
+            ok: false,
+            detail: `P0 未映射到 spec/tasks: ${missing.join(", ")}（须在 tasks.md 或 spec.md 含 [AC-XX]）`,
+        };
+    }
+    return { ok: true, detail: `全部 ${p0Ids.length} 条 P0 已映射到 change 文档` };
+}

package/dist/core/prdArtifacts.js

@@ -6,7 +6,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isPrdFetched = isPrdFetched;
 exports.isQuestionsClosed = isQuestionsClosed;
 exports.areAnalysisDocsReady = areAnalysisDocsReady;
+exports.isAcceptanceChecklistDefined = isAcceptanceChecklistDefined;
+exports.isAcceptanceChecklistSigned = isAcceptanceChecklistSigned;
 const path_1 = __importDefault(require("path"));
+const acMatrix_1 = require("./acMatrix");
 const fs_1 = require("./fs");
 const PRD_PLACEHOLDER_MARKERS = [
     "请把《PRD》",
@@ -51,3 +54,26 @@ async function areAnalysisDocsReady(outputRoot) {
     }
     return { ok: true, detail: "01/02/04 文档齐全" };
 }
+/** 05-验收清单是否已从 PRD 定义完成（含至少一条 P0）。 */
+async function isAcceptanceChecklistDefined(outputRoot) {
+    const parsed = await (0, acMatrix_1.parseAcMatrix)(outputRoot);
+    if (!parsed.ok) {
+        return { ok: false, detail: parsed.detail };
+    }
+    return { ok: true, detail: parsed.detail };
+}
+/** deliver 前 AC 签收：P0 全部已验收且清单标注已签收。 */
+async function isAcceptanceChecklistSigned(outputRoot) {
+    const parsed = await (0, acMatrix_1.parseAcMatrix)(outputRoot);
+    if (!parsed.ok) {
+        return { ok: false, detail: parsed.detail };
+    }
+    if (!parsed.signed) {
+        return { ok: false, detail: "05 未标注「签收状态：已签收」" };
+    }
+    const p0 = (0, acMatrix_1.areAllP0Accepted)(parsed.items, parsed.p0Ids);
+    if (!p0.ok) {
+        return { ok: false, detail: p0.detail };
+    }
+    return { ok: true, detail: `AC 签收完成（${parsed.p0Ids.length} 条 P0）` };
+}