kld-sdd 2.6.21 → 2.7.8

package/templates/git-hooks/pre-push

@@ -1,28 +1,27 @@
 #!/bin/sh
 # KLD SDD Pre-Push Hook
-# 远程引用 spec 仓 skywalk-sdd/git-hooks/ 下的 .cjs 脚本
-# 兼容单仓库/多仓库/单仓mono布局
+# 在下方 SCRIPTS 列表中声明要加载的 .cjs 脚本
+# 删除某行 = 禁用该插件
 # marker: KLD SDD quality gate
 
-# 从 hook 所在目录推算 git 根目录
-hook_dir="$(cd "$(dirname "$0")" && pwd)"
-git_dir="$(dirname "$hook_dir")"
-git_root="$(dirname "$git_dir")"
-
+# Git supplies the working tree context; this also supports worktrees and core.hooksPath.
+git_root=$(git rev-parse --show-toplevel 2>/dev/null) || {
+  echo "[SDD] 无法定位当前 Git 工作区"
+  exit 1
+}
 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
+spec_path=$(git -C "$git_root" config --local sdd.specPath 2>/dev/null)
+if [ -n "$spec_path" ]; then
+  case "$spec_path" in /*) ;; *) spec_path="$git_root/$spec_path" ;; esac
   hooks_dir="$spec_path/skywalk-sdd/git-hooks"
+elif [ -f "$git_root/.sdd-spec-root" ]; then
+  spec_rel=$(head -1 "$git_root/.sdd-spec-root" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+  case "$spec_rel" in /*) hooks_dir="$spec_rel/skywalk-sdd/git-hooks" ;; *) hooks_dir="$git_root/$spec_rel/skywalk-sdd/git-hooks" ;; esac
 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
+if [ -n "$hooks_dir" ] && [ ! -d "$hooks_dir" ]; then
+  echo "[SDD] 已配置的 Spec 路径失效：$hooks_dir"
+  echo "[SDD] 请恢复 Spec 仓，或修正 sdd.specPath / .sdd-spec-root 后重试"
+  exit 1
 fi
 
 # 方法3: 从 git 根向上搜索 skywalk-sdd/git-hooks（spec 仓本身或父级）
@@ -38,20 +37,64 @@ if [ -z "$hooks_dir" ]; then
 fi
 
 if [ -z "$hooks_dir" ]; then
-  echo "[SDD] 未找到 spec 仓的 skywalk-sdd/git-hooks 目录，跳过 pre-push 检查"
+  echo "[SDD] 未找到 spec 仓的 skywalk-sdd/git-hooks 目录，跳过 pre-push"
   exit 0
 fi
 
 echo "[SDD] 执行推送前检查..."
 
-# 1. doctor 质量门禁检查
-if [ -f "$hooks_dir/pre-push-sdd-check.cjs" ]; then
-  node "$hooks_dir/pre-push-sdd-check.cjs" --project="$git_root" "$@" || exit 1
-fi
+# 保存 pre-push stdin（Git 标准输入：local_ref local_sha remote_ref remote_sha）
+# 供下游 .cjs 读取本次 push 的 commit 范围
+SDD_PRE_PUSH_REFS=""
+while IFS= read -r line; do
+  SDD_PRE_PUSH_REFS="${SDD_PRE_PUSH_REFS}${line}\n"
+done
+export SDD_PRE_PUSH_REFS
 
-# 2. 代码-spec 一致性检查（推送前更严格）
-if [ -f "$hooks_dir/pre-push-consistency-check.cjs" ]; then
-  node "$hooks_dir/pre-push-consistency-check.cjs" --project="$git_root" "$@" || exit 1
+# 从配置文件读取插件列表
+config_file="$hooks_dir/hooks.config"
+if [ ! -f "$config_file" ]; then
+  echo "[SDD] ⚠️  配置文件不存在：hooks.config，使用默认插件"
+  SCRIPTS="pre-push-sdd-check.cjs pre-push-consistency-check.cjs"
+else
+  # 读取 [pre-push] 段落的配置
+  in_section=0
+  SCRIPTS=""
+  CR=$(printf '\r')
+  while IFS= read -r line; do
+    line=${line%"$CR"}
+    case "$line" in
+      "[pre-push]") in_section=1 ;;
+      "["*) in_section=0 ;;
+      "#"*|"") ;;
+      *)
+        if [ "$in_section" -eq 1 ]; then
+          SCRIPTS="$SCRIPTS $line"
+        fi
+        ;;
+    esac
+  done < "$config_file"
 fi
 
-echo "[SDD] ✅ 所有 pre-push 检查通过"
+executed=0
+failed=0
+for script_name in $SCRIPTS; do
+  script="$hooks_dir/$script_name"
+  if [ ! -f "$script" ]; then
+    echo "[SDD] ❌ 已配置的插件不存在：$script_name"
+    failed=$((failed + 1))
+    continue
+  fi
+  executed=$((executed + 1))
+  echo "[SDD] 执行 pre-push 插件：$script_name"
+  node "$script" --project="$git_root" "$@" || failed=$((failed + 1))
+done
+
+if [ "$failed" -gt 0 ]; then
+  echo "[SDD] ❌ 共执行 $executed 个 pre-push 插件，$failed 个失败"
+  exit 1
+elif [ "$executed" -eq 0 ]; then
+  echo "[SDD] 配置已禁用 pre-push 插件"
+else
+  echo "[SDD] ✅ 共执行 $executed 个 pre-push 插件，全部通过"
+fi

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

@@ -2,325 +2,87 @@
 /**
  * pre-push-consistency-check.cjs
  *
- * Pre-push 轻量门禁：仅检查报告是否存在、是否过期。
- * 完整的置信度校验由 pre-commit 完成，push 阶段不再重复。
+ * Pre-push 轻量门禁：仅检查待推送范围涉及报告的存在性、是否过期。
+ * - diff 驱动：仅检查待推送文件与报告 coveredFiles 有交集的 change，无关 change 跳过
+ * - 完整的置信度校验由 pre-commit 完成，push 阶段不再重复。
+ * - 过期判断读取 HEAD 已提交内容（而非工作区），避免工作区未提交修改造成误判。
+ *
+ * 待推送范围采集（逐级降级）：
+ *   1. git diff @{push}..HEAD（本地领先远程的提交）
+ *   2. git diff origin/HEAD..HEAD
+ *   3. 远程引用不存在（新分支/新仓库首次推送）：git diff <空树>..HEAD，
+ *      语义 = 首推时 HEAD 全部文件都是新增。空树 SHA 是 git 内置常量，
+ *      不依赖任何远程引用，避免「首推因无远程引用被拦 → 引用永远建立不起来」的死锁
+ *   4. 连空树 diff 都失败（如空仓无 HEAD）：返回 ok=false，由 core 拦截推送而非静默放行
  *
  * 通过环境变量控制：
  * - SDD_SKIP_CONSISTENCY_CHECK=1 → 跳过校验
  * - SDD_WARN_ONLY=1 → 仅告警不拦截
  * - 注意：两个环境变量互斥，只能启用一个
+ *
+ * 共享逻辑见同目录 consistency-check-core.cjs。
  */
 'use strict';
 
-const fs = require('fs');
-const path = require('path');
+const core = require('./consistency-check-core.cjs');
+const { gitDiffNameStatus } = core;
 const { execFileSync } = require('child_process');
 
-const readArg = (name) => {
-  const prefix = `--${name}=`;
-  const found = process.argv.find(a => a.startsWith(prefix));
-  return found ? found.slice(prefix.length) : '';
-};
-
-// --- Spec 根路径解析 ---
-
-function resolveSpecRoot() {
-  // .cjs 位于 <spec-root>/skywalk-sdd/git-hooks/，直接用 __dirname 推算
-  return path.resolve(__dirname, '..', '..');
-}
-
-function discoverActiveChanges(specRoot) {
-  const changesDir = path.join(specRoot, 'openspec', 'changes');
-  if (!fs.existsSync(changesDir)) return [];
-
-  return fs.readdirSync(changesDir).filter(name => {
-    const p = path.join(changesDir, name);
-    return fs.statSync(p).isDirectory() && !name.startsWith('.') && name !== 'archive';
-  });
-}
-
-// --- 报告查找与解析 ---
-
-function findReport(specRoot, changeName, type) {
-  const names = type === 'json'
-    ? ['consistency-report-result.json', 'consistency-report-self-review-result.json']
-    : ['consistency-report.md', 'consistency-report-self-review.md'];
-
-  const found = [];
-  for (const n of names) {
-    const p = path.join(specRoot, 'openspec', 'changes', changeName, n);
-    if (fs.existsSync(p)) found.push(p);
-  }
-
-  // 如果两种模式的报告都存在，返回错误标记
-  if (found.length > 1) {
-    return { error: 'duplicate', paths: found };
-  }
-
-  return found.length === 1 ? found[0] : null;
-}
-
-function parseReport(reportPath) {
-  try {
-    const data = JSON.parse(fs.readFileSync(reportPath, 'utf8'));
-    return {
-      confidence: (data.confidence || '').toLowerCase(),
-      reviewMode: data.reviewMode || 'independent-review',
-      humanConfirmed: data.humanConfirmed === true,
-      reportPath,
-    };
-  } catch (err) {
-    return { confidence: '', reviewMode: '', humanConfirmed: false, reportPath, parseError: err.message };
-  }
-}
-
-// --- 变更文件采集（基于配置文件精准定位） ---
+// git 内置空树对象 SHA（SHA-1 仓库恒定不变）
+const EMPTY_TREE_SHA = '4b825dc642cb6eb9a060e54bf8d69288fbee4904';
 
 /**
- * 简易 YAML 解析器：仅提取 code_repos 列表
+ * 单仓待推送范围采集：本地领先远程的提交所涉及的文件。
+ * files=修改/新增（排除删除）；deleted=删除文件。
+ * @returns {{files: string[], deleted: string[], ok: boolean}}
  */
-function parseCodeRepos(yamlPath) {
-  try {
-    const content = fs.readFileSync(yamlPath, 'utf8');
-    const match = content.match(/code_repos:\s*\n((?:\s+-\s+\S+\n?)+)/);
-    if (!match) return null;
-    return match[1]
-      .split('\n')
-      .map(line => line.replace(/^\s+-\s+/, '').trim())
-      .filter(Boolean);
-  } catch {
-    return null;
-  }
-}
-
-function gitDiff(repoRoot) {
-  try {
-    return execFileSync('git', ['diff', 'HEAD', '--name-only'], {
-      cwd: repoRoot, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'],
-    }).split(/\r?\n/).filter(Boolean);
-  } catch {
-    return [];
-  }
-}
-
-function getModifiedFiles(projectRoot) {
-  // 工作区模式：读 .sdd-workspace.yaml 的 code_repos
-  const wsYaml = path.join(projectRoot, '.sdd-workspace.yaml');
-  if (fs.existsSync(wsYaml)) {
-    const repos = parseCodeRepos(wsYaml);
-    if (repos && repos.length > 0) {
-      const files = [];
-      for (const repo of repos) {
-        const repoRoot = path.join(projectRoot, repo);
-        for (const f of gitDiff(repoRoot)) {
-          files.push(path.join(repo, f).replace(/\\/g, '/'));
-        }
-      }
-      return [...new Set(files)];
-    }
-  }
-
-  // 单仓模式 / 兜底：直接对 projectRoot 做 diff
-  return gitDiff(projectRoot);
+function gitPushRangeDiff(repoRoot) {
+  const ranges = ['@{push}..HEAD', 'origin/HEAD..HEAD'];
+  for (const range of ranges) {
+    const r = gitDiffNameStatus(repoRoot, ['diff', range]);
+    if (r.ok) return r;
+  }
+  // 首推降级：远程引用不存在（@{push}/origin/HEAD 均无法解析）时，
+  // 用 git 内置空树 SHA 做 diff —— 语义为「首推 = HEAD 全部文件都是新增」。
+  // 空树对象不依赖任何远程引用，打破「首推被拦 → 远程引用永远建立不起来」的死锁。
+  const emptyTree = gitEmptyTreeSha(repoRoot);
+  if (emptyTree) {
+    const r = gitDiffNameStatus(repoRoot, ['diff', `${emptyTree}..HEAD`]);
+    if (r.ok) return r;
+  }
+  // 连空树 diff 都失败（如空仓无 HEAD）：返回失败，由 core 拦截而非静默放行
+  return { files: [], deleted: [], ok: false };
 }
 
 /**
- * 获取报告生成时间：优先用 JSON 中的 generatedAt，降级用文件 mtime
+ * 读取 git 内置空树 SHA（4b825dc642cb6eb9a060e54bf8d69288fbee4904）。
+ * 优先用 git mktree 动态计算（兼容 SHA-256 仓库），失败时回退内置常量。
+ * @param {string} repoRoot
+ * @returns {string|null}
  */
-function getReportTime(jsonPath) {
+function gitEmptyTreeSha(repoRoot) {
   try {
-    const data = JSON.parse(fs.readFileSync(jsonPath, 'utf8'));
-    if (data.generatedAt) {
-      const t = new Date(data.generatedAt).getTime();
-      if (!isNaN(t)) return t;
-    }
-  } catch {}
-  // 降级：用文件 mtime
-  return fs.statSync(jsonPath).mtimeMs;
-}
-
-function isReportStale(specRoot, changeName, modifiedFiles, projectRoot) {
-  const jsonPath = findReport(specRoot, changeName, 'json');
-  if (!jsonPath) return false;
-
-  const reportTime = getReportTime(jsonPath);
-
-  // 排除报告文件本身
-  const reportFiles = [
-    'consistency-report.md',
-    'consistency-report-self-review.md',
-    'consistency-report-result.json',
-    'consistency-report-self-review-result.json',
-  ];
-
-  return modifiedFiles.some(file => {
-    if (reportFiles.includes(path.basename(file))) return false;
-    const fp = path.join(projectRoot, file);
-    return fs.existsSync(fp) && fs.statSync(fp).mtimeMs > reportTime;
-  });
-}
-
-// --- 提示信息 ---
-
-function generateInstructions(missing, stale, needsConfirmation, warnOnly) {
-  const lines = ['', '=========================================='];
-  const needsRegenerate = [...new Set([...missing, ...stale])];
-
-  if (warnOnly) {
-    lines.push('[SDD push-consistency-check] ⚠️  仅告警模式（SDD_WARN_ONLY=1），以下问题不会阻止推送：');
-  } else {
-    lines.push('[SDD push-consistency-check] 以下变更存在问题，拒绝推送：');
-  }
-
-  lines.push('');
-
-  if (missing.length) {
-    lines.push('  缺少一致性报告：');
-    missing.forEach(c => lines.push(`    - ${c}`));
-  }
-
-  if (stale.length) {
-    lines.push('  报告已过期（代码在报告生成后被修改）：');
-    stale.forEach(c => lines.push(`    - ${c}`));
-  }
-
-  if (needsConfirmation.length) {
-    lines.push('  自审模式需人工确认：');
-    needsConfirmation.forEach(c => lines.push(`    - ${c}`));
-  }
-
-  // 只有需要重新生成报告时才显示 skill 执行建议
-  if (needsRegenerate.length > 0) {
-    lines.push('');
-    lines.push(warnOnly
-      ? '建议执行 opsx-consistency-check skill 更新报告：'
-      : '请执行 opsx-consistency-check skill 更新报告后再推送：');
-    lines.push('');
-
-    if (needsRegenerate.length === 1) {
-      lines.push(`  skill: opsx-consistency-check ${needsRegenerate[0]}`);
-    } else {
-      lines.push('  skill（逐个执行）：');
-      needsRegenerate.forEach(c => lines.push(`    opsx-consistency-check ${c}`));
-    }
-
-    lines.push(
-      '',
-      '  💡 建议：新开对话窗口执行校验，以获得独立、客观的审核结果',
-    );
-  }
-
-  // 自审模式人工确认指引
-  if (needsConfirmation.length > 0) {
-    lines.push('');
-    lines.push('  人工确认步骤：');
-    lines.push('  1. 打开 consistency-report-self-review.md，找到「人工确认（自审模式）」章节');
-    lines.push('  2. 逐条核对断言，在「人工确认」列填写 ✅ 已确认 或 ❌ 有误');
-    lines.push('  3. 确认无误后，编辑 consistency-report-self-review-result.json，将 humanConfirmed 从 false 改为 true');
-    lines.push('');
-    lines.push('  报告路径: openspec/changes/<change-name>/consistency-report-self-review.md');
-    lines.push('  JSON 路径: openspec/changes/<change-name>/consistency-report-self-review-result.json');
-  }
-
-  // 如果没有需要重新生成的报告，但有其他问题，显示默认报告路径
-  if (needsRegenerate.length > 0 && needsConfirmation.length === 0) {
-    lines.push(
-      '',
-      '  报告路径: openspec/changes/<change-name>/consistency-report.md',
-      '  JSON 路径: openspec/changes/<change-name>/consistency-report-result.json',
-    );
+    const sha = execFileSync('git', ['mktree'], {
+      cwd: repoRoot, encoding: 'utf8', input: '', stdio: ['pipe', 'pipe', 'ignore'],
+    }).trim();
+    if (/^[0-9a-f]{40,64}$/.test(sha)) return sha;
+  } catch {
+    // 降级到内置常量
   }
-
-  lines.push('==========================================', '');
-
-  return lines.join('\n');
+  return /^[0-9a-f]{40}$/.test(EMPTY_TREE_SHA) ? EMPTY_TREE_SHA : null;
 }
 
-// --- 主流程 ---
-
-function main() {
-  const projectRoot = path.resolve(readArg('project') || process.env.SDD_PROJECT || process.cwd());
-
-  const skip = process.env.SDD_SKIP_CONSISTENCY_CHECK === '1';
-  const warnOnly = process.env.SDD_WARN_ONLY === '1';
-
-  // 互斥检查
-  if (skip && warnOnly) {
-    console.error('[SDD push-consistency-check] 错误：SDD_SKIP_CONSISTENCY_CHECK 与 SDD_WARN_ONLY 互斥，只能启用一个');
-    process.exit(1);
-  }
-
-  if (skip) {
-    console.log('[SDD push-consistency-check] 跳过校验');
-    process.exit(0);
-  }
-
-  if (warnOnly) console.log('[SDD push-consistency-check] 仅告警模式');
-
-  const specRoot = resolveSpecRoot();
-
-  const changes = discoverActiveChanges(specRoot);
-  if (!changes.length) {
-    console.log('[SDD push-consistency-check] 无活跃变更，跳过');
-    process.exit(0);
-  }
-
-  const modifiedFiles = getModifiedFiles(projectRoot);
-  const missing = [];
-  const stale = [];
-  const needsConfirmation = [];
-
-  for (const cn of changes) {
-    const rp = findReport(specRoot, cn, 'json');
-    if (!rp) {
-      missing.push(cn);
-      continue;
-    }
-
-    // 检查是否存在两种模式的报告
-    if (rp.error === 'duplicate') {
-      console.warn(`[SDD push-consistency-check] ⚠️  ${cn} 存在两种模式的报告，请删除其中一个：`);
-      rp.paths.forEach(p => console.warn(`    - ${p}`));
-      missing.push(cn);
-      continue;
-    }
-
-    const report = parseReport(rp);
-    if (report.parseError) {
-      console.warn(`[SDD push-consistency-check] ⚠️  ${cn}: 报告解析失败`);
-      missing.push(cn);
-      continue;
-    }
-
-    if (isReportStale(specRoot, cn, modifiedFiles, projectRoot)) {
-      console.log(`[SDD push-consistency-check] ⚠️  ${cn}: 报告已过期`);
-      stale.push(cn);
-      continue;
-    }
-
-    // 自审模式需要人工确认
-    if (report.reviewMode === 'self-review' && !report.humanConfirmed) {
-      console.log(`[SDD push-consistency-check] ⚠️  ${cn}: 自审模式需人工确认`);
-      needsConfirmation.push(cn);
-      continue;
-    }
-
-    console.log(`[SDD push-consistency-check] ✅ ${cn}: 报告有效`);
-  }
-
-  if (missing.length || stale.length || needsConfirmation.length) {
-    console.log(generateInstructions(missing, stale, needsConfirmation, warnOnly));
-
-    if (warnOnly) {
-      console.log('[SDD push-consistency-check] 仅告警模式，放行推送');
-      process.exit(0);
-    }
-
-    process.exit(1);
-  }
-
-  console.log('\n[SDD push-consistency-check] ✅ 所有变更均已通过一致性校验，放行推送');
-  process.exit(0);
+// strict 模式仅 pre-commit 支持：显式提示而非静默忽略
+const _mode = core.loadConsistencyMode();
+if (process.env.SDD_STRICT_CONSISTENCY === '1' || _mode.strict) {
+  console.log('[SDD push-consistency-check] ℹ️  SDD_STRICT_CONSISTENCY 仅在 pre-commit 阶段生效，push 阶段忽略');
 }
 
-main();
+core.runConsistencyCheck({
+  label: '[SDD push-consistency-check]',
+  actionNoun: '推送',
+  diffFn: gitPushRangeDiff,
+  checkConfidence: false, // 置信度校验由 pre-commit 完成，push 阶段不重复
+  includeUntracked: false, // untracked 文件不在任何 commit 中，不会被推送
+  staleFromHead: true, // 过期判断读 HEAD 已提交内容，避免工作区未提交修改误判
+});

package/templates/hooks/codebuddy/hooks/sdd-tdd-rhythm-gate.cjs

@@ -154,7 +154,7 @@ if (require.main === module) {
   }
 
   // G4: 批量更新检测（E1 修正：不再提前退出，模式检查继续执行）
-  var skipPerTaskCheck = false;
+  let skipPerTaskCheck = false;
   if (changes.length >= 2 && hasTddTasks) {
     // 安全网 2: 全部有 task_update 遥测 → check-task 合法更新，跳过逐个检查
     const allHaveTaskUpdate = changes.every(change =>

package/templates/openspec/tasks.md

@@ -8,7 +8,7 @@ capability-id: "CAP-<CAPABILITY>" # 必须与对应 spec/design 一致
 > 
 > **⚠️ 边界声明**：本任务清单仅服务于当前 Capability，严禁跨模块任务。
 > 
-> **【质量红线】颗粒度必须达到"AI能在5分钟内实现"；且拆解的任务和验证逻辑必须 100% 覆盖 spec 和 design
+> **【质量红线】任务按可验证行为或交付单元拆分，不设固定分钟数；且拆解的任务和验证逻辑必须 100% 覆盖 spec 和 design
 
 ---
 
@@ -105,7 +105,7 @@ capability-id: "CAP-<CAPABILITY>" # 必须与对应 spec/design 一致
 
 ## 3. 原子任务清单
 
-<!-- 【质量红线】每个任务必须能在5分钟内由AI实现 -->
+<!-- 【质量红线】每个任务应有可验证结果和明确依赖，避免按字段或命令机械拆分 -->
 
 ### 3.0 任务类型说明
 
@@ -299,7 +299,7 @@ capability-id: "CAP-<CAPABILITY>" # 必须与对应 spec/design 一致
 ---
 
 > **质量红线检查清单**
-> - [ ] 每个任务颗粒度符合"5分钟可实现"标准
+> - [ ] 每个任务对应可验证结果，粒度与真实依赖相匹配
 > - [ ] 任务清单 100% 覆盖 spec.md 定义
 > - [ ] 任务清单 100% 覆盖 design.md 定义
 > - [ ] 每个任务都有明确的验收标准

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

@@ -17,6 +17,8 @@ allowed-tools:
   - Agent
 ---
 
+> **执行方式**：先读 [交互与执行契约](../opsx-propose/interaction-policy.md)；同一会话已读则复用。用户已授权连续处理时按范围推进，不重复索要阶段口令；只请求单阶段时完成即停。
+
 你是一个 SDD（Specification-Driven Development）变更实施专家。激活本技能后，你将引导用户按 DAG 依赖顺序逐任务实施代码。
 
 
@@ -24,7 +26,7 @@ allowed-tools:
 >
 > - 本技能针对**单一 Capability** 执行实施
 > - **上下文**：overview.md → proposal.md → 当前 capability 的 spec/design/tasks
-> - ⛔ **隔离红线**：绝对禁止加载同级其他 Capability 的文档
+> - ⛔ **隔离红线**：默认聚焦当前 Capability；为核对已声明依赖可读取相关 Capability 契约并注明来源，不全量加载或混写其他能力。
 
 > **🖥️ 跨平台执行规则**
 > - **写代码**：cwd 保持在 Git 根（含 `src/`）；**文档 / telemetry**：`--project` 指向 SDD 包裹包（`node <spec-package>/skywalk-sdd/spec-root.cjs` 可获取）。
@@ -116,12 +118,40 @@ openspec list --json
 > - **Capability**：`<capability-name>`
 > - **任务文件**：`changes/<name>/specs/<capability>/tasks.md`"
 
-### 1.2 【Check 门禁检查】验证质量门禁状态
+### 1.5 【非阻断】编译依赖预检
+
+读取当前 Capability 的 tasks.md 中所有 IMPL/CONTROLLER 任务的描述，提取：
+1. 使用的注解（@PreAuthorize, @Transactional, @Valid, @Mapper 等）
+2. 导入的框架类（spring-security, mybatis, validation 等）
+3. 与当前 pom.xml（或 build.gradle）已声明依赖做对比
+
+**预检输出格式**（仅警告，不拦截 apply）：
+> "📋 **编译依赖预检**（非阻断）
+>
+> | 检查项 | 状态 | 详情 |
+> |--------|------|------|
+> | @PreAuthorize 依赖 | ⚠️ | spring-boot-starter-security 未在 pom.xml 中声明 |
+> | @Transactional 依赖 | ✅ | spring-tx 已声明 |
+> | @Mapper 依赖 | ✅ | mybatis 已声明 |
+>
+> 建议：若上述缺失依赖确需使用，可在 Layer 0 补充依赖配置任务，或确认现有构建文件已包含。
+>
+> 请选择：
+> - **A. 忽略警告，继续 apply**（默认）
+> - **B. 暂停，先补充依赖任务**
+> - **C. 确认 pom.xml 已包含（预检误报）**"
+
+**预检规则**：
+- 只扫描 tasks.md 中任务描述文本，不扫描实际代码（apply 前代码可能尚未生成）
+- 依赖映射表维护常用注解→Maven/Gradle 依赖的对应关系（见 `./reference.md`「§1.5a 注解依赖映射表」）
+- 误报时用户选择 C，记录 `process_note(kind=user_decision, decision_type=ignore_dependency_warning)`
+
+### 1.6 【Check 门禁检查】验证质量门禁状态
 
 > **⛔ 强制门禁**：apply 阶段开始前，必须确认 check 阶段已完成。这是 SDD 流程的关键质量保障。
 > 详细检查步骤、判定与门禁体系说明见 `./checklist.md`「§1.2 Check 门禁」。未完成强制拒绝。${HOOK_GATE_DESCRIPTION}
 
-### 1.5 【本地并行】Worktree 与工作区（建议性策略）
+### 1.7 【本地并行】Worktree 与工作区（建议性策略）
 
 > **目标（本质）**：在**本地仓库**加快 SDD Apply——让**解耦**的 spec/capability 可以各自实现、互不踩目录，做完再按依赖顺序合并回你**当时所在的分支**（集成分支，如 `hotfix-1`）。
 >
@@ -153,7 +183,7 @@ openspec list --json
 第 3 层：当前 Capability 四文档
   → spec.md → design.md → tasks.md
 
-⛔ 隔离红线：禁止加载其他 Capability 的文档！
+⛔ 隔离红线：默认聚焦当前 Capability；为核对已声明依赖可读取相关 Capability 契约并注明来源，不全量加载或混写其他能力。
 ```
 
 **【可选】业务知识库检索**：
@@ -267,7 +297,14 @@ g. **继续下一个层级** — 重新检查 DAG，找出依赖已满足的下
 > - 已完成：[N/M] 任务
 > - 当前层级：Layer [X]
 > - 下一步建议：[继续实施 / 运行测试 / 归档]"
->
+
+**【已授权连续处理完成】**
+若本次为用户已授权的连续处理，完成时展示一次整体交付结果：
+> "✅ **本轮连续处理完成**
+> - propose → spec → design → task → check → apply 已全部执行完毕
+> - 各阶段文档已生成，质量门禁已执行
+> - 建议下一步：运行测试 / 归档变更"
+
 > **💡 代码评审提示**：
 > 建议执行 `/kld-review --local` 对本次变更的代码进行评审。
 > 该技能可在公司内部 SkillHub 下载安装。
@@ -295,7 +332,7 @@ g. **继续下一个层级** — 重新检查 DAG，找出依赖已满足的下
 > 完整 ⛔ 强制项勾选清单见 `./checklist.md`「Guardrails ⛔ 强制项」。核心红线：
 
 - **⛔ Check 门禁检查**：apply 前必须确认 check 已完成；未完成强制拒绝。${HOOK_GATE_DESCRIPTION}
-- **⛔ 渐进式加载 + 隔离红线**：只加载当前 Capability 的四文档链，禁止加载同级其他 Capability 的文档。
+- **⛔ 渐进式加载 + 隔离红线**：只加载当前 Capability 的四文档链，默认聚焦当前 Capability；为核对已声明依赖可读取相关 Capability 契约并注明来源，不全量加载或混写其他能力。
 - **⛔ DAG 依赖拦截**：执行任务前必须检查依赖，前置未完成必须拦截。
 - **⛔ 编译检查门禁**：每完成一个任务后必须运行编译检查，编译失败禁止标记已完成。
 - **⛔ 测试执行门禁**：根据 `test-strategy` 决定（tdd=强制, impl-first=强制补跑, none=跳过）；须真实执行并留 telemetry。${HOOK_GATE_DESCRIPTION}

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

@@ -139,7 +139,7 @@ description: opsx-apply 的阶段强制检查点与自检清单。仅在执行 a
 
 - [ ] ⛔ **Check 门禁检查**：apply 前必须确认 check 已完成；未完成强制拒绝，与 `sdd-apply-gate.cjs` Hook 形成双重保障
 - [ ] ⛔ **渐进式加载**：只加载当前 Capability 的四文档链
-- [ ] ⛔ **隔离红线**：绝对禁止加载同级其他 Capability 的文档
+- [ ] ⛔ **隔离红线**：默认聚焦当前 Capability；为核对已声明依赖可读取相关 Capability 契约并注明来源，不全量加载或混写其他能力。
 - [ ] ⛔ **DAG 依赖拦截**：执行任务前必须检查依赖，前置未完成必须拦截
 - [ ] ⛔ **编译检查门禁**：每完成一个任务后必须运行编译检查，编译失败禁止标记已完成
 - [ ] ⛔ **测试执行门禁**：根据 `test-strategy` 决定（tdd=强制, impl-first=强制补跑, none=跳过）；须真实执行并留 telemetry，`sdd-apply-test-gate` 校验非占位数据

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

@@ -237,7 +237,7 @@ node "$(cat .sdd-spec-root)/skywalk-sdd/log.cjs" record --type=worktree_finish \
 - **§4 依赖**（是否依赖 `<当前 capability>` 或其它 cap）
 - **涉及模块 / 数据表 / 公共配置**（若有）
 
-⛔ 禁止为校验而加载其它 cap 的 `design.md`、`tasks.md`（完整实施上下文仍遵守 §2 隔离红线）。
+默认聚焦当前 cap；核对真实跨能力依赖时可读取相关契约并注明来源，避免全量加载或混写。
 
 **Step D — 判定矩阵（输出给用户）**