@deepstorm/cli 0.7.1 → 0.8.0

package/dist/cli.js

@@ -6042,22 +6042,6 @@ function readDeepStormConfig(targetDir) {
   if (fs.existsSync(settingsPath)) {
     return readAndMigrate(settingsPath);
   }
-  const oldPath = path.join(targetDir, ".claude", "settings.json");
-  if (fs.existsSync(oldPath)) {
-    try {
-      const raw = fs.readFileSync(oldPath, "utf-8");
-      const settings = JSON.parse(raw);
-      const config = settings.deepstorm;
-      if (config && Object.keys(config).length > 0) {
-        const migrated = migrateConfig(config);
-        writeDeepStormConfig(targetDir, migrated);
-        delete settings.deepstorm;
-        fs.writeFileSync(oldPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
-        return migrated;
-      }
-    } catch {
-    }
-  }
   return null;
 }
 function readAndMigrate(settingsPath) {
@@ -8074,7 +8058,7 @@ function printMcpEnvStatus(mcpTools, installedMcpServices, examplesDir, targetDi
 async function printGuide(options) {
   const { installedSkills, config, targetDir, mcpTools, mcpEnvStubs } = options;
   console.log("");
-  console.log("  \u2714 \u914D\u7F6E\u5DF2\u4FDD\u5B58\u5230 .claude/settings.json");
+  console.log("  \u2714 \u914D\u7F6E\u5DF2\u4FDD\u5B58\uFF08DeepStorm \u2192 .deepstorm/settings.json\uFF0CClaude Code \u2192 .claude/settings.json\uFF09");
   if (mcpTools && mcpTools.length > 0) {
     console.log("");
     console.log(`  \u2714 \u5DF2\u5B89\u88C5 ${mcpTools.length} \u4E2A\u5916\u90E8\u670D\u52A1`);

package/dist/mcp-skills/deepstorm-mcp-figma-read/SKILL.md

@@ -24,7 +24,7 @@ description: Use when you need to read Figma design data — get file info, read
 操作前先确认 Figma MCP 是否可用：
 
 ```
-检查 `.claude/settings.json` → `deepstorm.mcpCapabilities` 中 design_tools.available === true
+检查 `.deepstorm/settings.json` → `mcpCapabilities` 中 design_tools.available === true
 ```
 
 ---

package/dist/mcp-skills/deepstorm-mcp-jira-read/SKILL.md

@@ -24,7 +24,7 @@ description: Use when you need to read Jira Issue data — get issue details, se
 操作前先确认 Jira MCP 是否可用：
 
 ```
-检查 `.claude/settings.json` → `deepstorm.mcpCapabilities` 中 issue_tracker.available === true（providers 包含 jira）
+检查 `.deepstorm/settings.json` → `mcpCapabilities` 中 issue_tracker.available === true（providers 包含 jira）
 ```
 
 ---

package/dist/mcp-skills/deepstorm-mcp-playwright-read/SKILL.md

@@ -24,7 +24,7 @@ description: Use when you need to perform browser automation — navigate pages,
 操作前先确认 Playwright MCP 是否可用：
 
 ```
-检查 `.claude/settings.json` → `deepstorm.mcpCapabilities` 中 browser-automation.available === true（providers 包含 playwright）
+检查 `.deepstorm/settings.json` → `mcpCapabilities` 中 browser-automation.available === true（providers 包含 playwright）
 ```
 
 ---

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

@@ -41,6 +41,7 @@ git diff "$FORK_POINT"..HEAD --diff-filter=M --name-only
 {{#if reef.backend.language.sourcePath}}
 阅读本技能目录下的 `steps.md` 了解当前技术栈的编码步骤顺序和规范。编写过程中逐单元对照 `reef:reef-style-backend` 中对应章节检查。
 
+**注释要求**：所有生成的后端代码必须包含有意义的注释（Javadoc / Docstring / 行内注释），说明代码的功能、参数含义和业务逻辑。缺少必要注释的代码视为未完成，不得提交。
 **注释语言**：代码注释统一使用中文，专有名词/技术术语（如 REST、DTO、HTTP、JPA 等）保留英文。
 {{/if}}
 

package/dist/skills/reef-gen-backend/variants/java/steps.md

@@ -11,6 +11,18 @@
 
 每完成一块对照 `reef:reef-style-backend` 中对应章节检查。
 
+## 注释要求
+
+每类文件必须包含以下注释（缺少则视为未完成）：
+
+| 文件类型 | 注释要求 |
+|---------|---------|
+| **Entity** | 类 Javadoc `/** 实体描述 */`；每个字段 `/** 字段含义 */` |
+| **DTO / Record** | 类 Javadoc `/** 用途说明 */`；字段按 `reef-style-backend` 规范不加注释 |
+| **Repository** | 自定义查询方法加 `/** 查询意图、参数含义 */`；简单 CRUD 方法可不加 |
+| **Service** | 每个 public 方法加 Javadoc `/** 功能、@param、@return */`；复杂逻辑内联注释说明 |
+| **Controller** | 每个端点加 `@Operation(summary=, description=)` 或等价 Javadoc |
+
 ## 多租户红线
 
 - 所有数据库查询用 `findByIdAndAppId`，禁止裸 `findById`

package/dist/skills/reef-gen-backend/variants/python/steps.md

@@ -46,6 +46,18 @@ app.include_router(orders.router, prefix="/api/v1/orders", tags=["orders"])
 
 每完成一块对照 `reef:reef-style-backend` 的 Python 章节检查。
 
+## 注释要求
+
+每类文件必须包含以下注释（缺少则视为未完成）：
+
+| 文件类型 | 注释要求 |
+|---------|---------|
+| **Schema (Pydantic)** | 类 docstring 说明用途；关键字段用 `Field(description=...)`（会生成 OpenAPI 文档） |
+| **Model (SQLAlchemy)** | 类 docstring 说明表含义；复杂字段用 `comment=` 或行内注释说明 |
+| **Service** | 每个 public 函数加 docstring（Google 风格 `"""功能、Args、Returns"""`）；复杂逻辑行内注释 |
+| **Router** | 每个端点加 `summary=`/`description=` 参数或 docstring |
+| **Migration** | 每个 revision 加 docstring 说明变更意图 |
+
 ## ⚠️ 异步红线
 
 - 所有数据库操作用 `AsyncSession`，禁止同步 `Session`

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

@@ -62,6 +62,7 @@ git diff "$FORK_POINT"..HEAD --diff-filter=M --name-only
 {{#if reef.frontend.framework.sourcePath}}
 阅读本技能目录下的 `steps.md` 了解当前框架的编码步骤顺序和核心约束。编写过程中逐单元对照 `reef:reef-style-frontend` 中对应章节检查。
 
+**注释原则**：关键组件、自定义 Hooks / Composables / Service 和非直观逻辑添加必要的注释说明用途，简单模板代码可不加。
 **注释语言**：代码注释统一使用中文，专有名词/技术术语（如 Signal、Pipe、Component、Service、httpResource 等）保留英文。
 {{/if}}
 

package/dist/skills/reef-gen-frontend/variants/angular/steps.md

@@ -9,6 +9,15 @@
 
 每完成一块对照 `reef:reef-style-frontend` 中对应章节检查。
 
+## 注释要求
+
+| 文件类型 | 注释要求 |
+|---------|---------|
+| **类型定义** | 复杂类型加行内注释说明字段含义 |
+| **Service** | 简要说明每个方法的功能和返回类型 |
+| **Component** | 关键组件加注释说明用途；复杂逻辑行内注释 |
+| **路由** | 无需额外注释 |
+
 ## 核心约束
 
 - Standalone 组件（不使用 NgModule）

package/dist/skills/reef-gen-frontend/variants/react/steps.md

@@ -9,6 +9,15 @@
 
 每完成一块对照 `reef:reef-style-frontend` 中对应章节检查。
 
+## 注释要求
+
+| 文件类型 | 注释要求 |
+|---------|---------|
+| **类型定义** | 复杂类型加行内注释说明字段含义 |
+| **API Hook** | 简要说明该 Hook 的功能和返回值 |
+| **组件** | 关键组件加注释说明用途；复杂逻辑行内注释 |
+| **页面** | 无需额外注释 |
+
 ## 核心约束
 
 - 函数组件 + TypeScript（禁止 Class 组件）

package/dist/skills/reef-gen-frontend/variants/vue/steps.md

@@ -9,6 +9,15 @@
 
 每完成一块对照 `reef:reef-style-frontend` 中对应章节检查。
 
+## 注释要求
+
+| 文件类型 | 注释要求 |
+|---------|---------|
+| **类型定义** | 复杂类型加行内注释说明字段含义 |
+| **组合式函数** | 简要说明该函数的功能和返回值 |
+| **组件** | 关键组件加注释说明用途；复杂逻辑行内注释 |
+| **页面** | 无需额外注释 |
+
 ## 核心约束
 
 - `<script setup lang="ts">` 语法（禁止 Options API）

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

@@ -47,14 +47,14 @@ ls -d openspec/changes/$BRANCH/*.md 2>/dev/null
 **正文：**
 
 ```markdown
-## Summary
+## 概要
 {2-4 行概括变更动机，优先从 proposal.md 提取}
 ## 关联
 JIRA: {commit body / proposal.md / jira-start 元数据}
 OpenSpec: openspec/changes/{branch-name}/
 ## 变更清单
 {git diff --stat 输出}
-## Test plan
+## 测试计划
 - [ ] {前端路径含 src/main/web/ 则加}
 - [ ] {后端路径含 src/main/java/ 则加}
 - [ ] {手动验证步骤，如有}

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

@@ -355,7 +355,14 @@ openspec instructions tasks --change "$CHANGE" --json
 
 #### 3.8 语言规范
 
-中文正文 + 英文专有名词。
+**所有 SDD 文档（proposal/specs/design/tasks）正文必须使用中文。** 英文仅限专有名词和技术引用。
+
+| 组件 | 使用中文 | 保留英文原文 |
+|------|---------|-------------|
+| SDD 文档（proposal/specs/design/tasks） | 正文、场景描述、WHEN/THEN 描述 | 代码实体名、字段名、类名、枚举值、API 路径、技术术语 |
+| 代码注释 | 注释正文 | 专有名词（Signal、DTO、MapStruct、PrimeNG 等） |
+| 提交信息 | 描述性 message | JIRA URL、PRD 链接、技术术语 |
+| 变更名/分支名 | 输入为中文 | 输出为 kebab-case（3-6 词），如 `feat/add-user-auth` |
 
 #### 3.9 用户确认
 

package/dist/skills/reef-style-backend/variants/java/quick-reference.md

@@ -70,12 +70,15 @@ public abstract boolean supportsImporting();
 **替代方案：** 用 `instanceof` 判断 → ✗ 不推荐，违反开闭原则，每加一个子类就要改判断链。
 **优势：** 开闭原则 — 新增子类只需在自己的类中覆盖方法；新增能力只需在基类加方法 + 各子类实现。
 
-## 字段注释规则
-
-| 文件类型 | 需要 `/** */` 字段注释 |
-|---------|----------------------|
-| Model / Entity / Event | ✓ 是 |
-| DTO / Record | ✗ 否 |
+## 注释规则
+
+| 文件类型 | 注释要求 |
+|---------|---------|
+| **Entity** | 类 Javadoc `/** 实体描述 */`；每个字段 `/** 字段含义 */` |
+| **DTO / Record** | 类 Javadoc `/** 用途说明 */`；字段不加 `/** */` 注释 |
+| **Repository** | 自定义查询方法加 `/** 查询意图、参数含义 */`；简单 CRUD 方法可不加 |
+| **Service** | 每个 public 方法加 Javadoc `/** 功能、@param、@return */` |
+| **Controller** | 每个端点加 `@Operation(summary=, description=)` 或等价 Javadoc |
 
 ## 领域事件 / POJO
 

package/dist/skills/reef-style-backend/variants/python/quick-reference.md

@@ -74,6 +74,16 @@ class NumberControl(FormControl):
 **替代方案：** 用 `isinstance()` 判断 → ✗ 不推荐，违反开闭原则。
 **优势：** 开闭原则 — 新增子类只需在自己的类中覆盖方法；新增能力只需在基类加方法 + 各子类实现。
 
+## 注释规则
+
+| 文件类型 | 注释要求 |
+|---------|---------|
+| **Model (SQLAlchemy)** | 类 docstring 说明表含义；复杂字段用 `comment=` 行内注释 |
+| **Schema (Pydantic)** | 类 docstring 说明用途；关键字段用 `Field(description=...)` |
+| **Service** | public 函数加 docstring，说明功能、参数和返回值 |
+| **Router** | 每个端点加 `summary=`/`description=` 参数 |
+| **Migration** | 每个 revision 加 docstring 说明变更意图 |
+
 ## 类型注释规则
 
 | 声明位置 | 需要类型注释 |

package/dist/skills/reef-style-frontend/variants/angular/quick-reference.md

@@ -84,6 +84,14 @@ readonly form = form(signal({ name: '', email: '' }), (path) => {
 - 控制流语句必须使用大括号，禁止无大括号的早期返回
 - 代码折行规则（90 列限制）详见 `examples/code-wrapping.md`
 
+## 注释规则
+
+| 文件类型 | 注释要求 |
+|---------|---------|
+| **类型定义** | 复杂类型加行内注释说明字段含义 |
+| **Service** | 简要说明每个方法的功能和返回类型 |
+| **Component** | 关键组件加注释说明用途；复杂逻辑行内注释 |
+
 ## 前端实体类型
 
 实体接口镜像后端实体层次，定义在 `shared/base.ts`：`ImmutableEntity` → `Entity` → `Auditable<T>` / `ImmutableAuditable<T>`。完整定义、分页响应、Discriminated Union 模式见 `examples/entity-types.md`。

package/dist/skills/reef-style-frontend/variants/react/quick-reference.md

@@ -107,6 +107,14 @@ const routes = [
 - JSX 属性超过 3 个时换行排列
 - 自闭合标签：无子元素时使用 `<Component />` 而非 `<Component></Component>`
 
+## 注释规则
+
+| 文件类型 | 注释要求 |
+|---------|---------|
+| **类型定义** | 复杂类型加行内注释说明字段含义 |
+| **API Hook** | 简要说明该 Hook 的功能和返回值 |
+| **组件** | 关键组件加注释说明用途；复杂逻辑行内注释 |
+
 ## 常见坑
 
 | 场景 | 问题 | 正确做法 |

package/dist/skills/reef-style-frontend/variants/vue/quick-reference.md

@@ -133,6 +133,14 @@ const router = createRouter({
 - 自闭合标签：无子元素时使用 `<Component />` 而非 `<Component></Component>`
 - 模板表达式保持简洁，复杂逻辑提取到 `<script setup>` 中
 
+## 注释规则
+
+| 文件类型 | 注释要求 |
+|---------|---------|
+| **类型定义** | 复杂类型加行内注释说明字段含义 |
+| **组合式函数** | 简要说明该函数的功能和返回值 |
+| **组件** | 关键组件加注释说明用途；复杂逻辑行内注释 |
+
 ## 常见坑
 
 | 场景 | 问题 | 正确做法 |

package/dist/skills/sweep-init/SKILL.md

@@ -28,10 +28,10 @@ deepstorm:
 
 ### 步骤 0：读取框架配置
 
-在执行初始化前，先读取 `.claude/settings.json` 中的 `deepstorm.sweep.e2eFramework` 配置，确定当前项目使用的 E2E 框架。
+在执行初始化前，先读取 `.deepstorm/settings.json` 中的 `sweep.e2eFramework` 配置，确定当前项目使用的 E2E 框架。
 
 ```bash
-cat .claude/settings.json 2>/dev/null | grep -o '"e2eFramework"[^,]*' | head -1 | cut -d'"' -f4
+cat .deepstorm/settings.json 2>/dev/null | grep -o '"e2eFramework"[^,]*' | head -1 | cut -d'"' -f4
 ```
 
 如果配置不存在或为空，使用默认值 `playwright` 并输出提示。
@@ -230,7 +230,7 @@ cat .mcp.json 2>/dev/null | grep -c "deepstorm-playwright"
 - **THEN** 输出提示："⚠️ Playwright MCP 未配置。建议运行 `deepstorm setup` 并选择 Playwright MCP 服务以启用浏览器自动化。"
 - **THEN** 不阻塞初始化流程，继续执行
 
-> **注意：** Playwright MCP 配置由 CLI setup wizard 统一管理，不再由本 skill 在 `.claude/settings.json` 中独立配置。
+> **注意：** Playwright MCP 配置由 CLI setup wizard 统一管理，不再由本 skill 单独配置。
 
 ---
 

package/dist/skills/sweep-run/SKILL.md

@@ -43,14 +43,14 @@ deepstorm:
 
 ### 前置检查：读取框架配置
 
-在执行前，先读取 `.claude/settings.json` 中 `deepstorm.sweep.e2eFramework` 配置，确定当前项目使用的 E2E 框架。
+在执行前，先读取 `.deepstorm/settings.json` → `sweep.e2eFramework` 配置，确定当前项目使用的 E2E 框架。
 
 ```bash
 node scripts/env-manager.mjs --framework
 ```
 
 ```json
-{"framework":"playwright","source":"settings"}
+{"framework":"playwright","source":"deepstorm-settings"}
 ```
 
 - **playwright** → 通过 Playwright MCP（`deepstorm-playwright`）执行浏览器操作
@@ -425,7 +425,7 @@ Flow: L01 - 正常登录成功
 
 ## 检查清单
 
-- [ ] 前置检查：框架配置已读取 `.claude/settings.json`
+- [ ] 前置检查：框架配置已读取（`.deepstorm/settings.json` → `sweep.e2eFramework`）
 - [ ] 项目已初始化（`.sweep-init` 存在）
 - [ ] 执行范围已确定（--all / --path / 交互选择）
 - [ ] 执行模式已选择（hybrid / native / no-parallel / browser）

package/dist/skills/sweep-run/scripts/env-manager.mjs

@@ -24,9 +24,6 @@ import { resolve } from 'node:path';
 function getEnvPath() {
   return resolve(process.cwd(), '.env');
 }
-function getSettingsPath() {
-  return resolve(process.cwd(), '.claude/settings.json');
-}
 function getMcpPath() {
   return resolve(process.cwd(), '.mcp.json');
 }
@@ -119,22 +116,23 @@ export function resolveEnv(envName) {
 // ── Framework config ──────────────────────────────────────────────
 
 /**
- * Read E2E framework config from .claude/settings.json.
+ * Read E2E framework config from .deepstorm/settings.json → sweep.e2eFramework.
  *
  * @returns {{ framework: string|null, source: string }}
  *   framework: 'playwright' | 'cypress' | null
- *   source: 'settings' | 'default' | 'missing-file'
+ *   source: 'deepstorm-settings' | 'missing-file' | 'not-configured' | 'parse-error'
  */
 export function readFramework() {
-  if (!existsSync(getSettingsPath())) {
+  const deepstormPath = resolve(process.cwd(), '.deepstorm', 'settings.json');
+  if (!existsSync(deepstormPath)) {
     return { framework: null, source: 'missing-file' };
   }
 
   try {
-    const content = readFileSync(getSettingsPath(), 'utf-8');
+    const content = readFileSync(deepstormPath, 'utf-8');
     const config = JSON.parse(content);
-    const framework = config.deepstorm?.sweep?.e2eFramework || null;
-    return { framework, source: framework ? 'settings' : 'default' };
+    const framework = config.sweep?.e2eFramework || null;
+    return { framework, source: framework ? 'deepstorm-settings' : 'not-configured' };
   } catch {
     return { framework: null, source: 'parse-error' };
   }

package/dist/skills/tide-discuss/references/publish-flow.md

@@ -4,7 +4,7 @@ PRD 生成后（`status: prd_ready`），分三步完成发布流程。每步根
 
 ## MCP 能力发现
 
-进入 Step 4 时，AI 先读取 `.claude/settings.json` → `deepstorm.mcpCapabilities` 确定可用的 provider。
+进入 Step 4 时，AI 先读取 `.deepstorm/settings.json` → `mcpCapabilities` 确定可用的 provider。
 
 能力映射结构示例（安装时渲染）：
 ```json

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepstorm/cli",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "DeepStorm CLI — 一键配置项目开发环境",
   "license": "MIT",
   "author": "billkang",
@@ -16,7 +16,7 @@
     "dotenv": "^17.4.2",
     "handlebars": "^4.7.8",
     "js-yaml": "^4.1.0",
-    "@deepstorm/pilot": "^0.7.1"
+    "@deepstorm/pilot": "^0.8.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",