sdd-flow-kit 1.2.3 → 1.3.1

package/dist/core/projectRoots.js

@@ -7,9 +7,12 @@ exports.resolveInstallRoot = resolveInstallRoot;
 exports.isLegacyMonorepoMode = isLegacyMonorepoMode;
 exports.resolveOpenspecRoot = resolveOpenspecRoot;
 exports.resolvePackageRoot = resolvePackageRoot;
+exports.isSddKitSkillInstalled = isSddKitSkillInstalled;
+exports.resolvePostinstallProjectRoot = resolvePostinstallProjectRoot;
 exports.listOpenspecPrdRoots = listOpenspecPrdRoots;
 const promises_1 = __importDefault(require("fs/promises"));
 const path_1 = __importDefault(require("path"));
+const process_1 = __importDefault(require("process"));
 async function pathExists(filePath) {
     try {
         await promises_1.default.access(filePath);
@@ -26,14 +29,14 @@ async function pathExists(filePath) {
  */
 function resolveInstallRoot(projectRoot) {
     var _a;
-    const fromEnv = (_a = process.env.SDD_FLOW_KIT_INSTALL_ROOT) === null || _a === void 0 ? void 0 : _a.trim();
+    const fromEnv = (_a = process_1.default.env.SDD_FLOW_KIT_INSTALL_ROOT) === null || _a === void 0 ? void 0 : _a.trim();
     if (fromEnv)
         return path_1.default.resolve(fromEnv);
     return path_1.default.resolve(projectRoot);
 }
 /** 是否启用旧版 monorepo 行为（在仓库根执行时自动落到 frontend/） */
 function isLegacyMonorepoMode() {
-    return process.env.SDD_FLOW_KIT_LEGACY_MONOREPO === "1" || process.env.SDD_FLOW_KIT_LEGACY_MONOREPO === "true";
+    return process_1.default.env.SDD_FLOW_KIT_LEGACY_MONOREPO === "1" || process_1.default.env.SDD_FLOW_KIT_LEGACY_MONOREPO === "true";
 }
 /**
  * 从 installRoot 向上查找含 openspec/ 的目录（用于解析 PRD run、openspec CLI）。
@@ -74,6 +77,80 @@ async function resolvePackageRoot(installRoot) {
 /**
  * 收集自 installRoot 向上所有存在的 openspec/PRD 目录（用于 resolveRun）。
  */
+/** SDD 主 skill 是否已写入（任一 agent 目录有 SKILL.md 即视为已安装） */
+async function isSddKitSkillInstalled(installRoot) {
+    const root = resolveInstallRoot(installRoot);
+    const candidates = [
+        path_1.default.join(root, ".cursor", "skills", "sdd-flow-kit", "SKILL.md"),
+        path_1.default.join(root, ".claude", "skills", "sdd-flow-kit", "SKILL.md"),
+        path_1.default.join(root, ".codex", "skills", "sdd-flow-kit", "SKILL.md"),
+        path_1.default.join(root, ".openclaw", "skills", "sdd-flow-kit", "SKILL.md"),
+    ];
+    for (const candidate of candidates) {
+        if (await pathExists(candidate))
+            return true;
+    }
+    return false;
+}
+function packageJsonListsSddFlowKit(pkgPath, text) {
+    try {
+        const pkg = JSON.parse(text);
+        const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+        return Boolean(deps["sdd-flow-kit"]);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 解析 postinstall 应写入的目标项目根。
+ * 优先级：INIT_CWD → 从 node_modules/sdd-flow-kit 向上找消费方 package.json → process.cwd()。
+ */
+async function resolvePostinstallProjectRoot(pkgDir) {
+    var _a;
+    const resolvedPkgDir = path_1.default.resolve(pkgDir);
+    const initCwd = (_a = process_1.default.env.INIT_CWD) === null || _a === void 0 ? void 0 : _a.trim();
+    if (initCwd) {
+        const root = resolveInstallRoot(initCwd);
+        if (root !== resolvedPkgDir) {
+            return { root, source: "INIT_CWD" };
+        }
+    }
+    let cur = path_1.default.dirname(resolvedPkgDir);
+    for (let i = 0; i < 12; i += 1) {
+        cur = path_1.default.dirname(cur);
+        const pkgPath = path_1.default.join(cur, "package.json");
+        try {
+            const text = await promises_1.default.readFile(pkgPath, "utf8");
+            if (packageJsonListsSddFlowKit(pkgPath, text)) {
+                const root = resolveInstallRoot(cur);
+                if (root !== resolvedPkgDir) {
+                    return { root, source: "node_modules-ancestor" };
+                }
+            }
+        }
+        catch {
+            // continue walking up
+        }
+        const parent = path_1.default.dirname(cur);
+        if (parent === cur)
+            break;
+    }
+    const cwdRoot = resolveInstallRoot(process_1.default.cwd());
+    if (cwdRoot !== resolvedPkgDir) {
+        try {
+            const pkgPath = path_1.default.join(cwdRoot, "package.json");
+            const text = await promises_1.default.readFile(pkgPath, "utf8");
+            if (packageJsonListsSddFlowKit(pkgPath, text)) {
+                return { root: cwdRoot, source: "process.cwd()" };
+            }
+        }
+        catch {
+            // fall through
+        }
+    }
+    return null;
+}
 async function listOpenspecPrdRoots(startDir) {
     const seen = new Set();
     const out = [];

package/dist/core/sessionState.js

@@ -32,6 +32,7 @@ function defaultSession(args) {
         activeChange: null,
         createdAtISO: new Date().toISOString(),
         implGitBaseline: null,
+        validateRetryCount: 0,
     };
 }
 /** 将旧版 session（无 phase 字段）迁移为当前结构 */
@@ -51,5 +52,6 @@ function normalizeSession(raw, outputRoot) {
         activeChange: raw.activeChange ? String(raw.activeChange) : null,
         createdAtISO: String((_e = raw.createdAtISO) !== null && _e !== void 0 ? _e : new Date().toISOString()),
         implGitBaseline: raw.implGitBaseline ? String(raw.implGitBaseline) : null,
+        validateRetryCount: typeof raw.validateRetryCount === "number" ? raw.validateRetryCount : 0,
     };
 }

package/dist/core/writeNext.js

@@ -16,6 +16,15 @@ async function writeInitialNext(outputRoot, projectRoot, runId) {
         "",
         "> **禁止**跳过下列命令。失败 (exit≠0) 时不得进入下一阶段或修改 `src/`。",
         "",
+        "## 文档职责（SSOT）",
+        "",
+        "| 文档 | 职责 |",
+        "|------|------|",
+        "| `01` | 业务概述、范围、风险（**非**完整验收） |",
+        "| `05` | **唯一验收 SSOT**（AC Matrix） |",
+        "| `04` | 技术方案（须引用 AC-ID） |",
+        "| `tasks.md` | AC 的可执行映射（`[AC-XX]`） |",
+        "",
         "## 1. Step1 — 拉取 PRD",
         "按 `01-获取需求文档指引.md` 执行 confluence 脚本，然后：",
         "```bash",
@@ -30,7 +39,7 @@ async function writeInitialNext(outputRoot, projectRoot, runId) {
         "```",
         "",
         "## 3. 用户确认后 — 阶段 B（仅文档）",
-        "生成 01/02/04 后：",
+        "顺序：**03 闭合 → 从 `source/PRD.md` 生成 `05-验收清单.md` → `04`（引用 AC-ID）→ `01`/`02`**",
         "```bash",
         `npx sdd-flow-kit gate --project-root "${pr}" --run-id ${runId} --expect docs-closed`,
         `npx sdd-flow-kit phase advance --project-root "${pr}" --run-id ${runId} --to docs-done`,
@@ -39,17 +48,25 @@ async function writeInitialNext(outputRoot, projectRoot, runId) {
         "## 4. 阶段 C — propose",
         "```bash",
         `npx sdd-flow-kit propose --project-root "${pr}" --run-id ${runId} --change <kebab-name>`,
+        "# AI 生成 openspec artifacts 后，tasks.md 每条须含 [AC-XX]",
+        `npx sdd-flow-kit gate --project-root "${pr}" --run-id ${runId} --expect propose-ready --change <kebab-name>`,
+        `npx sdd-flow-kit gate --project-root "${pr}" --run-id ${runId} --expect ac-ready --change <kebab-name>`,
         `npx sdd-flow-kit phase advance --project-root "${pr}" --run-id ${runId} --to propose-done --change <kebab-name>`,
         "```",
         "",
         "## 5. 阶段 D — /opsx-apply 实现 tasks（必做）",
+        "Apply 前必读：`source/PRD.md` + `05-验收清单.md`",
         "```bash",
         `npx sdd-flow-kit phase advance --project-root "${pr}" --run-id ${runId} --to impl --change <kebab-name>`,
         "# 然后在 AI 工具中执行 /opsx-apply，按 tasks.md 逐条实现并勾选为 [x]",
         "```",
         "",
-        "## 6. 阶段 E — 交付与收尾",
+        "## 6. 阶段 E — 验收签收与交付",
         "```bash",
+        `npx sdd-flow-kit validate --project-root "${pr}" --run-id ${runId} --change <kebab-name>`,
+        `npx sdd-flow-kit phase advance --project-root "${pr}" --run-id ${runId} --to validate-done --change <kebab-name>`,
+        "# 在 05 中将 P0 标为已验收，签收状态改为已签收",
+        `npx sdd-flow-kit gate --project-root "${pr}" --run-id ${runId} --expect ac-signed`,
         `npx sdd-flow-kit deliver --project-root "${pr}" --run-id ${runId} --change <kebab-name>`,
         `npx sdd-flow-kit phase advance --project-root "${pr}" --run-id ${runId} --to shipped --change <kebab-name>`,
         "```",

package/dist/postinstall.js

@@ -68,26 +68,36 @@ async function inferAgent(projectRoot) {
         return "openclaw";
     return "cursor";
 }
+/** postinstall 默认 light；设 SDD_FLOW_KIT_POSTINSTALL_FULL=1 跑全量（含 opsx-workflow） */
+function isPostinstallLightMode() {
+    if (process_1.default.env.SDD_FLOW_KIT_POSTINSTALL_FULL === "1")
+        return false;
+    if (process_1.default.env.SDD_FLOW_KIT_POSTINSTALL_LIGHT === "0")
+        return false;
+    return true;
+}
 async function main() {
-    var _a;
     if (process_1.default.env.SDD_FLOW_KIT_SKIP_POSTINSTALL === "1") {
         return;
     }
-    const initCwd = (_a = process_1.default.env.INIT_CWD) === null || _a === void 0 ? void 0 : _a.trim();
     const pkgDir = path_1.default.resolve(__dirname, "..");
-    if (!initCwd) {
+    const resolved = await (0, projectRoots_1.resolvePostinstallProjectRoot)(pkgDir);
+    if (!resolved) {
+        const fallbackKind = await (0, inferProject_1.inferProjectKind)(process_1.default.cwd());
         // eslint-disable-next-line no-console
-        console.warn("[sdd-flow-kit] postinstall: 缺少 INIT_CWD，已跳过。请执行: npx sdd-flow-kit install --project ADI -y");
+        console.warn("[sdd-flow-kit] postinstall: 无法定位消费方项目根（INIT_CWD / node_modules 向上查找 / cwd 均失败）。" +
+            `请执行: npx sdd-flow-kit install --project ${fallbackKind} -y`);
         return;
     }
-    const projectRoot = (0, projectRoots_1.resolveInstallRoot)(initCwd);
-    if (projectRoot === pkgDir)
+    const { root: projectRoot, source } = resolved;
+    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";
+    const light = isPostinstallLightMode();
     // eslint-disable-next-line no-console
-    console.log(`[sdd-flow-kit] postinstall (${light ? "light" : "full"}) at: ${projectRoot}`);
+    console.log(`[sdd-flow-kit] postinstall (${light ? "light" : "full"}) at: ${projectRoot} (via ${source})`);
     // eslint-disable-next-line no-console
     console.log(`[sdd-flow-kit] agent=${agent}, project=${projectKind}`);
     const result = await (0, setupProject_1.setupProject)({
@@ -106,6 +116,10 @@ async function main() {
             `${projectKind} -y` +
             (process_1.default.env.SDD_OPSX_WORKFLOW_PACKAGE ? "" : "（或设 SDD_OPSX_WORKFLOW_PACKAGE 指向本地 opsx-workflow）"));
     }
+    else if (light) {
+        // eslint-disable-next-line no-console
+        console.log("[sdd-flow-kit] 轻量安装完成：SDD skill / 规则 / docs-skill / .opsx 已写入");
+    }
     else {
         // eslint-disable-next-line no-console
         console.log("[sdd-flow-kit] 安装完成：SDD + OPSX + Superpowers 已就绪");

package/dist/steps/runDeliver.js

@@ -12,7 +12,7 @@ const opsxDelivery_1 = require("../core/opsxDelivery");
 const projectRoots_1 = require("../core/projectRoots");
 const fs_1 = require("../core/fs");
 /**
- * 实现阶段交付：先 gate impl-allowed，再 ensure-opsx，再跑 opsx:delivery-pipeline，写入 .delivery-pass.json。
+ * 实现阶段交付：先 gate validate-pass（确保验收通过），再 ensure-opsx，再跑 opsx:delivery-pipeline，写入 .delivery-pass.json。
  */
 async function runDeliver(options) {
     var _a;
@@ -20,15 +20,27 @@ async function runDeliver(options) {
     if (!(loaded === null || loaded === void 0 ? void 0 : loaded.resolved)) {
         return { ok: false, detail: "未找到 PRD run" };
     }
-    const implGate = await (0, runGate_1.runGate)({
+    const validateGate = await (0, runGate_1.runGate)({
         projectRoot: options.projectRoot,
         runId: loaded.resolved.runId,
-        expect: "impl-allowed",
+        expect: "validate-pass",
         change: options.change,
     });
-    if (!implGate.ok) {
-        (0, runGate_1.printGateResult)(implGate);
-        return { ok: false, detail: "impl-allowed gate 未通过" };
+    if (!validateGate.ok) {
+        (0, runGate_1.printGateResult)(validateGate);
+        return { ok: false, detail: "validate-pass gate 未通过，禁止交付（请先执行 sdd-flow-kit validate --change <name>）" };
+    }
+    const acSignedGate = await (0, runGate_1.runGate)({
+        projectRoot: options.projectRoot,
+        runId: loaded.resolved.runId,
+        expect: "ac-signed",
+    });
+    if (!acSignedGate.ok) {
+        (0, runGate_1.printGateResult)(acSignedGate);
+        return {
+            ok: false,
+            detail: "ac-signed gate 未通过，禁止交付（请在 05-验收清单.md 完成 P0 签收）",
+        };
     }
     const installRoot = (0, projectRoots_1.resolveInstallRoot)(options.projectRoot);
     const pkgRoot = await (0, projectRoots_1.resolvePackageRoot)(installRoot);

package/dist/steps/runGate.js

@@ -8,6 +8,7 @@ exports.printGateResult = printGateResult;
 const path_1 = __importDefault(require("path"));
 const prdArtifacts_1 = require("../core/prdArtifacts");
 const gitDiffGuard_1 = require("../core/gitDiffGuard");
+const acMatrix_1 = require("../core/acMatrix");
 const projectRoots_1 = require("../core/projectRoots");
 const openspecGate_1 = require("../core/openspecGate");
 const resolveRun_1 = require("./resolveRun");
@@ -71,6 +72,7 @@ async function resolveImplRoots(projectRoot) {
  * 脚本门禁：失败时 process.exitCode=1，成功 exit 0。
  */
 async function runGate(options) {
+    var _a, _b, _c;
     const loaded = await (0, resolveRun_1.loadRunSession)(options.projectRoot, options.runId);
     const checks = [];
     if (!loaded || !loaded.resolved) {
@@ -102,6 +104,8 @@ async function runGate(options) {
         checks.push({ name: "questions-closed", ...closed });
         const docs = await (0, prdArtifacts_1.areAnalysisDocsReady)(outputRoot);
         checks.push({ name: "analysis-docs", ...docs });
+        const acDefined = await (0, prdArtifacts_1.isAcceptanceChecklistDefined)(outputRoot);
+        checks.push({ name: "acceptance-checklist-defined", ...acDefined });
         if (session && session.docModeOnly === false) {
             checks.push({
                 name: "doc-mode",
@@ -133,6 +137,48 @@ async function runGate(options) {
         }
         return pass(checks, options.expect, runId);
     }
+    if (options.expect === "ac-ready") {
+        const acDefined = await (0, prdArtifacts_1.isAcceptanceChecklistDefined)(outputRoot);
+        checks.push({ name: "acceptance-checklist-defined", ...acDefined });
+        const changeName = await readActiveChange(options.projectRoot, session, options.change);
+        if (!changeName) {
+            checks.push({ name: "active-change", ok: false, detail: "未指定 change（--change 或 .opsx-active-change）" });
+            return fail(checks, options.expect, runId);
+        }
+        const parsed = await (0, acMatrix_1.parseAcMatrix)(outputRoot);
+        const installRoot = (0, projectRoots_1.resolveInstallRoot)(options.projectRoot);
+        const openspecRoots = [
+            installRoot,
+            ...(await (0, projectRoots_1.listOpenspecPrdRoots)(installRoot)).map((p) => path_1.default.dirname(path_1.default.dirname(p))),
+        ];
+        const seen = new Set();
+        let mapped = false;
+        for (const root of openspecRoots) {
+            const key = path_1.default.resolve(root);
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            if (await (0, openspecGate_1.changeDirExists)(root, changeName)) {
+                const map = await (0, openspecGate_1.checkP0AcMappedInChange)(root, changeName, parsed.p0Ids);
+                checks.push({ name: "p0-ac-mapped", ...map });
+                mapped = true;
+                break;
+            }
+        }
+        if (!mapped) {
+            checks.push({
+                name: "change-dir",
+                ok: false,
+                detail: `openspec/changes/${changeName} 不存在，无法校验 AC 映射`,
+            });
+        }
+        return pass(checks, options.expect, runId);
+    }
+    if (options.expect === "ac-signed") {
+        const signed = await (0, prdArtifacts_1.isAcceptanceChecklistSigned)(outputRoot);
+        checks.push({ name: "acceptance-checklist-signed", ...signed });
+        return pass(checks, options.expect, runId);
+    }
     if (options.expect === "propose-ready") {
         const changeName = await readActiveChange(options.projectRoot, session, options.change);
         if (!changeName) {
@@ -217,6 +263,57 @@ async function runGate(options) {
         }
         return pass(checks, options.expect, runId);
     }
+    if (options.expect === "validate-pass") {
+        const changeName = await readActiveChange(options.projectRoot, session, options.change);
+        if (!changeName) {
+            checks.push({ name: "active-change", ok: false, detail: "未指定 change" });
+            return fail(checks, options.expect, runId);
+        }
+        // 1) tasks.md 全完成
+        const installRoot = (0, projectRoots_1.resolveInstallRoot)(options.projectRoot);
+        const openspecRoots = [
+            installRoot,
+            ...(await (0, projectRoots_1.listOpenspecPrdRoots)(installRoot)).map((p) => path_1.default.dirname(path_1.default.dirname(p))),
+        ];
+        const seen = new Set();
+        for (const root of openspecRoots) {
+            const key = path_1.default.resolve(root);
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            if (await (0, openspecGate_1.changeDirExists)(key, changeName)) {
+                const tasks = await (0, openspecGate_1.checkTasksAllDone)(key, changeName);
+                checks.push({ name: "tasks-done", ...tasks });
+                break;
+            }
+        }
+        // 2) 验收报告签收文件
+        const marker = await (0, fs_1.readFileIfExists)(path_1.default.join(outputRoot, ".validate-pass.json"));
+        if (marker) {
+            try {
+                const j = JSON.parse(marker);
+                const ok = j.verdict === "pass" && (!j.change || j.change === changeName);
+                checks.push({
+                    name: "validate-report",
+                    ok,
+                    detail: ok
+                        ? `验收通过 (pipeline=${(_a = j.pipelineShortExitCode) !== null && _a !== void 0 ? _a : "?"}, e2e=${(_b = j.e2eExitCode) !== null && _b !== void 0 ? _b : "?"})`
+                        : `验收结果: ${(_c = j.verdict) !== null && _c !== void 0 ? _c : "unknown"}`,
+                });
+            }
+            catch {
+                checks.push({ name: "validate-report", ok: false, detail: ".validate-pass.json 解析失败" });
+            }
+        }
+        else {
+            checks.push({
+                name: "validate-report",
+                ok: false,
+                detail: "缺少 .validate-pass.json，请先执行: sdd-flow-kit validate --change <name>",
+            });
+        }
+        return pass(checks, options.expect, runId);
+    }
     if (options.expect === "shipped") {
         const changeName = await readActiveChange(options.projectRoot, session, options.change);
         if (!changeName) {

package/dist/steps/runPhaseAdvance.js

@@ -53,7 +53,7 @@ async function runPhaseAdvance(options) {
                 "```bash",
                 `npx sdd-flow-kit gate --project-root ${options.projectRoot} --run-id ${runId} --expect questions-open`,
                 "```",
-                "3. 用户确认后生成 01/02/04，再执行：",
+                "3. 用户确认后生成 **05 → 04 → 01/02**，再执行：",
                 "```bash",
                 `npx sdd-flow-kit phase advance --project-root ${options.projectRoot} --run-id ${runId} --to docs-done`,
                 "```",
@@ -104,6 +104,16 @@ async function runPhaseAdvance(options) {
             (0, runGate_1.printGateResult)(gate);
             return { ok: false, runId, message: "gate propose-ready 未通过" };
         }
+        gate = await (0, runGate_1.runGate)({
+            projectRoot: options.projectRoot,
+            runId,
+            expect: "ac-ready",
+            change: changeName,
+        });
+        if (!gate.ok) {
+            (0, runGate_1.printGateResult)(gate);
+            return { ok: false, runId, message: "gate ac-ready 未通过（P0 未映射到 spec/tasks）" };
+        }
         const next = {
             ...session,
             phase: "C",
@@ -117,7 +127,7 @@ async function runPhaseAdvance(options) {
             await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(installRoot, ".opsx-active-change"), `${changeName}\n`);
             await writeNextMd(outputRoot, [
                 "## 当前：阶段 C 完成 → 进入 D（实现）",
-                "说明：先进入 impl，再在 AI 工具执行 `/opsx-apply` 按 tasks.md 实现；完成后才可 deliver。",
+                "说明：先进入 impl，再在 AI 工具执行 `/opsx-apply`；Apply 前必读 `source/PRD.md` + `05-验收清单.md`。",
                 "```bash",
                 `npx sdd-flow-kit phase advance --project-root ${options.projectRoot} --run-id ${runId} --to impl --change ${changeName}`,
                 "```",
@@ -133,12 +143,12 @@ async function runPhaseAdvance(options) {
         gate = await (0, runGate_1.runGate)({
             projectRoot: options.projectRoot,
             runId,
-            expect: "propose-ready",
+            expect: "ac-ready",
             change: changeName,
         });
         if (!gate.ok) {
             (0, runGate_1.printGateResult)(gate);
-            return { ok: false, runId, message: "propose 未就绪，禁止进入实现" };
+            return { ok: false, runId, message: "ac-ready 未通过，禁止进入实现" };
         }
         const installRoot = (0, projectRoots_1.resolveInstallRoot)(options.projectRoot);
         const gitRoot = (0, gitDiffGuard_1.resolveGitRoot)(installRoot);
@@ -160,14 +170,51 @@ async function runPhaseAdvance(options) {
                 `npx sdd-flow-kit gate --project-root ${options.projectRoot} --run-id ${runId} --expect impl-allowed --change ${changeName}`,
                 "```",
                 "在 AI 工具中执行：`/opsx-apply`（必须先完成 tasks.md 全部 [x]）",
-                "完成后交付：",
+                "完成后验收：",
                 "```bash",
-                `npx sdd-flow-kit deliver --project-root ${options.projectRoot} --run-id ${runId} --change ${changeName}`,
+                `npx sdd-flow-kit validate --project-root ${options.projectRoot} --run-id ${runId} --change ${changeName}`,
+                `npx sdd-flow-kit phase advance --project-root ${options.projectRoot} --run-id ${runId} --to validate-done --change ${changeName}`,
                 "```",
+                "验收不通过 → 修复后重新执行 validate；超过 3 次需用户确认。",
             ]);
         }
         return { ok: true, runId, message: "已进入实现阶段（docModeOnly=false）" };
     }
+    if (options.to === "validate-done") {
+        const changeName = options.change || session.activeChange;
+        if (!changeName) {
+            return { ok: false, runId, message: "需要 --change <name>" };
+        }
+        gate = await (0, runGate_1.runGate)({
+            projectRoot: options.projectRoot,
+            runId,
+            expect: "validate-pass",
+            change: changeName,
+        });
+        if (!gate.ok) {
+            (0, runGate_1.printGateResult)(gate);
+            return { ok: false, runId, message: "validate-pass gate 未通过" };
+        }
+        const next = {
+            ...session,
+            phase: "D",
+            status: "validate_done",
+            docModeOnly: false,
+        };
+        if (!options.dryRun) {
+            await (0, sessionState_1.writeSession)(outputRoot, next);
+            await writeNextMd(outputRoot, [
+                "## 当前：验收通过 → 可交付",
+                "1. 在 `05-验收清单.md` 将 P0 标为「已验收」，签收状态改为「已签收」",
+                "```bash",
+                `npx sdd-flow-kit gate --project-root ${options.projectRoot} --run-id ${runId} --expect ac-signed`,
+                `npx sdd-flow-kit deliver --project-root ${options.projectRoot} --run-id ${runId} --change ${changeName}`,
+                `npx sdd-flow-kit phase advance --project-root ${options.projectRoot} --run-id ${runId} --to shipped --change ${changeName}`,
+                "```",
+            ]);
+        }
+        return { ok: true, runId, message: "验收通过，可进入交付" };
+    }
     if (options.to === "shipped") {
         const changeName = options.change || session.activeChange;
         gate = await (0, runGate_1.runGate)({

package/dist/steps/runPropose.js

@@ -52,15 +52,17 @@ async function runPropose(options) {
         `change: \`${options.change}\``,
         "",
         "AI 须按 openspec-propose skill 生成 proposal/design/specs/tasks。",
+        "tasks.md 每条任务标题须含 `[AC-XX]`，与 `05-验收清单.md` 中 P0 一一映射。",
         "注意：propose 结束后不能直接 deliver，必须先 `/opsx-apply` 执行 tasks。",
         "完成提案后执行：",
         "```bash",
         `npx sdd-flow-kit gate --project-root ${options.projectRoot} --run-id ${loaded.resolved.runId} --expect propose-ready --change ${options.change}`,
+        `npx sdd-flow-kit gate --project-root ${options.projectRoot} --run-id ${loaded.resolved.runId} --expect ac-ready --change ${options.change}`,
         `npx sdd-flow-kit phase advance --project-root ${options.projectRoot} --run-id ${loaded.resolved.runId} --to propose-done --change ${options.change}`,
         "```",
         "",
     ].join("\n");
-    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(loaded.resolved.outputRoot, "05-openspec-提案草稿.md"), proposeNote);
+    await (0, fs_1.writeTextFileEnsuredDir)(path_1.default.join(loaded.resolved.outputRoot, "06-openspec-提案草稿.md"), proposeNote);
     const ready = await (0, runGate_1.runGate)({
         projectRoot: options.projectRoot,
         runId: loaded.resolved.runId,