kld-sdd 2.4.16 → 2.4.17

package/lib/init.js

@@ -547,8 +547,8 @@ function hookCommandText(hook) {
 
 function isSddClaudeHook(hook) {
   const text = hookCommandText(hook);
-  return /(?:^|\s|["'])\.claude[\\/]+hooks[\\/]+sdd-(?:prompt|pre-tool|post-tool|stop|apply-gate)\.(?:cjs|js)(?=$|\s|["'])/i.test(text) ||
-    /(?:^|\s|["'])\$\{CLAUDE_PROJECT_DIR\}[\\/]+\.claude[\\/]+hooks[\\/]+sdd-(?:prompt|pre-tool|post-tool|stop|apply-gate)\.(?:cjs|js)(?=$|\s|["'])/i.test(text);
+  return /(?:^|\s|["'])\.claude[\\/]+hooks[\\/]+sdd-(?:prompt|pre-tool|post-tool|stop|apply-gate|skill-apply-gate)\.(?:cjs|js)(?=$|\s|["'])/i.test(text) ||
+    /(?:^|\s|["'])\$\{CLAUDE_PROJECT_DIR\}[\\/]+\.claude[\\/]+hooks[\\/]+sdd-(?:prompt|pre-tool|post-tool|stop|apply-gate|skill-apply-gate)\.(?:cjs|js)(?=$|\s|["'])/i.test(text);
 }
 
 function sameHookCommand(left, right) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kld-sdd",
-  "version": "2.4.16",
+  "version": "2.4.17",
   "description": "KLD SDD OpenSpec 项目初始化工具 - 一键部署 SDD skills",
   "main": "index.js",
   "bin": {

package/templates/hooks/claude/hooks/sdd-apply-gate.cjs

@@ -8,7 +8,7 @@
  * 检查逻辑：
  * 1. 检测当前是否存在活跃的 apply 阶段（state 文件）
  * 2. 若存在，回溯 events 目录确认 check 阶段是否已完成
- * 3. 若 check 未完成，阻断本次写入并提示用户先执行 /opsx:check
+ * 3. 若 check 未完成，阻断本次写入并提示用户先执行 /opsx-check
  */
 const fs = require('fs');
 const path = require('path');
@@ -110,7 +110,7 @@ function hasCompletedCheck(projectRoot, changeName) {
       for (let i = lines.length - 1; i >= 0; i--) {
         try {
           const event = JSON.parse(lines[i]);
-          if (event.type === 'stage_end' && event.command === 'check' && event.result === 'success') {
+          if (event.type === 'stage_end' && event.command === 'check' && (event.result === 'success' || event.result === 'partial')) {
             return true;
           }
         } catch {
@@ -125,16 +125,18 @@ function hasCompletedCheck(projectRoot, changeName) {
 }
 
 /**
- * 将 change 名称转为安全的目录名（与 log.cjs 中 safeChangeName 逻辑一致）
+ * 将 change 名称转为安全的目录名（与 L1 门禁 && log.cjs 中 safeChangeName 逻辑一致）
+ *
+ * 规则：转小写 → 空格/下划线转连字符 → 剔除非法字符 → 压缩连字符 → 去头尾连字符
  */
 function safeChangeName(name) {
-  if (!name) return 'general';
+  if (!name) return '';
   return String(name)
-    .replace(/[\\/:*?"<>|]/g, '-')
-    .replace(/[\s.]+/g, '-')
+    .toLowerCase()
+    .replace(/[\s_]+/g, '-')
+    .replace(/[^a-z0-9一-鿿\-]/g, '-')
     .replace(/-+/g, '-')
-    .replace(/^-|-$/g, '')
-    .toLowerCase() || 'general';
+    .replace(/^-|-$/g, '');
 }
 
 // ── 主逻辑 ─────────────────────────────────────────────────
@@ -166,6 +168,6 @@ if (hasCompletedCheck(projectRoot, activeApply.change)) {
 const changeName = activeApply.change || 'unknown';
 console.log(JSON.stringify({
   decision: 'block',
-  reason: `[SDD Apply Gate] 检测到 apply 阶段正在执行（change: ${changeName}），但 check 阶段尚未完成。\n\n请先执行 /opsx:check 完成质量门禁检查，再执行 /opsx:apply 进行代码实施。\n\n操作顺序：/opsx:check → /opsx:apply`,
+  reason: `[SDD Apply Gate] 检测到 apply 阶段正在执行（change: ${changeName}），但 check 阶段尚未完成。\n\n请先执行 /opsx-check 完成质量门禁检查，再执行 /opsx-apply 进行代码实施。\n\n操作顺序：/opsx-check → /opsx-apply`,
 }));
 process.exit(2);

package/templates/hooks/claude/hooks/sdd-skill-apply-gate.cjs

@@ -0,0 +1,267 @@
+/**
+ * sdd-skill-apply-gate.cjs
+ *
+ * PreToolUse(Skill) 门禁 —— 在 opsx-apply Skill 被调用的瞬间阻断，不再等到 Write/Edit 阶段。
+ *
+ * 三层门禁体系中的第一层：
+ *   L1: sdd-skill-apply-gate  (PreToolUse/Skill) ← 本文件
+ *   L2: sdd-apply-gate        (PreToolUse/Write|Edit)
+ *   L3: SKILL.md Step 1.2     (Skill 自检)
+ *
+ * 判定逻辑：
+ *   - 非 opsx-apply 调用 → 放行
+ *   - 提供了 change-name → 检查该变更是否已完成 check，未完成则阻断
+ *   - 未提供 change-name → 扫描所有变更，只要有一个已完成 check 则放行，否则阻断
+ *
+ * 退出码约定（遵循 Claude Code hook 规范）：
+ *   0  → 放行（stdout 可为空，或输出允许决策 JSON）
+ *   2  → 阻断（stdout 需包含 { decision: "block", reason: "..." }）
+ */
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+// ---------------------------------------------------------------------------
+// 工具函数
+// ---------------------------------------------------------------------------
+
+/** 读取 stdin（与 sdd-prompt.cjs 保持一致的简洁实现） */
+function readStdin() {
+  try {
+    return fs.readFileSync(0, 'utf8');
+  } catch (_) {
+    return '';
+  }
+}
+
+/** 安全解析 hook 输入 JSON */
+function parseInput(raw) {
+  if (!raw || !raw.trim()) return null;
+  try {
+    return JSON.parse(raw);
+  } catch (_) {
+    return null;
+  }
+}
+
+/**
+ * 向上查找项目根目录 —— 以 skywalk-sdd/log.cjs 文件存在为标志
+ */
+function findProjectRoot(startDir) {
+  let dir = startDir;
+  for (let i = 0; i < 20; i++) {
+    if (fs.existsSync(path.join(dir, 'skywalk-sdd', 'log.cjs'))) {
+      return dir;
+    }
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return null;
+}
+
+/** 从 hook 输入中提取项目根目录 */
+function getProjectRoot(input) {
+  if (!input) return null;
+  const cwd = input.cwd || process.cwd();
+  return findProjectRoot(cwd);
+}
+
+/**
+ * 规范化变更名称 —— 与 openspec/changes/ 下的目录名保持一致
+ * 规则：
+ *   - 转小写
+ *   - 特殊字符 → 连字符
+ *   - 中文保留原样
+ */
+function safeChangeName(name) {
+  if (!name) return '';
+  return name
+    .toLowerCase()
+    .replace(/[\s_]+/g, '-')
+    .replace(/[^a-z0-9一-鿿\-]/g, '-')
+    .replace(/-+/g, '-')
+    .replace(/^-|-$/g, '');
+}
+
+/**
+ * 判断指定变更是否已完成 check 阶段。
+ *
+ * 检测方式：读取 skywalk-sdd/events/<changeName>/ 下的 JSONL 事件文件，
+ * 查找 stage_end + command=check + result=success 事件。
+ */
+function hasCompletedCheck(projectRoot, changeName) {
+  if (!projectRoot || !changeName) return false;
+  const eventsDir = path.join(projectRoot, 'skywalk-sdd', 'events', changeName);
+  if (!fs.existsSync(eventsDir)) return false;
+
+  try {
+    const files = fs.readdirSync(eventsDir).filter(f => f.endsWith('.jsonl'));
+    for (const file of files) {
+      const filePath = path.join(eventsDir, file);
+      const content = fs.readFileSync(filePath, 'utf8');
+      const lines = content.split('\n').filter(l => l.trim());
+      for (const line of lines) {
+        try {
+          const evt = JSON.parse(line);
+          if (
+            evt.type === 'stage_end' &&
+            evt.command === 'check' &&
+            (evt.result === 'success' || evt.result === 'partial')
+          ) {
+            return true;
+          }
+        } catch (_) { /* skip malformed lines */ }
+      }
+    }
+  } catch (_) {
+    return false;
+  }
+  return false;
+}
+
+/**
+ * 扫描 openspec/changes/ 下所有已通过 check 的变更。
+ * 返回已通过 check 的变更名称列表。
+ */
+function getPassedChanges(projectRoot) {
+  if (!projectRoot) return [];
+  const changesDir = path.join(projectRoot, 'openspec', 'changes');
+  if (!fs.existsSync(changesDir)) return [];
+
+  const passed = [];
+  try {
+    const entries = fs.readdirSync(changesDir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      if (entry.name.startsWith('.')) continue;
+      if (entry.name === 'archive') continue;
+      if (hasCompletedCheck(projectRoot, entry.name)) {
+        passed.push(entry.name);
+      }
+    }
+  } catch (_) { /* ignore */ }
+  return passed;
+}
+
+/**
+ * 判断给定的 tool_input 字符串是否为 opsx-apply Skill 调用。
+ *
+ * Skill 的 tool_input 格式为 JSON 字符串: {"skill": "opsx-apply", "args": "..."}
+ */
+function isOpsxApplySkill(toolInput) {
+  if (!toolInput) return false;
+  let input;
+  if (typeof toolInput === 'string') {
+    try { input = JSON.parse(toolInput); } catch (_) { return false; }
+  } else {
+    input = toolInput;
+  }
+  if (!input || typeof input !== 'object') return false;
+  const skill = input.skill || '';
+  return skill === 'opsx-apply';
+}
+
+/**
+ * 从 tool_input 中提取 change-name。
+ * opsx-apply 的 args 格式为: "change-name" 或 "--change change-name"
+ */
+function extractChangeName(toolInput) {
+  if (!toolInput) return null;
+  let input;
+  if (typeof toolInput === 'string') {
+    try { input = JSON.parse(toolInput); } catch (_) { return null; }
+  } else {
+    input = toolInput;
+  }
+  if (!input || typeof input !== 'object') return null;
+
+  const args = input.args || '';
+  if (!args.trim()) return null;
+
+  // args 可能是 "change-name" 或 "--change change-name ..." 格式
+  const trimmed = args.trim();
+
+  // 尝试 --change <name> 格式
+  const changeFlagMatch = trimmed.match(/^--change\s+(.+)$/);
+  if (changeFlagMatch) {
+    return safeChangeName(changeFlagMatch[1].trim().split(/\s+/)[0]);
+  }
+
+  // 否则整个 args 的第一个 token 就是 change-name
+  const firstToken = trimmed.split(/\s+/)[0];
+  return safeChangeName(firstToken);
+}
+
+// ---------------------------------------------------------------------------
+// 主逻辑
+// ---------------------------------------------------------------------------
+
+function main() {
+  const raw = readStdin();
+  const input = parseInput(raw);
+
+  if (!input) {
+    // 无法解析输入，保守放行（避免阻断非 opsx-apply 操作）
+    process.exit(0);
+  }
+
+  // --- 仅处理 Skill 工具调用 ---
+  const toolName = input.tool_name || '';
+  if (toolName !== 'Skill') {
+    // 非 Skill 调用，放行
+    process.exit(0);
+  }
+
+  // --- 确认是否为 opsx-apply ---
+  const toolInput = input.tool_input;
+  if (!isOpsxApplySkill(toolInput)) {
+    // 不是 opsx-apply skill，放行
+    process.exit(0);
+  }
+
+  // --- 确定项目根目录 ---
+  const projectRoot = getProjectRoot(input);
+  if (!projectRoot) {
+    // 找不到项目根目录，说明不在 kld-sdd 项目中，放行
+    process.exit(0);
+  }
+
+  // --- 提取 change-name ---
+  const changeName = extractChangeName(toolInput);
+
+  if (changeName) {
+    // 场景 A：指定了 change-name → 精确检查
+    if (hasCompletedCheck(projectRoot, changeName)) {
+      process.exit(0); // 已通过 check，放行
+    }
+    // 未通过 check，阻断
+    const reason = `变更 "${changeName}" 尚未完成 check 阶段。请先执行 /opsx-check ${changeName} 完成检查后再 apply。`;
+    console.log(JSON.stringify({ decision: 'block', reason }));
+    process.exit(2);
+  } else {
+    // 场景 B：未指定 change-name → 扫描所有变更
+    const passedChanges = getPassedChanges(projectRoot);
+
+    if (passedChanges.length === 0) {
+      const reason = '当前项目没有任何变更已完成 check 阶段。请先执行 /opsx-check <change-name> 完成检查后再 apply。';
+      console.log(JSON.stringify({ decision: 'block', reason }));
+      process.exit(2);
+    }
+
+    // 有已通过 check 的变更，放行（后续由 Skill 自身引导用户选择）
+    if (passedChanges.length === 1) {
+      const msg = `检测到已通过 check 的变更: "${passedChanges[0]}"，允许进入 apply。`;
+      console.log(JSON.stringify({ decision: 'allow', reason: msg }));
+    } else {
+      const msg = `检测到 ${passedChanges.length} 个已通过 check 的变更: ${passedChanges.join(', ')}，允许进入 apply。`;
+      console.log(JSON.stringify({ decision: 'allow', reason: msg }));
+    }
+    process.exit(0);
+  }
+}
+
+// --- 入口 ---
+main();

package/templates/hooks/claude/settings.json

@@ -11,6 +11,15 @@
       }
     ],
     "PreToolUse": [
+      {
+        "matcher": "Skill",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PROJECT_DIR}/.claude/hooks/sdd-skill-apply-gate.cjs\""
+          }
+        ]
+      },
       {
         "matcher": "Bash",
         "hooks": [

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

@@ -129,20 +129,20 @@ openspec list --json
    > **必须先执行质量门禁检查，再开始代码实施：**
    >
    > ```
-   > /opsx:check <change-name>
+   > /opsx-check <change-name>
    > ```
    >
    > **原因**：check 阶段验证文档完整性、一致性、可执行性，跳过 check 直接 apply 可能导致需求误解或设计缺陷。
    >
-   > **操作顺序**：`/opsx:check → /opsx:apply`
+   > **操作顺序**：`/opsx-check → /opsx-apply`
    >
    > 是否要现在执行 check？"
 
-   - 若用户确认执行 check → 引导执行 `/opsx:check`
+   - 若用户确认执行 check → 引导执行 `/opsx-check`
    - 若用户坚持跳过 → **强制拒绝**，不得跳过 check 直接 apply
 
 4. **若 telemetry 数据缺失**（如新项目无历史数据）：
-   > "⚠️ 未找到 check 阶段记录。如果这是首次执行，请先运行 `/opsx:check <change-name>` 完成质量门禁。
+   > "⚠️ 未找到 check 阶段记录。如果这是首次执行，请先运行 `/opsx-check <change-name>` 完成质量门禁。
    >
    > 是否要现在执行 check？"
 
@@ -343,7 +343,7 @@ node skywalk-sdd/log.cjs record --type=ai_adoption_review --command=apply --proj
 
 ## Guardrails
 
-- **⛔ Check 门禁检查**：apply 阶段开始前，必须确认 check 阶段已完成。若 check 未完成，**强制拒绝** apply，引导用户先执行 `/opsx:check`。与 `sdd-apply-gate.cjs` Hook 形成双重保障。
+- **⛔ Check 门禁检查**：apply 阶段开始前，必须确认 check 阶段已完成。若 check 未完成，**强制拒绝** apply，引导用户先执行 `/opsx-check`。与 `sdd-apply-gate.cjs` Hook 形成双重保障。
 - **⛔ 渐进式加载**：只加载当前 Capability 的四文档链
 - **⛔ 隔离红线**：绝对禁止加载同级其他 Capability 的文档
 - **⛔ DAG 依赖拦截**：执行任务前必须检查依赖，前置未完成必须拦截

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

@@ -23,7 +23,7 @@ allowed-tools:
 > - ❌ **禁止**：创建/修改任何代码文件、执行代码生成、运行测试
 >
 > 即使检查发现代码相关问题，也只记录在检查报告中，**不自动修复代码**。
-> 代码修复将在 `/opsx:apply` 阶段进行。
+> 代码修复将在 `/opsx-apply` 阶段进行。
 
 
 > **🖥️ 跨平台执行规则**
@@ -58,7 +58,7 @@ allowed-tools:
 openspec list
 ```
 
-若变更不存在，提示用户先运行 `/opsx:propose <name>` 创建变更。
+若变更不存在，提示用户先运行 `/opsx-propose <name>` 创建变更。
 
 ### 2. 读取完整文档链
 
@@ -168,13 +168,13 @@ node skywalk-sdd/log.cjs record --type=conformance_review --command=check --proj
 
 **全部通过**：
 > "✅ 质量检查通过！建议下一步：
-> - A. 运行 `/opsx:apply` 开始实施
+> - A. 运行 `/opsx-apply` 开始实施
 > - B. 再次确认某个文档细节"
 
 **有问题**：
 > "❌ 发现 [N] 个问题需要修复：
-> - 问题 1：[描述] → 建议运行 `/opsx:spec` 修复
-> - 问题 2：[描述] → 建议运行 `/opsx:design` 修复
+> - 问题 1：[描述] → 建议运行 `/opsx-spec` 修复
+> - 问题 2：[描述] → 建议运行 `/opsx-design` 修复
 >
 > 请选择：
 > - A. 逐个修复（引导到对应命令）

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

@@ -23,7 +23,7 @@ allowed-tools:
 > - ❌ **禁止**：创建/修改任何代码文件、执行代码生成、运行测试
 > - ⛔ **单阶段原则**：完成 design.md 后**必须立即停止**，等待用户主动触发下一阶段
 >
-> 代码实现将在 `/opsx:apply` 阶段进行。
+> 代码实现将在 `/opsx-apply` 阶段进行。
 > **完成本阶段后，绝对禁止自动继续执行 task 等后续阶段。**
 
 > **⚠️ 渐进式上下文加载原则**
@@ -172,7 +172,7 @@ openspec list
 
 最终输出：
 - 文档路径
-- 下一步提示："运行 `/opsx:task <name> <capability>` 创建任务拆解文档"
+- 下一步提示："运行 `/opsx-task <name> <capability>` 创建任务拆解文档"
 
 ---
 
@@ -185,4 +185,4 @@ openspec list
 - 必须 100% 覆盖 spec.md 定义的需求项
 - 代码锚点必须具体到类/方法级别
 - **⛔ 阶段边界**：禁止执行任何代码创建/修改操作
-- **⛔ 单阶段原则：完成 design.md 后必须立即停止**。仅提示用户下一步可运行 `/opsx:task`，**绝对禁止自动执行 task 等后续阶段**。每个阶段必须由用户主动触发。
+- **⛔ 单阶段原则：完成 design.md 后必须立即停止**。仅提示用户下一步可运行 `/opsx-task`，**绝对禁止自动执行 task 等后续阶段**。每个阶段必须由用户主动触发。

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

@@ -47,7 +47,7 @@ openspec list
 ```
 
 若没有任何变更，提示：
-> "当前项目还没有任何变更。运行 `/opsx:propose <变更描述>` 开始第一个变更。"
+> "当前项目还没有任何变更。运行 `/opsx-propose <变更描述>` 开始第一个变更。"
 
 ### 2. 检查每个变更的 SDD 文档完整性
 
@@ -68,18 +68,18 @@ openspec status --change "<name>" --json
 >
 > | 变更名称 | P | S | D | T | openspec状态 | 建议下一步 |
 > |---------|---|---|---|---|------------|---------|
-> | add-user-auth | ✅ | ✅ | ✅ | ❌ | PENDING | `/opsx:task add-user-auth` |
-> | payment-refund | ✅ | ❌ | ❌ | ❌ | PENDING | `/opsx:spec payment-refund` |
-> | points-exchange | ✅ | ✅ | ✅ | ✅ | IMPLEMENTING | `/opsx:check points-exchange` |"
+> | add-user-auth | ✅ | ✅ | ✅ | ❌ | PENDING | `/opsx-task add-user-auth` |
+> | payment-refund | ✅ | ❌ | ❌ | ❌ | PENDING | `/opsx-spec payment-refund` |
+> | points-exchange | ✅ | ✅ | ✅ | ✅ | IMPLEMENTING | `/opsx-check points-exchange` |"
 
 ### 4. 【交互引导】选择操作
 
 使用 **AskUserQuestion** 让用户选择：
 > "请选择操作：
 > - A. 查看变更详情：输入变更名称
-> - B. 创建新变更：运行 `/opsx:propose`
-> - C. 执行质量检查：运行 `/opsx:check <name>`
-> - D. 申请实施：运行 `/opsx:apply <name>`
+> - B. 创建新变更：运行 `/opsx-propose`
+> - C. 执行质量检查：运行 `/opsx-check <name>`
+> - D. 申请实施：运行 `/opsx-apply <name>`
 > - E. 退出浏览"
 
 ### 5. 若用户选择查看详情

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

@@ -24,7 +24,7 @@ allowed-tools:
 > - ⛔ **单阶段原则**：完成 proposal.md 后**必须立即停止**，等待用户主动触发下一阶段
 >
 > 即使用户提供了代码作为上下文，也只用于理解需求背景，**不执行任何代码操作**。
-> 代码实现请引导用户使用 `/opsx:apply` 命令。
+> 代码实现请引导用户使用 `/opsx-apply` 命令。
 > **完成本阶段后，绝对禁止自动继续执行 spec/design/task 等后续阶段。**
 
 
@@ -80,7 +80,7 @@ allowed-tools:
 ### 2. 【上下文加载】识别并读取用户提供的文件
 
 **自动识别上下文文件**：
-若用户在命令中指定了文件路径（如 `/opsx:propose atp-calc ./需求.md ./算法逻辑.md`），
+若用户在命令中指定了文件路径（如 `/opsx-propose atp-calc ./需求.md ./算法逻辑.md`），
 或在对话中附加/引用了文件，**必须自动读取这些文件**。
 
 **上下文处理原则**：
@@ -249,7 +249,7 @@ openspec instructions proposal --change "<name>" --json
 最终输出：
 - 文档路径
 - 内容摘要
-- 下一步提示："运行 `/opsx:spec` 创建技术契约文档 (specs/<capability>/spec.md)"
+- 下一步提示："运行 `/opsx-spec` 创建技术契约文档 (specs/<capability>/spec.md)"
 
 ---
 
@@ -263,5 +263,5 @@ openspec instructions proposal --change "<name>" --json
 - 若跳过此文档，后续 specs 必须补齐影响范围
 - 文档写入后验证文件确实存在
 - 每次生成都提供文档摘要，等待用户确认后再继续
-- **⛔ 阶段边界**：本阶段禁止执行任何代码创建/修改操作。若用户要求处理代码，回复：「当前处于 Propose 阶段，代码操作请在完成文档后使用 `/opsx:apply` 执行。」
-- **⛔ 单阶段原则：完成 proposal.md 后必须立即停止**。仅提示用户下一步可运行 `/opsx:spec`，**绝对禁止自动执行 spec/design/task 等后续阶段**。每个阶段必须由用户主动触发。
+- **⛔ 阶段边界**：本阶段禁止执行任何代码创建/修改操作。若用户要求处理代码，回复：「当前处于 Propose 阶段，代码操作请在完成文档后使用 `/opsx-apply` 执行。」
+- **⛔ 单阶段原则：完成 proposal.md 后必须立即停止**。仅提示用户下一步可运行 `/opsx-spec`，**绝对禁止自动执行 spec/design/task 等后续阶段**。每个阶段必须由用户主动触发。

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

@@ -24,7 +24,7 @@ allowed-tools:
 > - ⛔ **单阶段原则**：完成 spec.md 后**必须立即停止**，等待用户主动触发下一阶段
 >
 > 即使用户提供了代码作为上下文，也只用于分析现有实现，**不执行任何代码操作**。
-> 代码实现将在 `/opsx:apply` 阶段进行。
+> 代码实现将在 `/opsx-apply` 阶段进行。
 > **完成本阶段后，绝对禁止自动继续执行 design/task 等后续阶段。**
 
 
@@ -72,7 +72,7 @@ openspec/changes/<name>/
 ```bash
 openspec list
 ```
-若变更不存在，引导用户先运行 `/opsx:propose <name>`。
+若变更不存在，引导用户先运行 `/opsx-propose <name>`。
 
 ### 2. 【交互引导】确认 Capability
 
@@ -184,7 +184,7 @@ openspec list
 
 最终输出：
 - 文档路径
-- 下一步提示："运行 `/opsx:design <name> <capability>` 创建技术设计文档"
+- 下一步提示："运行 `/opsx-design <name> <capability>` 创建技术设计文档"
 
 ---
 
@@ -196,4 +196,4 @@ openspec list
 - 每个需求项必须有清晰的验收标准
 - 技术契约必须可执行、无歧义
 - **⛔ 阶段边界**：禁止执行任何代码创建/修改操作
-- **⛔ 单阶段原则：完成 spec.md 后必须立即停止**。仅提示用户下一步可运行 `/opsx:design`，**绝对禁止自动执行 design/task 等后续阶段**。每个阶段必须由用户主动触发。
+- **⛔ 单阶段原则：完成 spec.md 后必须立即停止**。仅提示用户下一步可运行 `/opsx-design`，**绝对禁止自动执行 design/task 等后续阶段**。每个阶段必须由用户主动触发。

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

@@ -24,7 +24,7 @@ allowed-tools:
 > - ⛔ **单阶段原则**：完成 tasks.md 后**必须立即停止**，等待用户主动触发下一阶段
 >
 > tasks.md 定义的是「待执行的任务清单」，**不是立即执行代码**。
-> 请引导用户使用 `/opsx:apply` 进入实施阶段。
+> 请引导用户使用 `/opsx-apply` 进入实施阶段。
 > **完成本阶段后，绝对禁止自动继续执行 apply/check 等后续阶段。**
 
 > **⚠️ 渐进式上下文加载原则**
@@ -200,7 +200,7 @@ allowed-tools:
 
 最终输出：
 - 文档路径
-- 下一步提示："运行 `/opsx:check <name>` 执行质量检查，或 `/opsx:apply <name> <capability>` 开始实施"
+- 下一步提示："运行 `/opsx-check <name>` 执行质量检查，或 `/opsx-apply <name> <capability>` 开始实施"
 
 ---
 
@@ -213,4 +213,4 @@ allowed-tools:
 - **⛔ 无循环依赖**：DAG 中不允许存在环
 - 任务颗粒度宁可过细也不要过粗
 - **⛔ 阶段边界**：禁止执行任何代码创建/修改操作
-- **⛔ 单阶段原则：完成 tasks.md 后必须立即停止**。仅提示用户下一步可运行 `/opsx:check` 或 `/opsx:apply`，**绝对禁止自动执行 apply/check 等后续阶段**。每个阶段必须由用户主动触发。
+- **⛔ 单阶段原则：完成 tasks.md 后必须立即停止**。仅提示用户下一步可运行 `/opsx-check` 或 `/opsx-apply`，**绝对禁止自动执行 apply/check 等后续阶段**。每个阶段必须由用户主动触发。

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

@@ -19,7 +19,7 @@ allowed-tools:
 
 > **⚠️ 命令定位**
 >
-> 本技能专注于**单元测试执行**，是 `/opsx:apply` 流程的可选验证环节。
+> 本技能专注于**单元测试执行**，是 `/opsx-apply` 流程的可选验证环节。
 > - 用户可在完成代码实现后主动调用
 > - 输出标准化测试报告，便于质量追踪
 
@@ -124,7 +124,7 @@ allowed-tools:
 **全部通过**：
 > "✅ 所有测试通过！建议下一步：
 > - A. 继续实施下一个任务
-> - B. 运行 `/opsx:archive` 归档变更"
+> - B. 运行 `/opsx-archive` 归档变更"
 
 **有失败**：
 > "❌ [N] 个测试失败，请选择：