@deepstorm/cli 0.10.2 → 0.11.1

package/dist/skills/reef-start/references/stage-4-implementation.md

@@ -53,6 +53,7 @@ PLAN_FILE="docs/superpowers/plans/$(date +%Y-%m-%d)-$CHANGE.md"
 适用于：新增业务逻辑、Bug 修复、权限/安全变更、资金/幂等性变更、状态机/并发逻辑
 
 **🔴 RED — 先写测试**
+
 - 先确认 code-style 已加载：检查 `reef:reef-style-backend` 或 `reef:reef-style-frontend` 是否已通过 Skill tool 加载，未加载则先加载
 - 根据 spec 的 Scenario 编写单元测试
 - 运行测试，确认失败（红）
@@ -60,12 +61,14 @@ PLAN_FILE="docs/superpowers/plans/$(date +%Y-%m-%d)-$CHANGE.md"
 - **不写实现代码**
 
 **🟢 GREEN — 最小实现**
+
 - 只写让当前测试通过的最小代码量
 - 不提前实现未测试的功能
 - 运行测试，确认全绿
 - 如果感觉"这段代码还没写完"，那是正常的 — 下一个 task 会覆盖
 
 **🔵 REFACTOR — 保持测试通过的前提下重构**
+
 - 清理重复代码、提取函数、重命名
 - 保持测试运行通过
 - 不改变行为
@@ -97,13 +100,13 @@ Step 3: Test 验证
 
 根据项目技术栈自动选择对应命令。无法推断时询问用户，并将结果写入 task 笔记复用。
 
-| 框架 | Build | Lint | Test |
-|------|-------|------|------|
-| Java Spring Boot | `mvn compile` | `mvn checkstyle:check` 或 `mvn validate` | `mvn test` |
-| Python FastAPI | `pip install -e .` dry-run 或 `poetry install --dry-run` | `ruff check .` 或 `pylint` | `pytest` |
-| Node.js / TypeScript | `npm run build` 或 `pnpm build` | `npm run lint` 或 `pnpm lint` | `npm test` 或 `pnpm test -- --related`（仅关联用例） |
-| Go | `go build ./...` | `golint` 或 `go vet` | `go test ./...` |
-| 无法推断 | 询问用户当前可用的验证命令 | 同左 | 同左 |
+| 框架                 | Build                                                    | Lint                                     | Test                                                 |
+| -------------------- | -------------------------------------------------------- | ---------------------------------------- | ---------------------------------------------------- |
+| Java Spring Boot     | `mvn compile`                                            | `mvn checkstyle:check` 或 `mvn validate` | `mvn test`                                           |
+| Python FastAPI       | `pip install -e .` dry-run 或 `poetry install --dry-run` | `ruff check .` 或 `pylint`               | `pytest`                                             |
+| Node.js / TypeScript | `npm run build` 或 `pnpm build`                          | `npm run lint` 或 `pnpm lint`            | `npm test` 或 `pnpm test -- --related`（仅关联用例） |
+| Go                   | `go build ./...`                                         | `golint` 或 `go vet`                     | `go test ./...`                                      |
+| 无法推断             | 询问用户当前可用的验证命令                               | 同左                                     | 同左                                                 |
 
 ### 完成一个 task 后
 
@@ -161,7 +164,15 @@ VERIFY_REPORT="openspec/changes/$CHANGE/verify-report.json"
   "tasks": { "total": 17, "passed": 17 },
   "build": { "command": "npm run build", "exitCode": 0, "passed": true, "duration": 8 },
   "lint": { "command": "npm run lint", "exitCode": 0, "passed": true },
-  "tests": { "command": "npm test", "exitCode": 0, "passed": true, "total": 42, "passed": 42, "failed": 0, "duration": 15 },
+  "tests": {
+    "command": "npm test",
+    "exitCode": 0,
+    "passed": true,
+    "total": 42,
+    "passed": 42,
+    "failed": 0,
+    "duration": 15
+  },
   "acCoverage": { "total": 5, "covered": 4, "uncovered": ["AC-5: ..."] },
   "review": { "findings": 3, "blockers": 0, "warnings": 2, "suggestions": 1, "reportPath": "..." },
   "summary": "PASSED"
@@ -169,20 +180,21 @@ VERIFY_REPORT="openspec/changes/$CHANGE/verify-report.json"
 ```
 
 **摘要字段取值：**
+
 - `PASSED` — 所有检查通过
 - `PASSED with warnings` — 有 warning 但无 blocker
 - `FAILED` — 存在 blocker 或测试失败
 
 **汇总逻辑：**
 
-| 数据来源 | 对应字段 | 说明 |
-|---------|---------|------|
-| tasks.md | `tasks` | 已完成的 task 数 / 总 task 数 |
-| 后置验证 build | `build` | build 命令、退出码、耗时 |
-| 后置验证 lint | `lint` | lint 命令、退出码 |
-| 后置验证 test | `tests` | 测试命令、总数/通过/失败 |
+| 数据来源        | 对应字段     | 说明                          |
+| --------------- | ------------ | ----------------------------- |
+| tasks.md        | `tasks`      | 已完成的 task 数 / 总 task 数 |
+| 后置验证 build  | `build`      | build 命令、退出码、耗时      |
+| 后置验证 lint   | `lint`       | lint 命令、退出码             |
+| 后置验证 test   | `tests`      | 测试命令、总数/通过/失败      |
 | AC-to-test 回溯 | `acCoverage` | AC 覆盖总数/已覆盖/未覆盖列表 |
-| code-audit 结果 | `review` | findings 统计 + 报告路径 |
+| code-audit 结果 | `review`     | findings 统计 + 报告路径      |
 
 写入后向用户摘要报告关键数据，用户确认后再进入分支结束处理。
 
@@ -190,9 +202,9 @@ VERIFY_REPORT="openspec/changes/$CHANGE/verify-report.json"
 
 询问用户：**创建提交 / 创建 PR / 保留分支 / 丢弃分支**
 
-| 操作 | 说明 |
-|------|------|
-| 创建提交 | 中文 message + Issue URL（Path A 有则加，Path B 可选）+ PRD 链接（如有），verify-report.json 随 change 目录归档 |
-| 创建 PR | `git push -u origin "$CHANGE"` → `gh pr create`，verify-report.json 随 change 目录移入 `openspec/changes/archive/` |
-| 保留分支 | 报告分支名和变更位置 |
-| 丢弃分支 | 用户确认后删除 |
+| 操作     | 说明                                                                                                               |
+| -------- | ------------------------------------------------------------------------------------------------------------------ |
+| 创建提交 | 中文 message + Issue URL（Path A 有则加，Path B 可选）+ PRD 链接（如有），verify-report.json 随 change 目录归档    |
+| 创建 PR  | `git push -u origin "$CHANGE"` → `gh pr create`，verify-report.json 随 change 目录移入 `openspec/changes/archive/` |
+| 保留分支 | 报告分支名和变更位置                                                                                               |
+| 丢弃分支 | 用户确认后删除                                                                                                     |

package/dist/skills/reef-start/references/superpowers-gate.md

@@ -68,12 +68,12 @@
 
 > 以下每一个想法都是一个危险信号。**任何一个出现 → 立即停止 → 回到本步骤执行 superpowers 检查。**
 
-| 想法 | 现实 |
-|------|------|
-| "tasks + plan 都完成了，直接实现吧" | ❌ 必须先走完 3.8 语言规范 → 3.9 用户确认 → Superpowers 门禁。plan 生成 ≠ 可以跳过后续步骤。 |
-| "tasks 完成了，直接进入实现吧" | ❌ 必须先检查 superpowers。顺序不可颠倒。 |
-| "这个变更很简单，不需要检查" | 只要有 1% 的可能性适用，就**必须**检查。 |
-| "我知道 TDD 是什么，不用加载技能" | 技能会更新。加载当前版本才有效。 |
-| "先搞快点，后面再补测试" | 补 = 不补。不可协商的纪律。 |
-| "子代理一次性写代码效率高，TDD 太慢" | TDD 铁律优先于效率。质量不可妥协。 |
-| "已经改了代码，回头补测试也一样" | 测试-after 和 TDD 不等价。测试-after 验证的是"代码做了什么"，不是"代码应该做什么"。 |
+| 想法                                 | 现实                                                                                         |
+| ------------------------------------ | -------------------------------------------------------------------------------------------- |
+| "tasks + plan 都完成了，直接实现吧"  | ❌ 必须先走完 3.8 语言规范 → 3.9 用户确认 → Superpowers 门禁。plan 生成 ≠ 可以跳过后续步骤。 |
+| "tasks 完成了，直接进入实现吧"       | ❌ 必须先检查 superpowers。顺序不可颠倒。                                                    |
+| "这个变更很简单，不需要检查"         | 只要有 1% 的可能性适用，就**必须**检查。                                                     |
+| "我知道 TDD 是什么，不用加载技能"    | 技能会更新。加载当前版本才有效。                                                             |
+| "先搞快点，后面再补测试"             | 补 = 不补。不可协商的纪律。                                                                  |
+| "子代理一次性写代码效率高，TDD 太慢" | TDD 铁律优先于效率。质量不可妥协。                                                           |
+| "已经改了代码，回头补测试也一样"     | 测试-after 和 TDD 不等价。测试-after 验证的是"代码做了什么"，不是"代码应该做什么"。          |

package/dist/skills/reef-style-backend/fragments/java/ai/spring-ai/examples/structured-output.md

@@ -16,7 +16,7 @@ log.info("城市: {}, 温度: {}{}", weather.city(), weather.temperature(), weat
 
 ## 嵌套结构
 
-```java
+````java
 public record CodeReviewResult(
   String file,
   List<Issue> issues,
@@ -44,7 +44,7 @@ CodeReviewResult result = chatClient.prompt()
     """)
   .call()
   .entity(CodeReviewResult.class);
-```
+````
 
 ## 列表输出
 

package/dist/skills/reef-style-backend/fragments/java/ai/spring-ai/quick-reference.md

@@ -7,6 +7,7 @@ Spring AI 是 Spring 生态中的 AI 集成框架，提供统一的 API 来调
 ## 核心概念
 
 ### ChatClient
+
 Spring AI 的中央 API，用于与大语言模型交互。
 
 ```java
@@ -17,6 +18,7 @@ ChatClient chatClient(ChatClient.Builder builder) {
 ```
 
 **最佳实践：**
+
 - `ChatClient` 声明为 `@Bean` 并注入使用，不直接创建实例
 - `defaultSystem()` 设置默认系统提示词
 - `builder.clone()` 创建独立的客户端实例（需要不同配置时）
@@ -33,6 +35,7 @@ public List<Order> getOrders(@ToolParam(description = "用户 ID") String userId
 ```
 
 **最佳实践：**
+
 - 每个 `@Tool` 方法加 `description` 描述，帮助模型选择正确的工具
 - `@ToolParam` 的 `description` 帮助模型理解参数含义
 - 工具方法放在 `@Service` 类中，统一管理
@@ -51,6 +54,7 @@ ChatClientResponse response = chatClient.prompt()
 ```
 
 **常见 Advisor：**
+
 - `QuestionAnswerAdvisor` — RAG 支持
 - `MessageChatMemoryAdvisor` — 对话记忆
 - `LoggingAdvisor` — 日志记录
@@ -80,6 +84,7 @@ public class DocumentService {
 ```
 
 **最佳实践：**
+
 - VectorStore 通过 Spring DI 注入，不同实现（PGVector、Redis、Chroma）切换只需改配置
 - 文档入库时保留 metadata（来源、更新时间、权限）
 
@@ -97,6 +102,7 @@ WeatherResponse weather = chatClient.prompt()
 ```
 
 **最佳实践：**
+
 - 使用 `record` 而非 class 定义输出结构
 - 字段类型明确，避免 `String` 滥用
 
@@ -114,6 +120,7 @@ spring:
 ```
 
 **最佳实践：**
+
 - API Key 始终通过 `${}` 环境变量引用，不硬编码
 - 敏感配置放在 `.env` 文件中，不提交到 Git
 
@@ -136,6 +143,7 @@ spring:
 ```
 
 **可用模型：**
+
 - `deepseek-chat` — 通用对话模型，适用于日常问答、代码生成、内容创作
 - `deepseek-reasoner` — 推理模型，适用于复杂推理、数学问题、逻辑分析（通过 API 调用，Spring AI Starter 暂未直接封装）
 
@@ -174,6 +182,7 @@ implementation 'org.springframework.ai:spring-ai-starter-model-deepseek'
 ```
 
 或 Maven：
+
 ```xml
 <dependency>
     <groupId>org.springframework.ai</groupId>
@@ -191,6 +200,7 @@ implementation 'org.springframework.ai:spring-ai-pgvector-store-spring-boot-star
 ```
 
 或 Maven：
+
 ```xml
 <dependency>
     <groupId>org.springframework.ai</groupId>
@@ -211,6 +221,7 @@ try {
 ```
 
 **注意事项：**
+
 - AI 调用可能失败或超时，必须有降级逻辑
 - 记录 AI 调用的输入和输出，便于调试和审计
 

package/dist/skills/reef-style-backend/fragments/java/api-spec/jackson-polymorphism.md

@@ -77,6 +77,7 @@ public class LineChartView extends ChartView {
 ```
 
 > **💡 Import 说明：**
+>
 > - `@JsonTypeInfo`、`@JsonSubTypes`、`@JsonInclude` 来自 `com.fasterxml.jackson.annotation.*`
 > - `@JsonInclude(Include.NON_NULL)` 需导入 `com.fasterxml.jackson.annotation.JsonInclude.Include`
 > - 或在注解中写全路径 `@JsonInclude(JsonInclude.Include.NON_NULL)`，无需额外 import
@@ -127,63 +128,58 @@ export type ChartView = MetricCardView | LineChartView | BarChartView | PieChart
 ```typescript
 export interface MetricAnswer {
   // ...
-  chartView: ChartView | null;  // ✅ 联合类型自动窄化
+  chartView: ChartView | null; // ✅ 联合类型自动窄化
 }
 ```
 
 **步骤 3：模板中使用 @switch**
 
 ```html
-@if (answer.chartView) {
-  @switch (answer.chartView.type) {
-    @case ('MetricCardView') {
-      <app-metric-card [answer]="answer" />
-    }
-    @case ('LineChartView') {
-      <app-line-chart [chartData]="answer.chartData" />
-    }
-  }
-}
+@if (answer.chartView) { @switch (answer.chartView.type) { @case ('MetricCardView') {
+<app-metric-card [answer]="answer" />
+} @case ('LineChartView') {
+<app-line-chart [chartData]="answer.chartData" />
+} } }
 ```
 
 ## 三、最佳实践
 
-| 要点 | 说明 |
-|------|------|
-| `property = "type"` | discriminator 字段名使用 `"type"`（简短、通用），而非 `"chartType"` |
-| 前后端 value 一致 | `@JsonSubTypes.Type(name = "MetricCardView")` 与 TS `type: 'MetricCardView'` 的值必须一致 |
-| Checkstyle 兼容 | Jackson 字段名与 getter 名可以不同：`@JsonProperty("xAxisName") private String categoryAxisLabel` |
-| 共享 DTO | 子类共享的嵌套类型（如 `ChartDataPoint`）定义为独立 `record` 或类 |
-| 判空安全 | 模板中 `@if (answer.chartView)` 保护空值（如错误响应时 chartView 为 null） |
-| 不删除旧 DTO 层 | `ChartData`、`gridResults`、`singleResults` 等依然存在，chartView 是新增的视图抽象，并非替代所有响应字段 |
-| 删除前确认引用 | 删除旧枚举前 MUST 搜索全项目 Java + TypeScript 引用，确认 0 引用后方可删除 |
+| 要点                | 说明                                                                                                     |
+| ------------------- | -------------------------------------------------------------------------------------------------------- |
+| `property = "type"` | discriminator 字段名使用 `"type"`（简短、通用），而非 `"chartType"`                                      |
+| 前后端 value 一致   | `@JsonSubTypes.Type(name = "MetricCardView")` 与 TS `type: 'MetricCardView'` 的值必须一致                |
+| Checkstyle 兼容     | Jackson 字段名与 getter 名可以不同：`@JsonProperty("xAxisName") private String categoryAxisLabel`        |
+| 共享 DTO            | 子类共享的嵌套类型（如 `ChartDataPoint`）定义为独立 `record` 或类                                        |
+| 判空安全            | 模板中 `@if (answer.chartView)` 保护空值（如错误响应时 chartView 为 null）                               |
+| 不删除旧 DTO 层     | `ChartData`、`gridResults`、`singleResults` 等依然存在，chartView 是新增的视图抽象，并非替代所有响应字段 |
+| 删除前确认引用      | 删除旧枚举前 MUST 搜索全项目 Java + TypeScript 引用，确认 0 引用后方可删除                               |
 
 ## 四、效果对比
 
-| 维度 | 旧模式（Enum） | 新模式（Polymorphism） |
-|------|---------------|----------------------|
-| 新增图表类型 | 枚举 + switch + 前端分支 | 新建子类 + 注册 `@JsonSubTypes` + TS 类型 |
-| JSON 结构 | `{"chartType": "METRIC_CARD", ...}` | `{"chartView": {"type": "MetricCardView", ...}}` |
-| TS 类型安全 | 手动维护 | 自动通过 discriminated union 窄化 |
-| 后端字段数 | chartType + 具体数据各自校验 | chartView 自包含 |
+| 维度         | 旧模式（Enum）                      | 新模式（Polymorphism）                           |
+| ------------ | ----------------------------------- | ------------------------------------------------ |
+| 新增图表类型 | 枚举 + switch + 前端分支            | 新建子类 + 注册 `@JsonSubTypes` + TS 类型        |
+| JSON 结构    | `{"chartType": "METRIC_CARD", ...}` | `{"chartView": {"type": "MetricCardView", ...}}` |
+| TS 类型安全  | 手动维护                            | 自动通过 discriminated union 窄化                |
+| 后端字段数   | chartType + 具体数据各自校验        | chartView 自包含                                 |
 
 ## 五、设计决策说明
 
 ### 5.1 `property` 选择 `"type"` 而非 `"chartType"`
 
-| 候选 | 理由 | 结论 |
-|------|------|------|
-| `"type"` | 简短通用，多态基类职责就是描述"是什么类型"，与低代码项目 (`DatasetDto`) 一致 | ✅ |
-| `"chartType"` | 业务含义明确，但限制了基类的可复用性。未来其他多态场景（如 `DataSourceConnector`）需要不同字段名 | ❌ |
-| `"kind"` | Jackson 社区惯例使用 `"type"`，不应引入不必要的差异 | ❌ |
+| 候选          | 理由                                                                                             | 结论 |
+| ------------- | ------------------------------------------------------------------------------------------------ | ---- |
+| `"type"`      | 简短通用，多态基类职责就是描述"是什么类型"，与低代码项目 (`DatasetDto`) 一致                     | ✅   |
+| `"chartType"` | 业务含义明确，但限制了基类的可复用性。未来其他多态场景（如 `DataSourceConnector`）需要不同字段名 | ❌   |
+| `"kind"`      | Jackson 社区惯例使用 `"type"`，不应引入不必要的差异                                              | ❌   |
 
 ### 5.2 discriminator 策略使用 `SIMPLE_NAME`
 
-| 候选 | 理由 | 结论 |
-|------|------|------|
-| `SIMPLE_NAME` | 子类简名自描述，无需额外常量文件 | ✅ |
-| `CLASS_NAME` | 全限定名过长，JSON 中不可读且暴露包结构 | ❌ |
-| `CUSTOM` | 需要 `@JsonTypeIdResolver`，增加复杂度 | ❌ |
+| 候选          | 理由                                    | 结论 |
+| ------------- | --------------------------------------- | ---- |
+| `SIMPLE_NAME` | 子类简名自描述，无需额外常量文件        | ✅   |
+| `CLASS_NAME`  | 全限定名过长，JSON 中不可读且暴露包结构 | ❌   |
+| `CUSTOM`      | 需要 `@JsonTypeIdResolver`，增加复杂度  | ❌   |
 
 ### 5.3 使用 `@JsonSubTypes` 而非自定义序列化器
 
@@ -195,10 +191,10 @@ TypeScript union type + `type` literal 可直接利用 `@switch` 的类型窄化
 
 ### 5.5 Checkstyle 冲突：`@JsonProperty` 解耦而非禁用规则
 
-| 候选 | 理由 | 结论 |
-|------|------|------|
-| `@JsonProperty("xAxisName") private String categoryAxisLabel` | 字段名合规，getter 合规，JSON 输出保留 `xAxisName` | ✅ |
-| 禁用 Checkstyle `ParameterNameCheck` | 全局禁用降低代码规范性 | ❌ |
+| 候选                                                          | 理由                                               | 结论 |
+| ------------------------------------------------------------- | -------------------------------------------------- | ---- |
+| `@JsonProperty("xAxisName") private String categoryAxisLabel` | 字段名合规，getter 合规，JSON 输出保留 `xAxisName` | ✅   |
+| 禁用 Checkstyle `ParameterNameCheck`                          | 全局禁用降低代码规范性                             | ❌   |
 
 ### 5.6 DTO 对象保持 record
 

package/dist/skills/reef-style-backend/fragments/java/api-spec/quick-reference.md

@@ -2,16 +2,16 @@
 
 ## 速查
 
-| 场景 | 决策 |
-| --- | --- |
-| 资源路径 | 英文复数 kebab-case：`/api/v1/user-roles`，不是 `/api/v1/userRoles` 或 `/api/v1/user_role` |
-| 自定义动作 | AIP-136 冒号语法：`@PostMapping("/{id}:publish")` |
-| 查询参数 | `?status=active&page=0&size=20&sort=name,asc` |
-| 统一响应体 | `ApiResponse<T>` / `PageResponse<T>` / `ErrorResponse` |
-| 版本策略 | URL path 前缀 `/api/v1/`；非破坏性变更不升级，破坏性变更 +1 |
-| 错误响应 | AIP-193 兼容 `ErrorResponse`：`{ "code": "USER_001", "message": "...", "detail": {} }` |
-| 分页 | Spring `Pageable` → `PageResponse` |
-| OpenAPI | `@Operation(summary = "...")` + `@ApiResponse` + `@Tag(name = "users")` |
+| 场景       | 决策                                                                                       |
+| ---------- | ------------------------------------------------------------------------------------------ |
+| 资源路径   | 英文复数 kebab-case：`/api/v1/user-roles`，不是 `/api/v1/userRoles` 或 `/api/v1/user_role` |
+| 自定义动作 | AIP-136 冒号语法：`@PostMapping("/{id}:publish")`                                          |
+| 查询参数   | `?status=active&page=0&size=20&sort=name,asc`                                              |
+| 统一响应体 | `ApiResponse<T>` / `PageResponse<T>` / `ErrorResponse`                                     |
+| 版本策略   | URL path 前缀 `/api/v1/`；非破坏性变更不升级，破坏性变更 +1                                |
+| 错误响应   | AIP-193 兼容 `ErrorResponse`：`{ "code": "USER_001", "message": "...", "detail": {} }`     |
+| 分页       | Spring `Pageable` → `PageResponse`                                                         |
+| OpenAPI    | `@Operation(summary = "...")` + `@ApiResponse` + `@Tag(name = "users")`                    |
 
 ## 核心规范
 
@@ -113,6 +113,7 @@ public class UserController {
 ```
 
 **规范：**
+
 - 每个 Controller 类加 `@Tag(name = "...", description = "...")`
 - 每个接口方法加 `@Operation(summary = "...")`
 - 非 200 响应（400/403/404）加 `@ApiResponse(responseCode = "4XX", description = "...")`

package/dist/skills/reef-style-backend/fragments/java/db-migration/liquibase/examples/database-migration.md

@@ -10,13 +10,13 @@
 
 主 changelog 定义了数据库类型变量以支持多数据库（H2 开发/测试，MySQL/PG/MSSQL 生产）：
 
-| 变量 | 用途 |
-|------|------|
-| `${boolean.type}` | 布尔类型 |
-| `${string.type}(255)` | 字符串 VARCHAR/NVARCHAR |
-| `${date.time.type}` | 日期时间 TIMESTAMP/DATETIME/DATETIME2 |
-| `${clob.type}` | 大文本 CLOB/LONGTEXT/TEXT/NVARCHAR(MAX) |
-| `${enum.ordinal.type}` | 枚举序号类型 |
+| 变量                   | 用途                                    |
+| ---------------------- | --------------------------------------- |
+| `${boolean.type}`      | 布尔类型                                |
+| `${string.type}(255)`  | 字符串 VARCHAR/NVARCHAR                 |
+| `${date.time.type}`    | 日期时间 TIMESTAMP/DATETIME/DATETIME2   |
+| `${clob.type}`         | 大文本 CLOB/LONGTEXT/TEXT/NVARCHAR(MAX) |
+| `${enum.ordinal.type}` | 枚举序号类型                            |
 
 枚举类型在不同数据库中处理方式不同：H2/MySQL 用 `ENUM(...)` 原生枚举，PG/MSSQL 用 `${string.type}(255)`。枚举属性命名规则：`${<module>.<enum-name>.type}`。
 

package/dist/skills/reef-style-backend/fragments/java/dependency-management/quick-reference.md

@@ -2,15 +2,15 @@
 
 ## 速查
 
-| 场景 | 决策 |
-| --- | --- |
-| 声明依赖 | 全部在 `gradle/libs.versions.toml` 的 `[libraries]` 中声明 |
-| 版本声明 | 全部在 `gradle/libs.versions.toml` 的 `[versions]` 中声明 |
+| 场景       | 决策                                                       |
+| ---------- | ---------------------------------------------------------- |
+| 声明依赖   | 全部在 `gradle/libs.versions.toml` 的 `[libraries]` 中声明 |
+| 版本声明   | 全部在 `gradle/libs.versions.toml` 的 `[versions]` 中声明  |
 | 引入新依赖 | 先查 version catalog 是否已有，无则按模块 + 版本号格式添加 |
-| 临时排除 | 在 catalog 中使用 `exclude` 而非 `build.gradle.kts` 中排除 |
-| 版本升级 | 同步升级相关依赖（如 Liquibase + Spring Boot 一起升级） |
-| CVE 检查 | 配合 Dependabot / Renovate + Gradle Versions Plugin |
-| 许可限制 | 禁止引入 AGPL / 需商业许可的依赖 |
+| 临时排除   | 在 catalog 中使用 `exclude` 而非 `build.gradle.kts` 中排除 |
+| 版本升级   | 同步升级相关依赖（如 Liquibase + Spring Boot 一起升级）    |
+| CVE 检查   | 配合 Dependabot / Renovate + Gradle Versions Plugin        |
+| 许可限制   | 禁止引入 AGPL / 需商业许可的依赖                           |
 
 ## 核心规范
 
@@ -39,6 +39,7 @@ spring-boot = { id = "org.springframework.boot", version.ref = "spring-boot" }
 ```
 
 **规范：**
+
 - 所有依赖的**版本号**必须声明在 `[versions]` 中，不得在 `[libraries]` 中使用 `version = "1.0.0"` 字面量
 - `[libraries]` 中使用 `version.ref` 引用版本
 - 同一生态的依赖使用同一个版本变量（如所有 Spring Boot starter 共享 `spring-boot` 版本）
@@ -66,13 +67,13 @@ dependencies {
 
 升级一个依赖时，检查同一生态链的其他依赖是否需要同步升级：
 
-| 升级场景 | 需同步升级的关联依赖 |
-|---------|-------------------|
-| Spring Boot 升级 | Spring Cloud、spring-dependency-management、相关 starter |
-| Liquibase 升级 | 验证与 Spring Boot 版本兼容性 |
-| MapStruct 升级 | mapstruct-processor 必须保持同一版本 |
-| Hibernate 升级 | Spring Boot 提供的 Hibernate 版本（随 Boot 版本） |
-| Testcontainers 升级 | 验证与 JUnit 5 兼容性 |
+| 升级场景            | 需同步升级的关联依赖                                     |
+| ------------------- | -------------------------------------------------------- |
+| Spring Boot 升级    | Spring Cloud、spring-dependency-management、相关 starter |
+| Liquibase 升级      | 验证与 Spring Boot 版本兼容性                            |
+| MapStruct 升级      | mapstruct-processor 必须保持同一版本                     |
+| Hibernate 升级      | Spring Boot 提供的 Hibernate 版本（随 Boot 版本）        |
+| Testcontainers 升级 | 验证与 JUnit 5 兼容性                                    |
 
 ### Gradle Versions Plugin
 
@@ -93,6 +94,7 @@ plugins {
 ```
 
 **规范：**
+
 - 每个 Major 版本升级前先在本地验证兼容性
 - 升级依赖必须作为独立 PR/commit，附 changelog 摘要
 - Minor/Patch 升级可随功能 PR 一起提交
@@ -105,15 +107,16 @@ plugins {
 ```
 
 **规范：**
+
 - Dependabot 或 Renovate 的 CVE PR 在 7 天内处理
 - 紧急 CVE（CVSS >= 7.0）：1 天内升级并验证
 - 无法立即升级时，记录在安全看板中，加 `@SuppressWarnings("CVE-XXXX")` 并附缓解说明
 
 ### 禁止使用的依赖
 
-| 依赖 | 禁止原因 | 替代方案 |
-|------|---------|---------|
-| Apache Commons Lang 2 | 有已知 CVE，已被 lang3 取代 | `org.apache.commons:commons-lang3` |
-| Log4j 1.x | EOL，有已知 CVE | Spring Boot 内置 Logback 或 Log4j 2 |
-| Guava 旧版 < 30.0 | 已知 CVE | 最低 32.x |
-| Joda-Time | 已被 java.time 取代 | `java.time.*` / `ThreeTen-Extra`（如需要） |
+| 依赖                  | 禁止原因                    | 替代方案                                   |
+| --------------------- | --------------------------- | ------------------------------------------ |
+| Apache Commons Lang 2 | 有已知 CVE，已被 lang3 取代 | `org.apache.commons:commons-lang3`         |
+| Log4j 1.x             | EOL，有已知 CVE             | Spring Boot 内置 Logback 或 Log4j 2        |
+| Guava 旧版 < 30.0     | 已知 CVE                    | 最低 32.x                                  |
+| Joda-Time             | 已被 java.time 取代         | `java.time.*` / `ThreeTen-Extra`（如需要） |

package/dist/skills/reef-style-backend/fragments/java/exception-handling/examples/error-code-enum.md

@@ -76,13 +76,13 @@ public enum ErrorCode {
 
 ## 异常 + 错误码对照表
 
-| 异常类 | HTTP | 错误码示例 | 典型场景 |
-|--------|------|-----------|---------|
-| `ResourceNotFoundException` | 404 | `USER_100` | 用户不存在 |
-| `AlreadyExistsException` | 409 | `USER_001` | 用户名重复 |
-| `InvalidArgumentException` | 400 | `ORDER_001` | 金额无效 |
-| `PermissionDeniedException` | 403 | `AUTH_201` | 无权操作 |
-| `FailedPreconditionException` | 400 | `ORDER_101` | 订单状态不允许 |
+| 异常类                        | HTTP | 错误码示例  | 典型场景       |
+| ----------------------------- | ---- | ----------- | -------------- |
+| `ResourceNotFoundException`   | 404  | `USER_100`  | 用户不存在     |
+| `AlreadyExistsException`      | 409  | `USER_001`  | 用户名重复     |
+| `InvalidArgumentException`    | 400  | `ORDER_001` | 金额无效       |
+| `PermissionDeniedException`   | 403  | `AUTH_201`  | 无权操作       |
+| `FailedPreconditionException` | 400  | `ORDER_101` | 订单状态不允许 |
 
 ## 映射逻辑
 

package/dist/skills/reef-style-backend/fragments/java/exception-handling/quick-reference.md

@@ -2,14 +2,14 @@
 
 ## 速查
 
-| 场景 | 决策 |
-| --- | --- |
-| 业务异常 | 继承 `BusinessException` → 按场景选子类：`ResourceNotFoundException` / `AlreadyExistsException` / `InvalidArgumentException` / `PermissionDeniedException` / `FailedPreconditionException` |
-| 全局捕获 | `@RestControllerAdvice` + `GlobalExceptionHandler` |
-| 错误响应 | `ErrorResponse(code, message, detail)` — AIP-193 兼容 |
-| 错误码 | `{MODULE}_{NNN}` 枚举：`ErrorCode` enum 统一管理 |
-| 参数校验失败 | `MethodArgumentNotValidException` → `InvalidArgumentException` 统一处理 |
-| 未知异常 | 兜底 500 — `GENERIC_001`，记录完整堆栈 |
+| 场景         | 决策                                                                                                                                                                                       |
+| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| 业务异常     | 继承 `BusinessException` → 按场景选子类：`ResourceNotFoundException` / `AlreadyExistsException` / `InvalidArgumentException` / `PermissionDeniedException` / `FailedPreconditionException` |
+| 全局捕获     | `@RestControllerAdvice` + `GlobalExceptionHandler`                                                                                                                                         |
+| 错误响应     | `ErrorResponse(code, message, detail)` — AIP-193 兼容                                                                                                                                      |
+| 错误码       | `{MODULE}_{NNN}` 枚举：`ErrorCode` enum 统一管理                                                                                                                                           |
+| 参数校验失败 | `MethodArgumentNotValidException` → `InvalidArgumentException` 统一处理                                                                                                                    |
+| 未知异常     | 兜底 500 — `GENERIC_001`，记录完整堆栈                                                                                                                                                     |
 
 ## 核心规范
 
@@ -63,6 +63,7 @@ public class ResourceNotFoundException extends BusinessException {
 ```
 
 **规范：**
+
 - 业务异常**必须**继承 `BusinessException`，不得直接抛 `RuntimeException` 或 `ResponseStatusException`
 - 每个构造函数传入 `ErrorCode` 枚举值，而非硬编码字符串
 - 可选的 `detail` map 携带上下文信息（如资源 ID、字段名）用于调试
@@ -149,6 +150,7 @@ public class GlobalExceptionHandler {
 ```
 
 **规范：**
+
 - 不要在每个 Controller 中写 try-catch
 - 不要吞异常后返回 null 或空集合
 - 兜底 handler 必须 `log.error` 记录完整堆栈

package/dist/skills/reef-style-backend/fragments/java/framework/spring-boot/examples/dto-mapper.md

@@ -105,8 +105,8 @@ public interface DataObjectFieldMapper {
 
 ### 命名约定
 
-| 方法名 | 用途 |
-|--------|------|
+| 方法名                 | 用途               |
+| ---------------------- | ------------------ |
 | `mapToSummary(entity)` | 精简 DTO（列表用） |
 | `mapToDetails(entity)` | 完整 DTO（详情用） |
 

package/dist/skills/reef-style-backend/fragments/java/framework/spring-boot/examples/service-entity.md

@@ -52,12 +52,12 @@ public interface FormRepository extends JpaRepository<Form, Long> {
 
 ## 3. 实体
 
-| 场景 | 基类 |
-|------|------|
-| 普通多租户，可变 | `AbstractTenantAwareEntity` |
-| 多租户 + 审计字段 | `AbstractTenantAwareAuditable` |
+| 场景                  | 基类                                    |
+| --------------------- | --------------------------------------- |
+| 普通多租户，可变      | `AbstractTenantAwareEntity`             |
+| 多租户 + 审计字段     | `AbstractTenantAwareAuditable`          |
 | 多租户，不可变 + 审计 | `AbstractTenantAwareImmutableAuditable` |
-| 非租户实体（极少） | `AbstractEntity` 或 `AbstractAuditable` |
+| 非租户实体（极少）    | `AbstractEntity` 或 `AbstractAuditable` |
 
 ```java
 @Entity

package/dist/skills/reef-style-backend/fragments/java/framework/spring-boot/examples/testing.md

@@ -103,5 +103,6 @@ class FormServiceTest {
 ```
 
 关键点：
+
 - `ArgumentCaptor` 验证事件发布，不直接 Mock `ApplicationEventPublisher`
 - `@Transactional` 确保每个测试回滚，互不干扰