kld-sdd 2.6.6 → 2.6.8

package/skywalk-sdd/ontology/workspace-layout.cjs

@@ -0,0 +1,194 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const WORKSPACE_FILE = '.sdd-workspace.yaml';
+const IGNORE_DIR_NAMES = new Set([
+  'node_modules',
+  '.git',
+  '.claude',
+  '.codebuddy',
+  '.kunlunzhima',
+  '.cursor',
+  '.opencode',
+  'skywalk-sdd',
+  'openspec',
+  'openspec-templates',
+  'dist',
+  'build',
+  'coverage',
+]);
+
+function isGitRepo(dir) {
+  return fs.existsSync(path.join(dir, '.git'));
+}
+
+function looksLikeSpecRepo(dir) {
+  const name = path.basename(dir).toLowerCase();
+  if (/-sdd-specs$/.test(name) || name.endsWith('sdd-specs')) return true;
+  if (fs.existsSync(path.join(dir, 'modules.yaml'))) return true;
+  if (fs.existsSync(path.join(dir, 'openspec', 'changes'))) return true;
+  if (fs.existsSync(path.join(dir, 'openspec', 'specs', 'overview.md'))) return true;
+  return false;
+}
+
+function listChildGitRepos(workspaceRoot) {
+  if (!fs.existsSync(workspaceRoot)) return [];
+  return fs.readdirSync(workspaceRoot)
+    .filter((name) => !name.startsWith('.') && !IGNORE_DIR_NAMES.has(name))
+    .map((name) => ({ name, abs: path.join(workspaceRoot, name) }))
+    .filter((entry) => {
+      try {
+        return fs.statSync(entry.abs).isDirectory() && isGitRepo(entry.abs);
+      } catch {
+        return false;
+      }
+    })
+    .sort((a, b) => a.name.localeCompare(b.name));
+}
+
+/**
+ * Detect personal workspace layout: cwd hosts multiple/sibling git repos,
+ * and skills should live once at workspace root (not in every code repo).
+ */
+function detectWorkspaceLayout(workspaceRoot = process.cwd()) {
+  const root = path.resolve(workspaceRoot);
+  const children = listChildGitRepos(root);
+  const rootIsGit = isGitRepo(root);
+  const rootLooksSpec = looksLikeSpecRepo(root);
+
+  const specCandidates = children.filter((c) => looksLikeSpecRepo(c.abs));
+  let spec = null;
+  if (specCandidates.length === 1) {
+    spec = specCandidates[0];
+  } else if (specCandidates.length > 1) {
+    spec = specCandidates.find((c) => fs.existsSync(path.join(c.abs, 'modules.yaml')))
+      || specCandidates.find((c) => /-sdd-specs$/i.test(c.name))
+      || specCandidates[0];
+  } else if (rootLooksSpec && rootIsGit) {
+    spec = { name: path.basename(root), abs: root };
+  }
+
+  const codeRepos = children.filter((c) => !spec || c.abs !== spec.abs);
+
+  const isWorkspace = (!rootIsGit && children.length >= 1)
+    || (children.length >= 2)
+    || (Boolean(spec) && codeRepos.length >= 1 && !rootLooksSpec);
+
+  return {
+    root,
+    isWorkspace: Boolean(isWorkspace),
+    rootIsGit,
+    specRepo: spec,
+    codeRepos,
+    allChildGitRepos: children,
+  };
+}
+
+function parseWorkspaceYaml(text) {
+  const result = {
+    version: 1,
+    spec_path: '',
+    code_repos: [],
+  };
+  const lines = String(text || '').split(/\r?\n/);
+  let inCode = false;
+  for (const raw of lines) {
+    const line = raw.replace(/#.*$/, '').replace(/\s+$/, '');
+    if (!line.trim()) continue;
+    const version = /^version:\s*(\d+)\s*$/.exec(line);
+    if (version) {
+      result.version = Number(version[1]);
+      inCode = false;
+      continue;
+    }
+    const spec = /^spec_path:\s*(.+?)\s*$/.exec(line);
+    if (spec) {
+      let value = spec[1].trim();
+      if (
+        (value.startsWith('"') && value.endsWith('"')) ||
+        (value.startsWith("'") && value.endsWith("'"))
+      ) {
+        value = value.slice(1, -1);
+      }
+      result.spec_path = value;
+      inCode = false;
+      continue;
+    }
+    if (/^code_repos:\s*$/.test(line)) {
+      inCode = true;
+      continue;
+    }
+    if (inCode) {
+      const item = /^\s*-\s+(.+?)\s*$/.exec(line);
+      if (item) {
+        result.code_repos.push(item[1].trim());
+        continue;
+      }
+      if (/^\S/.test(line)) inCode = false;
+    }
+  }
+  return result;
+}
+
+function loadWorkspaceFile(workspaceRoot) {
+  const filePath = path.join(workspaceRoot, WORKSPACE_FILE);
+  if (!fs.existsSync(filePath)) {
+    return { ok: false, path: filePath, data: null };
+  }
+  const data = parseWorkspaceYaml(fs.readFileSync(filePath, 'utf8'));
+  return { ok: true, path: filePath, data };
+}
+
+function writeWorkspaceFile(workspaceRoot, layout) {
+  const specRel = layout.specRepo
+    ? path.relative(workspaceRoot, layout.specRepo.abs) || '.'
+    : '';
+  const codeRels = (layout.codeRepos || []).map((c) =>
+    path.relative(workspaceRoot, c.abs) || c.name,
+  );
+  const lines = [
+    '# 个人工作目录编排清单（不替代各仓 .sdd.yaml）',
+    '# skills 只部署在本工作目录；代码仓仅挂 Hook / 关联 spec。',
+    'version: 1',
+    `spec_path: ${specRel}`,
+    'code_repos:',
+    ...codeRels.map((name) => `  - ${name}`),
+    '',
+  ];
+  const filePath = path.join(workspaceRoot, WORKSPACE_FILE);
+  fs.writeFileSync(filePath, lines.join('\n'), 'utf8');
+  return filePath;
+}
+
+/**
+ * Compare discovery with saved workspace file; return newly found code repos.
+ */
+function findNewCodeRepos(workspaceRoot) {
+  const layout = detectWorkspaceLayout(workspaceRoot);
+  const saved = loadWorkspaceFile(workspaceRoot);
+  const known = new Set(
+    saved.ok && saved.data
+      ? saved.data.code_repos.map((item) => path.resolve(workspaceRoot, item))
+      : [],
+  );
+  const newcomers = layout.codeRepos.filter((c) => !known.has(path.resolve(c.abs)));
+  return {
+    layout,
+    saved,
+    newcomers,
+  };
+}
+
+module.exports = {
+  WORKSPACE_FILE,
+  isGitRepo,
+  looksLikeSpecRepo,
+  listChildGitRepos,
+  detectWorkspaceLayout,
+  parseWorkspaceYaml,
+  loadWorkspaceFile,
+  writeWorkspaceFile,
+  findNewCodeRepos,
+};

package/templates/dot-sdd.yaml

@@ -0,0 +1,8 @@
+# 代码仓库根目录配置：关联团队 spec Git 仓库
+# 个人绝对路径请写入 git config --local sdd.specPath，不要写进本文件。
+#
+# 单仓（openspec 文档与代码在同一仓库）改为下面两行即可，无需 spec_repository：
+#   version: 1
+#   layout: mono
+version: 1
+spec_repository: git@gitlab.example.com:biz/xxx-sdd-specs.git

package/templates/git-hooks/commit-msg-sdd-trailer.cjs

@@ -0,0 +1,224 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * commit-msg hook，两种布局：
+ *
+ * - 多仓（代码仓有 .sdd.yaml，spec 是另一个 clone）：
+ *   写 Spec-Revision（spec 干净 HEAD 的完整 SHA）+ Spec-Change（活动 change，可多条）。
+ * - 单仓（openspec 与代码同仓）：
+ *   spec 与代码在同一次 commit 里，指针自指无意义 → 只写 Spec-Change，不写 Spec-Revision，
+ *   且不做「spec 工作区干净」检查（提交进行中必然是脏的）。
+ *
+ * Spec-Change 来源：KLD_SDD_CHANGE（显式覆盖）> sdd.config.yaml active_changes。
+ * Not from branch name, ever.
+ *
+ * Authority: 10-最小化多仓库关联与变更命名方案.md
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+function resolveOntologyDir() {
+  const deployed = path.join(__dirname, '..', 'ontology');
+  if (fs.existsSync(path.join(deployed, 'change-key.cjs'))) return deployed;
+  const fromPackageTemplates = path.join(__dirname, '..', '..', 'skywalk-sdd', 'ontology');
+  if (fs.existsSync(path.join(fromPackageTemplates, 'change-key.cjs'))) return fromPackageTemplates;
+  throw new Error('无法定位 skywalk-sdd/ontology');
+}
+
+const ontologyDir = resolveOntologyDir();
+const changeKey = require(path.join(ontologyDir, 'change-key.cjs'));
+const sddConfig = require(path.join(ontologyDir, 'sdd-config.cjs'));
+const activeChanges = require(path.join(ontologyDir, 'active-changes.cjs'));
+const { parseFrontmatter } = require(path.join(ontologyDir, 'artifact-parser.cjs'));
+
+function projectRootFromHook() {
+  const explicit = process.argv.find((arg) => arg.startsWith('--project='));
+  if (explicit) return path.resolve(explicit.slice('--project='.length));
+  return path.resolve(__dirname, '..', '..');
+}
+
+function fail(message) {
+  console.error(`[kld-sdd commit-msg] ${message}`);
+  process.exit(1);
+}
+
+function isSddLinkedCodeRepo(codeRepoRoot) {
+  return fs.existsSync(path.join(codeRepoRoot, '.sdd.yaml'));
+}
+
+/**
+ * 决定本次提交按哪种布局处理。布局来自 .sdd.yaml 显式声明，不做启发式推断
+ * （否则单独诊断的 spec 仓 clone 会被误判成单仓）。
+ *
+ * 单仓优先于 specPath：即使用户把 sdd.specPath 指回本仓，也走单仓路径，
+ * 否则会因为「spec 工作区不干净」永久阻断提交。
+ */
+function resolveLayout(repoRoot, env = process.env) {
+  if (!isSddLinkedCodeRepo(repoRoot)) {
+    return { mode: 'unlinked' };
+  }
+  if (sddConfig.isMonoLayout(repoRoot)) {
+    return { mode: 'mono', specPath: repoRoot };
+  }
+
+  const context = sddConfig.resolveCodeRepoContext(repoRoot, env);
+  if (!context.specPath) {
+    fail(context.message || '无法解析 spec clone 路径。请执行 kld-sdd link-spec --path=<spec>');
+  }
+  if (context.code === sddConfig.CODES.SPEC_PATH_INVALID) {
+    fail(context.message);
+  }
+  // specPath 指回本仓：等同单仓，不能按外部 spec 校验干净度
+  if (path.resolve(context.specPath) === path.resolve(repoRoot)) {
+    return { mode: 'mono', specPath: repoRoot, context };
+  }
+  return { mode: 'multi', specPath: context.specPath, context };
+}
+
+/**
+ * Explicit override: KLD_SDD_CHANGE, comma/space separated for several changes.
+ * Not from branch name, not from repo-wide git config.
+ */
+function parseEnvChangeKeys(env = process.env) {
+  const raw = env.KLD_SDD_CHANGE && String(env.KLD_SDD_CHANGE).trim();
+  if (!raw) return null;
+  const keys = [];
+  for (const token of raw.split(/[,\s]+/).filter(Boolean)) {
+    const validated = changeKey.validate(token);
+    if (!validated.ok) {
+      fail(`KLD_SDD_CHANGE 无效: ${validated.message}`);
+    }
+    if (!keys.includes(validated.normalized)) keys.push(validated.normalized);
+  }
+  return keys.length ? keys : null;
+}
+
+/**
+ * Spec-Change values: explicit env wins, otherwise every active change
+ * registered in the spec repo's sdd.config.yaml.
+ */
+function resolveChangeKeys(specRoot, env = process.env) {
+  const fromEnv = parseEnvChangeKeys(env);
+  if (fromEnv) {
+    for (const key of fromEnv) {
+      requireChangeDir(specRoot, key, { strict: true });
+    }
+    return { keys: fromEnv, source: 'env' };
+  }
+  const registered = activeChanges.activeChangeKeys(specRoot);
+  const keys = registered.filter((key) => requireChangeDir(specRoot, key, { strict: false }));
+  return { keys, source: 'sdd.config.yaml' };
+}
+
+/**
+ * @param {{ strict: boolean }} options strict=true 阻断提交；false 仅警告并跳过该条
+ */
+function requireChangeDir(specRoot, key, options = { strict: true }) {
+  const proposalPath = path.join(specRoot, 'openspec', 'changes', key, 'proposal.md');
+  if (!fs.existsSync(proposalPath)) {
+    const message = `spec 中不存在 change: openspec/changes/${key}/proposal.md`;
+    if (options.strict) fail(message);
+    console.error(`[kld-sdd commit-msg] 警告: ${message}（已跳过该 Spec-Change）`);
+    return false;
+  }
+  const lines = fs.readFileSync(proposalPath, 'utf8').split(/\r?\n/);
+  const fm = parseFrontmatter(lines);
+  const declared = (fm['change-key'] || '').toLowerCase();
+  if (declared && declared !== key) {
+    const message = `proposal change-key (${declared}) 与目录 (${key}) 不一致`;
+    if (options.strict) fail(message);
+    console.error(`[kld-sdd commit-msg] 警告: ${message}（已跳过该 Spec-Change）`);
+    return false;
+  }
+  return true;
+}
+
+/**
+ * 重写 Trailer 区块：同名旧行先全部摘除，再作为连续区块追加到末尾。
+ *
+ * @param {Record<string, string|string[]>} trailers 数组值写成多条同名 Trailer
+ */
+function upsertTrailers(message, trailers) {
+  let body = String(message || '').replace(/\s+$/g, '');
+  const block = [];
+
+  for (const [name, value] of Object.entries(trailers)) {
+    const linePattern = new RegExp(`^${name}:[^\\n]*\\n?`, 'gim');
+    body = body.replace(linePattern, '');
+    const values = (Array.isArray(value) ? value : [value]).filter(
+      (item) => item != null && String(item).length > 0,
+    );
+    for (const item of values) {
+      block.push(`${name}: ${item}`);
+    }
+  }
+
+  body = body.replace(/\s+$/g, '');
+  if (block.length) {
+    body += `\n\n${block.join('\n')}`;
+  }
+  body = body.replace(/\n{3,}/g, '\n\n');
+  if (!body.endsWith('\n')) body += '\n';
+  return body;
+}
+
+function main(env = process.env) {
+  const msgFile = process.argv[2];
+  if (!msgFile) {
+    fail('缺少 commit message 文件参数');
+  }
+
+  const repoRoot = projectRootFromHook();
+  const layout = resolveLayout(repoRoot, env);
+
+  // 未接入 SDD 的普通代码仓：不写 Trailer
+  if (layout.mode === 'unlinked') {
+    process.exit(0);
+  }
+
+  const trailers = {
+    // 多个活动 change 时写多条 Spec-Change
+    'Spec-Change': resolveChangeKeys(layout.specPath, env).keys,
+  };
+
+  if (layout.mode === 'multi') {
+    const context = layout.context;
+    // remote mismatch：仍允许写本地 Revision（溯源本地快照）；仅警告
+    if (context.code === sddConfig.CODES.REMOTE_MISMATCH) {
+      console.error(`[kld-sdd commit-msg] 警告: ${context.message}`);
+    }
+
+    if (!sddConfig.gitWorkingTreeClean(layout.specPath)) {
+      fail('spec 工作区不干净。请先提交或暂存 spec 变更后再提交代码。');
+    }
+
+    const revision = sddConfig.gitHeadSha(layout.specPath);
+    if (!revision || revision.length < 40) {
+      fail(`无法读取完整 Spec-Revision（需要完整 SHA）: ${revision}`);
+    }
+    trailers['Spec-Revision'] = revision;
+  }
+
+  const original = fs.readFileSync(msgFile, 'utf8');
+  const updated = upsertTrailers(original, trailers);
+  fs.writeFileSync(msgFile, updated, 'utf8');
+}
+
+if (require.main === module) {
+  try {
+    main();
+  } catch (error) {
+    fail(error.message || String(error));
+  }
+}
+
+module.exports = {
+  upsertTrailers,
+  parseEnvChangeKeys,
+  resolveChangeKeys,
+  isSddLinkedCodeRepo,
+  resolveLayout,
+  main,
+};

package/templates/modules.yaml

@@ -0,0 +1,13 @@
+# 模块代号注册表（spec 仓库根目录）
+# 只登记模块代号与中文名，不包含代码仓库、路径或 CI 配置。
+version: 1
+
+modules:
+  fi:
+    name: 财务核算
+  mm:
+    name: 物料管理
+  sd:
+    name: 销售与分销
+  cross:
+    name: 跨模块

package/templates/openspec/proposal.md

@@ -1,17 +1,26 @@
 ---
 # 【用户选择配置 - 由 /opsx:propose 引导填写】
-change-id: "CHG-<CHANGE-SLUG>" # 创建时生成，后续不得修改
+change-id: "CHG-<MODULE>-<YYMMDD>-<SLUG>" # 创建时由 change-key 派生一次，后续不得修改
+change-key: "<module>-<yymmdd>-<slug>" # spec 仓目录名；可选写入代码 commit 的 Spec-Change（需 KLD_SDD_CHANGE）
+title: "<中文标题>" # 人读名称，opsx-explore / 知识平台展示
+module: "<module>" # modules.yaml 中的模块代号；跨模块用 cross
+# affected-modules: # 仅 module=cross 时必填，至少两个已注册模块
+#   - fi
+#   - mm
 entity-id: "<8位十六进制ID>" # Change 的全局逻辑实体 ID，added 时生成
 version-id: "<UUID>" # 本次 Change 版本 UUID
 delta-state: "added"
 predecessor-version: "" # added 留空；modified/removed 指向直接前序版本
 mode: "" # full=分 Capability 产物，simple=根目录精简产物
 test-strategy: "" # tdd=测试先行, impl-first=实现优先, none=无测试
-# 外部需求键（首轮冷启动也建议写入，便于 ingest 种桥）
+# 外部需求键（默认必填 ≥1 个合规 REQ；探索性/纯内部重构可走 numbering-waiver）
 requirement-refs:
   - system: requirement-mgmt
     object-type: requirement
-    external-id: REQ-<DOMAIN>-<NNN>
+    external-id: REQ-<DOMAIN>-<YEAR>-<SEQ>   # 例 REQ-FI-2024-001
+    feature-id: FEAT-<DOMAIN>-<SEQ>          # 可选，需求所属功能（需求系统权威）
+# numbering-waiver:
+#   reason: "探索性原型，本轮不种桥"
 # Continuity：字段一律来自知识库 resolve，禁止本地 archive 文件夹名
 continuity:
   kind: new # iteration | similar-reference | new

package/templates/openspec/spec.md

@@ -34,7 +34,7 @@ capability-id: "CAP-<CAPABILITY>" # 必须与 proposal.md 中的 Capability ID
 - **version-id**: <UUID>
 - **delta-state**: added
 - **predecessor-version**: 无
-- **external-ref**: requirement-mgmt:scenario:REQ-<DOMAIN>-<NNN>:SCN-<slug>
+- **external-ref**: requirement-mgmt:scenario:REQ-<DOMAIN>-<YEAR>-<SEQ>:SCN-<slug>-<NNN>
 - **当** <!-- 触发条件 -->
 - **预期** <!-- 预期结果 -->
 
@@ -43,7 +43,7 @@ capability-id: "CAP-<CAPABILITY>" # 必须与 proposal.md 中的 Capability ID
 - **version-id**: <UUID>
 - **delta-state**: added
 - **predecessor-version**: 无
-- **external-ref**: requirement-mgmt:scenario:REQ-<DOMAIN>-<NNN>:SCN-<slug>
+- **external-ref**: requirement-mgmt:scenario:REQ-<DOMAIN>-<YEAR>-<SEQ>:SCN-<slug>-<NNN>
 - **当** <!-- 触发条件 -->
 - **预期** <!-- 预期结果 -->
 
@@ -63,7 +63,7 @@ capability-id: "CAP-<CAPABILITY>" # 必须与 proposal.md 中的 Capability ID
 - **version-id**: <新 UUID>
 - **delta-state**: <modified|added>
 - **predecessor-version**: <modified 时填写；added 为无>
-- **external-ref**: requirement-mgmt:scenario:REQ-<DOMAIN>-<NNN>:SCN-<slug>
+- **external-ref**: requirement-mgmt:scenario:REQ-<DOMAIN>-<YEAR>-<SEQ>:SCN-<slug>-<NNN>
 - **当** <!-- 触发条件 -->
 - **预期** <!-- 预期结果 -->
 

package/templates/sdd.config.yaml

@@ -0,0 +1,12 @@
+# 活动变更登记表（spec 仓库根目录）
+# 由 opsx-propose 隐式写入、opsx-archive 隐式移除，供代码仓 AI 与 commit-msg Hook 读取。
+# 不登记代码仓清单、路径 glob 或 CI 配置。
+version: 1
+
+active_changes:
+# 示例（propose 会自动写入，无需手填）：
+#   - change-key: fi-260727-account-doc-head-create
+#     change-id: CHG-FI-260727-ACCOUNT-DOC-HEAD-CREATE
+#     title: 会计凭证头创建
+#     module: fi
+#     summary: 支持凭证头创建与字段校验

package/templates/skills/kld-sdd/opsx-apply/SKILL.md

@@ -183,8 +183,8 @@ openspec list --json
 
 **执行每个任务**（a-g 步骤）：
 
-a. **DAG 依赖检查 & 层级收集** — 收集依赖已满足的待执行任务；同层多个独立任务可并行派发子代理。
-b. **显示当前层级任务** — `📍 层级 [X]：准备派发 [K] 个子代理并行处理 [M] 个任务`。
+a. **DAG 依赖检查 & 层级收集** — 收集依赖已满足的待执行任务；同层多个独立任务可并行派发子代理。**⛔ TDD 模式豁免**：当 `test-strategy=tdd` 时，同层的 RED→GREEN 对**不可并行**，必须逐对串行执行（见下方 S2）。仅同层的非 TDD 模块任务（UI/配置/SQL DDL）可并行。
+b. **显示当前层级任务** — `📍 层级 [X]：准备派发 [K] 个子代理并行处理 [M] 个任务`。**TDD 模式下**：若本层含 RED→GREEN 对，显示 `📍 层级 [X]：[M] 个 RED→GREEN 对须逐对串行执行（TDD 串行约束），[K] 个非 TDD 任务可并行`。
 c. **🤖 派发子代理实现代码** — 使用 Agent 工具并行派发同层任务，⛔ 子代理阶段不创建 worktree/分支。**派发模板与状态处理见 `./reference.md`「§5c 子代理派发模板」+ `./implementer-prompt.md`**。
 d. **⛔ 编译检查门禁** — 每完成一个任务后必须编译通过；**详细见 `./checklist.md`「§5d 编译检查门禁」**。
 e. **⛔ 测试执行门禁** — 按 `proposal.md` 的 `test-strategy` 决定（tdd=强制, impl-first=警告, none=跳过）；**详细见 `./checklist.md`「§5e 测试执行门禁」**。
@@ -285,7 +285,7 @@ g. **继续下一个层级** — 重新检查 DAG，找出依赖已满足的下
 - **⛔ 必须实时更新任务状态**：每完成一个任务立即改 tasks.md，两种格式同步。
 - **⛔ apply 结束前 checkbox 全量同步校验**：`stage_end` 前对比 telemetry `task_update` 记录数与 tasks.md `[x]` 数量，不一致则补齐（见 `./checklist.md` §5f.1）。
 - **⛔ task_update 后必须验证 checkbox 已更新**：执行 `check-task` 确认 tasks.md 对应行已变更；未更新则手动修改。
-- **⛔ TDD RED→GREEN 严格串行**：不适用同层并行派发；RED-N 确认失败后必须执行中断声明再进入 GREEN-N；GREEN 完成后必须通过 Scope 门禁再进入下一个 RED。
+- **⛔ TDD RED→GREEN 严格串行**：不适用同层并行派发；RED-N 确认失败后必须执行中断声明再进入 GREEN-N；GREEN 完成后必须通过 Scope 门禁再进入下一个 RED。同层存在多个 RED→GREEN 对时，必须逐对串行完成，禁止并行派发子代理处理多个 RED→GREEN 对。同层非 TDD 模块任务（UI/配置/SQL DDL）仍可并行。
 - **Git 只读策略**：禁止为了度量自动初始化 Git、创建分支或提交 commit；非 Git 项目用 `vcs_mode=no-git` 继续执行。
 - **⛔ Step 0.1 隔离校验必做**：建 worktree / 建议分支名前必须完成 proposal + 跨 cap spec 依赖校验并输出报告。
 - **Worktree 为加速手段，非必选项**：校验通过且解耦方可多 worktree；有依赖或共享修改面则串行。

package/templates/skills/kld-sdd/opsx-apply/checklist.md

@@ -130,7 +130,7 @@ description: opsx-apply 的阶段强制检查点与自检清单。仅在执行 a
 - [ ] ⛔ **必须实时更新任务状态**：每完成一个任务立即改 tasks.md，两种格式（`- [ ]`→`- [x]` 与 `**状态**: [ ]`→`[x]`）同步
 - [ ] ⛔ **apply 结束前 checkbox 全量同步校验**：见 §5f.1，`stage_end` 前对比 telemetry `task_update` 记录数与 tasks.md `[x]` 数量
 - [ ] ⛔ **task_update 后必须验证 checkbox 已更新**：执行 `check-task` 确认 tasks.md 对应行已变更；未更新则手动修改
-- [ ] ⛔ **TDD RED→GREEN 严格串行**：不适用同层并行派发；RED-N 确认失败后必须执行中断声明再进入 GREEN-N；GREEN 完成后必须通过 Scope 门禁再进入下一个 RED
+- [ ] ⛔ **TDD RED→GREEN 严格串行**：不适用同层并行派发；RED-N 确认失败后必须执行中断声明再进入 GREEN-N；GREEN 完成后必须通过 Scope 门禁再进入下一个 RED。同层多个 RED→GREEN 对须逐对串行，禁止并行派发；同层非 TDD 模块任务仍可并行
 - [ ] ⛔ **TDD 节奏校验**：见 §5e.1，连续 RED-N/GREEN-N 的 `task_update` 时间戳须有可验证间距
 - [ ] **Git 只读策略**：禁止为了度量自动初始化 Git、创建分支或提交 commit；非 Git 项目用 `vcs_mode=no-git` 继续执行
 - [ ] ⛔ **Step 0.1 隔离校验必做**：建 worktree / 建议分支名前必须完成 proposal + 跨 cap spec 依赖校验并输出报告；未通过不得按 full 并行策略拆 `kld-sdd/<change>/<cap>`

package/templates/skills/kld-sdd/opsx-archive/SKILL.md

@@ -118,6 +118,16 @@ node skywalk-sdd/log.cjs archive-docs --project=. --change=<变更名称> --reas
 - 最终中文报告生成到 `openspec/changes/archive/<日期>-<name>/reports/<name>-report.md` 及同名 `<name>-report.html`（默认同时生成 .md 与 .html 双产物，默认归档后 archive 目录，可用 --report-output 自定义）。
 - 执行日志 `openspec/changes/archive/<日期>-<name>/logs/execution-log.md` 随归档整目录迁移（人读审计层）。
 
+### 5.4 隐式注销活动变更
+
+归档成功后立即执行（不询问用户）：
+
+```bash
+node skywalk-sdd/ontology/cli.cjs active-change --remove --change=<变更名称> --project=.
+```
+
+把该 change 从 spec 仓 `sdd.config.yaml` 的 `active_changes` 移除，避免已归档 change 继续被代码 commit 写成 `Spec-Change`。该操作幂等；条目本就不存在时不报错。
+
 ### 5.5 收尾入库（opsx-kb-ingest）
 
 1. 确认 `${AGENT_SKILL_DIR}/opsx-kb-ingest/SKILL.md` 存在并 Read；按该技能完成 API Key / targets。

package/templates/skills/kld-sdd/opsx-check/SKILL.md

@@ -1,4 +1,4 @@
----
+---
 name: opsx-check
 description: "质量检查技能 - 验证文档完整性、一致性、算法正确性及可执行性"
 argument-hint: "[change-name] [上下文文件...]"
@@ -69,6 +69,43 @@ openspec list
 - `specs/<capability>/design.md`（实现方案）
 - `specs/<capability>/tasks.md`（或 task.md，兼容旧格式）（任务拆解）
 
+### 2.5 【多仓库关联配置诊断】（在五维检查之前）
+
+先执行轻量配置诊断，**不执行代码 diff**，只检查命名与引用配置：
+
+```bash
+# 在 spec 仓库：
+node skywalk-sdd/ontology/cli.cjs diagnose-naming --project=. --change=<change-key>
+
+# 在代码仓库：
+node skywalk-sdd/ontology/cli.cjs diagnose-naming --project=. --mode=code-repo
+```
+
+诊断结果三类：
+
+| 状态 | 含义 |
+|------|------|
+| PASS | 配置完整 |
+| FIXABLE | 修复方式唯一，用户确认后可自动修复（如安装 commit-msg Hook、设置 sdd.specPath） |
+| NEEDS_INPUT | 多候选或团队级配置，必须询问用户 |
+
+规则：
+- 只问缺失项，不重复询问已合法配置
+- 本地 Git config / Hook 可在确认后修复
+- `.sdd.yaml`、`modules.yaml`、proposal frontmatter 修改前必须展示变更摘要
+- 已被代码 commit 引用的 change-id/change-key **禁止静默重命名**
+- 用户拒绝修复时按严重程度记 warning/failure，然后继续后续文档检查
+- spec 仓诊断跳过代码仓 Hook；代码仓诊断跳过 modules/change 命名（入口分离）
+- 单仓（`.sdd.yaml` 声明 `layout: mono`，openspec 与代码同仓）：`mode=mono-repo`，命名与 Hook 一并就地检查；该布局 commit 只写 `Spec-Change`，不写 `Spec-Revision`
+- 若在个人工作目录发现未接入的新代码仓（缺 `.sdd.yaml` 或 commit-msg Hook）：
+  1. 向用户展示仓名列表；
+  2. 用户确认后执行 `kld-sdd sync-repos`（只装 Hook/关联，不装 skills）；
+  3. 用户拒绝则记 warning，不阻断五维文档检查
+- Trailer 协议：已接入仓 commit 必写 `Spec-Revision`；`Spec-Change` 来自 spec 仓 `sdd.config.yaml` 的 `active_changes`（多个则写多条），`KLD_SDD_CHANGE` 可显式覆盖，**不从分支名推断**
+- 活动变更登记表诊断：`sdd.config.yaml` 是否存在且格式合法；当前 change 是否已登记（未登记则提示执行 `active-change --register`）；登记项对应目录是否仍存在（已归档应执行 `active-change --remove`）
+
+最终检查报告必须包含「多仓库关联配置」章节（命令输出已按此格式打印）。
+
 ### 3. 【上下文加载】识别并读取用户提供的文件
 
 **自动识别上下文文件**：
@@ -117,7 +154,7 @@ openspec list
 
 #### 4.4a TDD 合规性检查（仅 test-strategy=tdd 时执行）
 
-⛔ 执行 `opsx-tdd-core/checklist.md` §B（11 项）逐项检查。
+⛔ 执行 `opsx-tdd-core/checklist.md` §B（15 项）逐项检查。
 
 > 不在此内联复制，以 opsx-tdd-core/checklist.md §B 为唯一真相源。
 > 额外补充：还需检查 `opsx-tdd-rules/rules/exception-path-coverage.md`（异常路径覆盖门禁）。
@@ -220,7 +257,7 @@ node skywalk-sdd/log.cjs record --type=conformance_review --command=check --proj
 
 ---
 
-## Continuity / external_ref 确定性门禁
+## Continuity / external_ref / 编号确定性门禁
 
 `opsx-check` **不联网提问**。Agent 应在 propose/spec 已问完；本阶段只验证并入既有 apply 前门禁：
 
@@ -228,6 +265,13 @@ node skywalk-sdd/log.cjs record --type=conformance_review --command=check --proj
 - 已写 spec 的 Capability：场景 `external-ref` 与 `continuity-resolution.json` 决议一致；同 key+同锚点未偷偷换 entity_id
 - 用户选「原对象」却仍用新 id、或选「新对象」却仍共用旧锚点 → 失败（`CONTINUITY_IDENTITY_MISMATCH` / `EXTERNAL_REF_CONFLICT`）
 - 决议缺失 / pending / 与产物不一致 → `CONTINUITY_DECISION_REQUIRED`
+- **编号诊断码**（并入五维报告与 apply gate）：
+  - `EXTERNAL_KEY_FORMAT_INVALID` — external_id / feature_id 不合规
+  - `EXTERNAL_KEY_SCOPE_MISMATCH` — 场景键 REQ 前缀不在 `requirement-refs`
+  - `EXTERNAL_KEY_FEATURE_UNDECLARED` — feature↔requirement.`feature_id` 配对断裂
+  - `EXTERNAL_KEY_SEQ_REUSED` — 本 Change 内 SCN 重复或复用 removed 墓碑号
+  - `NUMBERING_WAIVER_ACTIVE`（warning）— 豁免生效，本轮不种桥
+- `requirement-refs` 为空且无有效 waiver → `CONTINUITY_DECISION_REQUIRED` 级阻断
 - CI/非交互：失败即非零退出并打印修复说明，不挂起等待输入
 
 ## 本体语义关系门禁