kld-sdd 2.6.15 → 2.6.16

package/lib/init.js

@@ -894,64 +894,115 @@ function deployTelemetryDataDir(targetCwd = process.cwd()) {
   return true;
 }
 
-function installGitHookShim(cwd, hookName, scriptPath, options = {}) {
+/**
+ * 安装 SDD shell hook（多脚本调用型 hook，如 pre-commit / pre-push / commit-msg）。
+ * 直接部署完整的 shell 脚本到 .git/hooks/，脚本内部远程引用 spec 仓的 .cjs 脚本。
+ *
+ * shell hook 运行时通过 git config sdd.specPath / .sdd-spec-root / 向上搜索
+ * 定位 spec 仓的 skywalk-sdd/git-hooks/ 目录，兼容单仓/多仓/mono 布局。
+ *
+ * @param {string} cwd - Git 仓库根目录
+ * @param {string} hookName - hook 名称（如 'pre-commit'、'pre-push'）
+ * @param {string} pkgPath - kld-sdd 包路径（用于读取模板）
+ */
+function installSddShellHook(cwd, hookName, pkgPath = getPackagePath()) {
   const hooksDir = path.join(cwd, '.git', 'hooks');
   if (!fs.existsSync(hooksDir)) {
     return;
   }
 
+  const templatePath = path.join(pkgPath, 'templates', 'git-hooks', hookName);
+  if (!fs.existsSync(templatePath)) {
+    console.log(`   ⚠️  Hook 模板不存在: ${templatePath}`);
+    return;
+  }
+
   const hookPath = path.join(hooksDir, hookName);
   const marker = 'KLD SDD quality gate';
-  // Git 把 commit-msg 文件路径放在 $1；--project 等额外参数必须跟在 "$@" 后面，
-  // 否则 trailer 脚本会把 --project=… 误当成 message 文件（argv[2]）。
-  const extraArgs = options.extraArgs || '';
-  // Windows 反斜杠路径在 #!/bin/sh（Git for Windows MSYS2）中不被 [ -f ] 和 node 识别，
-  // 统一转为正斜杠，确保 hook shim 跨平台可执行。
-  const shScriptPath = scriptPath.replace(/\\/g, '/');
-  const shExtraArgs = extraArgs.replace(/\\/g, '/');
-  const nodeLine = shExtraArgs
-    ? `  node "${shScriptPath}" "$@" ${shExtraArgs}`
-    : `  node "${shScriptPath}" "$@"`;
-  const shim = [
-    '#!/bin/sh',
-    `# ${marker}`,
-    `if [ -f "${shScriptPath}" ]; then`,
-    nodeLine,
-    'else',
-    `  echo "[kld-sdd] Hook 脚本不存在: ${shScriptPath}" >&2`,
-    '  exit 1',
-    'fi',
-    '',
-  ].join('\n');
+  const content = fs.readFileSync(templatePath, 'utf8');
 
   if (fs.existsSync(hookPath)) {
     const existing = fs.readFileSync(hookPath, 'utf8');
     if (existing.includes(marker)) {
-      // 已是 SDD shim：若指向路径变化（如改为引用 spec 仓），允许覆盖升级
-      if (existing.includes(shScriptPath) && (!shExtraArgs || existing.includes(shExtraArgs.trim()))) {
-        console.log(`   ✓ .git/hooks/${hookName} 已包含 SDD 质量门禁`);
-        return;
-      }
-      fs.writeFileSync(hookPath, shim, 'utf8');
+      // 已是 SDD hook：允许覆盖升级
+      fs.writeFileSync(hookPath, content, 'utf8');
       try {
         fs.chmodSync(hookPath, 0o755);
       } catch {
         // ignore
       }
-      console.log(`   ✓ 更新 .git/hooks/${hookName} SDD 质量门禁`);
+      console.log(`   ✓ 更新 .git/hooks/${hookName} SDD 质量门禁（多脚本）`);
       return;
     }
-    console.log(`   ℹ️  .git/hooks/${hookName} 已存在，已保留不覆盖；可手动调用 ${scriptPath}`);
+    console.log(`   ℹ️  .git/hooks/${hookName} 已存在且非 SDD 受管 hook，已保留不覆盖`);
     return;
   }
 
-  fs.writeFileSync(hookPath, shim, 'utf8');
+  fs.writeFileSync(hookPath, content, 'utf8');
   try {
     fs.chmodSync(hookPath, 0o755);
   } catch {
-    // Windows 上 chmod 可能没有实际效果，不影响 Git Bash 执行文本 hook。
+    // Windows 上 chmod 可能没有实际效果
   }
-  console.log(`   ✓ 安装 .git/hooks/${hookName} SDD 质量门禁`);
+  console.log(`   ✓ 安装 .git/hooks/${hookName} SDD 质量门禁（多脚本）`);
+}
+
+/**
+ * 部署代码仓全部 Git hooks（commit-msg + pre-commit + pre-push）。
+ *
+ * 统一入口，封装三种 hook 的部署逻辑。代码仓**不落 skywalk-sdd/**，
+ * 只在 .git/hooks/ 安装 shell hook 模板，远程引用 spec 仓的 .cjs 脚本：
+ *
+ * - **spec 仓**：确保 skywalk-sdd/git-hooks/ 下有全部 .cjs 脚本
+ *   （commit-msg-sdd-trailer + pre-commit-* + pre-push-* + ontology）。
+ * - **代码仓 .git/hooks/**：仅安装 3 个 shell hook 模板，运行时通过
+ *   git config sdd.specPath / .sdd-spec-root / 向上搜索定位 spec 仓的脚本。
+ *
+ * @param {string} codeRepoRoot - 代码仓根目录
+ * @param {string} specRepoRoot - spec 包裹包根目录
+ * @param {object} options - { pkgPath }
+ * @returns {{ ok: boolean, message?: string }}
+ */
+function deployCodeRepoHooks(codeRepoRoot, specRepoRoot, options = {}) {
+  const cwd = path.resolve(codeRepoRoot);
+  const specRoot = path.resolve(specRepoRoot);
+  const pkgPath = options.pkgPath || getPackagePath();
+
+  if (!workspaceLayout.isGitRepo(cwd)) {
+    return { ok: false, message: '不是 Git 仓库' };
+  }
+
+  // ── 1. 确保 spec 仓有全部 hook 脚本 + ontology ──
+  // commit-msg .cjs + ontology（ensureSpecCommitMsgScript 已处理）
+  ensureSpecCommitMsgScript(specRoot, pkgPath);
+  // pre-commit / pre-push .cjs 脚本
+  const specHooksDir = path.join(specRoot, 'skywalk-sdd', 'git-hooks');
+  const gitHooksTemplateDir = path.join(pkgPath, 'templates', 'git-hooks');
+  if (!fs.existsSync(specHooksDir)) {
+    fs.mkdirSync(specHooksDir, { recursive: true });
+  }
+  const hookScripts = [
+    'pre-commit-sdd-check.cjs',
+    'pre-commit-consistency-check.cjs',
+    'pre-push-sdd-check.cjs',
+    'pre-push-consistency-check.cjs',
+  ];
+  for (const script of hookScripts) {
+    const src = path.join(gitHooksTemplateDir, script);
+    const dst = path.join(specHooksDir, script);
+    if (fs.existsSync(src) && !fs.existsSync(dst)) {
+      fs.copyFileSync(src, dst);
+    }
+  }
+  console.log(`   ✓ 确保 spec 仓 skywalk-sdd/git-hooks/ 脚本齐全`);
+
+  // ── 2. 安装三个 shell hooks 到代码仓 .git/hooks/ ──
+  // 模板 hook 运行时自动定位 spec 仓的 .cjs 脚本
+  installSddShellHook(cwd, 'commit-msg', pkgPath);
+  installSddShellHook(cwd, 'pre-commit', pkgPath);
+  installSddShellHook(cwd, 'pre-push', pkgPath);
+
+  return { ok: true };
 }
 
 /**
@@ -976,22 +1027,6 @@ function ensureSpecCommitMsgScript(specRepoRoot, pkgPath = getPackagePath()) {
   return { ok: true, scriptPath, deployed: true };
 }
 
-/**
- * 代码仓 commit-msg：只写 .git/hooks，脚本与 ontology 一律用 spec 仓那一份。
- */
-function installCodeRepoCommitMsgHook(codeRepoRoot, specRepoRoot, options = {}) {
-  const cwd = path.resolve(codeRepoRoot);
-  const ensured = ensureSpecCommitMsgScript(specRepoRoot, options.pkgPath || getPackagePath());
-  if (!ensured.ok) {
-    console.log(`   ⚠️  ${ensured.message}`);
-    return false;
-  }
-  installGitHookShim(cwd, 'commit-msg', ensured.scriptPath, {
-    extraArgs: `"--project=${cwd}"`,
-  });
-  return true;
-}
-
 /**
  * 部署 Git hooks / CI 兜底模板
  * 这些脚本只做质量门禁和 CI 补充记录，不替代 OPSX 主采集链路。
@@ -999,7 +1034,7 @@ function installCodeRepoCommitMsgHook(codeRepoRoot, specRepoRoot, options = {})
  * @param {string} [targetCwd]
  * @param {{ mode?: 'full'|'commit-msg-only' }} [options]
  *   full: spec 包裹包（pre-commit/pre-push/commit-msg + CI）
- *   commit-msg-only: 单仓 Git 根（本仓落 skywalk-sdd/git-hooks；多仓代码仓请用 installCodeRepoCommitMsgHook）
+ *   commit-msg-only: 仅安装 commit-msg hook（跳过 pre-commit/pre-push）
  */
 function deployQualityGateTemplates(targetCwd = process.cwd(), options = {}) {
   const pkgPath = getPackagePath();
@@ -1030,18 +1065,18 @@ function deployQualityGateTemplates(targetCwd = process.cwd(), options = {}) {
   }
 
   if (mode === 'full') {
-    installGitHookShim(cwd, 'pre-commit', 'skywalk-sdd/git-hooks/pre-commit-sdd-check.cjs');
-    installGitHookShim(cwd, 'pre-push', 'skywalk-sdd/git-hooks/pre-push-sdd-check.cjs');
+    installSddShellHook(cwd, 'pre-commit', pkgPath);
+    installSddShellHook(cwd, 'pre-push', pkgPath);
   }
-  installGitHookShim(cwd, 'commit-msg', 'skywalk-sdd/git-hooks/commit-msg-sdd-trailer.cjs');
+  installSddShellHook(cwd, 'commit-msg', pkgPath);
 
   console.log('✅ Git hooks 已就绪');
   return true;
 }
 
 /**
- * 代码仓轻量接入：只写 .sdd.yaml + sdd.specPath + .git/hooks/commit-msg。
- * 不在代码仓落 skywalk-sdd/——Hook 脚本与 ontology 引用 spec 包裹包那一份。
+ * 代码仓轻量接入：写 .sdd.yaml + sdd.specPath + .git/hooks/（commit-msg + pre-commit + pre-push）。
+ * 代码仓不落 skywalk-sdd/，shell hook 远程引用 spec 仓 skywalk-sdd/git-hooks/ 下的 .cjs 脚本。
  */
 function attachCodeRepoLite(codeRepoRoot, specRepoRoot, options = {}) {
   const cwd = path.resolve(codeRepoRoot);
@@ -1055,7 +1090,7 @@ function attachCodeRepoLite(codeRepoRoot, specRepoRoot, options = {}) {
     return { ok: false, repo: label, message: `spec 路径不是 Git 仓库: ${specRoot}` };
   }
 
-  console.log(`🔗 轻量接入代码仓（无 skywalk-sdd/、无 skills）: ${label}`);
+  console.log(`🔗 轻量接入代码仓（commit-msg + pre-commit + pre-push）: ${label}`);
 
   const remote = sddConfig.gitRemoteUrl(specRoot) || 'git@gitlab.example.com:biz/xxx-sdd-specs.git';
   const sddYamlPath = path.join(cwd, '.sdd.yaml');
@@ -1081,8 +1116,8 @@ function attachCodeRepoLite(codeRepoRoot, specRepoRoot, options = {}) {
   }
   console.log(`   ✓ sdd.specPath = ${linked.path}`);
 
-  installCodeRepoCommitMsgHook(cwd, specRoot, options);
-  console.log('   ✓ commit-msg → spec 仓 skywalk-sdd/git-hooks/（代码仓不落 skywalk-sdd/）');
+  // 部署代码仓全部 Git hooks（commit-msg + pre-commit + pre-push）
+  deployCodeRepoHooks(cwd, specRoot, options);
 
   return { ok: true, repo: label, path: cwd, specPath: linked.path };
 }
@@ -1555,8 +1590,9 @@ async function main() {
         removeOuterSkywalk(workspaceRoot);
 
         deployMonoSddYaml(workspaceRoot, { specPathRelative: specPackage.name });
-        // Hook 装在 Git 根，脚本在包裹包内（Git 根不落 skywalk-sdd/）
-        installCodeRepoCommitMsgHook(workspaceRoot, specPackage.abs);
+        // 部署代码仓全部 Git hooks（commit-msg + pre-commit + pre-push）
+        // 单仓 mono：hook 通过 .sdd-spec-root 定位包裹包的 skywalk-sdd/git-hooks/
+        deployCodeRepoHooks(workspaceRoot, specPackage.abs);
         const linked = sddConfig.setSpecPath(workspaceRoot, specPackage.abs, {
           allowNestedPackage: true,
         });
@@ -1649,7 +1685,7 @@ async function main() {
     console.log('  📌 .sdd-spec-root → 包裹包；无根目录 skywalk-sdd/');
   }
   if (selectedTools.includes('kunlunzhima')) {
-    console.log('  📎 .kunlunzhima/commands/opsx/    # KunlunZhima OPSX command bridge（11 个）');
+    console.log('  📎 .kunlunzhima/commands/opsx/    # KunlunZhima OPSX command bridge（12 个）');
     console.log('  ℹ️  KunlunZhima 通过 commands/skills 入口使用 SDD，未启用自动 Hook');
   }
   if (selectedTools.includes('codebuddy')) {
@@ -1661,18 +1697,19 @@ async function main() {
   console.log();
   
   // 统一的 skill 格式说明
-  console.log('可用 skills（opsx-* 系列，11 个 SDD skills）:');
-  console.log('  opsx-propose   - 创建业务意图文档（Why）');
-  console.log('  opsx-spec      - 创建技术契约文档（What）');
-  console.log('  opsx-design    - 创建技术实现方案（How）');
-  console.log('  opsx-task      - 拆解AI编码任务（Do）');
-  console.log('  opsx-check     - 质量门禁检查（Verify）');
-  console.log('  opsx-apply     - 申请变更实施（Apply）');
-  console.log('  opsx-test      - 执行单元测试（Test）');
-  console.log('  opsx-archive   - 归档变更（Archive）');
-  console.log('  opsx-explore   - 浏览变更状态（Explore）');
-  console.log('  opsx-knowledge - 业务知识库检索（辅助）');
-  console.log('  opsx-rules     - 生成/更新 Agent 规则（辅助）');
+  console.log('可用 skills（opsx-* 系列，14 个 SDD skills）:');
+  console.log('  opsx-propose           - 创建业务意图文档（Why）');
+  console.log('  opsx-spec              - 创建技术契约文档（What）');
+  console.log('  opsx-design            - 创建技术实现方案（How）');
+  console.log('  opsx-task              - 拆解AI编码任务（Do）');
+  console.log('  opsx-check             - 质量门禁检查（Verify）');
+  console.log('  opsx-apply             - 申请变更实施（Apply）');
+  console.log('  opsx-test              - 执行单元测试（Test）');
+  console.log('  opsx-archive           - 归档变更（Archive）');
+  console.log('  opsx-explore           - 浏览变更状态（Explore）');
+  console.log('  opsx-knowledge         - 业务知识库检索（辅助）');
+  console.log('  opsx-rules             - 生成/更新 Agent 规则（辅助）');
+  console.log('  opsx-consistency-check - Spec 一致性校验（代码 vs spec）');
     
   console.log();
   console.log('后续步骤:');
@@ -1729,5 +1766,7 @@ module.exports = {
   syncWorkspaceRepos,
   copyDirRendered,
   parseSelectedTools,
+  installSddShellHook,
+  deployCodeRepoHooks,
   TOOL_CONFIGS,
 };

package/lib/skills-bundle.js

@@ -22,6 +22,8 @@ const OPSX_SKILL_DIRS = [
   // Engineering KB 依赖技能（随 init 部署；propose/spec/archive 硬依赖）
   'opsx-ontology-query',
   'opsx-kb-ingest',
+  // Spec 一致性校验技能
+  'opsx-consistency-check',
 ];
 
 const PKG_ROOT = path.resolve(__dirname, '..');
@@ -102,6 +104,7 @@ const KUNLUN_SLASH_COMMANDS = [
   'explore',
   'ontology-query',
   'kb-ingest',
+  'consistency-check',
 ];
 
 function transformKunlunSlashCommands(content) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kld-sdd",
-  "version": "2.6.15",
+  "version": "2.6.16",
   "description": "KLD SDD OpenSpec 项目初始化工具 - 一键部署 SDD skills",
   "main": "index.js",
   "bin": {
@@ -36,6 +36,7 @@
     "skywalk-sdd/runtime-metadata.cjs",
     "skywalk-sdd/reporting/",
     "skywalk-sdd/context-client.cjs",
+    "skywalk-sdd/openspec-shim.cjs",
     "skywalk-sdd/ontology/",
     "skywalk-sdd/apply-worktree-finish.cjs",
     "README.md"

package/skywalk-sdd/openspec-shim.cjs

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * openspec-shim.cjs — 自动定位 spec 包并透传 openspec 命令。
+ *
+ * 用法: node skywalk-sdd/openspec-shim.cjs <openspec-args>
+ * 示例: node skywalk-sdd/openspec-shim.cjs list
+ *       node skywalk-sdd/openspec-shim.cjs add change my-feature
+ *
+ * 自动通过 resolve-spec-root.cjs 定位 spec 包目录，
+ * 然后在该目录下执行 openspec 命令。
+ */
+
+const { resolveSpecProjectRoot } = require('./ontology/resolve-spec-root.cjs');
+
+const args = process.argv.slice(2);
+
+if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+  console.log('用法: node skywalk-sdd/openspec-shim.cjs <openspec-args>');
+  console.log('示例: node skywalk-sdd/openspec-shim.cjs list');
+  console.log('      node skywalk-sdd/openspec-shim.cjs add change my-feature');
+  process.exit(0);
+}
+
+const projectRoot = process.cwd();
+const specRoot = resolveSpecProjectRoot(projectRoot);
+
+if (specRoot === projectRoot) {
+  console.error('⚠️  未找到 spec 包目录（未配置 .sdd-spec-root，也未检测到 *-sdd-specs 仓库）');
+  console.error('    配置方式: 在项目根目录创建 .sdd-spec-root 文件，写入 spec 包相对或绝对路径');
+  console.error('    或使用: kld-sdd link-spec --path=<spec-clone>');
+  process.exit(1);
+}
+
+const { execSync } = require('child_process');
+const openspecArgs = args.map(a => `"${a.replace(/"/g, '\\"')}"`).join(' ');
+const cmd = `openspec ${openspecArgs}`;
+
+try {
+  execSync(cmd, { cwd: specRoot, stdio: 'inherit' });
+} catch (err) {
+  if (err.status) {
+    process.exit(err.status);
+  }
+  console.error(`❌ openspec 执行失败: ${err.message}`);
+  process.exit(1);
+}

package/templates/git-hooks/commit-msg

@@ -0,0 +1,46 @@
+#!/bin/sh
+# KLD SDD Commit-MSG Hook
+# 自动查找 commit-msg-sdd-trailer.cjs，兼容单仓库/多仓库/单仓mono布局
+# marker: KLD SDD quality gate
+
+# 从 hook 所在目录推算 git 根目录
+hook_dir="$(cd "$(dirname "$0")" && pwd)"
+git_dir="$(dirname "$hook_dir")"
+git_root="$(dirname "$git_dir")"
+
+script=""
+
+# 方法1: git config sdd.specPath（多仓布局：spec 是独立 clone）
+spec_path=$(git config --local sdd.specPath 2>/dev/null)
+if [ -n "$spec_path" ] && [ -f "$spec_path/skywalk-sdd/git-hooks/commit-msg-sdd-trailer.cjs" ]; then
+  script="$spec_path/skywalk-sdd/git-hooks/commit-msg-sdd-trailer.cjs"
+fi
+
+# 方法2: .sdd-spec-root（单仓 mono 布局：skywalk-sdd 在 spec 包裹包子目录内）
+if [ -z "$script" ] && [ -f "$git_root/.sdd-spec-root" ]; then
+  spec_rel=$(cat "$git_root/.sdd-spec-root" | head -1 | tr -d '[:space:]')
+  if [ -n "$spec_rel" ] && [ -f "$git_root/$spec_rel/skywalk-sdd/git-hooks/commit-msg-sdd-trailer.cjs" ]; then
+    script="$git_root/$spec_rel/skywalk-sdd/git-hooks/commit-msg-sdd-trailer.cjs"
+  fi
+fi
+
+# 方法3: 从 git 根向上搜索 skywalk-sdd/git-hooks（spec 仓本身或父级）
+if [ -z "$script" ]; then
+  search_dir="$git_root"
+  while [ "$search_dir" != "/" ] && [ "$search_dir" != "" ]; do
+    if [ -f "$search_dir/skywalk-sdd/git-hooks/commit-msg-sdd-trailer.cjs" ]; then
+      script="$search_dir/skywalk-sdd/git-hooks/commit-msg-sdd-trailer.cjs"
+      break
+    fi
+    search_dir="$(dirname "$search_dir")"
+  done
+fi
+
+if [ -z "$script" ]; then
+  echo "[SDD] 未找到 commit-msg-sdd-trailer.cjs，跳过 commit-msg trailer"
+  exit 0
+fi
+
+# $1 = Git 传入的 commit message 文件路径
+# --project 告诉 .cjs 脚本代码仓根目录（用于解析 spec 布局）
+node "$script" "$1" --project="$git_root"

package/templates/git-hooks/pre-commit

@@ -0,0 +1,57 @@
+#!/bin/sh
+# KLD SDD Pre-Commit Hook
+# 远程引用 spec 仓 skywalk-sdd/git-hooks/ 下的 .cjs 脚本
+# 兼容单仓库/多仓库/单仓mono布局
+# marker: KLD SDD quality gate
+
+# 从 hook 所在目录推算 git 根目录
+hook_dir="$(cd "$(dirname "$0")" && pwd)"
+git_dir="$(dirname "$hook_dir")"
+git_root="$(dirname "$git_dir")"
+
+hooks_dir=""
+
+# 方法1: git config sdd.specPath（多仓布局：spec 是独立 clone）
+spec_path=$(git config --local sdd.specPath 2>/dev/null)
+if [ -n "$spec_path" ] && [ -d "$spec_path/skywalk-sdd/git-hooks" ]; then
+  hooks_dir="$spec_path/skywalk-sdd/git-hooks"
+fi
+
+# 方法2: .sdd-spec-root（单仓 mono 布局：skywalk-sdd 在 spec 包裹包子目录内）
+if [ -z "$hooks_dir" ] && [ -f "$git_root/.sdd-spec-root" ]; then
+  spec_rel=$(cat "$git_root/.sdd-spec-root" | head -1 | tr -d '[:space:]')
+  if [ -n "$spec_rel" ] && [ -d "$git_root/$spec_rel/skywalk-sdd/git-hooks" ]; then
+    hooks_dir="$git_root/$spec_rel/skywalk-sdd/git-hooks"
+  fi
+fi
+
+# 方法3: 从 git 根向上搜索 skywalk-sdd/git-hooks（spec 仓本身或父级）
+if [ -z "$hooks_dir" ]; then
+  search_dir="$git_root"
+  while [ "$search_dir" != "/" ] && [ "$search_dir" != "" ]; do
+    if [ -d "$search_dir/skywalk-sdd/git-hooks" ]; then
+      hooks_dir="$search_dir/skywalk-sdd/git-hooks"
+      break
+    fi
+    search_dir="$(dirname "$search_dir")"
+  done
+fi
+
+if [ -z "$hooks_dir" ]; then
+  echo "[SDD] 未找到 spec 仓的 skywalk-sdd/git-hooks 目录，跳过 pre-commit 检查"
+  exit 0
+fi
+
+echo "[SDD] 执行提交前检查..."
+
+# 1. tasks.md 完成度检查
+if [ -f "$hooks_dir/pre-commit-sdd-check.cjs" ]; then
+  node "$hooks_dir/pre-commit-sdd-check.cjs" --project="$git_root" "$@" || exit 1
+fi
+
+# 2. 代码-spec 一致性检查
+if [ -f "$hooks_dir/pre-commit-consistency-check.cjs" ]; then
+  node "$hooks_dir/pre-commit-consistency-check.cjs" --project="$git_root" "$@" || exit 1
+fi
+
+echo "[SDD] ✅ 所有 pre-commit 检查通过"

package/templates/git-hooks/pre-commit-consistency-check.cjs

@@ -0,0 +1,193 @@
+#!/usr/bin/env node
+/**
+ * pre-commit-consistency-check.cjs
+ *
+ * Pre-commit 门禁：检查活跃变更的 Spec 一致性校验报告。
+ * 若 confidence=low 则阻止提交；缺少报告则警告但放行（向后兼容）。
+ *
+ * 用法: node pre-commit-consistency-check.cjs --project=<project-root> [--change=<change-name>]
+ */
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+function readArg(name) {
+  const prefix = `--${name}=`;
+  const found = process.argv.find(arg => arg.startsWith(prefix));
+  return found ? found.slice(prefix.length) : '';
+}
+
+function hasFlag(name) {
+  return process.argv.includes(`--${name}`);
+}
+
+/**
+ * 从 .sdd-spec-root 文件读取 spec 包裹包相对路径（单仓 mono 布局）
+ */
+function resolveSpecRoot(projectRoot) {
+  // 1. 检查 .sdd-spec-root（单仓 mono 模式）
+  const hintPath = path.join(projectRoot, '.sdd-spec-root');
+  if (fs.existsSync(hintPath)) {
+    const rel = fs.readFileSync(hintPath, 'utf8').trim();
+    if (rel) {
+      const specAbs = path.resolve(projectRoot, rel);
+      if (fs.existsSync(specAbs)) {
+        return specAbs;
+      }
+    }
+  }
+
+  // 2. 查找 *-sdd-specs 子目录（多仓工作区模式）
+  const entries = fs.existsSync(projectRoot) ? fs.readdirSync(projectRoot) : [];
+  for (const name of entries) {
+    if (/-sdd-specs$/i.test(name)) {
+      const candidate = path.join(projectRoot, name);
+      if (fs.statSync(candidate).isDirectory() && fs.existsSync(path.join(candidate, 'openspec'))) {
+        return candidate;
+      }
+    }
+  }
+
+  // 3. 项目根本身就是 spec 仓
+  if (fs.existsSync(path.join(projectRoot, 'openspec', 'changes'))) {
+    return projectRoot;
+  }
+
+  return null;
+}
+
+/**
+ * 发现活跃变更列表
+ */
+function discoverActiveChanges(specRoot, explicitChange) {
+  if (explicitChange) {
+    return [explicitChange];
+  }
+
+  const changesDir = path.join(specRoot, 'openspec', 'changes');
+  if (!fs.existsSync(changesDir)) {
+    return [];
+  }
+
+  return fs.readdirSync(changesDir)
+    .filter(name => {
+      const fullPath = path.join(changesDir, name);
+      return fs.statSync(fullPath).isDirectory()
+        && !name.startsWith('.')
+        && name !== 'archive';
+    });
+}
+
+/**
+ * 查找变更的一致性报告 JSON
+ */
+function findConsistencyReport(specRoot, changeName) {
+  const patterns = [
+    'consistency-report-result.json',
+    'consistency-report-self-review-result.json',
+  ];
+
+  for (const pattern of patterns) {
+    const reportPath = path.join(specRoot, 'openspec', 'changes', changeName, pattern);
+    if (fs.existsSync(reportPath)) {
+      return reportPath;
+    }
+  }
+
+  return null;
+}
+
+/**
+ * 解析一致性报告，返回置信度
+ */
+function parseReport(reportPath) {
+  try {
+    const content = fs.readFileSync(reportPath, 'utf8');
+    const data = JSON.parse(content);
+    return {
+      confidence: (data.confidence || '').toLowerCase(),
+      overallResult: (data.overallResult || '').toLowerCase(),
+      changeName: data.changeName || '',
+      reportPath,
+    };
+  } catch (err) {
+    return { confidence: '', overallResult: '', changeName: '', reportPath, parseError: err.message };
+  }
+}
+
+function main() {
+  const projectRoot = path.resolve(readArg('project') || process.env.SDD_PROJECT || process.cwd());
+  const explicitChange = readArg('change') || process.env.SDD_CHANGE || process.env.OPENSPEC_CHANGE || '';
+  const strictMode = hasFlag('strict') || process.env.SDD_STRICT_CONSISTENCY === '1';
+
+  const specRoot = resolveSpecRoot(projectRoot);
+  if (!specRoot) {
+    console.log('SDD consistency-check: 未找到 spec 仓库，跳过一致性校验');
+    return;
+  }
+
+  const changes = discoverActiveChanges(specRoot, explicitChange);
+  if (changes.length === 0) {
+    console.log('SDD consistency-check: 无活跃变更，跳过一致性校验');
+    return;
+  }
+
+  const blockers = [];
+  const missing = [];
+  const passed = [];
+
+  for (const changeName of changes) {
+    const reportPath = findConsistencyReport(specRoot, changeName);
+    if (!reportPath) {
+      missing.push(changeName);
+      continue;
+    }
+
+    const report = parseReport(reportPath);
+    if (report.parseError) {
+      console.warn(`SDD consistency-check: ⚠️  ${changeName} 报告解析失败: ${report.parseError}`);
+      missing.push(changeName);
+      continue;
+    }
+
+    if (report.confidence === 'low' || report.overallResult === 'fail') {
+      blockers.push({ changeName, report });
+    } else {
+      passed.push({ changeName, report });
+    }
+  }
+
+  // 输出摘要
+  if (passed.length > 0) {
+    for (const item of passed) {
+      console.log(`SDD consistency-check: ✅ ${item.changeName} 置信度=${item.report.confidence}`);
+    }
+  }
+
+  if (missing.length > 0) {
+    console.warn(`SDD consistency-check: ⚠️  以下变更缺少一致性校验报告（允许提交，建议执行 opsx-consistency-check）:`);
+    for (const name of missing) {
+      console.warn(`  - ${name}`);
+    }
+  }
+
+  if (blockers.length > 0) {
+    console.error(`SDD consistency-check: ❌ 以下变更的一致性校验未通过（confidence=low），阻止提交:`);
+    for (const item of blockers) {
+      console.error(`  - ${item.changeName} (confidence=${item.report.confidence}, result=${item.report.overallResult})`);
+      console.error(`    报告路径: ${item.report.reportPath}`);
+    }
+    console.error('');
+    console.error('请修复不一致项后重新执行 opsx-consistency-check，或使用 --no-verify 跳过（不推荐）。');
+    process.exit(1);
+  }
+
+  if (strictMode && missing.length > 0) {
+    console.error('SDD consistency-check: ❌ strict 模式已启用，缺少报告的变更不允许提交。');
+    process.exit(1);
+  }
+}
+
+main();