create-yss-spec 2.2.3 → 2.2.4

package/README.md

@@ -38,6 +38,7 @@ npx create-yss-spec@latest --version
 - `--no-example-docs`
 - `attach` 子命令：在已有项目中补齐研发管理资产
 - `sync` 子命令
+- `update` / `upgrade` 子命令：检查 npm 最新版本，如有更新则安装 CLI 自身
 - 基于 `.yss-template.json` 的模板版本基线和 managed baseline
 - 只使用当前 CLI 包内置、绑定不可变 commit 的模板快照
 - 初始化时将 `yss-project.yaml` 从 `template-source` 改写为 `project-instance`
@@ -47,7 +48,7 @@ npx create-yss-spec@latest --version
 - init / sync 不把模板源治理笔记、wiki、审查证据、源仓 CI / Cloud 环境和公开发布清单写入项目实例；attach 会带上 `yss-public-skills.json` 供 `verify-template` 使用
 - 空 gitlink / detached HEAD / git-submodule 挂载点 fail closed，`--force` 也不能覆盖
 
-本次模板适配按 `2.2.3` 发布，绑定 `yss-spec-project-template@030d806`。`templateCommit` 会写入实例 metadata；“最新模板”指用户执行的 `npx create-yss-spec@latest` 所携带的最新已发布快照，CLI 运行时不会拉取模板仓库。实例会带上数字人角色叠加（`docs/agents/digital-human-roles.yaml`）、YSS 前端技能叠加层（如 `ytable-usage`、`formily-foundation`、`yss-page-module-development`）、`.cursorrules` 与 `.agents/rules/yss-ai-skills.md`；审查临时目录 `docs/.scratch/` 与已退役的 `high-fidelity-html-prototype` 等独立入口不进入快照。
+本次模板适配按 `2.2.4` 发布，绑定 `yss-spec-project-template@37251d0`。`templateCommit` 会写入实例 metadata；“最新模板”指用户执行的 `npx create-yss-spec@latest` 所携带的最新已发布快照，CLI 运行时不会拉取模板仓库。实例会带上数字人角色叠加（`docs/agents/digital-human-roles.yaml`）、YSS 前端技能叠加层（如 `ytable-usage`、`formily-foundation`、`yss-page-module-development`）、DDD Tactical Design 与生命周期转换校验资产、`.cursorrules` 与 `.agents/rules/yss-ai-skills.md`；审查临时目录 `docs/.scratch/` 与已退役的 `high-fidelity-html-prototype` 等独立入口不进入快照。
 
 ## 接管已有项目
 
@@ -107,6 +108,21 @@ npx create-yss-spec@latest sync --target-dir . --dry-run
 npx create-yss-spec@latest sync --target-dir . [--force]
 ```
 
+## 升级 CLI 自身
+
+`update`（别名 `upgrade`）检查 npm registry 上的最新 `create-yss-spec` 版本，如有更新则按当前安装方式自动安装。它升级的是 CLI 包本身，不会同步项目里的模板资产；模板同步仍使用 `sync`。
+
+```bash
+npx create-yss-spec update
+npx create-yss-spec update --dry-run
+npx create-yss-spec upgrade
+```
+
+- 全局安装会执行 `npm install -g create-yss-spec@latest`
+- 项目本地依赖会在对应项目根执行 `npm install create-yss-spec@latest`
+- 通过 npx 运行或在源码目录中运行时只报告版本并给出安装建议，不覆盖当前文件
+- `--dry-run` 只查询和预览，不安装；`--force` 在已是最新时仍重新安装（npx / 源码目录除外）
+
 ## 开发验证
 
 CLI 源码和研发记录由本仓库独立维护。首次测试会从

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-yss-spec",
-  "version": "2.2.3",
+  "version": "2.2.4",
   "description": "Initialize a YSS spec project template repository",
   "repository": {
     "type": "git",

package/src/cli.js

@@ -5,6 +5,7 @@ const path = require("node:path");
 const readline = require("node:readline/promises");
 const { spawnSync } = require("node:child_process");
 const { treeHash } = require("./template-hash");
+const { UPDATE_COMMANDS, runUpdate } = require("./self-update");
 
 const PACKAGE_ROOT = path.resolve(__dirname, "..");
 const PACKAGE_MANIFEST = JSON.parse(
@@ -2125,6 +2126,8 @@ COMMANDS
   (default)  初始化新的模板实例仓库
   attach     向已有项目补齐受管研发管理资产
   sync       同步已有模板实例的受管资产
+  update     检查 npm 最新版本，如有更新则安装
+  upgrade    update 的别名
 
 OPTIONS
   --project-name <name>              项目名称；init 不传则进入交互输入
@@ -2132,10 +2135,11 @@ OPTIONS
   --team-size <size>                 团队规模；init 不传则可留空，默认「待补充」
   --target-dir <dir>                 目标目录；init 不传则进入交互输入，sync 默认为当前目录
   --issue-tracker github|gitlab      默认 issue tracker 偏好（默认 github）
-  --dry-run                          只预览计划，不写入文件
+  --dry-run                          只预览计划，不写入文件；update 只查询不安装
   --apply                            attach 确认执行写入；不能与 --dry-run 同时使用
   --force                            init：允许清空非空目录后重新生成
                                      attach / sync：覆盖受管冲突文件；unsafe 路径始终阻断
+                                     update：即使已是最新也重新安装；npx / 源码目录仍不覆盖
   --git-init                         初始化完成后执行 git init
   --include-example-docs             显式保留示例文档（默认开启）
   --no-example-docs                  不生成示例文档
@@ -2171,6 +2175,9 @@ EXAMPLES
   $ npx create-yss-spec@latest sync
   $ npx create-yss-spec@latest sync --dry-run
   $ npx create-yss-spec@latest sync --target-dir . --force
+  $ npx create-yss-spec update
+  $ npx create-yss-spec update --dry-run
+  $ npx create-yss-spec upgrade
 
 LEARN MORE
   仓库 README：https://github.com/iloveZzz/create-yss-spec#readme
@@ -2196,6 +2203,13 @@ async function runCli(argv = []) {
     runAttach(argv.slice(1));
     return;
   }
+  if (UPDATE_COMMANDS.has(argv[0])) {
+    runUpdate(argv.slice(1), {
+      packageRoot: PACKAGE_ROOT,
+      currentVersion: PACKAGE_MANIFEST.version,
+    });
+    return;
+  }
   await runInit(argv);
 }
 

package/src/self-update.js

@@ -0,0 +1,277 @@
+const fs = require("node:fs");
+const path = require("node:path");
+const { spawnSync } = require("node:child_process");
+
+const PACKAGE_NAME = "create-yss-spec";
+const UPDATE_COMMANDS = new Set(["update", "upgrade"]);
+
+function parseUpdateArgs(argv = []) {
+  const options = { dryRun: false, force: false };
+
+  for (const current of argv) {
+    if (current === "--dry-run") {
+      options.dryRun = true;
+    } else if (current === "--force") {
+      options.force = true;
+    } else {
+      throw new Error(`不支持的参数：${current}`);
+    }
+  }
+
+  return options;
+}
+
+function parseSemver(version) {
+  const match = String(version)
+    .trim()
+    .match(/^v?(\d+)\.(\d+)\.(\d+)/);
+  if (!match) {
+    throw new Error(`无法解析版本号：${version}`);
+  }
+  return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+
+function compareSemver(left, right) {
+  const leftParts = parseSemver(left);
+  const rightParts = parseSemver(right);
+  for (let index = 0; index < 3; index += 1) {
+    if (leftParts[index] > rightParts[index]) {
+      return 1;
+    }
+    if (leftParts[index] < rightParts[index]) {
+      return -1;
+    }
+  }
+  return 0;
+}
+
+function defaultSpawn(command, args, options = {}) {
+  return spawnSync(command, args, {
+    encoding: "utf8",
+    timeout: 120000,
+    ...options,
+  });
+}
+
+function spawnFailed(result) {
+  return Boolean(result.error) || result.status !== 0;
+}
+
+function spawnErrorDetail(result) {
+  return (result.stderr || result.error?.message || result.stdout || "").trim();
+}
+
+function npmViewLatest(packageName, spawn) {
+  const result = spawn("npm", ["view", packageName, "version"], {
+    encoding: "utf8",
+    timeout: 30000,
+  });
+  if (spawnFailed(result)) {
+    const detail = spawnErrorDetail(result);
+    throw new Error(`无法查询最新版本${detail ? `：${detail}` : ""}`);
+  }
+
+  const lines = (result.stdout || "")
+    .trim()
+    .split(/\r?\n/)
+    .map((line) => line.trim().replace(/^['"]|['"]$/g, ""))
+    .filter(Boolean);
+  const version = lines[lines.length - 1];
+  if (!version) {
+    throw new Error("无法查询最新版本：npm view 未返回版本号");
+  }
+  parseSemver(version);
+  return version;
+}
+
+function npmGlobalPrefix(spawn) {
+  const result = spawn("npm", ["prefix", "-g"], {
+    encoding: "utf8",
+    timeout: 15000,
+  });
+  if (spawnFailed(result)) {
+    return "";
+  }
+  return (result.stdout || "").trim();
+}
+
+function hasPathSegment(target, segment) {
+  return path.resolve(target).split(path.sep).includes(segment);
+}
+
+function sameResolvedPath(left, right) {
+  try {
+    return fs.realpathSync(left) === fs.realpathSync(right);
+  } catch {
+    return path.resolve(left) === path.resolve(right);
+  }
+}
+
+function findLocalProjectRoot(packageRoot, packageName) {
+  const resolved = path.resolve(packageRoot);
+  const marker = `${path.sep}node_modules${path.sep}${packageName}`;
+  const index = resolved.lastIndexOf(marker);
+  if (index === -1) {
+    return null;
+  }
+  const after = resolved.slice(index + marker.length);
+  if (after !== "") {
+    return null;
+  }
+  return resolved.slice(0, index) || path.parse(resolved).root;
+}
+
+function detectInstallKind(packageRoot, spawn, packageName = PACKAGE_NAME) {
+  const resolvedRoot = path.resolve(packageRoot);
+
+  if (hasPathSegment(resolvedRoot, "_npx")) {
+    return { kind: "npx" };
+  }
+
+  if (fs.existsSync(path.join(resolvedRoot, ".git"))) {
+    return { kind: "source" };
+  }
+
+  const prefix = npmGlobalPrefix(spawn);
+  if (prefix) {
+    const globalRoots = [
+      path.join(prefix, "lib", "node_modules", packageName),
+      path.join(prefix, "node_modules", packageName),
+    ];
+    if (globalRoots.some((candidate) => sameResolvedPath(candidate, resolvedRoot))) {
+      return { kind: "global" };
+    }
+  }
+
+  const projectRoot = findLocalProjectRoot(resolvedRoot, packageName);
+  if (projectRoot) {
+    return { kind: "local", cwd: projectRoot };
+  }
+
+  return { kind: "unknown" };
+}
+
+function buildInstallPlan(install, packageName) {
+  if (install.kind === "global") {
+    return {
+      command: "npm",
+      args: ["install", "-g", `${packageName}@latest`],
+      cwd: undefined,
+    };
+  }
+  if (install.kind === "local") {
+    return {
+      command: "npm",
+      args: ["install", `${packageName}@latest`],
+      cwd: install.cwd,
+    };
+  }
+  return null;
+}
+
+function formatInstallCommand(plan) {
+  const rendered = `npm ${plan.args.join(" ")}`;
+  if (!plan.cwd) {
+    return rendered;
+  }
+  return `npm ${plan.args.join(" ")}（目录：${plan.cwd}）`;
+}
+
+function writeln(stdout, line) {
+  stdout.write(line.endsWith("\n") ? line : `${line}\n`);
+}
+
+function printInstallAdvice(stdout, install) {
+  writeln(stdout, "当前安装方式不会自动覆盖本地文件");
+  if (install.kind === "source") {
+    writeln(
+      stdout,
+      "检测到源码目录；请通过发布流程或 npm install -g create-yss-spec@latest 升级",
+    );
+  } else if (install.kind === "npx") {
+    writeln(
+      stdout,
+      "当前通过 npx 运行；下次使用 npx create-yss-spec@latest 即可拿到最新版",
+    );
+  } else {
+    writeln(stdout, "未能判断安装位置");
+  }
+  writeln(stdout, "建议：");
+  writeln(stdout, "  npm install -g create-yss-spec@latest");
+  writeln(stdout, "  npx create-yss-spec@latest");
+}
+
+function runUpdate(argv = [], deps = {}) {
+  const spawn = deps.spawn || defaultSpawn;
+  const packageRoot = deps.packageRoot;
+  const currentVersion = deps.currentVersion;
+  const packageName = deps.packageName || PACKAGE_NAME;
+  const stdout = deps.stdout || process.stdout;
+  const options = parseUpdateArgs(argv);
+
+  if (!packageRoot) {
+    throw new Error("update 缺少 packageRoot");
+  }
+  if (!currentVersion) {
+    throw new Error("update 缺少 currentVersion");
+  }
+
+  const latestVersion = npmViewLatest(packageName, spawn);
+  const comparison = compareSemver(currentVersion, latestVersion);
+
+  writeln(stdout, `当前版本：${currentVersion}`);
+  writeln(stdout, `最新版本：${latestVersion}`);
+
+  if (comparison > 0) {
+    writeln(stdout, "当前版本新于 npm latest，未降级");
+    return { status: "newer-than-latest", latestVersion };
+  }
+
+  if (comparison === 0 && !options.force) {
+    writeln(stdout, "已是最新版本");
+    return { status: "up-to-date", latestVersion };
+  }
+
+  const install = detectInstallKind(packageRoot, spawn, packageName);
+  const plan = buildInstallPlan(install, packageName);
+
+  if (!plan) {
+    printInstallAdvice(stdout, install);
+    return { status: "advice", kind: install.kind, latestVersion };
+  }
+
+  const commandText = formatInstallCommand(plan);
+  if (options.dryRun) {
+    writeln(stdout, "dry-run 预览");
+    writeln(stdout, `将执行：${commandText}`);
+    return { status: "dry-run", kind: install.kind, latestVersion, commandText };
+  }
+
+  writeln(stdout, `正在安装：${commandText}`);
+  const result = spawn(plan.command, plan.args, {
+    encoding: "utf8",
+    timeout: 120000,
+    cwd: plan.cwd,
+  });
+  if (result.stdout) {
+    writeln(stdout, result.stdout);
+  }
+  if (spawnFailed(result)) {
+    const detail = spawnErrorDetail(result);
+    throw new Error(`升级失败${detail ? `：${detail}` : ""}`);
+  }
+  if (result.stderr && result.stderr.trim()) {
+    writeln(stdout, result.stderr);
+  }
+  writeln(stdout, `升级完成：${currentVersion} -> ${latestVersion}`);
+  return { status: "updated", kind: install.kind, latestVersion };
+}
+
+module.exports = {
+  PACKAGE_NAME,
+  UPDATE_COMMANDS,
+  parseUpdateArgs,
+  compareSemver,
+  detectInstallKind,
+  runUpdate,
+};

package/template/.agents/skills/yss-domain/SKILL.md

@@ -5,7 +5,7 @@ description: 用于构建或重构 YSS 领域层代码。当用户要求设计
 
 # yss-domain
 
-这是一个建模型 skill。核心目标是先把领域语义和边界建立清楚，再落代码。
+这是一个领域实现 skill。核心目标是消费已批准的战术模型，将领域行为落实为代码；战术模型的设计与批准由 `yss-tactical-design` 和 `yss-product-lifecycle` 负责。
 
 默认输出是新 DDD target profile；现有 YSS 组件仓库常见 `core/client/repository`、贫血对象和 VO 型 Gateway 只是 legacy profile，不得静默复制成新模块架构。
 
@@ -23,10 +23,10 @@ description: 用于构建或重构 YSS 领域层代码。当用户要求设计
 
 ## 工作方式
 
-1. 先抽业务术语、聚合边界和状态变化。
+1. 先读取批准且版本当前的 tactical-design contract 和 Slice Implementation Contract。
 2. 数据库字段只做补充，不直接决定领域对象结构。
-3. 先定义领域行为，再决定 Gateway 边界。
-4. 规则不清晰时，保留显式假设，不要静默猜测。
+3. 按合同实现领域行为、状态机、不变量和 Gateway 边界。
+4. 规则不清晰或模型需要扩展时，返回 `new_impacts` / `drift` 并停止，不要静默猜测。
 
 ## 产物范围
 
@@ -63,6 +63,7 @@ description: 用于构建或重构 YSS 领域层代码。当用户要求设计
 ## 阶段 7 合同
 
 - 只消费生命周期已批准的 `Slice Implementation Contract` 和当前 `work_unit`；不得扩大 `allowed_write_paths`。
+- `Slice Implementation Contract` 必须引用批准且版本当前的 `tactical_design_ref`；不得在实现阶段重新批准或替换聚合、不变量和一致性策略。
 - 领域规则、状态机和不变量必须使用 `behavior-tdd`，先形成失败测试，再实现最小行为。
 - 完成后按 `yss-router/references/yss-skill-execution-result.md` 返回统一 `YSS Skill Execution Result`：changed files、领域/测试证据、实际验证结果、偏离和新增影响。
 - 发现新 API、权限、状态机、数据模型或架构影响时填入 `new_impacts` 并暂停，不得静默扩张切片。

package/template/.agents/skills/yss-product-lifecycle/SKILL.md

@@ -27,12 +27,12 @@ Matt 的 `grill-with-docs`、`to-spec`、`to-tickets`、`implement` 等保留为
 | 阶段 | 必需产物/门禁 | 工作单元与技能 | 通过条件 |
 |---|---|---|---|
 | 入口分诊 | 身份、影响面、最近可信阶段 | `yss-product-lifecycle` | `yss-project.yaml` 合法且影响面可解释 |
-| 机会调研/需求分析 | Discovery、用户/MVP/非目标/成功标准、测试 seam | `work-unit.discovery-opportunity` + `work-unit.discovery-requirements`；市场/竞品事实用 `competitive-intelligence`，技术/标准事实用 `research`；`grill-with-docs` 为兼容入口 | 未决事实已 research 或 handoff，用户确认，无 runnable blocker |
+| 机会调研/需求分析 | Discovery、用户/MVP/非目标/成功标准、测试 seam；命中 DDD 影响时补充领域战略设计与阶段决策包 | `work-unit.discovery-opportunity` + `work-unit.discovery-requirements` + `work-unit.domain-strategy-design` + `work-unit.stage-decision`；市场/竞品事实用 `competitive-intelligence`，技术/标准事实用 `research`；领域建模用 `domain-modeling`；`grill-with-docs` 为兼容入口 | 未决事实已 research 或 handoff，领域边界和统一语言可审查，阶段决策包完成必要批准 |
 | Spec/功能架构 | Spec、产品总体设计、功能架构；必要时 Spec Delta | 原生 `work-unit.spec-synthesis`；`to-spec` 为兼容入口 | 初稿先为 `ready-for-human`；只有 Spec baseline 会签批准后资产才为 `approved` 并进入下游 |
 | 原型设计 | 交互说明、低保真、状态矩阵、高保真 HTML、评审记录 | `yss-design-system` → `yss-prototype-stage` → `yss-antd-design`（仅原型事实）→ Codex `product-design:index`（非 Codex 交付等价合同）。前端落地改用 `yss-ui` | `gate.prototype-reviewed`、`gate.prototype-verified`、`gate.user-confirmation` 均有证据 |
-| 技术分析 | OpenAPI Draft/Freeze、数据架构、工程基线、架构审查 | `yss-openapi-governance` / `yss-openapi-draft-review`、`codebase-design`、`implementation-repo-onboarding`、`yss-router` | API/架构契约冻结；无 API 影响有明确记录；脚手架策略满足 |
+| 技术分析 | OpenAPI Draft/Freeze、数据架构、工程基线、架构审查；按领域影响执行 Tactical DDD Check | `yss-openapi-governance` / `yss-openapi-draft-review`、`codebase-design`、`implementation-repo-onboarding`、`yss-tactical-design`、`yss-router` | API/架构契约冻结；无 API 影响有明确记录；战术模型无未解释冲突；脚手架策略满足 |
 | Ticket 正式化 | 功能父 Ticket、垂直切片、Slice Implementation Contract | 原生 `work-unit.ticket-decomposition`；`to-tickets` 为兼容入口；生命周期复算 | 依赖、验收、测试 seam 可执行；合同已批准、持久化且为当前版本 |
-| 技术实现 | 前端/后端代码、TDD 证据、YSS Skill Execution Result | 原生 `work-unit.slice-implementation`；`implement` 为兼容入口；前端按 `yss-ui` + `yss-page-module-development`，后端按 `yss-router` 最小闭包，业务行为统一 `tdd` | 只写允许路径；业务行为用 `behavior-tdd`；UI 影响必须有还原计划 |
+| 技术实现 | 前端/后端代码、TDD 证据、YSS Skill Execution Result | 原生 `work-unit.slice-implementation`；`implement` 为兼容入口；前端按 `yss-ui` + `yss-page-module-development`，后端按 `yss-router` 最小闭包，业务行为统一 `tdd` | 仅接收已完成 Ticket 正式化、已绑定垂直切片且 `ready-for-agent` 公式通过的输入；只写允许路径；业务行为用 `behavior-tdd`；UI 影响必须有还原计划 |
 | Review/验证 | 不可变候选快照、review 结论、fresh verification | `code-review`（独立于实现者）；UI 影响追加 `yss-ui` + `yss-design-system` 的 UI fidelity 轴 | findings 已处理；同一候选快照通过全部审查轴与验证 |
 | 发布/复盘 | 发布/回滚证据、复盘记录 | 生命周期自有工作单元 | fresh verification、独立审查和发布裁决齐全；`gate.release-ready` 仍须生物人 |
 
@@ -42,8 +42,8 @@ Matt 的 `grill-with-docs`、`to-spec`、`to-tickets`、`implement` 等保留为
 
 ## 结果与暂停
 
-每个工作单元必须返回 `Workflow Execution Result`（workflow reference、skill、changed files、evidence refs、actual verification、deferred seams、drift/new impacts）。缺少可读证据、`stale`、`violation`、`drift`、`new_impacts` 或阻塞信号时不得标记 completed。实现授权不包含 Git commit/push 授权；“做完提交”等自然语言意向不构成上述结构化 Git 授权。
+凡主控向数字人角色或独立运行时正式派发生命周期工作单元，都必须通过结构化任务包派发，并返回 `Workflow Execution Result`（workflow reference、skill、changed files、evidence refs、actual verification、deferred seams、drift/new impacts）。任务包使用 `docs/process/schemas/digital-human-task-package.schema.json`，由 `scripts/verify-digital-human-task-package` 校验；其中 `role_id`、`runtime_id`、`execution_state`、`contract.kind/id/version`、允许写路径、预期证据和汇合引用必须完整。`slice-implementation` 任务包额外绑定批准且当前版本的 Slice Implementation Contract；Discovery、Spec、原型、技术分析、Ticket、Review、发布和模板维护分别绑定各自的生命周期资产或维护 checkpoint，不得伪造 Slice Contract。缺少可读证据、`stale`、`violation`、`drift`、`new_impacts` 或阻塞信号时不得标记 completed。实现授权不包含 Git commit/push 授权；“做完提交”等自然语言意向不构成上述结构化 Git 授权。
 
-输出固定包含：模式、当前阶段、影响面、资产/门禁状态、证据、阻塞项、本轮动作、下一工作单元、暂停/继续理由、Ticket 同步和 Git checkpoint 判断。暂停会签时必须输出门禁 ID、指定 `role_id`、`runtime_id` 和会签文件路径（`docs/.scratch/<feature>/gates/<gate-id>-approval.yaml`）。恢复前运行 `scripts/verify-approval-record`；错误会签记为 `blocked`，不得把该门禁标为 `approved`。任务包的 `core_skills` / `forbidden_skills` 必须从 `docs/agents/digital-human-roles.yaml` 复制（`taskPackageDefaults`），禁止手写第二套。
+输出固定包含：模式、当前阶段、影响面、资产/门禁状态、证据、Ticket 正式化状态、垂直切片引用、`ready-for-agent` 计算结果、阻塞项、本轮动作、下一工作单元、暂停/继续理由、Ticket 同步和 Git checkpoint 判断。原生路径未出现 `to-tickets` / `implement` 名称本身不构成异常；但没有完成 `work-unit.ticket-decomposition`、垂直切片仍为 `ready-for-human`、引用父 Ticket 或 `next_route` 越过 Ticket 正式化时必须返回 `blocked`。暂停会签时必须输出门禁 ID、指定 `role_id`、`runtime_id` 和会签文件路径（`docs/.scratch/<feature>/gates/<gate-id>-approval.yaml`）。恢复前运行 `scripts/verify-approval-record`；错误会签记为 `blocked`，不得把该门禁标为 `approved`。任务包的 `core_skills` / `forbidden_skills` 必须从 `docs/agents/digital-human-roles.yaml` 复制（`taskPackageDefaults`），禁止手写第二套。
 
 详细执行循环、readiness、脚手架（包括 `controlled-generation`）、审查快照、状态传播和 Matt 边界见 [orchestration.md](references/orchestration.md)、[orchestration-contract.yaml](references/orchestration-contract.yaml)、[artifact-dependencies.md](references/artifact-dependencies.md) 和 [state-model.md](references/state-model.md)。

package/template/.agents/skills/yss-product-lifecycle/references/artifact-dependencies.md

@@ -7,6 +7,8 @@ Discovery → Spec → Product Overview / Functional Architecture
 Spec + Product Overview → Product Design / Requirement Freeze
 Spec + Product Overview → API Impact / OpenAPI Draft
 Spec + Product Overview → System / Data Architecture
+System / Data Architecture + domain impact → Tactical DDD Check / tactical-design contract
+Tactical DDD contract → Architecture Review / Engineering Baseline / Slice Implementation Contract
 API impact = yes: Requirement Freeze + Design Review + Draft Review → OpenAPI Freeze
 API impact = no: API Impact Assessment approved → No-API-Impact record；Draft/Freeze gates = not-applicable
 Frozen Contract → Vertical Slice Tickets
@@ -30,3 +32,5 @@ Implementation → Independent Review → Fresh Verification → Release
 明确写入需求的认证、授权、租户隔离、敏感数据或合规行为变化不使用独立影响类型；按它实际改变的 UI 状态、API schema、状态机、数据模型或服务边界传播。普通 action 注册、SQL / DDL / 迁移和上传 / 下载只使用既有技术影响类型，不增加安全 / 权限传播。
 
 OpenAPI Freeze 后发生上游变化时，不得仅因父 Ticket 仍写阶段 6 就继续实现。先做影响分析，再精准更新相关资产和门禁。
+
+战术设计合同上游引用发生版本变化时，先将 tactical-design 标记为 `stale`，再传播到 Slice Contract；发现新的聚合、状态、不变量、一致性或 Gateway 影响时标记 `drift` / `new_impacts` 并重新路由。

package/template/.agents/skills/yss-product-lifecycle/references/matt-yss-adapter.md

@@ -69,8 +69,8 @@ Router 状态映射为：`draft → completed`、`blocked → blocked`、`ready-
 | Matt flow | 进入条件 | 生命周期结果 |
 |---|---|---|
 | `to-spec`（用户显式） | Discovery work unit 或 `grill-with-docs` 已满足退出条件，且不存在未回流 runnable blocker；用户问题、MVP/非目标、成功标准、测试 seam 和术语审查均有证据 | 生命周期只准备/验收；Spec 初稿为 `ready-for-human`，不等于批准 |
-| `to-tickets`（用户显式） | OpenAPI Freeze 或 `no-api-impact` 记录、必要门禁、垂直切片范围和阻塞边均已明确 | 生命周期只准备/验收；只能生成垂直切片 Ticket，初始统一为 `ready-for-human` |
-| `implement`（用户显式） | `ready-for-agent` 公式、Contract 已批准/持久化/版本一致、Build Architecture Checklist、实现仓库/分支/CI/验证命令/回滚点，以及后端 Contract（适用时）均满足 | 生命周期只准备/验收；单会话实现同样适用，不得绕过门禁 |
+| `to-tickets`（用户显式） | OpenAPI Freeze 或 `no-api-impact` 记录、必要门禁、垂直切片范围和阻塞边均已明确 | 生命周期只准备/验收；只能生成垂直切片 Ticket，初始统一为 `ready-for-human`；必须留下 `ticket_decomposition_result_ref` 和 `vertical_slice_ticket_ref` |
+| `implement`（用户显式） | `ready-for-agent` 公式、Ticket 正式化结果、垂直切片引用/类型/状态、Contract 已批准/持久化/版本一致、Build Architecture Checklist、实现仓库/分支/CI/验证命令/回滚点，以及后端 Contract（适用时）均满足 | 生命周期只准备/验收；单会话实现同样适用，不得绕过门禁；父 Ticket、`ready-for-human` 切片或跳过 Ticket 正式化的 `next_route` 必须 `blocked` |
 
 `grill_exit` 不是“已经聊过”的自然语言声明。它必须同时证明 frontier 为空、事实已解决或分别路由到 `research` / prototype / external input、用户决策已确认、双方共同理解已确认，并且没有未回流的 runnable blocker。