kld-sdd 2.4.9 → 2.4.10

package/lib/init.js

@@ -566,7 +566,7 @@ function deployOpsxSkills(selectedTools = Object.keys(TOOL_CONFIGS)) {
 
 /**
  * 部署 Claude Code Hook Pack（可选增强）
- * Hook 只调用 skywalk-sdd/log.js，不写私有日志，不替代 OPSX 模板采集。
+ * Hook 只调用 skywalk-sdd/log.cjs，不写私有日志，不替代 OPSX 模板采集。
  */
 function deployClaudeHookPack(selectedTools = Object.keys(TOOL_CONFIGS)) {
   if (!selectedTools.includes('claude')) {
@@ -593,7 +593,7 @@ function deployClaudeHookPack(selectedTools = Object.keys(TOOL_CONFIGS)) {
   }
 
   copyDir(hookSourceDir, targetHookDir);
-  console.log('   ✓ 部署 .claude/hooks/sdd-*.js');
+  console.log('   ✓ 部署 .claude/hooks/sdd-*.cjs');
 
   const targetSettingsPath = path.join(claudeDir, 'settings.json');
   const templateSettings = JSON.parse(fs.readFileSync(settingsTemplatePath, 'utf8'));
@@ -790,16 +790,16 @@ function deployTelemetryDataDir() {
   }
 
   // 部署项目内 Telemetry CLI（不依赖 npm 发布）
-  const telemetrySrc = path.join(pkgPath, 'skywalk-sdd', 'index.js');
-  const telemetryDst = path.join(dataDir, 'log.js');
+  const telemetrySrc = path.join(pkgPath, 'skywalk-sdd', 'index.cjs');
+  const telemetryDst = path.join(dataDir, 'log.cjs');
   if (fs.existsSync(telemetrySrc)) {
     fs.copyFileSync(telemetrySrc, telemetryDst);
-    console.log('   ✓ 部署 skywalk-sdd/log.js（本地 Telemetry CLI）');
+    console.log('   ✓ 部署 skywalk-sdd/log.cjs（本地 Telemetry CLI）');
   } else {
     console.log(`   ⚠️  Telemetry CLI 源文件缺失: ${telemetrySrc}`);
   }
 
-  console.log('   ✓ 调用方式: node skywalk-sdd/log.js start|end|metrics');
+  console.log('   ✓ 调用方式: node skywalk-sdd/log.cjs start|end|metrics');
   console.log('✅ Telemetry 已就绪（数据存储在 skywalk-sdd/，无需配置 MCP）');
   return true;
 }
@@ -869,8 +869,8 @@ function deployQualityGateTemplates() {
     console.log(`   ⚠️  CI 模板缺失: ${ciTemplateDir}`);
   }
 
-  installGitHookShim(cwd, 'pre-commit', 'skywalk-sdd/git-hooks/pre-commit-sdd-check.js');
-  installGitHookShim(cwd, 'pre-push', 'skywalk-sdd/git-hooks/pre-push-sdd-check.js');
+  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');
 
   console.log('✅ Git hooks / CI 兜底模板已就绪');
   return true;
@@ -1086,7 +1086,7 @@ async function main() {
   console.log();
   console.log('📊 SDD Telemetry（嵌入在命令流程中，自动执行，无需配置）：');
   console.log('  - 度量数据自动采集到 skywalk-sdd/events/');
-  console.log('  - 运行 node skywalk-sdd/log.js metrics --project=. 查看四维度指标');
+  console.log('  - 运行 node skywalk-sdd/log.cjs metrics --project=. 查看四维度指标');
   console.log();
 
   rl.close();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kld-sdd",
-  "version": "2.4.9",
+  "version": "2.4.10",
   "description": "KLD SDD OpenSpec 项目初始化工具 - 内置模版一键初始化",
   "main": "index.js",
   "bin": {
@@ -30,7 +30,7 @@
     "bin/",
     "lib/",
     "templates/",
-    "skywalk-sdd/index.js",
+    "skywalk-sdd/index.cjs",
     "README.md"
   ]
 }

package/skywalk-sdd/{index.js → index.cjs}

@@ -6,9 +6,9 @@
  * AI Agent 通过终端命令调用，将事件写入项目本地 skywalk-sdd/ 目录。
  * 
  * 用法:
- *   node skywalk-sdd/log.js start  --command=propose --project=/path --change=xxx [--agent=cursor]
- *   node skywalk-sdd/log.js end    --event-id=evt_xxx --result=success --summary="..."
- *   node skywalk-sdd/log.js metrics --project=/path [--change=xxx]
+ *   node skywalk-sdd/log.cjs start  --command=propose --project=/path --change=xxx [--agent=cursor]
+ *   node skywalk-sdd/log.cjs end    --event-id=evt_xxx --result=success --summary="..."
+ *   node skywalk-sdd/log.cjs metrics --project=/path [--change=xxx]
  */
 
 const fs = require('fs');
@@ -1395,7 +1395,9 @@ function computeAiAdoptionMetrics(events) {
     const review = getAiAdoptionReview(e);
     return review?.review_status === 'final' || e.status === 'final';
   });
-  const latestEvent = latestByTimestamp(finalEvents.length > 0 ? finalEvents : adoptionEvents);
+  // 优先使用 final 事件，无 final 时 fallback 到 snapshot（AI 产出快照）
+  const candidates = finalEvents.length > 0 ? finalEvents : adoptionEvents;
+  const latestEvent = latestByTimestamp(candidates);
   const latestReview = getAiAdoptionReview(latestEvent);
   if (!latestReview) {
     return {
@@ -1665,7 +1667,7 @@ function computeSinglePdfMvpMetrics(events, options = {}) {
   const gitDocumentMetrics = options.projectRoot && options.change
     ? computeGitDocumentMetrics(options.projectRoot, options.change)
     : null;
-  const specIterationCount = gitDocumentMetrics
+  const specIterationCount = gitDocumentMetrics?.spec_iteration_count != null
     ? gitDocumentMetrics.spec_iteration_count
     : stageSpecIterationCount;
 
@@ -1902,6 +1904,10 @@ function renderExecutiveReportMarkdown(report) {
     '',
     '## 说明',
     '- `null` 表示当前还没有采集到对应事件或该指标暂不适用。',
+    '- E4 AI 一次成码率：依赖 `task_update` 事件中的 `task_id` 和首次执行结果，若 apply 阶段未正确记录则显示 null。',
+    '- P1 文档迭代次数：优先使用 Git 提交历史统计，无 Git 仓库或无提交历史时使用阶段 start 事件数。',
+    '- P2 AI 代码保留率：优先使用 `ai_adoption_review` 的 final 状态，无 final 时 fallback 到 AI 产出快照（ai_snapshot）。',
+    '- Q4 规约驱动测试覆盖率：依赖 check/test 阶段记录 spec 断言到测试用例的映射数据（spec_test_coverage 字段），属高级功能。',
     '- Q1 规约符合度与人工反馈类指标属于评审信号，默认不作为强阻断门禁。',
   ].join('\n');
 }
@@ -2064,7 +2070,7 @@ function cmdStart(args) {
 
   if (!command) {
     console.error('错误: 缺少 --command 参数');
-    console.error('用法: node skywalk-sdd/log.js start --command=propose --project=/path');
+    console.error('用法: node skywalk-sdd/log.cjs start --command=propose --project=/path');
     process.exit(1);
   }
 
@@ -2556,7 +2562,7 @@ function cmdArchiveDocs(args) {
 function main() {
   // 支持两种调用方式:
   // 1) npx kld-sdd log start ...     → argv 含 'log'
-  // 2) node skywalk-sdd/log.js start ... → argv 直接以子命令开头
+  // 2) node skywalk-sdd/log.cjs start ... → argv 直接以子命令开头
   const argv = process.argv.slice(2);
   const logIdx = argv.indexOf('log');
   const subArgs = logIdx === -1 ? argv : argv.slice(logIdx + 1);
@@ -2604,12 +2610,12 @@ function showHelp() {
 SDD Telemetry CLI - 流程度量采集工具
 
 用法:
-  node skywalk-sdd/log.js start   --command=<cmd> --project=<path> [--change=<name>] [--agent=<type>]
-  node skywalk-sdd/log.js end     --event-id=<id> --result=<success|failure|partial> --summary="..."
-  node skywalk-sdd/log.js metrics --project=<path> [--change=<name>] [--pdf-mvp] [--format=json|markdown]
-  node skywalk-sdd/log.js report  --project=<path> [--change=<name>] [--format=json|markdown] [--output=<file>]
-  node skywalk-sdd/log.js tasks-status --project=<path> --change=<name> [--require-complete]
-  node skywalk-sdd/log.js archive-docs --project=<path> --change=<name> [--reason=<text>] [--event-id=<id>] [--report-output=<file>]
+  node skywalk-sdd/log.cjs start   --command=<cmd> --project=<path> [--change=<name>] [--agent=<type>]
+  node skywalk-sdd/log.cjs end     --event-id=<id> --result=<success|failure|partial> --summary="..."
+  node skywalk-sdd/log.cjs metrics --project=<path> [--change=<name>] [--pdf-mvp] [--format=json|markdown]
+  node skywalk-sdd/log.cjs report  --project=<path> [--change=<name>] [--format=json|markdown] [--output=<file>]
+  node skywalk-sdd/log.cjs tasks-status --project=<path> --change=<name> [--require-complete]
+  node skywalk-sdd/log.cjs archive-docs --project=<path> --change=<name> [--reason=<text>] [--event-id=<id>] [--report-output=<file>]
 
 子命令:
   start    记录 SDD 阶段开始，返回 event_id
@@ -2622,18 +2628,18 @@ SDD Telemetry CLI - 流程度量采集工具
   archive-docs 将 Simple/Full spec 变更真实移动到 openspec/changes/archive/，并可结束 archive 阶段生成报告
 
 示例:
-  node skywalk-sdd/log.js start --command=propose --project=/my/project --change=user-auth --agent=cursor
-  node skywalk-sdd/log.js end --event-id=evt_abc123 --result=success --summary="创建 proposal.md"
-  node skywalk-sdd/log.js record --type=task_update --command=apply --project=/my/project --change=user-auth --task-id=TASK-01 --status=completed
-  node skywalk-sdd/log.js record --type=conformance_review --command=check --project=/my/project --change=user-auth --source=manual --details-file=conformance-review.json
-  node skywalk-sdd/log.js record --type=ai_adoption_review --command=apply --project=/my/project --change=user-auth --status=final --details-file=ai-adoption.json
-  node skywalk-sdd/log.js record --type=survey_result --project=/my/project --change=user-auth --source=manual --details-file=survey.json
-  node skywalk-sdd/log.js metrics --project=/my/project --change=user-auth
-  node skywalk-sdd/log.js metrics --project=/my/project --change=user-auth --pdf-mvp --format=markdown
-  node skywalk-sdd/log.js report --project=/my/project --change=user-auth --format=markdown
-  node skywalk-sdd/log.js doctor --project=/my/project --change=user-auth
-  node skywalk-sdd/log.js tasks-status --project=/my/project --change=user-auth --require-complete
-  node skywalk-sdd/log.js archive-docs --project=/my/project --change=user-auth --reason="变更已完成实施" --event-id=evt_archive --report-output=skywalk-sdd/reports/user-auth-report.md
+  node skywalk-sdd/log.cjs start --command=propose --project=/my/project --change=user-auth --agent=cursor
+  node skywalk-sdd/log.cjs end --event-id=evt_abc123 --result=success --summary="创建 proposal.md"
+  node skywalk-sdd/log.cjs record --type=task_update --command=apply --project=/my/project --change=user-auth --task-id=TASK-01 --status=completed
+  node skywalk-sdd/log.cjs record --type=conformance_review --command=check --project=/my/project --change=user-auth --source=manual --details-file=conformance-review.json
+  node skywalk-sdd/log.cjs record --type=ai_adoption_review --command=apply --project=/my/project --change=user-auth --status=final --details-file=ai-adoption.json
+  node skywalk-sdd/log.cjs record --type=survey_result --project=/my/project --change=user-auth --source=manual --details-file=survey.json
+  node skywalk-sdd/log.cjs metrics --project=/my/project --change=user-auth
+  node skywalk-sdd/log.cjs metrics --project=/my/project --change=user-auth --pdf-mvp --format=markdown
+  node skywalk-sdd/log.cjs report --project=/my/project --change=user-auth --format=markdown
+  node skywalk-sdd/log.cjs doctor --project=/my/project --change=user-auth
+  node skywalk-sdd/log.cjs tasks-status --project=/my/project --change=user-auth --require-complete
+  node skywalk-sdd/log.cjs archive-docs --project=/my/project --change=user-auth --reason="变更已完成实施" --event-id=evt_archive --report-output=skywalk-sdd/reports/user-auth-report.md
 `);
 }
 

package/templates/ci/github-actions-sdd.yml

@@ -28,7 +28,7 @@ jobs:
         run: npm install
 
       - name: SDD doctor
-        run: node skywalk-sdd/log.js doctor --project="$SDD_PROJECT" --change="$SDD_CHANGE"
+        run: node skywalk-sdd/log.cjs doctor --project="$SDD_PROJECT" --change="$SDD_CHANGE"
 
       - name: Build and record SDD result
         shell: bash
@@ -45,7 +45,7 @@ jobs:
             result="failure"
             success="false"
           fi
-          node skywalk-sdd/log.js record --type=build_result --command=ci --project="$SDD_PROJECT" --change="$SDD_CHANGE" --agent="$SDD_AGENT" --source=ci --session-id="$SDD_SESSION" --result="$result" --summary="CI build $result" --details-json="{\"build_results\":{\"command\":\"$SDD_BUILD_COMMAND\",\"success\":$success,\"duration_ms\":$duration,\"error_count\":0}}"
+          node skywalk-sdd/log.cjs record --type=build_result --command=ci --project="$SDD_PROJECT" --change="$SDD_CHANGE" --agent="$SDD_AGENT" --source=ci --session-id="$SDD_SESSION" --result="$result" --summary="CI build $result" --details-json="{\"build_results\":{\"command\":\"$SDD_BUILD_COMMAND\",\"success\":$success,\"duration_ms\":$duration,\"error_count\":0}}"
           exit "$status"
 
       - name: Test and record SDD result
@@ -63,5 +63,5 @@ jobs:
             result="failure"
             failed=1
           fi
-          node skywalk-sdd/log.js record --type=test_result --command=ci --project="$SDD_PROJECT" --change="$SDD_CHANGE" --agent="$SDD_AGENT" --source=ci --session-id="$SDD_SESSION" --result="$result" --summary="CI test $result" --details-json="{\"test_results\":{\"command\":\"$SDD_TEST_COMMAND\",\"passed\":0,\"failed\":$failed,\"skipped\":0,\"coverage\":null,\"duration_ms\":$duration}}"
+          node skywalk-sdd/log.cjs record --type=test_result --command=ci --project="$SDD_PROJECT" --change="$SDD_CHANGE" --agent="$SDD_AGENT" --source=ci --session-id="$SDD_SESSION" --result="$result" --summary="CI test $result" --details-json="{\"test_results\":{\"command\":\"$SDD_TEST_COMMAND\",\"passed\":0,\"failed\":$failed,\"skipped\":0,\"coverage\":null,\"duration_ms\":$duration}}"
           exit "$status"

package/templates/ci/gitlab-ci-sdd.yml

@@ -11,7 +11,7 @@ sdd_quality_gate:
   before_script:
     - npm install
   script:
-    - node skywalk-sdd/log.js doctor --project="$SDD_PROJECT" --change="$SDD_CHANGE"
+    - node skywalk-sdd/log.cjs doctor --project="$SDD_PROJECT" --change="$SDD_CHANGE"
     - |
       set +e
       start_ms=$(date +%s%3N)
@@ -25,7 +25,7 @@ sdd_quality_gate:
         result="failure"
         success="false"
       fi
-      node skywalk-sdd/log.js record --type=build_result --command=ci --project="$SDD_PROJECT" --change="$SDD_CHANGE" --agent="$SDD_AGENT" --source=ci --session-id="$SDD_SESSION" --result="$result" --summary="CI build $result" --details-json="{\"build_results\":{\"command\":\"$SDD_BUILD_COMMAND\",\"success\":$success,\"duration_ms\":$duration,\"error_count\":0}}"
+      node skywalk-sdd/log.cjs record --type=build_result --command=ci --project="$SDD_PROJECT" --change="$SDD_CHANGE" --agent="$SDD_AGENT" --source=ci --session-id="$SDD_SESSION" --result="$result" --summary="CI build $result" --details-json="{\"build_results\":{\"command\":\"$SDD_BUILD_COMMAND\",\"success\":$success,\"duration_ms\":$duration,\"error_count\":0}}"
       if [ "$status" -ne 0 ]; then exit "$status"; fi
     - |
       set +e
@@ -40,5 +40,5 @@ sdd_quality_gate:
         result="failure"
         failed=1
       fi
-      node skywalk-sdd/log.js record --type=test_result --command=ci --project="$SDD_PROJECT" --change="$SDD_CHANGE" --agent="$SDD_AGENT" --source=ci --session-id="$SDD_SESSION" --result="$result" --summary="CI test $result" --details-json="{\"test_results\":{\"command\":\"$SDD_TEST_COMMAND\",\"passed\":0,\"failed\":$failed,\"skipped\":0,\"coverage\":null,\"duration_ms\":$duration}}"
+      node skywalk-sdd/log.cjs record --type=test_result --command=ci --project="$SDD_PROJECT" --change="$SDD_CHANGE" --agent="$SDD_AGENT" --source=ci --session-id="$SDD_SESSION" --result="$result" --summary="CI test $result" --details-json="{\"test_results\":{\"command\":\"$SDD_TEST_COMMAND\",\"passed\":0,\"failed\":$failed,\"skipped\":0,\"coverage\":null,\"duration_ms\":$duration}}"
       if [ "$status" -ne 0 ]; then exit "$status"; fi

package/templates/git-hooks/{pre-push-sdd-check.js → pre-push-sdd-check.cjs}

@@ -16,7 +16,7 @@ function main() {
   const logCli = path.join(projectRoot, 'skywalk-sdd', 'log.js');
 
   if (!fs.existsSync(logCli)) {
-    console.log('SDD pre-push: skywalk-sdd/log.js not found; doctor gate skipped.');
+    console.log('SDD pre-push: skywalk-sdd/log.cjs not found; doctor gate skipped.');
     return;
   }
 

package/templates/hooks/claude/hooks/{sdd-prompt.js → sdd-prompt.cjs}

@@ -54,8 +54,8 @@ const activeStages = readActiveStages(projectRoot)
 
 const lines = [
   'SDD Telemetry reminder:',
-  '- Run skywalk-sdd/log.js start before the OPSX stage work begins.',
-  '- Run skywalk-sdd/log.js end before stopping the stage.',
+  '- Run skywalk-sdd/log.cjs start before the OPSX stage work begins.',
+  '- Run skywalk-sdd/log.cjs end before stopping the stage.',
   '- Hooks are only an enhancement; OPSX command instructions remain authoritative.',
 ];
 

package/templates/hooks/claude/hooks/{sdd-stop.js → sdd-stop.cjs}

@@ -78,5 +78,5 @@ for (const event of activeStages) {
 console.log([
   'SDD Telemetry warning: open stage(s) detected.',
   ...activeStages.map(event => `- ${event.change || 'general'}:${event.command || event.stage || 'unknown'} event_id=${event.event_id}`),
-  'Run skywalk-sdd/log.js end before closing the OPSX stage, or explicitly mark it partial/failure.',
+  'Run skywalk-sdd/log.cjs end before closing the OPSX stage, or explicitly mark it partial/failure.',
 ].join('\n'));

package/templates/hooks/claude/settings.json

@@ -5,7 +5,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node .claude/hooks/sdd-prompt.js"
+            "command": "node .claude/hooks/sdd-prompt.cjs"
           }
         ]
       }
@@ -16,7 +16,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node .claude/hooks/sdd-pre-tool.js"
+            "command": "node .claude/hooks/sdd-pre-tool.cjs"
           }
         ]
       }
@@ -27,7 +27,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node .claude/hooks/sdd-post-tool.js"
+            "command": "node .claude/hooks/sdd-post-tool.cjs"
           }
         ]
       }
@@ -37,7 +37,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node .claude/hooks/sdd-stop.js"
+            "command": "node .claude/hooks/sdd-stop.cjs"
           }
         ]
       }

package/templates/opsx-commands/apply.md

@@ -12,7 +12,7 @@ argument-hint: "[change-name] [capability-name] [上下文文件...]"
 > - 在 Windows Bash / Git Bash / Claude Bash 中，禁止裸写 Windows 反斜杠绝对路径（如 `D:\project\demo`）；如必须使用绝对路径，请写成正斜杠路径或加引号。
 > - 不要省略 `--source=opsx-command` 与 `--session-id=<会话ID>`。
 > **📊 Telemetry（必做，不得跳过）**
-> 在终端执行（必须成功）：`node skywalk-sdd/log.js start --command=apply --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --git-sha=<base_git_sha_or_none>`，记录返回的 event_id。
+> 在终端执行（必须成功）：`node skywalk-sdd/log.cjs start --command=apply --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --git-sha=<base_git_sha_or_none>`，记录返回的 event_id。
 
 > **🔒 Git 策略（只读增强，不改变开发流）**
 > - Git 只作为可选度量数据源，不是 apply 前置条件。
@@ -65,7 +65,7 @@ argument-hint: "[change-name] [capability-name] [上下文文件...]"
 
    在终端执行（若命令失败必须中止本阶段，不得跳过）：
    ```bash
-   node skywalk-sdd/log.js start --command=apply --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --git-sha=<base_git_sha_or_none>
+   node skywalk-sdd/log.cjs start --command=apply --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --git-sha=<base_git_sha_or_none>
    ```
    保存输出 JSON 中的 `event_id`，供阶段结束使用。
 
@@ -350,7 +350,7 @@ argument-hint: "[change-name] [capability-name] [上下文文件...]"
       
       5. **记录构建 Telemetry**：
          ```bash
-         node skywalk-sdd/log.js record --type=build_result --command=apply --project=. --change=<变更名称> --capability=<capability-name> --task-id=<TASK-ID> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/failure --summary="编译检查结果" --details-json="{\"build_results\":{\"command\":\"<实际编译命令>\",\"success\":true,\"duration_ms\":0,\"error_count\":0}}"
+         node skywalk-sdd/log.cjs record --type=build_result --command=apply --project=. --change=<变更名称> --capability=<capability-name> --task-id=<TASK-ID> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/failure --summary="编译检查结果" --details-json="{\"build_results\":{\"command\":\"<实际编译命令>\",\"success\":true,\"duration_ms\":0,\"error_count\":0}}"
          ```
          `build_results` 字段口径：
          - `command`: 实际执行的编译/构建命令。
@@ -402,8 +402,10 @@ argument-hint: "[change-name] [capability-name] [上下文文件...]"
 
       4. **记录任务级 Telemetry**：
          ```bash
-         node skywalk-sdd/log.js record --type=task_update --command=apply --project=. --change=<变更名称> --capability=<capability-name> --task-id=<TASK-ID> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --status=completed --result=success --summary="<TASK-ID> 完成" --details-json="{\"files_changed\":[],\"build_results\":{\"command\":\"<实际编译命令>\",\"success\":true,\"duration_ms\":0,\"error_count\":0},\"test_results\":{\"command\":\"<实际测试命令>\",\"passed\":0,\"failed\":0,\"skipped\":0,\"coverage\":null,\"duration_ms\":0}}"
+         node skywalk-sdd/log.cjs record --type=task_update --command=apply --project=. --change=<变更名称> --capability=<capability-name> --task-id=<TASK-ID> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --status=completed --result=success --summary="<TASK-ID> 完成" --details-json="{\"files_changed\":[],\"build_results\":{\"command\":\"<实际编译命令>\",\"success\":true,\"duration_ms\":0,\"error_count\":0},\"test_results\":{\"command\":\"<实际测试命令>\",\"passed\":0,\"failed\":0,\"skipped\":0,\"coverage\":null,\"duration_ms\":0}}"
          ```
+         **⚠️ 注意**：`--task-id=<TASK-ID>` 中的 `<TASK-ID>` 必须替换为当前任务的实际 ID（如 `TASK-USER-AUTH-01`），不得保留占位符，否则 E4 指标无法计算。
+
          若任务失败或暂停，`--status` 使用 `failed` / `blocked`，`--result` 使用 `failure` / `partial`，并在 details 中记录失败原因。
 
    g. **继续下一个可执行任务**
@@ -481,8 +483,8 @@ argument-hint: "[change-name] [capability-name] [上下文文件...]"
 > - 在 Windows Bash / Git Bash / Claude Bash 中，禁止裸写 Windows 反斜杠绝对路径（如 `D:\project\demo`）；如必须使用绝对路径，请写成正斜杠路径或加引号。
 > - 不要省略 `--source=opsx-command` 与 `--session-id=<会话ID>`。
 > **📊 Telemetry（必做，不得跳过）**
-> 每次编译检查后，必须记录构建事件：`node skywalk-sdd/log.js record --type=build_result --command=apply --project=. --change=<变更名称> --capability=<capability-name> --task-id=<TASK-ID> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/failure --summary="编译检查结果" --details-json="{\"build_results\":{\"command\":\"<实际编译命令>\",\"success\":true,\"duration_ms\":0,\"error_count\":0}}"`
-> 每完成一个任务，必须记录任务级结构化事件：`node skywalk-sdd/log.js record --type=task_update --command=apply --project=. --change=<变更名称> --capability=<capability-name> --task-id=<TASK-ID> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --status=completed --result=success --summary="<TASK-ID> 完成" --details-json="{\"files_changed\":[],\"build_results\":{\"command\":\"<实际编译命令>\",\"success\":true,\"duration_ms\":0,\"error_count\":0},\"test_results\":{\"command\":\"<实际测试命令>\",\"passed\":0,\"failed\":0,\"skipped\":0,\"coverage\":null,\"duration_ms\":0}}"`
-> AI 代码产出完成后，必须记录采纳率快照，但不得为了采集快照自动提交 commit。Git 可用时只读统计 SHA/diff；Git 不可用时使用 `vcs_mode=no-git` 和 `base_git_sha=null`：`node skywalk-sdd/log.js record --type=ai_adoption_review --command=apply --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --status=ai_snapshot --result=success --summary="AI 代码产出快照" --details-json="{\"ai_adoption\":{\"review_status\":\"ai_snapshot\",\"vcs_mode\":\"<readonly|no-git>\",\"base_git_sha\":\"<base_git_sha_or_null>\",\"ai_git_sha\":\"<ai_git_sha_or_null>\",\"ai_diff\":{\"files_changed\":0,\"added_lines\":null,\"deleted_lines\":null},\"notes\":\"未自动创建 Git 仓库，未自动提交 commit；仅记录可用统计\"}}"`
-> 若后续发生人工修改并完成采纳确认，必须补录最终采纳统计；若非 Git 项目，SHA 可填 `null`，采纳行数由人工或工具统计补录：`node skywalk-sdd/log.js record --type=ai_adoption_review --command=apply --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=manual --session-id=<会话ID> --status=final --result=success --summary="AI 代码采纳率人工确认" --details-json="{\"ai_adoption\":{\"review_status\":\"final\",\"vcs_mode\":\"<readonly|no-git>\",\"base_git_sha\":\"<base_git_sha_or_null>\",\"ai_git_sha\":\"<ai_git_sha_or_null>\",\"final_git_sha\":\"<final_git_sha_or_null>\",\"retained_lines\":0,\"rewritten_lines\":0,\"deleted_lines\":0,\"ai_diff\":{\"files_changed\":0,\"added_lines\":null,\"deleted_lines\":null},\"final_diff\":{\"files_changed\":0,\"added_lines\":null,\"deleted_lines\":null},\"notes\":\"只记录行数统计，不记录源码；非 Git 项目允许 SHA 为 null\"}}"`
-> 阶段结束时执行（必须成功）：`node skywalk-sdd/log.js end --event-id=<开头记录的event_id> --command=apply --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/failure --summary="实施结果摘要"`
+> 每次编译检查后，必须记录构建事件：`node skywalk-sdd/log.cjs record --type=build_result --command=apply --project=. --change=<变更名称> --capability=<capability-name> --task-id=<TASK-ID> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/failure --summary="编译检查结果" --details-json="{\"build_results\":{\"command\":\"<实际编译命令>\",\"success\":true,\"duration_ms\":0,\"error_count\":0}}"`
+> 每完成一个任务，必须记录任务级结构化事件：`node skywalk-sdd/log.cjs record --type=task_update --command=apply --project=. --change=<变更名称> --capability=<capability-name> --task-id=<TASK-ID> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --status=completed --result=success --summary="<TASK-ID> 完成" --details-json="{\"files_changed\":[],\"build_results\":{\"command\":\"<实际编译命令>\",\"success\":true,\"duration_ms\":0,\"error_count\":0},\"test_results\":{\"command\":\"<实际测试命令>\",\"passed\":0,\"failed\":0,\"skipped\":0,\"coverage\":null,\"duration_ms\":0}}"`
+> AI 代码产出完成后，必须记录采纳率快照，但不得为了采集快照自动提交 commit。Git 可用时只读统计 SHA/diff；Git 不可用时使用 `vcs_mode=no-git` 和 `base_git_sha=null`：`node skywalk-sdd/log.cjs record --type=ai_adoption_review --command=apply --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --status=ai_snapshot --result=success --summary="AI 代码产出快照" --details-json="{\"ai_adoption\":{\"review_status\":\"ai_snapshot\",\"vcs_mode\":\"<readonly|no-git>\",\"base_git_sha\":\"<base_git_sha_or_null>\",\"ai_git_sha\":\"<ai_git_sha_or_null>\",\"ai_diff\":{\"files_changed\":0,\"added_lines\":null,\"deleted_lines\":null},\"notes\":\"未自动创建 Git 仓库，未自动提交 commit；仅记录可用统计\"}}"`
+> 若后续发生人工修改并完成采纳确认，必须补录最终采纳统计；若非 Git 项目，SHA 可填 `null`，采纳行数由人工或工具统计补录：`node skywalk-sdd/log.cjs record --type=ai_adoption_review --command=apply --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=manual --session-id=<会话ID> --status=final --result=success --summary="AI 代码采纳率人工确认" --details-json="{\"ai_adoption\":{\"review_status\":\"final\",\"vcs_mode\":\"<readonly|no-git>\",\"base_git_sha\":\"<base_git_sha_or_null>\",\"ai_git_sha\":\"<ai_git_sha_or_null>\",\"final_git_sha\":\"<final_git_sha_or_null>\",\"retained_lines\":0,\"rewritten_lines\":0,\"deleted_lines\":0,\"ai_diff\":{\"files_changed\":0,\"added_lines\":null,\"deleted_lines\":null},\"final_diff\":{\"files_changed\":0,\"added_lines\":null,\"deleted_lines\":null},\"notes\":\"只记录行数统计，不记录源码；非 Git 项目允许 SHA 为 null\"}}"`
+> 阶段结束时执行（必须成功）：`node skywalk-sdd/log.cjs end --event-id=<开头记录的event_id> --command=apply --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/failure --summary="实施结果摘要"`

package/templates/opsx-commands/archive.md

@@ -20,7 +20,7 @@ argument-hint: "[change-name]"
 **核心原则**
 
 - `archive` 必须产生真实归档结果：活动目录 `openspec/changes/<name>/` 应被移出，归档目录位于 `openspec/changes/archive/<日期>-<name>/`。
-- 归档统一使用 `node skywalk-sdd/log.js archive-docs`，同时兼容 Simple 与 Full 两种文档结构。
+- 归档统一使用 `node skywalk-sdd/log.cjs archive-docs`，同时兼容 Simple 与 Full 两种文档结构。
 - 最终报告必须随着 `archive` 阶段成功结束自动生成，不再作为可选手工步骤。
 - 即使归档原因是“变更已完成实施”，未勾选的 `tasks.md/task.md` 项也不阻断归档；但必须写入 archive 详情和最终报告。
 
@@ -31,7 +31,7 @@ argument-hint: "[change-name]"
 ### 0. 记录阶段开始
 
 ```bash
-node skywalk-sdd/log.js start --command=archive --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>
+node skywalk-sdd/log.cjs start --command=archive --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>
 ```
 
 保存输出 JSON 中的 `event_id`。
@@ -63,7 +63,7 @@ openspec list
 归档前执行 doctor：
 
 ```bash
-node skywalk-sdd/log.js doctor --project=. --change=<变更名称>
+node skywalk-sdd/log.cjs doctor --project=. --change=<变更名称>
 ```
 
 处理规则：
@@ -76,7 +76,7 @@ node skywalk-sdd/log.js doctor --project=. --change=<变更名称>
 始终扫描 Simple 和 Full 两种布局下的所有 `tasks.md/task.md`：
 
 ```bash
-node skywalk-sdd/log.js tasks-status --project=. --change=<变更名称>
+node skywalk-sdd/log.cjs tasks-status --project=. --change=<变更名称>
 ```
 
 处理规则：
@@ -89,7 +89,7 @@ node skywalk-sdd/log.js tasks-status --project=. --change=<变更名称>
 执行：
 
 ```bash
-node skywalk-sdd/log.js archive-docs --project=. --change=<变更名称> --reason="<归档原因>" --event-id=<event_id> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --report-output=skywalk-sdd/reports/<变更名称>-report.md
+node skywalk-sdd/log.cjs archive-docs --project=. --change=<变更名称> --reason="<归档原因>" --event-id=<event_id> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --report-output=skywalk-sdd/reports/<变更名称>-report.md
 ```
 
 该命令必须一次完成：
@@ -103,7 +103,7 @@ node skywalk-sdd/log.js archive-docs --project=. --change=<变更名称> --reaso
 如果命令失败，必须以失败状态结束 telemetry：
 
 ```bash
-node skywalk-sdd/log.js end --event-id=<event_id> --command=archive --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=failure --summary="归档失败：<失败原因>"
+node skywalk-sdd/log.cjs end --event-id=<event_id> --command=archive --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=failure --summary="归档失败：<失败原因>"
 ```
 
 失败时不要输出“归档完成”。
@@ -126,13 +126,13 @@ node skywalk-sdd/log.js end --event-id=<event_id> --command=archive --project=.
 如用户愿意提供反馈，可补录问卷结果：
 
 ```bash
-node skywalk-sdd/log.js record --type=survey_result --command=archive --project=. --change=<变更名称> --agent=<Agent类型> --source=manual --session-id=<会话ID> --result=success --summary="SDD 人工反馈" --details-json="{\"survey_result\":{\"nps\":9,\"cognitive_load\":3,\"spec_fatigue_index\":2,\"satisfaction\":8,\"respondent_role\":\"developer\",\"collected_at\":\"<ISO时间>\",\"notes\":\"\"}}"
+node skywalk-sdd/log.cjs record --type=survey_result --command=archive --project=. --change=<变更名称> --agent=<Agent类型> --source=manual --session-id=<会话ID> --result=success --summary="SDD 人工反馈" --details-json="{\"survey_result\":{\"nps\":9,\"cognitive_load\":3,\"spec_fatigue_index\":2,\"satisfaction\":8,\"respondent_role\":\"developer\",\"collected_at\":\"<ISO时间>\",\"notes\":\"\"}}"
 ```
 
 如团队有传统方式工时基线，可补录 baseline：
 
 ```bash
-node skywalk-sdd/log.js record --type=baseline_record --command=archive --project=. --change=<变更名称> --agent=<Agent类型> --source=manual --session-id=<会话ID> --result=success --summary="传统工时基线" --details-json="{\"baseline_record\":{\"traditional_hours\":10,\"sdd_hours\":6,\"task_type\":\"feature\",\"baseline_source\":\"manual-estimate\",\"collected_at\":\"<ISO时间>\",\"notes\":\"\"}}"
+node skywalk-sdd/log.cjs record --type=baseline_record --command=archive --project=. --change=<变更名称> --agent=<Agent类型> --source=manual --session-id=<会话ID> --result=success --summary="传统工时基线" --details-json="{\"baseline_record\":{\"traditional_hours\":10,\"sdd_hours\":6,\"task_type\":\"feature\",\"baseline_source\":\"manual-estimate\",\"collected_at\":\"<ISO时间>\",\"notes\":\"\"}}"
 ```
 
 ---

package/templates/opsx-commands/check.md

@@ -12,7 +12,7 @@ argument-hint: "[change-name] [上下文文件...]"
 > - 在 Windows Bash / Git Bash / Claude Bash 中，禁止裸写 Windows 反斜杠绝对路径（如 `D:\project\demo`）；如必须使用绝对路径，请写成正斜杠路径或加引号。
 > - 不要省略 `--source=opsx-command` 与 `--session-id=<会话ID>`。
 > **📊 Telemetry（必做，不得跳过）**
-> 在终端执行（必须成功）：`node skywalk-sdd/log.js start --command=check --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`，记录返回的 event_id。
+> 在终端执行（必须成功）：`node skywalk-sdd/log.cjs start --command=check --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`，记录返回的 event_id。
 
 > **⚠️ 阶段边界提示**
 >
@@ -31,7 +31,7 @@ argument-hint: "[change-name] [上下文文件...]"
 
    在终端执行（若命令失败必须中止本阶段，不得跳过）：
    ```bash
-   node skywalk-sdd/log.js start --command=check --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>
+   node skywalk-sdd/log.cjs start --command=check --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>
    ```
    保存输出 JSON 中的 `event_id`，供阶段结束使用。
 
@@ -170,7 +170,7 @@ argument-hint: "[change-name] [上下文文件...]"
    执行：
 
    ```bash
-   node skywalk-sdd/log.js tasks-status --project=. --change=<变更名称>
+   node skywalk-sdd/log.cjs tasks-status --project=. --change=<变更名称>
    ```
 
    判定规则：
@@ -317,7 +317,7 @@ argument-hint: "[change-name] [上下文文件...]"
    | | | |
 
    ## 任务完成状态
-   - 检查命令：`node skywalk-sdd/log.js tasks-status --project=. --change=<name>`
+   - 检查命令：`node skywalk-sdd/log.cjs tasks-status --project=. --change=<name>`
    - 状态口径：task 阶段允许未勾选；apply/test/archive readiness 阶段不得把未勾选项静默视为完成。
    - 未勾选项清单：列出文件、行号、原文。
 
@@ -402,7 +402,7 @@ argument-hint: "[change-name] [上下文文件...]"
 
    在终端执行（必须成功）：
    ```bash
-   node skywalk-sdd/log.js record --type=check_result --command=check --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/partial/failure --summary="检查结果摘要" --details-json="{\"check_results\":{\"total\":0,\"errors\":0,\"warnings\":0,\"suggestions\":0,\"fixed_before_apply\":0,\"consistency_score\":null,\"categories\":{\"completeness\":{\"passed\":0,\"total\":0},\"consistency\":{\"passed\":0,\"total\":0},\"executability\":{\"passed\":0,\"total\":0}},\"task_completion\":{\"completed\":0,\"incomplete\":0,\"total\":0,\"has_incomplete\":false,\"checked_for_archive_readiness\":false}}}"
+   node skywalk-sdd/log.cjs record --type=check_result --command=check --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/partial/failure --summary="检查结果摘要" --details-json="{\"check_results\":{\"total\":0,\"errors\":0,\"warnings\":0,\"suggestions\":0,\"fixed_before_apply\":0,\"consistency_score\":null,\"categories\":{\"completeness\":{\"passed\":0,\"total\":0},\"consistency\":{\"passed\":0,\"total\":0},\"executability\":{\"passed\":0,\"total\":0}},\"task_completion\":{\"completed\":0,\"incomplete\":0,\"total\":0,\"has_incomplete\":false,\"checked_for_archive_readiness\":false}}}"
    ```
 
 12. **【Telemetry 建议】记录规约符合度 Q1**
@@ -437,7 +437,7 @@ argument-hint: "[change-name] [上下文文件...]"
 
    在终端执行（若存在实现代码则必须成功）：
    ```bash
-   node skywalk-sdd/log.js record --type=conformance_review --command=check --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=manual --session-id=<会话ID> --result=success --summary="规约符合度人工确认" --details-json="{\"conformance_review\":{\"method\":\"llm-as-judge+manual\",\"manual_confirmed\":true,\"assertions\":[{\"id\":\"ASSERT-001\",\"description\":\"规约中的可验证断言\",\"judge_status\":\"matched\",\"human_status\":\"matched\",\"evidence\":\"代码、测试或文档证据摘要\",\"files\":[],\"notes\":\"\"}]}}"
+   node skywalk-sdd/log.cjs record --type=conformance_review --command=check --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=manual --session-id=<会话ID> --result=success --summary="规约符合度人工确认" --details-json="{\"conformance_review\":{\"method\":\"llm-as-judge+manual\",\"manual_confirmed\":true,\"assertions\":[{\"id\":\"ASSERT-001\",\"description\":\"规约中的可验证断言\",\"judge_status\":\"matched\",\"human_status\":\"matched\",\"evidence\":\"代码、测试或文档证据摘要\",\"files\":[],\"notes\":\"\"}]}}"
    ```
 
    若当前尚未进入实现阶段或无法验证代码，允许跳过 `conformance_review`，但需要在检查报告中说明原因。
@@ -459,5 +459,5 @@ argument-hint: "[change-name] [上下文文件...]"
 > - 在 Windows Bash / Git Bash / Claude Bash 中，禁止裸写 Windows 反斜杠绝对路径（如 `D:\project\demo`）；如必须使用绝对路径，请写成正斜杠路径或加引号。
 > - 不要省略 `--source=opsx-command` 与 `--session-id=<会话ID>`。
 > **📊 Telemetry（必做，不得跳过）**
-> 生成检查报告后，必须先记录结构化检查结果：`node skywalk-sdd/log.js record --type=check_result --command=check --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/partial/failure --summary="检查结果摘要" --details-json="{\"check_results\":{\"total\":0,\"errors\":0,\"warnings\":0,\"suggestions\":0,\"fixed_before_apply\":0,\"consistency_score\":null,\"categories\":{\"completeness\":{\"passed\":0,\"total\":0},\"consistency\":{\"passed\":0,\"total\":0},\"executability\":{\"passed\":0,\"total\":0}},\"task_completion\":{\"completed\":0,\"incomplete\":0,\"total\":0,\"has_incomplete\":false,\"checked_for_archive_readiness\":false}}}"`
-> `check_result` 记录成功后，才允许执行阶段结束：`node skywalk-sdd/log.js end --event-id=<开头记录的event_id> --command=check --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/partial/failure --summary="检查结果摘要" --details-json="{\"check_results\":{\"total\":0,\"errors\":0,\"warnings\":0,\"suggestions\":0,\"fixed_before_apply\":0,\"consistency_score\":null,\"categories\":{\"completeness\":{\"passed\":0,\"total\":0},\"consistency\":{\"passed\":0,\"total\":0},\"executability\":{\"passed\":0,\"total\":0}},\"task_completion\":{\"completed\":0,\"incomplete\":0,\"total\":0,\"has_incomplete\":false,\"checked_for_archive_readiness\":false}}}"`
+> 生成检查报告后，必须先记录结构化检查结果：`node skywalk-sdd/log.cjs record --type=check_result --command=check --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/partial/failure --summary="检查结果摘要" --details-json="{\"check_results\":{\"total\":0,\"errors\":0,\"warnings\":0,\"suggestions\":0,\"fixed_before_apply\":0,\"consistency_score\":null,\"categories\":{\"completeness\":{\"passed\":0,\"total\":0},\"consistency\":{\"passed\":0,\"total\":0},\"executability\":{\"passed\":0,\"total\":0}},\"task_completion\":{\"completed\":0,\"incomplete\":0,\"total\":0,\"has_incomplete\":false,\"checked_for_archive_readiness\":false}}}"`
+> `check_result` 记录成功后，才允许执行阶段结束：`node skywalk-sdd/log.cjs end --event-id=<开头记录的event_id> --command=check --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/partial/failure --summary="检查结果摘要" --details-json="{\"check_results\":{\"total\":0,\"errors\":0,\"warnings\":0,\"suggestions\":0,\"fixed_before_apply\":0,\"consistency_score\":null,\"categories\":{\"completeness\":{\"passed\":0,\"total\":0},\"consistency\":{\"passed\":0,\"total\":0},\"executability\":{\"passed\":0,\"total\":0}},\"task_completion\":{\"completed\":0,\"incomplete\":0,\"total\":0,\"has_incomplete\":false,\"checked_for_archive_readiness\":false}}}"`

package/templates/opsx-commands/design.md

@@ -12,7 +12,7 @@ argument-hint: "[change-name] [capability-name] [上下文文件...]"
 > - 在 Windows Bash / Git Bash / Claude Bash 中，禁止裸写 Windows 反斜杠绝对路径（如 `D:\project\demo`）；如必须使用绝对路径，请写成正斜杠路径或加引号。
 > - 不要省略 `--source=opsx-command` 与 `--session-id=<会话ID>`。
 > **📊 Telemetry（必做，不得跳过）**
-> 在终端执行（必须成功）：`node skywalk-sdd/log.js start --command=design --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`，记录返回的 event_id。
+> 在终端执行（必须成功）：`node skywalk-sdd/log.cjs start --command=design --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`，记录返回的 event_id。
 
 > **⚠️ 阶段边界提示**
 >
@@ -41,7 +41,7 @@ argument-hint: "[change-name] [capability-name] [上下文文件...]"
 
    在终端执行（若命令失败必须中止本阶段，不得跳过）：
    ```bash
-   node skywalk-sdd/log.js start --command=design --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>
+   node skywalk-sdd/log.cjs start --command=design --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>
    ```
    保存输出 JSON 中的 `event_id`，供阶段结束使用。
 
@@ -567,4 +567,4 @@ argument-hint: "[change-name] [capability-name] [上下文文件...]"
 > - 在 Windows Bash / Git Bash / Claude Bash 中，禁止裸写 Windows 反斜杠绝对路径（如 `D:\project\demo`）；如必须使用绝对路径，请写成正斜杠路径或加引号。
 > - 不要省略 `--source=opsx-command` 与 `--session-id=<会话ID>`。
 > **📊 Telemetry（必做，不得跳过）**
-> 在终端执行（必须成功）：`node skywalk-sdd/log.js end --event-id=<开头记录的event_id> --command=design --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/failure --summary="一句话摘要"`
+> 在终端执行（必须成功）：`node skywalk-sdd/log.cjs end --event-id=<开头记录的event_id> --command=design --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/failure --summary="一句话摘要"`

package/templates/opsx-commands/explore.md

@@ -12,7 +12,7 @@ argument-hint: "[change-name]"
 > - 在 Windows Bash / Git Bash / Claude Bash 中，禁止裸写 Windows 反斜杠绝对路径（如 `D:\project\demo`）；如必须使用绝对路径，请写成正斜杠路径或加引号。
 > - 不要省略 `--source=opsx-command` 与 `--session-id=<会话ID>`。
 > **📊 Telemetry（必做，不得跳过）**
-> 在终端执行（必须成功）：`node skywalk-sdd/log.js start --command=explore --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`，记录返回的 event_id。
+> 在终端执行（必须成功）：`node skywalk-sdd/log.cjs start --command=explore --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`，记录返回的 event_id。
 
 ---
 
@@ -24,7 +24,7 @@ argument-hint: "[change-name]"
 
    在终端执行（若命令失败必须中止本阶段，不得跳过）：
    ```bash
-   node skywalk-sdd/log.js start --command=explore --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>
+   node skywalk-sdd/log.cjs start --command=explore --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>
    ```
    保存输出 JSON 中的 `event_id`，供阶段结束使用。
 
@@ -96,4 +96,4 @@ argument-hint: "[change-name]"
 > - 在 Windows Bash / Git Bash / Claude Bash 中，禁止裸写 Windows 反斜杠绝对路径（如 `D:\project\demo`）；如必须使用绝对路径，请写成正斜杠路径或加引号。
 > - 不要省略 `--source=opsx-command` 与 `--session-id=<会话ID>`。
 > **📊 Telemetry（必做，不得跳过）**
-> 在终端执行（必须成功）：`node skywalk-sdd/log.js end --event-id=<开头记录的event_id> --command=explore --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success --summary="浏览结果摘要"`
+> 在终端执行（必须成功）：`node skywalk-sdd/log.cjs end --event-id=<开头记录的event_id> --command=explore --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success --summary="浏览结果摘要"`

package/templates/opsx-commands/propose.md

@@ -13,7 +13,7 @@ argument-hint: "[change-name] [上下文文件...]"
 > - 不要省略 `--source=opsx-command` 与 `--session-id=<会话ID>`。
 
 > **📊 Telemetry（必做，不得跳过）**
-> 在终端执行（必须成功）：`node skywalk-sdd/log.js start --command=propose --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`，记录返回的 event_id。
+> 在终端执行（必须成功）：`node skywalk-sdd/log.cjs start --command=propose --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`，记录返回的 event_id。
 
 > **⚠️ 阶段边界提示**
 >
@@ -34,7 +34,7 @@ argument-hint: "[change-name] [上下文文件...]"
 
    在终端执行（若命令失败必须中止本阶段，不得跳过）：
    ```bash
-   node skywalk-sdd/log.js start --command=propose --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>
+   node skywalk-sdd/log.cjs start --command=propose --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>
    ```
    保存输出 JSON 中的 `event_id`，供阶段结束使用。
 
@@ -402,4 +402,4 @@ argument-hint: "[change-name] [上下文文件...]"
 - **⛔ 单阶段原则：完成 proposal.md 后必须立即停止**。仅提示用户下一步可运行 `/opsx:spec`，**绝对禁止自动执行 spec/design/task 等后续阶段**。每个阶段必须由用户主动触发。
 
 > **📊 Telemetry（必做，不得跳过）**
-> 在终端执行（必须成功）：`node skywalk-sdd/log.js end --event-id=<开头记录的event_id> --command=propose --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/failure --summary="一句话摘要"`
+> 在终端执行（必须成功）：`node skywalk-sdd/log.cjs end --event-id=<开头记录的event_id> --command=propose --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/failure --summary="一句话摘要"`

package/templates/opsx-commands/spec.md

@@ -12,7 +12,7 @@ argument-hint: "[change-name] [上下文文件...]"
 > - 在 Windows Bash / Git Bash / Claude Bash 中，禁止裸写 Windows 反斜杠绝对路径（如 `D:\project\demo`）；如必须使用绝对路径，请写成正斜杠路径或加引号。
 > - 不要省略 `--source=opsx-command` 与 `--session-id=<会话ID>`。
 > **📊 Telemetry（必做，不得跳过）**
-> 在终端执行（必须成功）：`node skywalk-sdd/log.js start --command=spec --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`，记录返回的 event_id。
+> 在终端执行（必须成功）：`node skywalk-sdd/log.cjs start --command=spec --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`，记录返回的 event_id。
 
 > **⚠️ 阶段边界提示**
 >
@@ -49,7 +49,7 @@ openspec/changes/<name>/
 
    在终端执行（若命令失败必须中止本阶段，不得跳过）：
    ```bash
-   node skywalk-sdd/log.js start --command=spec --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>
+   node skywalk-sdd/log.cjs start --command=spec --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>
    ```
    保存输出 JSON 中的 `event_id`，供阶段结束使用。
 
@@ -523,4 +523,4 @@ openspec/changes/<name>/
 > - 在 Windows Bash / Git Bash / Claude Bash 中，禁止裸写 Windows 反斜杠绝对路径（如 `D:\project\demo`）；如必须使用绝对路径，请写成正斜杠路径或加引号。
 > - 不要省略 `--source=opsx-command` 与 `--session-id=<会话ID>`。
 > **📊 Telemetry（必做，不得跳过）**
-> 在终端执行（必须成功）：`node skywalk-sdd/log.js end --event-id=<开头记录的event_id> --command=spec --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/failure --summary="一句话摘要"`
+> 在终端执行（必须成功）：`node skywalk-sdd/log.cjs end --event-id=<开头记录的event_id> --command=spec --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/failure --summary="一句话摘要"`

package/templates/opsx-commands/task.md

@@ -12,7 +12,7 @@ argument-hint: "[change-name] [capability-name] [上下文文件...]"
 > - 在 Windows Bash / Git Bash / Claude Bash 中，禁止裸写 Windows 反斜杠绝对路径（如 `D:\project\demo`）；如必须使用绝对路径，请写成正斜杠路径或加引号。
 > - 不要省略 `--source=opsx-command` 与 `--session-id=<会话ID>`。
 > **📊 Telemetry（必做，不得跳过）**
-> 在终端执行（必须成功）：`node skywalk-sdd/log.js start --command=task --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`，记录返回的 event_id。
+> 在终端执行（必须成功）：`node skywalk-sdd/log.cjs start --command=task --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`，记录返回的 event_id。
 
 > **⚠️ 阶段边界提示**
 >
@@ -42,7 +42,7 @@ argument-hint: "[change-name] [capability-name] [上下文文件...]"
 
    在终端执行（若命令失败必须中止本阶段，不得跳过）：
    ```bash
-   node skywalk-sdd/log.js start --command=task --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>
+   node skywalk-sdd/log.cjs start --command=task --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>
    ```
    保存输出 JSON 中的 `event_id`，供阶段结束使用。
 
@@ -430,4 +430,4 @@ argument-hint: "[change-name] [capability-name] [上下文文件...]"
 > - 在 Windows Bash / Git Bash / Claude Bash 中，禁止裸写 Windows 反斜杠绝对路径（如 `D:\project\demo`）；如必须使用绝对路径，请写成正斜杠路径或加引号。
 > - 不要省略 `--source=opsx-command` 与 `--session-id=<会话ID>`。
 > **📊 Telemetry（必做，不得跳过）**
-> 在终端执行（必须成功）：`node skywalk-sdd/log.js end --event-id=<开头记录的event_id> --command=task --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/failure --summary="一句话摘要"`
+> 在终端执行（必须成功）：`node skywalk-sdd/log.cjs end --event-id=<开头记录的event_id> --command=task --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/failure --summary="一句话摘要"`

package/templates/opsx-commands/test.md

@@ -12,7 +12,7 @@ argument-hint: "[test-scope] [options]"
 > - 在 Windows Bash / Git Bash / Claude Bash 中，禁止裸写 Windows 反斜杠绝对路径（如 `D:\project\demo`）；如必须使用绝对路径，请写成正斜杠路径或加引号。
 > - 不要省略 `--source=opsx-command` 与 `--session-id=<会话ID>`。
 > **📊 Telemetry（必做，不得跳过）**
-> 在终端执行（必须成功）：`node skywalk-sdd/log.js start --command=test --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`，记录返回的 event_id。
+> 在终端执行（必须成功）：`node skywalk-sdd/log.cjs start --command=test --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`，记录返回的 event_id。
 
 > **⚠️ 命令定位**
 >
@@ -28,7 +28,7 @@ argument-hint: "[test-scope] [options]"
 
    在终端执行（若命令失败必须中止本阶段，不得跳过）：
    ```bash
-   node skywalk-sdd/log.js start --command=test --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>
+   node skywalk-sdd/log.cjs start --command=test --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>
    ```
    保存输出 JSON 中的 `event_id`，供阶段结束使用。
 
@@ -239,6 +239,6 @@ argument-hint: "[test-scope] [options]"
 > - 在 Windows Bash / Git Bash / Claude Bash 中，禁止裸写 Windows 反斜杠绝对路径（如 `D:\project\demo`）；如必须使用绝对路径，请写成正斜杠路径或加引号。
 > - 不要省略 `--source=opsx-command` 与 `--session-id=<会话ID>`。
 > **📊 Telemetry（必做，不得跳过）**
-> 测试运行后，必须记录结构化测试结果：`node skywalk-sdd/log.js record --type=test_result --command=test --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/failure --summary="测试结果摘要" --details-json="{\"test_results\":{\"command\":\"<实际测试命令>\",\"passed\":0,\"failed\":0,\"skipped\":0,\"coverage\":null,\"duration_ms\":0}}"`
-> 若 spec.md 中有可识别场景 ID，且测试能映射到这些场景，建议记录 Q4 规约驱动测试覆盖率（可选，不阻塞测试流程）：`node skywalk-sdd/log.js record --type=coverage_result --command=test --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/partial/failure --summary="规约场景测试覆盖率" --details-json="{\"spec_test_coverage\":{\"mappings\":[{\"scenario_id\":\"SCN-001\",\"description\":\"规约场景摘要\",\"test_ids\":[\"<测试文件或用例ID>\"],\"status\":\"covered\",\"notes\":\"\"}]}}"`
-> 阶段结束时执行（必须成功）：`node skywalk-sdd/log.js end --event-id=<开头记录的event_id> --command=test --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/failure --summary="测试结果摘要" --details-json="{\"test_results\":{\"command\":\"<实际测试命令>\",\"passed\":0,\"failed\":0,\"skipped\":0,\"coverage\":null,\"duration_ms\":0}}"`
+> 测试运行后，必须记录结构化测试结果：`node skywalk-sdd/log.cjs record --type=test_result --command=test --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/failure --summary="测试结果摘要" --details-json="{\"test_results\":{\"command\":\"<实际测试命令>\",\"passed\":0,\"failed\":0,\"skipped\":0,\"coverage\":null,\"duration_ms\":0}}"`
+> 若 spec.md 中有可识别场景 ID，且测试能映射到这些场景，建议记录 Q4 规约驱动测试覆盖率（可选，不阻塞测试流程）：`node skywalk-sdd/log.cjs record --type=coverage_result --command=test --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/partial/failure --summary="规约场景测试覆盖率" --details-json="{\"spec_test_coverage\":{\"mappings\":[{\"scenario_id\":\"SCN-001\",\"description\":\"规约场景摘要\",\"test_ids\":[\"<测试文件或用例ID>\"],\"status\":\"covered\",\"notes\":\"\"}]}}"`
+> 阶段结束时执行（必须成功）：`node skywalk-sdd/log.cjs end --event-id=<开头记录的event_id> --command=test --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/failure --summary="测试结果摘要" --details-json="{\"test_results\":{\"command\":\"<实际测试命令>\",\"passed\":0,\"failed\":0,\"skipped\":0,\"coverage\":null,\"duration_ms\":0}}"`

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

@@ -29,8 +29,8 @@ allowed-tools:
 > - 在 Windows Bash / Git Bash / Claude Bash 中，禁止裸写 Windows 反斜杠绝对路径（如 `D:\project\demo`）；如必须使用绝对路径，请写成正斜杠路径或加引号。
 > - 不要省略 `--source=opsx-command` 与 `--session-id=<会话ID>`。
 > **📊 Telemetry（必做，不得跳过）**
-> - 阶段开始：`node skywalk-sdd/log.js start --command=apply --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --git-sha=<base_git_sha_or_none>`（保存 event_id）
-> - 阶段结束：`node skywalk-sdd/log.js end --event-id=<event_id> --command=apply --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success|failure --summary="摘要"`
+> - 阶段开始：`node skywalk-sdd/log.cjs start --command=apply --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --git-sha=<base_git_sha_or_none>`（保存 event_id）
+> - 阶段结束：`node skywalk-sdd/log.cjs end --event-id=<event_id> --command=apply --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success|failure --summary="摘要"`
 
 > **🔒 Git 策略（只读增强，不改变开发流）**
 > - Git 只作为可选度量数据源，不是 apply 前置条件。
@@ -187,8 +187,9 @@ f. **⛔ 立即更新任务状态**
    - 显示进度：`✅ [TASK-ID] 已完成 [N/M]`
    - 记录任务级 Telemetry：
      ```bash
-     node skywalk-sdd/log.js record --type=task_update --command=apply --project=. --change=<变更名称> --capability=<capability-name> --task-id=<TASK-ID> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --status=completed --result=success --summary="<TASK-ID> 完成" --details-json="{\"files_changed\":[],\"build_results\":{\"command\":\"<实际编译命令>\",\"success\":true,\"duration_ms\":0,\"error_count\":0},\"test_results\":{\"command\":\"<实际测试命令>\",\"passed\":0,\"failed\":0,\"skipped\":0,\"coverage\":null,\"duration_ms\":0}}"
+     node skywalk-sdd/log.cjs record --type=task_update --command=apply --project=. --change=<变更名称> --capability=<capability-name> --task-id=<TASK-ID> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --status=completed --result=success --summary="<TASK-ID> 完成" --details-json="{\"files_changed\":[],\"build_results\":{\"command\":\"<实际编译命令>\",\"success\":true,\"duration_ms\":0,\"error_count\":0},\"test_results\":{\"command\":\"<实际测试命令>\",\"passed\":0,\"failed\":0,\"skipped\":0,\"coverage\":null,\"duration_ms\":0}}"
      ```
+     **⚠️ 注意**：`--task-id=<TASK-ID>` 必须替换为实际任务 ID，否则 E4 指标无法计算。
 
 g. **继续下一个可执行任务**
 
@@ -196,9 +197,12 @@ g. **继续下一个可执行任务**
 
 当前 Capability 的 AI 代码产出完成后，必须记录 `ai_adoption_review`，但不得为了采集快照自动提交 commit。
 
+- `--status=ai_snapshot` 用于记录 AI 初始产出快照，P2 指标在无 final 事件时会使用此快照数据
+- 若用户进行了人工 review 并确认保留率，可补录 `--status=final` 事件（`review_status: "final"`），P2 指标将优先使用 final 数据
+
 Git 可用时只读统计 SHA/diff；Git 不可用时使用 `vcs_mode=no-git` 和 `base_git_sha=null`：
 ```bash
-node skywalk-sdd/log.js record --type=ai_adoption_review --command=apply --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --status=ai_snapshot --result=success --summary="AI 代码产出快照" --details-json="{\"ai_adoption\":{\"review_status\":\"ai_snapshot\",\"vcs_mode\":\"<readonly|no-git>\",\"base_git_sha\":\"<base_git_sha_or_null>\",\"ai_git_sha\":\"<ai_git_sha_or_null>\",\"ai_diff\":{\"files_changed\":0,\"added_lines\":null,\"deleted_lines\":null},\"notes\":\"未自动创建 Git 仓库，未自动提交 commit；仅记录可用统计\"}}"
+node skywalk-sdd/log.cjs record --type=ai_adoption_review --command=apply --project=. --change=<变更名称> --capability=<capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --status=ai_snapshot --result=success --summary="AI 代码产出快照" --details-json="{\"ai_adoption\":{\"review_status\":\"ai_snapshot\",\"vcs_mode\":\"<readonly|no-git>\",\"base_git_sha\":\"<base_git_sha_or_null>\",\"ai_git_sha\":\"<ai_git_sha_or_null>\",\"ai_diff\":{\"files_changed\":0,\"added_lines\":null,\"deleted_lines\":null},\"notes\":\"未自动创建 Git 仓库，未自动提交 commit；仅记录可用统计\"}}"
 ```
 
 ### 6. 完成或暂停时显示状态

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

@@ -3,7 +3,7 @@ name: opsx-archive
 description: "归档变更技能 - 将已结束的 SDD 变更真实移入 archive，并生成最终中文度量报告"
 argument-hint: "[change-name]"
 license: MIT
-compatibility: Requires skywalk-sdd/log.js.
+compatibility: Requires skywalk-sdd/log.cjs.
 metadata:
   author: sdd-team
   version: "3.2"
@@ -48,7 +48,7 @@ openspec list
 让用户选择现有变更。确认后记录阶段开始：
 
 ```bash
-node skywalk-sdd/log.js start --command=archive --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>
+node skywalk-sdd/log.cjs start --command=archive --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>
 ```
 
 保存 `event_id`。
@@ -68,7 +68,7 @@ node skywalk-sdd/log.js start --command=archive --project=. --change=<变更名
 ### 3. 运行 telemetry doctor
 
 ```bash
-node skywalk-sdd/log.js doctor --project=. --change=<变更名称>
+node skywalk-sdd/log.cjs doctor --project=. --change=<变更名称>
 ```
 
 如果存在 `severe_issues`，暂停归档并说明必须先修复。`superseded_open_stages` 和 `rework_summary` 只作为返工/重复执行展示，不要求用户人工区分测试回滚或真实研发返工。
@@ -76,7 +76,7 @@ node skywalk-sdd/log.js doctor --project=. --change=<变更名称>
 ### 4. 扫描 tasks 完成状态
 
 ```bash
-node skywalk-sdd/log.js tasks-status --project=. --change=<变更名称>
+node skywalk-sdd/log.cjs tasks-status --project=. --change=<变更名称>
 ```
 
 即使用户选择“变更已完成实施”，未勾选项也不阻断归档。它可能代表任务真实未完成，也可能代表代码已完成但文档未同步；不要猜测，也不要静默忽略。最终必须让 `archive-docs` 将其写入 `archive_result.task_completion` 和报告。
@@ -86,7 +86,7 @@ node skywalk-sdd/log.js tasks-status --project=. --change=<变更名称>
 执行唯一归档命令：
 
 ```bash
-node skywalk-sdd/log.js archive-docs --project=. --change=<变更名称> --reason="<归档原因>" --event-id=<event_id> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --report-output=skywalk-sdd/reports/<变更名称>-report.md
+node skywalk-sdd/log.cjs archive-docs --project=. --change=<变更名称> --reason="<归档原因>" --event-id=<event_id> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --report-output=skywalk-sdd/reports/<变更名称>-report.md
 ```
 
 该命令成功后必须已经完成：
@@ -100,7 +100,7 @@ node skywalk-sdd/log.js archive-docs --project=. --change=<变更名称> --reaso
 如果该命令失败，以失败状态结束 telemetry：
 
 ```bash
-node skywalk-sdd/log.js end --event-id=<event_id> --command=archive --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=failure --summary="归档失败：<失败原因>"
+node skywalk-sdd/log.cjs end --event-id=<event_id> --command=archive --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=failure --summary="归档失败：<失败原因>"
 ```
 
 失败时不要输出“归档完成”。
@@ -124,13 +124,13 @@ node skywalk-sdd/log.js end --event-id=<event_id> --command=archive --project=.
 如用户愿意提供反馈，可补录问卷结果：
 
 ```bash
-node skywalk-sdd/log.js record --type=survey_result --command=archive --project=. --change=<变更名称> --agent=<Agent类型> --source=manual --session-id=<会话ID> --result=success --summary="SDD 人工反馈" --details-json="{\"survey_result\":{\"nps\":9,\"cognitive_load\":3,\"spec_fatigue_index\":2,\"satisfaction\":8,\"respondent_role\":\"developer\",\"collected_at\":\"<ISO时间>\",\"notes\":\"\"}}"
+node skywalk-sdd/log.cjs record --type=survey_result --command=archive --project=. --change=<变更名称> --agent=<Agent类型> --source=manual --session-id=<会话ID> --result=success --summary="SDD 人工反馈" --details-json="{\"survey_result\":{\"nps\":9,\"cognitive_load\":3,\"spec_fatigue_index\":2,\"satisfaction\":8,\"respondent_role\":\"developer\",\"collected_at\":\"<ISO时间>\",\"notes\":\"\"}}"
 ```
 
 如团队有传统方式工时基线，可补录 baseline：
 
 ```bash
-node skywalk-sdd/log.js record --type=baseline_record --command=archive --project=. --change=<变更名称> --agent=<Agent类型> --source=manual --session-id=<会话ID> --result=success --summary="传统工时基线" --details-json="{\"baseline_record\":{\"traditional_hours\":10,\"sdd_hours\":6,\"task_type\":\"feature\",\"baseline_source\":\"manual-estimate\",\"collected_at\":\"<ISO时间>\",\"notes\":\"\"}}"
+node skywalk-sdd/log.cjs record --type=baseline_record --command=archive --project=. --change=<变更名称> --agent=<Agent类型> --source=manual --session-id=<会话ID> --result=success --summary="传统工时基线" --details-json="{\"baseline_record\":{\"traditional_hours\":10,\"sdd_hours\":6,\"task_type\":\"feature\",\"baseline_source\":\"manual-estimate\",\"collected_at\":\"<ISO时间>\",\"notes\":\"\"}}"
 ```
 
 ---

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

@@ -32,9 +32,9 @@ allowed-tools:
 > - 在 Windows Bash / Git Bash / Claude Bash 中，禁止裸写 Windows 反斜杠绝对路径（如 `D:\project\demo`）；如必须使用绝对路径，请写成正斜杠路径或加引号。
 > - 不要省略 `--source=opsx-command` 与 `--session-id=<会话ID>`。
 > **📊 Telemetry（必做，不得跳过）**
-> - 阶段开始：`node skywalk-sdd/log.js start --command=check --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`（保存 event_id）
-> - 检查报告生成后，必须先记录结构化检查结果：`node skywalk-sdd/log.js record --type=check_result --command=check --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/partial/failure --summary="检查结果摘要" --details-json="{\"check_results\":{\"total\":0,\"errors\":0,\"warnings\":0,\"suggestions\":0,\"fixed_before_apply\":0,\"consistency_score\":null,\"categories\":{\"completeness\":{\"passed\":0,\"total\":0},\"consistency\":{\"passed\":0,\"total\":0},\"executability\":{\"passed\":0,\"total\":0}},\"task_completion\":{\"completed\":0,\"incomplete\":0,\"total\":0,\"has_incomplete\":false,\"checked_for_archive_readiness\":false}}}"`
-> - `check_result` 记录成功后，才允许阶段结束：`node skywalk-sdd/log.js end --event-id=<event_id> --command=check --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/partial/failure --summary="摘要"`
+> - 阶段开始：`node skywalk-sdd/log.cjs start --command=check --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`（保存 event_id）
+> - 检查报告生成后，必须先记录结构化检查结果：`node skywalk-sdd/log.cjs record --type=check_result --command=check --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/partial/failure --summary="检查结果摘要" --details-json="{\"check_results\":{\"total\":0,\"errors\":0,\"warnings\":0,\"suggestions\":0,\"fixed_before_apply\":0,\"consistency_score\":null,\"categories\":{\"completeness\":{\"passed\":0,\"total\":0},\"consistency\":{\"passed\":0,\"total\":0},\"executability\":{\"passed\":0,\"total\":0}},\"task_completion\":{\"completed\":0,\"incomplete\":0,\"total\":0,\"has_incomplete\":false,\"checked_for_archive_readiness\":false}}}"`
+> - `check_result` 记录成功后，才允许阶段结束：`node skywalk-sdd/log.cjs end --event-id=<event_id> --command=check --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/partial/failure --summary="摘要"`
 
 ---
 
@@ -115,7 +115,7 @@ openspec list
 `task` 阶段允许 `tasks.md` 出现未完成项；这只是计划状态。但如果当前变更已经进入 apply 之后，或本次 check 发现实现代码、测试报告、`build_result/test_result/task_update/conformance_review` 等实施证据，必须检查任务勾选状态：
 
 ```bash
-node skywalk-sdd/log.js tasks-status --project=. --change=<变更名称>
+node skywalk-sdd/log.cjs tasks-status --project=. --change=<变更名称>
 ```
 
 判定规则：
@@ -156,12 +156,12 @@ node skywalk-sdd/log.js tasks-status --project=. --change=<变更名称>
 
 在终端执行（必须成功）：
 ```bash
-node skywalk-sdd/log.js record --type=check_result --command=check --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/partial/failure --summary="检查结果摘要" --details-json="{\"check_results\":{\"total\":0,\"errors\":0,\"warnings\":0,\"suggestions\":0,\"fixed_before_apply\":0,\"consistency_score\":null,\"categories\":{\"completeness\":{\"passed\":0,\"total\":0},\"consistency\":{\"passed\":0,\"total\":0},\"executability\":{\"passed\":0,\"total\":0}},\"task_completion\":{\"completed\":0,\"incomplete\":0,\"total\":0,\"has_incomplete\":false,\"checked_for_archive_readiness\":false}}}"
+node skywalk-sdd/log.cjs record --type=check_result --command=check --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success/partial/failure --summary="检查结果摘要" --details-json="{\"check_results\":{\"total\":0,\"errors\":0,\"warnings\":0,\"suggestions\":0,\"fixed_before_apply\":0,\"consistency_score\":null,\"categories\":{\"completeness\":{\"passed\":0,\"total\":0},\"consistency\":{\"passed\":0,\"total\":0},\"executability\":{\"passed\":0,\"total\":0}},\"task_completion\":{\"completed\":0,\"incomplete\":0,\"total\":0,\"has_incomplete\":false,\"checked_for_archive_readiness\":false}}}"
 ```
 
 若当前已有实现代码，并且能够验证 spec 断言，还应记录 `conformance_review`（用于 Q1 规约符合度）：
 ```bash
-node skywalk-sdd/log.js record --type=conformance_review --command=check --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=manual --session-id=<会话ID> --result=success --summary="规约符合度人工确认" --details-json="{\"conformance_review\":{\"method\":\"llm-as-judge+manual\",\"manual_confirmed\":true,\"assertions\":[{\"id\":\"ASSERT-001\",\"description\":\"规约中的可验证断言\",\"judge_status\":\"matched\",\"human_status\":\"matched\",\"evidence\":\"代码、测试或文档证据摘要\",\"files\":[],\"notes\":\"\"}]}}"
+node skywalk-sdd/log.cjs record --type=conformance_review --command=check --project=. --change=<变更名称> --capability=<可选capability-name> --agent=<Agent类型> --source=manual --session-id=<会话ID> --result=success --summary="规约符合度人工确认" --details-json="{\"conformance_review\":{\"method\":\"llm-as-judge+manual\",\"manual_confirmed\":true,\"assertions\":[{\"id\":\"ASSERT-001\",\"description\":\"规约中的可验证断言\",\"judge_status\":\"matched\",\"human_status\":\"matched\",\"evidence\":\"代码、测试或文档证据摘要\",\"files\":[],\"notes\":\"\"}]}}"
 ```
 
 ### 6. 【交互引导】根据结果引导下一步

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

@@ -40,8 +40,8 @@ allowed-tools:
 > - 在 Windows Bash / Git Bash / Claude Bash 中，禁止裸写 Windows 反斜杠绝对路径（如 `D:\project\demo`）；如必须使用绝对路径，请写成正斜杠路径或加引号。
 > - 不要省略 `--source=opsx-command` 与 `--session-id=<会话ID>`。
 > **📊 Telemetry（必做，不得跳过）**
-> - 阶段开始：`node skywalk-sdd/log.js start --command=design --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`（保存 event_id）
-> - 阶段结束：`node skywalk-sdd/log.js end --event-id=<event_id> --command=design --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success|failure --summary="摘要"`
+> - 阶段开始：`node skywalk-sdd/log.cjs start --command=design --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`（保存 event_id）
+> - 阶段结束：`node skywalk-sdd/log.cjs end --event-id=<event_id> --command=design --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success|failure --summary="摘要"`
 
 ---
 

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

@@ -23,8 +23,8 @@ allowed-tools:
 > - 在 Windows Bash / Git Bash / Claude Bash 中，禁止裸写 Windows 反斜杠绝对路径（如 `D:\project\demo`）；如必须使用绝对路径，请写成正斜杠路径或加引号。
 > - 不要省略 `--source=opsx-command` 与 `--session-id=<会话ID>`。
 > **📊 Telemetry（必做，不得跳过）**
-> - 阶段开始：`node skywalk-sdd/log.js start --command=explore --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`（保存 event_id）
-> - 阶段结束：`node skywalk-sdd/log.js end --event-id=<event_id> --command=explore --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success|failure --summary="摘要"`
+> - 阶段开始：`node skywalk-sdd/log.cjs start --command=explore --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`（保存 event_id）
+> - 阶段结束：`node skywalk-sdd/log.cjs end --event-id=<event_id> --command=explore --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success|failure --summary="摘要"`
 
 ---
 

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

@@ -34,8 +34,8 @@ allowed-tools:
 > - 在 Windows Bash / Git Bash / Claude Bash 中，禁止裸写 Windows 反斜杠绝对路径（如 `D:\project\demo`）；如必须使用绝对路径，请写成正斜杠路径或加引号。
 > - 不要省略 `--source=opsx-command` 与 `--session-id=<会话ID>`。
 > **📊 Telemetry（必做，不得跳过）**
-> - 阶段开始：`node skywalk-sdd/log.js start --command=propose --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`（保存 event_id）
-> - 阶段结束：`node skywalk-sdd/log.js end --event-id=<event_id> --command=propose --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success|failure --summary="摘要"`
+> - 阶段开始：`node skywalk-sdd/log.cjs start --command=propose --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`（保存 event_id）
+> - 阶段结束：`node skywalk-sdd/log.cjs end --event-id=<event_id> --command=propose --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success|failure --summary="摘要"`
 
 ---
 

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

@@ -34,8 +34,8 @@ allowed-tools:
 > - 在 Windows Bash / Git Bash / Claude Bash 中，禁止裸写 Windows 反斜杠绝对路径（如 `D:\project\demo`）；如必须使用绝对路径，请写成正斜杠路径或加引号。
 > - 不要省略 `--source=opsx-command` 与 `--session-id=<会话ID>`。
 > **📊 Telemetry（必做，不得跳过）**
-> - 阶段开始：`node skywalk-sdd/log.js start --command=spec --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`（保存 event_id）
-> - 阶段结束：`node skywalk-sdd/log.js end --event-id=<event_id> --command=spec --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success|failure --summary="摘要"`
+> - 阶段开始：`node skywalk-sdd/log.cjs start --command=spec --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`（保存 event_id）
+> - 阶段结束：`node skywalk-sdd/log.cjs end --event-id=<event_id> --command=spec --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success|failure --summary="摘要"`
 
 ---
 

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

@@ -41,8 +41,8 @@ allowed-tools:
 > - 在 Windows Bash / Git Bash / Claude Bash 中，禁止裸写 Windows 反斜杠绝对路径（如 `D:\project\demo`）；如必须使用绝对路径，请写成正斜杠路径或加引号。
 > - 不要省略 `--source=opsx-command` 与 `--session-id=<会话ID>`。
 > **📊 Telemetry（必做，不得跳过）**
-> - 阶段开始：`node skywalk-sdd/log.js start --command=task --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`（保存 event_id）
-> - 阶段结束：`node skywalk-sdd/log.js end --event-id=<event_id> --command=task --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success|failure --summary="摘要"`
+> - 阶段开始：`node skywalk-sdd/log.cjs start --command=task --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`（保存 event_id）
+> - 阶段结束：`node skywalk-sdd/log.cjs end --event-id=<event_id> --command=task --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success|failure --summary="摘要"`
 
 ---
 

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

@@ -29,8 +29,8 @@ allowed-tools:
 > - 在 Windows Bash / Git Bash / Claude Bash 中，禁止裸写 Windows 反斜杠绝对路径（如 `D:\project\demo`）；如必须使用绝对路径，请写成正斜杠路径或加引号。
 > - 不要省略 `--source=opsx-command` 与 `--session-id=<会话ID>`。
 > **📊 Telemetry（必做，不得跳过）**
-> - 阶段开始：`node skywalk-sdd/log.js start --command=test --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`（保存 event_id）
-> - 阶段结束：`node skywalk-sdd/log.js end --event-id=<event_id> --command=test --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success|failure --summary="摘要"`
+> - 阶段开始：`node skywalk-sdd/log.cjs start --command=test --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID>`（保存 event_id）
+> - 阶段结束：`node skywalk-sdd/log.cjs end --event-id=<event_id> --command=test --project=. --change=<变更名称> --agent=<Agent类型> --source=opsx-command --session-id=<会话ID> --result=success|failure --summary="摘要"`
 
 ---