@deepstorm/cli 0.9.1 → 0.9.3

package/dist/skills/reef-commit/scripts/run-tests.sh

@@ -0,0 +1,91 @@
+#!/bin/bash
+# run-tests.sh
+# 根据项目类型自动检测并运行测试。
+#
+# 用法:
+#   bash run-tests.sh              # 自动检测并运行
+#   bash run-tests.sh --json       # JSON 格式输出结果
+#   bash run-tests.sh --help       # 显示帮助
+
+set -euo pipefail
+
+MODE="text"
+for arg in "$@"; do
+  case "$arg" in
+    --json) MODE="json" ;;
+    --help|-h)
+      echo "用法: bash run-tests.sh [--json]"
+      echo "自动检测项目类型（Java/Python/Frontend）并运行测试"
+      exit 0
+      ;;
+  esac
+done
+
+FRONTEND_FAILED=false
+BACKEND_FAILED=false
+HAS_FRONTEND=false
+HAS_BACKEND=false
+
+# 检测后端
+if [ -f "build.gradle" ] || [ -f "build.gradle.kts" ]; then
+  HAS_BACKEND=true
+  echo "🔍 检测到 Gradle 项目，运行 ./gradlew test..."
+  if ./gradlew test 2>&1; then
+    echo "✅ Java 测试通过"
+  else
+    BACKEND_FAILED=true
+    echo "❌ Java 测试失败"
+  fi
+elif [ -f "pom.xml" ]; then
+  HAS_BACKEND=true
+  echo "🔍 检测到 Maven 项目，运行 mvn test..."
+  if mvn test 2>&1; then
+    echo "✅ Java 测试通过"
+  else
+    BACKEND_FAILED=true
+    echo "❌ Java 测试失败"
+  fi
+elif [ -f "pyproject.toml" ] || [ -f "pytest.ini" ]; then
+  HAS_BACKEND=true
+  echo "🔍 检测到 Python 项目，运行 pytest..."
+  if python -m pytest 2>&1; then
+    echo "✅ Python 测试通过"
+  else
+    BACKEND_FAILED=true
+    echo "❌ Python 测试失败"
+  fi
+fi
+
+# 检测前端
+if [ -f "package.json" ]; then
+  HAS_FRONTEND=true
+  echo "🔍 检测到前端项目，运行 pnpm test..."
+  if pnpm test -- --run 2>&1; then
+    echo "✅ 前端测试通过"
+  else
+    FRONTEND_FAILED=true
+    echo "❌ 前端测试失败"
+  fi
+fi
+
+if [ "$HAS_BACKEND" = false ] && [ "$HAS_FRONTEND" = false ]; then
+  echo "⚠️  未检测到可运行的测试项目"
+fi
+
+# JSON 输出
+if [ "$MODE" = "json" ]; then
+  cat <<EOF
+{
+  "hasFrontend": $HAS_FRONTEND,
+  "hasBackend": $HAS_BACKEND,
+  "frontendPassed": $( [ "$FRONTEND_FAILED" = false ] && echo "$HAS_FRONTEND" || echo false ),
+  "backendPassed": $( [ "$BACKEND_FAILED" = false ] && echo "$HAS_BACKEND" || echo false ),
+  "allPassed": $( [ "$FRONTEND_FAILED" = false ] && [ "$BACKEND_FAILED" = false ] && echo true || echo false )
+}
+EOF
+fi
+
+# exit code
+if [ "$FRONTEND_FAILED" = true ] || [ "$BACKEND_FAILED" = true ]; then
+  exit 1
+fi

package/dist/skills/reef-commit/scripts/stash-and-switch.sh

@@ -0,0 +1,44 @@
+#!/bin/bash
+# stash-and-switch.sh
+# git stash → checkout main → pull → checkout -b → stash pop
+#
+# 用法:
+#   bash stash-and-switch.sh <new-branch-name>
+#
+# 说明:
+#   自动处理 stash 保存和恢复当前工作区变更。
+#   新分支基于 main 的最新提交。
+
+set -euo pipefail
+
+if [ $# -lt 1 ]; then
+  echo "用法: bash $0 <new-branch-name>"
+  exit 1
+fi
+
+NEW_BRANCH="$1"
+STASHED=false
+
+# stash 当前变更（如有）
+if [ -n "$(git status --porcelain)" ]; then
+  echo "📦 暂存当前未提交变更..."
+  git stash push -m "stash-and-switch-auto-stash"
+  STASHED=true
+fi
+
+# 切换到 main 并更新
+echo "🔀 切换到 main..."
+git checkout main
+git pull origin main 2>/dev/null || echo "  ⚠️  pull 失败（可能无远程）"
+
+# 创建新分支
+echo "🌿 创建新分支: $NEW_BRANCH"
+git checkout -b "$NEW_BRANCH"
+
+# 恢复暂存的变更
+if [ "$STASHED" = true ]; then
+  echo "📦 恢复暂存的变更..."
+  git stash pop
+fi
+
+echo "✅ 已切换到新分支: $NEW_BRANCH"

package/dist/skills/reef-gen-backend/SKILL.md.tmpl

@@ -30,9 +30,15 @@ git diff "$FORK_POINT"..HEAD --diff-filter=M --name-only
 
 **规则**：不凭空写新文件。先读一个真实存在的同类文件，理解模式后再动手。写新模块时参考已有模块的完整实现。
 
-### 2. 查阅规范
+### 2. 🔴 加载编码规范（硬性门禁）
 
-加载 `reef:reef-style-backend` 技能，阅读 `quick-reference.md` 和必要示例。
+> **必须先通过 Skill tool 加载 `reef:reef-style-backend`，阅读 `quick-reference.md` 了解核心编码规范，并根据当前变更类型阅读对应的维度规范文件（如 `spring-boot.md`、`hibernate.md`、`fastapi-quick-reference.md`、`pytest-testing.md` 等）。完成后方可进入后续代码编写步骤。未加载 code-style 技能不得编写代码，否则视为违反工作流纪律。**
+
+加载完成后，AI MUST 输出以下声明：
+
+```
+✅ [CODE-STYLE] 已加载后端编码规范（quick-reference + 必要维度规范），所有新增/修改代码将遵循项目编码规范。
+```
 
 涉及库/框架 API 用法时，使用 context7 获取最新文档：`resolve-library-id` → `query-docs`。
 
@@ -83,6 +89,6 @@ ruff check . && mypy . && python -m pytest
 ```
 {{/if}}
 
-### {{#if reef.backend.java.dbMigration.styleRef}}6{{else}}{{#if reef.backend.python.dbMigration.styleRef}}6{{else}}5{{/if}}{{/if}}. 提交前自检
+### {{#if reef.backend.java.dbMigration.styleRef}}6{{else}}{{#if reef.backend.python.dbMigration.styleRef}}6{{else}}5{{/if}}{{/if}}. 🔴 提交前自检（后置检查）
 
-加载 `reef:reef-style-backend` 技能，逐项检查所有规范要求。**未通过不得提交。**
+重新加载 `reef:reef-style-backend` 技能，逐项对照所有规范要求检查本变更中的每处代码修改。**检查未通过不得提交。**

package/dist/skills/reef-gen-frontend/SKILL.md.tmpl

@@ -31,9 +31,15 @@ git diff "$FORK_POINT"..HEAD --diff-filter=M --name-only
 
 **规则**：不凭空写新文件。先读一个真实存在的同类文件，理解模式后再动手。
 
-### 2. 查阅规范
+### 2. 🔴 加载编码规范（硬性门禁）
 
-加载 `reef:reef-style-frontend` 技能，阅读 `quick-reference.md` 和必要示例。
+> **必须先通过 Skill tool 加载 `reef:reef-style-frontend`，阅读 `quick-reference.md` 了解核心编码规范，并根据当前变更类型阅读对应的维度规范文件（框架规范、UI 组件库规范、CSS 方案、TypeScript 配置、测试框架等）。完成后方可进入后续代码编写步骤。未加载 code-style 技能不得编写代码，否则视为违反工作流纪律。**
+
+加载完成后，AI MUST 输出以下声明：
+
+```
+✅ [CODE-STYLE] 已加载前端编码规范（quick-reference + 必要维度规范），所有新增/修改代码将遵循项目编码规范。
+```
 
 涉及库/框架 API 用法时，使用 context7 获取最新文档：`resolve-library-id` → `query-docs`。
 
@@ -79,6 +85,6 @@ git diff "$FORK_POINT"..HEAD --diff-filter=M --name-only
 {{reef.frontend.framework.formatCmd}} lint && {{reef.frontend.framework.formatCmd}} typecheck && {{reef.frontend.framework.formatCmd}} test
 ```
 
-### {{#if reef.frontend.framework.sourcePath}}6{{else}}5{{/if}}. 提交前自检
+### {{#if reef.frontend.framework.sourcePath}}6{{else}}5{{/if}}. 🔴 提交前自检（后置检查）
 
-加载 `reef:reef-style-frontend` 技能，逐项检查所有规范要求。**未通过不得提交。**
+重新加载 `reef:reef-style-frontend` 技能，逐项对照所有规范要求检查本变更中的每处代码修改。**检查未通过不得提交。**

package/dist/skills/reef-harden/SKILL.md

@@ -10,25 +10,17 @@ deepstorm:
 
 ## 上下文约定
 
-当前 change 名 = 当前分支名（由 jira-start 阶段三建立）：
+使用 `find-change-dir.mjs` 自动发现当前 change：
 
 ```bash
-# 自动发现当前 change
-CHANGE=$(git branch --show-current)
-CHANGE_DIR="openspec/changes/$CHANGE"
-
-# 如分支名与 change 目录不匹配，遍历所有 change 取最近一个
-if [ ! -d "$CHANGE_DIR" ]; then
-  CHANGE=$(ls -t openspec/changes/ 2>/dev/null | head -1)
-  CHANGE_DIR="openspec/changes/$CHANGE"
-fi
-
-# 如仍无结果，列出所有 change 让用户选择
-if [ ! -d "$CHANGE_DIR" ]; then
-  echo "未找到 openspec change，可用的目录:"
-  ls openspec/changes/
-  echo "请指定 change 名"
-fi
+node packages/reef/skills/reef-harden/scripts/find-change-dir.mjs
+```
+
+输出 JSON。`noMatch: true` 时需让用户选择；有 `suggestion` 时使用推荐 change。
+
+如需并列出 SDD 文档路径：
+```bash
+node packages/reef/skills/reef-harden/scripts/find-change-dir.mjs --files
 ```
 
 ## 快速开始
@@ -45,8 +37,8 @@ fi
 ### Step 1: 加载文档
 
 ```bash
-# 列出当前 change 下所有 SDD 文档
-find "$CHANGE_DIR" -name "*.md" -maxdepth 2 | sort
+CHANGE_JSON=$(node packages/reef/skills/reef-harden/scripts/find-change-dir.mjs)
+# CHANGE_JSON 中包含 path 和 files[]，files 为所有 SDD 文档路径
 ```
 
 读取所有这些文档。目录结构通常为：

package/dist/skills/reef-harden/scripts/find-change-dir.mjs

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+
+/**
+ * find-change-dir.mjs
+ * 自动发现当前 OpenSpec change 目录。
+ *
+ * 用法:
+ *   node find-change-dir.mjs                   # 根据分支自动查找
+ *   node find-change-dir.mjs --branch <name>   # 指定分支
+ *   node find-change-dir.mjs --files           # 同时列出 SDD 文档
+ *   node find-change-dir.mjs --dir <path>      # 指定扫描目录
+ *   node find-change-dir.mjs --help
+ */
+
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { execSync } from 'node:child_process';
+import { join } from 'node:path';
+
+const CHANGES_GLOB = 'openspec/changes';
+
+// ── Pure functions ────────────────────────────────────────────────
+
+function isArchivePath(changePath) {
+  return changePath.includes('/archive/');
+}
+
+/**
+ * 在 changes 列表中按 name 精确查找
+ * @param {Array} changes
+ * @param {string} name
+ * @returns {object|null}
+ */
+export function findChangeByName(changes, name) {
+  return changes.find(c =>
+    c.name === name && !isArchivePath(c.path)
+  ) || null;
+}
+
+/**
+ * 返回最近修改的非归档 change
+ * @param {Array} changes
+ * @returns {object|null}
+ */
+export function findMostRecent(changes) {
+  const active = changes.filter(c => !c.archived);
+  if (active.length === 0) return null;
+  return active.sort((a, b) => b.mtimeMs - a.mtimeMs)[0];
+}
+
+/**
+ * 列出 changes 目录下的所有 change
+ * @param {string} changesDir
+ * @returns {Array<{name:string, path:string, archived:boolean, mtimeMs:number, files:string[]}>}
+ */
+export function listChanges(changesDir) {
+  if (!existsSync(changesDir)) return [];
+  const entries = readdirSync(changesDir, { withFileTypes: true });
+  const results = [];
+
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    if (entry.name === 'archive') continue;
+
+    const dirPath = join(changesDir, entry.name);
+    const stats = statSync(dirPath);
+
+    // 收集 .md 文件
+    const files = collectMdFiles(dirPath);
+
+    results.push({
+      name: entry.name,
+      path: dirPath,
+      archived: false,
+      mtimeMs: stats.mtimeMs,
+      files,
+    });
+  }
+
+  return results;
+}
+
+function collectMdFiles(dir) {
+  try {
+    const entries = readdirSync(dir, { withFileTypes: true });
+    const files = [];
+    for (const e of entries) {
+      if (e.isFile() && e.name.endsWith('.md')) {
+        files.push(join(dir, e.name));
+      }
+      if (e.isDirectory()) {
+        const sub = collectMdFiles(join(dir, e.name));
+        files.push(...sub);
+      }
+    }
+    return files;
+  } catch {
+    return [];
+  }
+}
+
+// ── CLI entry ─────────────────────────────────────────────────────
+
+if (import.meta.filename === process.argv[1]) {
+  if (process.argv.includes('--help') || process.argv.includes('-h')) {
+    console.log(`
+find-change-dir.mjs — 发现 OpenSpec change 目录
+
+用法:
+  node find-change-dir.mjs                 根据分支自动查找
+  node find-change-dir.mjs --branch <name> 指定分支
+  node find-change-dir.mjs --files         同时列出 SDD 文档
+  node find-change-dir.mjs --dir <path>    指定扫描目录
+  node find-change-dir.mjs --help
+`);
+    process.exit(0);
+  }
+
+  const root = process.argv.indexOf('--dir') >= 0
+    ? process.argv[process.argv.indexOf('--dir') + 1]
+    : process.env.INIT_CWD || process.cwd();
+  const changesDir = join(root, CHANGES_GLOB);
+  const allChanges = listChanges(changesDir);
+
+  const branchIdx = process.argv.indexOf('--branch');
+  let result;
+
+  if (branchIdx >= 0) {
+    const branch = process.argv[branchIdx + 1];
+    result = findChangeByName(allChanges, branch);
+    if (!result) {
+      result = {
+        noMatch: true,
+        branch,
+        suggestion: findMostRecent(allChanges),
+      };
+    }
+  } else {
+    const branch = execGitBranch();
+    result = branch
+      ? (findChangeByName(allChanges, branch) ||
+         { noMatch: true, branch,
+           suggestion: findMostRecent(allChanges) })
+      : { noMatch: true, allChanges };
+  }
+
+  process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+}
+
+function execGitBranch() {
+  try {
+    return execSync('git branch --show-current', {
+      encoding: 'utf8', timeout: 5000,
+    }).trim() || null;
+  } catch {
+    return null;
+  }
+}

package/dist/skills/reef-pr/SKILL.md

@@ -30,15 +30,10 @@ CHANGE_DIR="openspec/changes/$BRANCH"
 先检查未提交变更。如有则提示「请先 commit 再创建 PR」，中止流程。
 
 ```bash
-BRANCH=$(git branch --show-current)
-FORK_POINT=$(git merge-base main HEAD 2>/dev/null)
-echo "Branch: $BRANCH"; git status -sb
-echo "Commits:"; git log "$FORK_POINT"..HEAD --oneline
-echo "Changes:"; git diff "$FORK_POINT"..HEAD --stat
-ls -d openspec/changes/$BRANCH/*.md 2>/dev/null
+node packages/reef/skills/reef-pr/scripts/create-pr.mjs --collect
 ```
 
-如有 OpenSpec change，读取 `proposal.md` 和 `tasks.md` 作为描述素材。
+输出 JSON 包含 `branch`、`hasUncommitted`、`diffStat`、`commitLog`、`proposalTitle`。如有 OpenSpec change，`proposalTitle` 会包含 proposal 标题。
 
 ### 2. 构建 PR 信息
 
@@ -71,20 +66,11 @@ OpenSpec: openspec/changes/{branch-name}/
 
 ### 4. 推送并创建 PR
 
-先检查是否已有打开的 PR：
+先检查是否已有打开的 PR，用 `create-pr.mjs` 统一处理：
 
 ```bash
-EXISTING_PR=$(gh pr view --json url 2>/dev/null)
-```
-
-如有则询问「已有 PR，是否更新描述？」，用户确认后用 `gh pr update` 更新；否则正常创建：
-
-```bash
-# 首次推送当前分支
-git push -u origin $(git branch --show-current)
-
-# 创建 PR（如有 reviewer/label/draft 则追加对应参数）
-gh pr create \
+# --title 和 --body 从步骤 2 构建的 PR 信息中取
+node packages/reef/skills/reef-pr/scripts/create-pr.mjs --create \
   --title "<标题>" \
   --body "<正文>" \
   [--reviewer "<用户>"] \
@@ -92,6 +78,8 @@ gh pr create \
   [--draft]
 ```
 
+如有已有 PR，脚本输出 `{"exists":true}` 并在 stderr 输出提示，此时可用 `gh pr update` 更新。
+
 ### 5. 输出结果
 
 返回 PR 链接。

package/dist/skills/reef-pr/scripts/create-pr.mjs

@@ -0,0 +1,217 @@
+#!/usr/bin/env node
+
+/**
+ * create-pr.mjs — PR 上下文收集与创建
+ *
+ * 用法:
+ *   node create-pr.mjs --collect          # 收集 PR 上下文
+ *   node create-pr.mjs --create <args>    # 创建 PR
+ *   node create-pr.mjs --help
+ */
+
+import { execSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+// ── Pure functions ────────────────────────────────────────────────
+
+export function checkUncommitted(statusShort) {
+  return statusShort.trim().length > 0;
+}
+
+export function buildPrBody(ctx) {
+  const lines = [];
+
+  lines.push('## 概要');
+  if (ctx.proposalTitle) {
+    lines.push(ctx.proposalTitle);
+  } else if (ctx.commitLog && ctx.commitLog.length > 0) {
+    lines.push(ctx.commitLog[0].message);
+  } else {
+    lines.push(ctx.branch);
+  }
+
+  lines.push('');
+  lines.push('## 关联');
+  lines.push(`Branch: ${ctx.branch}`);
+
+  if (ctx.diffStat) {
+    const s = ctx.diffStat;
+    lines.push(`Changes: ${s.files} 文件, +${s.insertions}/-${s.deletions}`);
+    lines.push('');
+    lines.push('## 变更清单');
+    s.changedFiles.forEach(f => lines.push(`- \`${f}\``));
+  }
+
+  if (ctx.commitLog && ctx.commitLog.length > 0) {
+    lines.push('');
+    lines.push('## Commits');
+    ctx.commitLog.forEach(c => lines.push(`- ${c.hash} ${c.message}`));
+  }
+
+  return lines.join('\n');
+}
+
+export function buildGhCreateArgs(opts) {
+  const args = ['gh pr create'];
+  args.push(`--title "${opts.title}"`);
+  args.push(`--body "${opts.body}"`);
+  if (opts.reviewer) args.push(`--reviewer ${opts.reviewer}`);
+  if (opts.label) args.push(`--label ${opts.label}`);
+  if (opts.draft) args.push('--draft');
+  return args.join(' ');
+}
+
+// ── Git helpers ────────────────────────────────────────────────────
+
+function exec(command) {
+  try {
+    return execSync(command, { encoding: 'utf8', timeout: 10000 }).trim();
+  } catch {
+    return '';
+  }
+}
+
+function collectContext() {
+  const branch = exec('git branch --show-current');
+  const forkPoint = exec(
+    'git merge-base main HEAD 2>/dev/null || echo ""'
+  );
+  const diffStat = exec(
+    `git diff "${forkPoint || 'main'}..HEAD" --stat`
+  );
+  const commitLog = forkPoint
+    ? exec(`git log "${forkPoint}"..HEAD --oneline`)
+    : '';
+  const statusShort = exec('git status --short');
+
+  // 查找关联 proposal
+  let proposalTitle = '';
+  const root = exec(
+    'git rev-parse --show-toplevel 2>/dev/null || echo ""'
+  );
+  if (root && branch) {
+    const p = join(root, 'openspec', 'changes', branch, 'proposal.md');
+    if (existsSync(p)) {
+      const firstLine = readFileSync(p, 'utf8')
+        .split('\n')[0] || '';
+      proposalTitle = firstLine.replace(/^#+\s*/, '').trim();
+    }
+  }
+
+  return {
+    branch,
+    hasUncommitted: checkUncommitted(statusShort),
+    proposalTitle,
+    commitLog: commitLog
+      ? commitLog.split('\n').filter(Boolean).map(l => {
+          const m = l.match(/^(\S+)\s+(.*)/);
+          return m ? { hash: m[1], message: m[2] } : null;
+        }).filter(Boolean)
+      : [],
+    diffStat: diffStat ? parseDiffStat(diffStat) : null,
+  };
+}
+
+function parseDiffStat(output) {
+  const lines = output.trim().split('\n').filter(Boolean);
+  const changedFiles = [];
+  let files = 0, insertions = 0, deletions = 0;
+
+  for (const line of lines) {
+    const sm = line.match(/(\d+)\s+files?\s+changed/);
+    if (sm) {
+      files = parseInt(sm[1], 10);
+      const im = line.match(/(\d+)\s+insertions?\(\+\)/);
+      if (im) insertions = parseInt(im[1], 10);
+      const dm = line.match(/(\d+)\s+deletions?\(-\)/);
+      if (dm) deletions = parseInt(dm[1], 10);
+      continue;
+    }
+    const fm = line.match(/^\s*(.+?)\s+\|/);
+    if (fm) changedFiles.push(fm[1].trim());
+  }
+
+  return { files, insertions, deletions, changedFiles };
+}
+
+function checkExistingPR() {
+  const out = exec('gh pr view --json url 2>/dev/null || true');
+  return out ? { exists: true, url: out } : { exists: false };
+}
+
+// ── CLI entry ─────────────────────────────────────────────────────
+
+if (import.meta.filename === process.argv[1]) {
+  if (process.argv.includes('--help') || process.argv.includes('-h')) {
+    console.log(`
+create-pr.mjs — PR 上下文收集与创建
+
+用法:
+  node create-pr.mjs --collect            收集 PR 上下文（JSON）
+  node create-pr.mjs --create             创建 PR
+  node create-pr.mjs --help               显示帮助
+
+--create 选项:
+  --title <text>     PR 标题
+  --body <text>      PR 正文
+  --reviewer <user>  Reviewer
+  --label <label>    标签
+  --draft            创建 Draft PR
+`);
+    process.exit(0);
+  }
+
+  if (process.argv.includes('--collect')) {
+    const ctx = collectContext();
+    process.stdout.write(JSON.stringify(ctx, null, 2) + '\n');
+    process.exit(0);
+  }
+
+  if (process.argv.includes('--create')) {
+    const titleArg = process.argv.indexOf('--title');
+    const bodyArg = process.argv.indexOf('--body');
+    const reviewerArg = process.argv.indexOf('--reviewer');
+    const labelArg = process.argv.indexOf('--label');
+    const isDraft = process.argv.includes('--draft');
+
+    if (titleArg < 0 || bodyArg < 0) {
+      console.error('--title 和 --body 必填');
+      process.exit(1);
+    }
+
+    const existing = checkExistingPR();
+    if (existing.exists) {
+      process.stdout.write(JSON.stringify(existing, null, 2) + '\n');
+      process.exit(0);
+    }
+
+    const branch = exec('git branch --show-current');
+    const pushOut = exec(`git push -u origin ${branch} 2>&1`);
+    if (!pushOut) {
+      console.error('git push 失败');
+      process.exit(1);
+    }
+
+    const cmd = buildGhCreateArgs({
+      title: process.argv[titleArg + 1],
+      body: process.argv[bodyArg + 1],
+      branch,
+      reviewer: reviewerArg >= 0
+        ? process.argv[reviewerArg + 1] : null,
+      label: labelArg >= 0 ? process.argv[labelArg + 1] : null,
+      draft: isDraft,
+    });
+
+    const out = exec(cmd);
+    process.stdout.write(JSON.stringify({
+      created: true,
+      url: out,
+    }, null, 2) + '\n');
+    process.exit(0);
+  }
+
+  // 默认：--collect
+  const ctx = collectContext();
+  process.stdout.write(JSON.stringify(ctx, null, 2) + '\n');
+}

package/dist/skills/reef-start/SKILL.md.tmpl

@@ -377,6 +377,7 @@ openspec instructions tasks --change "$CHANGE" --json
 ### 流程
 
 1. **调用 Skill 工具** — 根据 tasks.md 的任务范围，加载可能适用的 superpowers：
+   - `reef:reef-style-backend` 或 `reef:reef-style-frontend`（如果 tasks 涉及后端/前端**代码改动**，**必须**加载对应 code-style 技能，未加载不得进入阶段四）
    - `superpowers:test-driven-development`（如果 tasks 涉及 TypeScript/Java/Python 等代码改动）
    - `superpowers:verification-before-completion`
    - 根据 tasks.md 内容判断是否适用其他 superpowers