@deepstorm/cli 0.11.0 → 0.11.1

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

@@ -6,19 +6,19 @@
 
 ## 速查
 
-| 场景 | 决策 |
-| --- | --- |
+| 场景            | 决策                                                                                           |
+| --------------- | ---------------------------------------------------------------------------------------------- |
 | 新建 Controller | `@RestController` + `@RequestMapping("/api/v1/apps/{appId}/...")` + `@RequiredArgsConstructor` |
-| 新建 Service | `@Service` + `@Transactional` + `@RequiredArgsConstructor`，字段 `private final` |
-| 新建 Repository | 继承 `JpaRepository<Entity, Long>` |
-| 新建立方 DTO | 继承 `AbstractDto` 等基类或使用 `@Value` |
-| 新建写请求 | 独立 `record CreateRequest` / `UpdateRequest` |
-| 对象映射 | MapStruct `@Mapper(config = MapStructConfig.class)` |
-| 异常处理 | 使用项目自定义异常（`NotFoundException` 等） |
-| 多租户查询 | 禁止裸 `findById`，使用 `findByIdAndAppId`；禁止 `createNativeQuery` |
-| Controller 权限 | 写操作接口加 `@PreAuthorize("hasAuthority('...')")` |
-| 密码存储 | `BCryptPasswordEncoder` |
-| 弃用 API | 编译警告中的 `@Deprecated` API 在同一次 PR 中替换为新 API |
+| 新建 Service    | `@Service` + `@Transactional` + `@RequiredArgsConstructor`，字段 `private final`               |
+| 新建 Repository | 继承 `JpaRepository<Entity, Long>`                                                             |
+| 新建立方 DTO    | 继承 `AbstractDto` 等基类或使用 `@Value`                                                       |
+| 新建写请求      | 独立 `record CreateRequest` / `UpdateRequest`                                                  |
+| 对象映射        | MapStruct `@Mapper(config = MapStructConfig.class)`                                            |
+| 异常处理        | 使用项目自定义异常（`NotFoundException` 等）                                                   |
+| 多租户查询      | 禁止裸 `findById`，使用 `findByIdAndAppId`；禁止 `createNativeQuery`                           |
+| Controller 权限 | 写操作接口加 `@PreAuthorize("hasAuthority('...')")`                                            |
+| 密码存储        | `BCryptPasswordEncoder`                                                                        |
+| 弃用 API        | 编译警告中的 `@Deprecated` API 在同一次 PR 中替换为新 API                                      |
 
 ## 核心规范
 

package/dist/skills/reef-style-backend/fragments/java/orm/hibernate/quick-reference.md

@@ -4,13 +4,13 @@
 
 ## 速查
 
-| 场景 | 决策 |
-| --- | --- |
-| 新建实体 | 继承 `AbstractTenantAwareEntity` 或 `AbstractTenantAwareAuditable` |
-| 实体 `@Table` 命名 | 小写蛇形复数，如 `app_forms` |
-| 审计字段 | `createdById` 由 `AuditingEntityListener` 自动填充 |
-| 日志实体 | 继承 `LogEntry`（SINGLE_TABLE），不直接继承基类 |
-| `open-in-view` | 设为 `false` |
+| 场景               | 决策                                                               |
+| ------------------ | ------------------------------------------------------------------ |
+| 新建实体           | 继承 `AbstractTenantAwareEntity` 或 `AbstractTenantAwareAuditable` |
+| 实体 `@Table` 命名 | 小写蛇形复数，如 `app_forms`                                       |
+| 审计字段           | `createdById` 由 `AuditingEntityListener` 自动填充                 |
+| 日志实体           | 继承 `LogEntry`（SINGLE_TABLE），不直接继承基类                    |
+| `open-in-view`     | 设为 `false`                                                       |
 
 ## 概述
 
@@ -46,6 +46,7 @@ public class User extends AbstractAuditable {
 ```
 
 **规则：**
+
 - 继承正确的基类（参见「实体/DTO 层次」章节）
 - 三件套：`@Entity` + `@NoArgsConstructor(access = PROTECTED)`（final 字段加 `force = true`），`@Getter` 类级别或字段级别，`@SuperBuilder` 按需使用
 - `@Table(name = "...")` 命名：小写蛇形，复数
@@ -99,11 +100,11 @@ classDiagram
 
 ## 关系映射
 
-| 关系 | 注解 | Fetch 策略 | 使用场景 |
-|------|------|-----------|---------|
-| 多对一 | `@ManyToOne` | LAZY (默认) | 子→父引用 |
-| 一对多 | `@OneToMany` | LAZY (默认) | 父→子集合 |
-| 一对一 | `@OneToOne` | LAZY (显式) | 用户→档案 |
+| 关系   | 注解          | Fetch 策略  | 使用场景  |
+| ------ | ------------- | ----------- | --------- |
+| 多对一 | `@ManyToOne`  | LAZY (默认) | 子→父引用 |
+| 一对多 | `@OneToMany`  | LAZY (默认) | 父→子集合 |
+| 一对一 | `@OneToOne`   | LAZY (显式) | 用户→档案 |
 | 多对多 | `@ManyToMany` | LAZY (显式) | 用户→角色 |
 
 ## 查询

package/dist/skills/reef-style-backend/fragments/java/security-redlines/quick-reference.md

@@ -2,15 +2,15 @@
 
 ## 🔴 红线速查
 
-| 红线 | 禁止行为 | 正确做法 | 违反后果 |
-|------|---------|---------|---------|
-| 密码存储 | 明文存储密码 | `BCryptPasswordEncoder`（Spring Security） | P0 — 安全漏洞 |
-| SQL 拼接 | 字符串拼接 SQL | JPA `@Query` + 命名参数，或 QueryDSL/JPA Criteria | P0 — SQL 注入 |
-| 危险初始化 | `@PostConstruct` 中触发写操作 | 延迟到首次调用或独立 `@EventListener(ApplicationReadyEvent.class)` | P1 — 非预期行为 |
-| 硬编码密钥 | 代码中硬编码 API Key / Secret | 环境变量或 `application-{profile}.yml`（.env 不提交） | P0 — 凭据泄露 |
-| 敏感信息打印 | `System.out.println` 敏感数据 | 用 SLF4J，生产日志级别过滤敏感字段 | P1 — 信息泄露 |
-| 文件上传验证 | 无限制的文件上传 | 限制类型 + 大小 + 重命名 + 非 webroot 存储 | P1 — 任意文件上传 |
-| 不安全的反序列化 | 信任外部反序列化数据 | 验证输入类型 + 数字签名 + 白名单 | P1 — 远程代码执行 |
+| 红线             | 禁止行为                      | 正确做法                                                           | 违反后果          |
+| ---------------- | ----------------------------- | ------------------------------------------------------------------ | ----------------- |
+| 密码存储         | 明文存储密码                  | `BCryptPasswordEncoder`（Spring Security）                         | P0 — 安全漏洞     |
+| SQL 拼接         | 字符串拼接 SQL                | JPA `@Query` + 命名参数，或 QueryDSL/JPA Criteria                  | P0 — SQL 注入     |
+| 危险初始化       | `@PostConstruct` 中触发写操作 | 延迟到首次调用或独立 `@EventListener(ApplicationReadyEvent.class)` | P1 — 非预期行为   |
+| 硬编码密钥       | 代码中硬编码 API Key / Secret | 环境变量或 `application-{profile}.yml`（.env 不提交）              | P0 — 凭据泄露     |
+| 敏感信息打印     | `System.out.println` 敏感数据 | 用 SLF4J，生产日志级别过滤敏感字段                                 | P1 — 信息泄露     |
+| 文件上传验证     | 无限制的文件上传              | 限制类型 + 大小 + 重命名 + 非 webroot 存储                         | P1 — 任意文件上传 |
+| 不安全的反序列化 | 信任外部反序列化数据          | 验证输入类型 + 数字签名 + 白名单                                   | P1 — 远程代码执行 |
 
 ## 🔴 红线详情
 
@@ -60,6 +60,7 @@ List<User> findByRawSQL(@Param("name") String name);
 ```
 
 **红线规则：**
+
 - Repository 中禁止使用 `+ name +` 拼接查询条件
 - 禁止 `createNativeQuery`（也绕过多租户过滤）
 - `@Query` 必须使用命名参数 `:paramName`，禁止使用 `?1` 位置参数
@@ -158,6 +159,7 @@ public static String maskPhone(String phone) {
 ```
 
 **红线规则：**
+
 - 禁止打印密码、Token、完整手机号、完整身份证号
 - DTO 中密码字段加 `@JsonIgnore` 或从响应 DTO 中排除
 - 禁止 `System.out.println` — 必须通过 SLF4J 日志框架

package/dist/skills/reef-style-backend/fragments/java/test/data-jpa-test/quick-reference.md

@@ -92,10 +92,10 @@ void should_findByEmail() {
 
 ## 关键规则
 
-| 场景 | 做法 |
-|------|------|
-| Repository 测试 | `@DataJpaTest` |
-| 测试数据库 | Testcontainers + `@ServiceConnection` |
-| 数据准备 | `entityManager.persistAndFlush()` 或 `@Sql` |
-| 多租户 | `findByIdAndAppId(id, appId)` **禁止裸 `findById`** |
-| 写操作 | `@Modifying` + 验证 `int updated` 返回值 |
+| 场景            | 做法                                                |
+| --------------- | --------------------------------------------------- |
+| Repository 测试 | `@DataJpaTest`                                      |
+| 测试数据库      | Testcontainers + `@ServiceConnection`               |
+| 数据准备        | `entityManager.persistAndFlush()` 或 `@Sql`         |
+| 多租户          | `findByIdAndAppId(id, appId)` **禁止裸 `findById`** |
+| 写操作          | `@Modifying` + 验证 `int updated` 返回值            |

package/dist/skills/reef-style-backend/fragments/java/test/junit5/quick-reference.md

@@ -9,13 +9,13 @@
 
 ## 基本注解
 
-| 注解 | 用途 |
-|------|------|
-| `@Test` | 标记测试方法，每个方法一个独立场景 |
+| 注解          | 用途                                |
+| ------------- | ----------------------------------- |
+| `@Test`       | 标记测试方法，每个方法一个独立场景  |
 | `@BeforeEach` | 每个测试前执行（初始化、Mock 设置） |
-| `@AfterEach` | 每个测试后执行（清理资源） |
-| `@BeforeAll` | 所有测试前（static） |
-| `@AfterAll` | 所有测试后（static） |
+| `@AfterEach`  | 每个测试后执行（清理资源）          |
+| `@BeforeAll`  | 所有测试前（static）                |
+| `@AfterAll`   | 所有测试后（static）                |
 
 ## AAA 模式
 

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

@@ -75,11 +75,11 @@ void should_return400_when_invalidInput() throws Exception {
 
 ## 关键规则
 
-| 场景 | 做法 |
-|------|------|
-| Controller 测试 | `@WebMvcTest` + `MockMvc` |
-| Service Mock | `@MockitoBean` |
-| 权限测试 | `@WithMockUser` + `authorities` |
-| JSON 验证 | `jsonPath("$.field").value(...)` |
-| 请求体 | `objectMapper.writeValueAsString(dto)` |
-| 异常路径 | Service 抛出异常，验证状态码 + message |
+| 场景            | 做法                                   |
+| --------------- | -------------------------------------- |
+| Controller 测试 | `@WebMvcTest` + `MockMvc`              |
+| Service Mock    | `@MockitoBean`                         |
+| 权限测试        | `@WithMockUser` + `authorities`        |
+| JSON 验证       | `jsonPath("$.field").value(...)`       |
+| 请求体          | `objectMapper.writeValueAsString(dto)` |
+| 异常路径        | Service 抛出异常，验证状态码 + message |

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

@@ -15,6 +15,7 @@ class UserServiceTest {
 ```
 
 > **⚠️ 何时用 `@SpringBootTest` vs `@ExtendWith(MockitoExtension.class)`**
+>
 > - **数据库交互**（Repository / 事务）→ `@SpringBootTest`
 > - **纯业务逻辑**（计算、校验、映射）→ `MockitoExtension`（更快）
 
@@ -72,12 +73,12 @@ void should_rollback_on_failure() {
 
 ## 关键规则
 
-| 场景 | 做法 |
-|------|------|
-| 需要数据库交互 | `@SpringBootTest` + `TestEntityManager` |
-| 纯业务逻辑 | `@ExtendWith(MockitoExtension.class)` |
-| 测试隔离 | `@Transactional`（自动回滚） |
-| 测试配置 | `@ActiveProfiles("test")` |
-| 数据准备 | `entityManager.persistAndFlush()` 或 `@Sql` |
+| 场景           | 做法                                        |
+| -------------- | ------------------------------------------- |
+| 需要数据库交互 | `@SpringBootTest` + `TestEntityManager`     |
+| 纯业务逻辑     | `@ExtendWith(MockitoExtension.class)`       |
+| 测试隔离       | `@Transactional`（自动回滚）                |
+| 测试配置       | `@ActiveProfiles("test")`                   |
+| 数据准备       | `entityManager.persistAndFlush()` 或 `@Sql` |
 
 > **注意：** `@Transactional` 不回滚 `@PostConstruct` 和异步操作（`@Async`）中的操作。

package/dist/skills/reef-style-backend/fragments/nodejs/eslint-config.json

@@ -10,10 +10,7 @@
     "sourceType": "module"
   },
   "plugins": ["@typescript-eslint/eslint-plugin"],
-  "extends": [
-    "plugin:@typescript-eslint/recommended",
-    "plugin:prettier/recommended"
-  ],
+  "extends": ["plugin:@typescript-eslint/recommended", "plugin:prettier/recommended"],
   "rules": {
     "@typescript-eslint/no-explicit-any": "error",
     "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],

package/dist/skills/reef-style-backend/fragments/nodejs/nestjs-structure.md

@@ -47,12 +47,12 @@ src/
 
 ## 命名规范
 
-| 类型 | 命名规则 | 示例 |
-|------|---------|------|
-| Module 类 | PascalCase + Module | `UsersModule` |
-| Controller 类 | PascalCase + Controller | `UsersController` |
-| Service 类 | PascalCase + Service | `UsersService` |
-| DTO 类 | PascalCase + Dto | `CreateUserDto` |
-| Module 目录 | kebab-case | `src/modules/user-roles/` |
-| DTO 文件 | kebab-case | `create-user-role.dto.ts` |
-| 配置键 | UPPER_SNAKE_CASE | `DATABASE_URL` |
+| 类型          | 命名规则                | 示例                      |
+| ------------- | ----------------------- | ------------------------- |
+| Module 类     | PascalCase + Module     | `UsersModule`             |
+| Controller 类 | PascalCase + Controller | `UsersController`         |
+| Service 类    | PascalCase + Service    | `UsersService`            |
+| DTO 类        | PascalCase + Dto        | `CreateUserDto`           |
+| Module 目录   | kebab-case              | `src/modules/user-roles/` |
+| DTO 文件      | kebab-case              | `create-user-role.dto.ts` |
+| 配置键        | UPPER_SNAKE_CASE        | `DATABASE_URL`            |

package/dist/skills/reef-style-backend/fragments/python/alembic-migration/quick-reference.md

@@ -45,7 +45,7 @@ alembic current
 """add user table
 
 Revision ID: abc123
-Revises: 
+Revises:
 Create Date: 2026-06-25 10:00:00
 """
 from alembic import op
@@ -71,6 +71,7 @@ def downgrade() -> None:
 ```
 
 **规范：**
+
 - 每个迁移文件只做**一件事**（一个表或一个字段变更）
 - `upgrade()` 和 `downgrade()` 必须互逆
 - `down_revision` 必须正确指向前一个迁移

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

@@ -2,17 +2,17 @@
 
 ## 速查
 
-| 场景 | 决策 |
-| --- | --- |
-| 资源路径 | 英文复数 kebab-case：`/api/v1/user-roles`，不用 camelCase |
-| 路径变量 | snake_case：`/api/v1/users/{user_id}` |
+| 场景       | 决策                                                                |
+| ---------- | ------------------------------------------------------------------- |
+| 资源路径   | 英文复数 kebab-case：`/api/v1/user-roles`，不用 camelCase           |
+| 路径变量   | snake_case：`/api/v1/users/{user_id}`                               |
 | 自定义动作 | 遵循 REST 语义；无法用标准 CRUD 时用 `@router.post("/{id}:action")` |
-| 查询参数 | snake_case：`?status=active&page=1&page_size=20` |
-| 统一响应体 | `response_model` + `ApiResponse[T]` / `PageResponse[T]` 包装 |
-| 版本策略 | URL path 前缀 `/api/v1/` |
-| 错误响应 | 统一 JSON：`{"code": "USER_001", "message": "...", "detail": {}}` |
-| OpenAPI | FastAPI 自动生成，配合 `summary` / `description` / `tags` |
-| 分页 | `page`(1-based) + `page_size`(默认 20，最大 100) |
+| 查询参数   | snake_case：`?status=active&page=1&page_size=20`                    |
+| 统一响应体 | `response_model` + `ApiResponse[T]` / `PageResponse[T]` 包装        |
+| 版本策略   | URL path 前缀 `/api/v1/`                                            |
+| 错误响应   | 统一 JSON：`{"code": "USER_001", "message": "...", "detail": {}}`   |
+| OpenAPI    | FastAPI 自动生成，配合 `summary` / `description` / `tags`           |
+| 分页       | `page`(1-based) + `page_size`(默认 20，最大 100)                    |
 
 ## 核心规范
 

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

@@ -2,17 +2,17 @@
 
 ## 速查
 
-| 场景 | 决策 |
-| --- | --- |
-| 包管理器 | `uv`（统一管理和运行） |
-| 声明依赖 | `uv add {package}` 或直接在 `pyproject.toml` 中声明 |
-| 版本声明 | 在 `pyproject.toml` 中指定主版本范围：`>=1.0,<2.0` |
-| 禁止通配符版本 | 禁止 `*` 或 `>=0.0.0` |
-| 禁止硬编码 | 禁止 `pip install package==1.0.0`（不可复现） |
-| 依赖分组 | `[project.dependencies]`（运行）+ `[project.optional-dependencies]`（dev） |
-| 锁定文件 | `uv.lock` — 提交到 Git |
-| CVE 检查 | `uv audit` 扫描已知漏洞 |
-| 版本升级 | 手动升级后运行 `uv lock` 更新锁定文件 |
+| 场景           | 决策                                                                       |
+| -------------- | -------------------------------------------------------------------------- |
+| 包管理器       | `uv`（统一管理和运行）                                                     |
+| 声明依赖       | `uv add {package}` 或直接在 `pyproject.toml` 中声明                        |
+| 版本声明       | 在 `pyproject.toml` 中指定主版本范围：`>=1.0,<2.0`                         |
+| 禁止通配符版本 | 禁止 `*` 或 `>=0.0.0`                                                      |
+| 禁止硬编码     | 禁止 `pip install package==1.0.0`（不可复现）                              |
+| 依赖分组       | `[project.dependencies]`（运行）+ `[project.optional-dependencies]`（dev） |
+| 锁定文件       | `uv.lock` — 提交到 Git                                                     |
+| CVE 检查       | `uv audit` 扫描已知漏洞                                                    |
+| 版本升级       | 手动升级后运行 `uv lock` 更新锁定文件                                      |
 
 ## 核心规范
 
@@ -50,6 +50,7 @@ dev = [
 ```
 
 **规范：**
+
 - 运行依赖在 `[project.dependencies]` 中声明
 - 开发/测试依赖在 `[project.optional-dependencies]` 中分组
 - 每组使用语义化版本范围：`>=min,<max`
@@ -106,11 +107,11 @@ uv add fastapi
 
 ### 版本升级规则
 
-| 升级类型 | 操作 | 验证 |
-|---------|------|------|
-| Major 升级 | 手动升级，独立 PR | 需检查 breaking changes + API 兼容性 |
-| Minor 升级 | `uv lock --upgrade-package {pkg}` | 运行完整测试套件 |
-| Patch 升级 | `uv lock --upgrade-package {pkg}` | 运行测试 + lint |
+| 升级类型   | 操作                              | 验证                                 |
+| ---------- | --------------------------------- | ------------------------------------ |
+| Major 升级 | 手动升级，独立 PR                 | 需检查 breaking changes + API 兼容性 |
+| Minor 升级 | `uv lock --upgrade-package {pkg}` | 运行完整测试套件                     |
+| Patch 升级 | `uv lock --upgrade-package {pkg}` | 运行测试 + lint                      |
 
 ### 安全审计
 
@@ -125,15 +126,16 @@ uv audit
 ```
 
 **规范：**
+
 - 每次 CI 中运行 `uv audit`
 - 紧急 CVE（CVSS >= 7.0）：1 天内升级并验证
 - 无法立即升级时，加备注和缓解措施文档
 
 ### 已知 CVE 常见的 Python 包
 
-| 包 | 受影响版本 | 最低安全版本 |
-|---|----------|------------|
-| urllib3 | < 2.2.3 | >= 2.2.3 |
-| requests | < 2.32.0 | >= 2.32.0 |
-| Jinja2 | < 3.1.5 | >= 3.1.5 |
-| cryptography | < 43.0.1 | >= 43.0.1 |
+| 包           | 受影响版本 | 最低安全版本 |
+| ------------ | ---------- | ------------ |
+| urllib3      | < 2.2.3    | >= 2.2.3     |
+| requests     | < 2.32.0   | >= 2.32.0    |
+| Jinja2       | < 3.1.5    | >= 3.1.5     |
+| cryptography | < 43.0.1   | >= 43.0.1    |

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

@@ -2,15 +2,15 @@
 
 ## 速查
 
-| 场景 | 决策 |
-| --- | --- |
-| 业务异常 | 继承 `AppError(HTTPException)`，含 `code` + `status_code` + `detail` |
-| 全局捕获 | `@app.exception_handler(AppError)` 统一处理 |
-| 错误响应 | `{"code": "USER_001", "message": "...", "detail": {}}` |
-| 错误码 | `{MODULE}_{NNN}` 枚举 |
-| 参数校验失败 | FastAPI 自动处理 `RequestValidationError` |
-| 未知异常 | 兜底 500 — `GENERIC_001`，记录完整 traceback |
-| Service 层异常 | 抛出 `AppError` 子类，不在 Router 中 try-catch |
+| 场景           | 决策                                                                 |
+| -------------- | -------------------------------------------------------------------- |
+| 业务异常       | 继承 `AppError(HTTPException)`，含 `code` + `status_code` + `detail` |
+| 全局捕获       | `@app.exception_handler(AppError)` 统一处理                          |
+| 错误响应       | `{"code": "USER_001", "message": "...", "detail": {}}`               |
+| 错误码         | `{MODULE}_{NNN}` 枚举                                                |
+| 参数校验失败   | FastAPI 自动处理 `RequestValidationError`                            |
+| 未知异常       | 兜底 500 — `GENERIC_001`，记录完整 traceback                         |
+| Service 层异常 | 抛出 `AppError` 子类，不在 Router 中 try-catch                       |
 
 ## 核心规范
 
@@ -146,6 +146,7 @@ async def unexpected_error_handler(request: Request, exc: Exception):
 ```
 
 **规范：**
+
 - 不要在 Router 函数中写 try-except 包裹业务逻辑
 - 不要吞异常后返回 `None` 或空字典
 - 兜底 handler 必须 `logger.error(..., exc_info=True)`

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

@@ -17,6 +17,7 @@ async def list_users(
 ```
 
 **规范：**
+
 - 每个模块一个 `APIRouter`，在 `app/api/v1/__init__.py` 中 `include_router`
 - 路径用 kebab-case：`/api/v1/user-roles`，不用 `/api/v1/userRoles`
 - 路径变量用 snake_case：`/api/v1/users/{user_id}`
@@ -41,6 +42,7 @@ async def get_user(user_id: int):   # ← 没有依赖注入
 ```
 
 **规范：**
+
 - Service 类使用 `__init__` 接收依赖，注册为 `Depends()`
 - 不要用全局单例模式
 - DAO / Repository 也通过 `Depends()` 注入到 Service
@@ -65,6 +67,7 @@ class UserResponse(BaseModel):
 ```
 
 **规范：**
+
 - Request Schema 用 `BaseModel`，加输入约束
 - Response Schema 用 `ConfigDict(from_attributes=True)` 以支持 ORM 序列化
 - CRUD 接口用 `Create*Request` / `Update*Request` / `*Response` 命名

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

@@ -7,6 +7,7 @@ LangChain 是 Python 生态中的 AI 集成框架，提供统一的 API 来调
 ## 核心概念
 
 ### ChatModel
+
 LangChain 的中央 API，用于与大语言模型交互。
 
 ```python
@@ -25,6 +26,7 @@ print(response.content)
 ```
 
 **最佳实践：**
+
 - `ChatOpenAI` / `ChatAnthropic` 在应用初始化时创建一次，通过依赖注入传递
 - 不要在每个请求中重新创建 LLM 实例
 - `temperature=0` 用于确定性结果，`temperature>0` 用于创意场景
@@ -65,6 +67,7 @@ llm_with_tools = llm.bind_tools([get_user_order])
 ```
 
 **最佳实践：**
+
 - `@tool` 的 docstring 会被模型理解，写清楚参数含义和返回值格式
 - 工具函数内部调用 Service 层，不在工具内写业务逻辑
 - `bind_tools([])` 传工具数组，不逐个 `.bind()` 调用
@@ -126,10 +129,10 @@ uv add chromadb tiktoken
 
 ## 常见坑
 
-| 场景 | 问题 | 正确做法 |
-|------|------|---------|
-| API Key 管理 | 硬编码在代码中 | 从 `os.getenv("OPENAI_API_KEY")` 读取 |
-| 每次请求新建 LLM | 性能差、连接池耗尽 | 应用启动时创建单例，通过 DI 注入 |
-| 工具函数逻辑过重 | 工具内包含全部业务逻辑 | 工具只做参数解析 + 调用 Service |
-| 忽略 `async` 支持 | LCEL 链中调同步 IO | 使用 `ainvoke()` 和 async retriever |
-| prompt 不设 system message | 模型行为不可控 | 始终设置 system message 定义角色和约束 |
+| 场景                       | 问题                   | 正确做法                               |
+| -------------------------- | ---------------------- | -------------------------------------- |
+| API Key 管理               | 硬编码在代码中         | 从 `os.getenv("OPENAI_API_KEY")` 读取  |
+| 每次请求新建 LLM           | 性能差、连接池耗尽     | 应用启动时创建单例，通过 DI 注入       |
+| 工具函数逻辑过重           | 工具内包含全部业务逻辑 | 工具只做参数解析 + 调用 Service        |
+| 忽略 `async` 支持          | LCEL 链中调同步 IO     | 使用 `ainvoke()` 和 async retriever    |
+| prompt 不设 system message | 模型行为不可控         | 始终设置 system message 定义角色和约束 |

package/dist/skills/reef-style-backend/fragments/python/pytest-testing/quick-reference.md

@@ -14,6 +14,7 @@ tests/
 ```
 
 **规范：**
+
 - `tests/unit/` — 不依赖外部服务的纯逻辑测试
 - `tests/integration/` — 依赖数据库、HTTP 调用的测试
 - 测试文件以 `test_` 开头，函数以 `test_` 开头
@@ -40,6 +41,7 @@ async def user_service(db_session: AsyncSession):
 ```
 
 **规范：**
+
 - 测试用 `pytest-asyncio` 支持异步 fixture 和 test
 - fixture 只在 `conftest.py` 中定义，不在测试文件中
 - fixture 范围默认 `function`，仅共享资源用 `session` / `module`

package/dist/skills/reef-style-backend/fragments/python/ruff-mypy-toolchain/quick-reference.md

@@ -31,6 +31,7 @@ line-ending = "lf"
 ```
 
 **规范：**
+
 - ruff 负责 lint（`ruff check`）和 format（`ruff format`）双重职责
 - 启用 `F` + `E` + `W` + `I` + `N` + `UP` + `B` 规则组
 - 行长度检查（`E501`）交给 black / ruff format，不在 lint 中重复
@@ -59,6 +60,7 @@ disallow_untyped_defs = false
 ```
 
 **规范：**
+
 - 生产代码使用 `strict = true`
 - 所有函数必须有类型注释
 - 测试文件放宽类型要求

package/dist/skills/reef-style-backend/fragments/python/security-redlines/quick-reference.md

@@ -2,15 +2,15 @@
 
 ## 🔴 红线速查
 
-| 红线 | 禁止行为 | 正确做法 | 违反后果 |
-|------|---------|---------|---------|
-| 密码存储 | 明文存储密码 | `hashlib` / `bcrypt` / `passlib` 哈希后存储 | P0 — 安全漏洞 |
-| SQL 拼接 | f-string / format 拼接 SQL | SQLAlchemy ORM 或 参数化查询 | P0 — SQL 注入 |
-| 硬编码密钥 | 代码中硬编码 Secret / Token | 环境变量 `os.getenv()` 或 `pydantic-settings` | P0 — 凭据泄露 |
-| 敏感信息打印 | `print()` 敏感数据 | `logging` + 脱敏 + 生产级别过滤 | P1 — 信息泄露 |
-| 输入验证缺失 | 不验证用户输入 | Pydantic model + 严格约束 | P1 — 注入/越权 |
-| 不安全的 CORS | `allow_origins=["*"]` | 明确指定允许源列表 | P1 — CORS 安全 |
-| 调试接口 | 生产暴露 `/docs` / 调试路由 | 根据环境变量控制开启 | P1 — 信息泄露 |
+| 红线          | 禁止行为                    | 正确做法                                      | 违反后果       |
+| ------------- | --------------------------- | --------------------------------------------- | -------------- |
+| 密码存储      | 明文存储密码                | `hashlib` / `bcrypt` / `passlib` 哈希后存储   | P0 — 安全漏洞  |
+| SQL 拼接      | f-string / format 拼接 SQL  | SQLAlchemy ORM 或 参数化查询                  | P0 — SQL 注入  |
+| 硬编码密钥    | 代码中硬编码 Secret / Token | 环境变量 `os.getenv()` 或 `pydantic-settings` | P0 — 凭据泄露  |
+| 敏感信息打印  | `print()` 敏感数据          | `logging` + 脱敏 + 生产级别过滤               | P1 — 信息泄露  |
+| 输入验证缺失  | 不验证用户输入              | Pydantic model + 严格约束                     | P1 — 注入/越权 |
+| 不安全的 CORS | `allow_origins=["*"]`       | 明确指定允许源列表                            | P1 — CORS 安全 |
+| 调试接口      | 生产暴露 `/docs` / 调试路由 | 根据环境变量控制开启                          | P1 — 信息泄露  |
 
 ## 🔴 红线详情
 
@@ -62,6 +62,7 @@ cursor.execute("SELECT * FROM users WHERE email = %s", (email,))
 ```
 
 **红线规则：**
+
 - 禁止在 SQL 中使用 `f"..."` 或 `"".format()` 拼接用户输入
 - 优先使用 SQLAlchemy ORM 的查询构建器
 - 必须使用原生 SQL 时，必须使用参数化查询（`:name` 或 `%s`）
@@ -133,6 +134,7 @@ logger.info(f"User [id={user_id}] logged in")
 ```
 
 **红线规则：**
+
 - 禁止打印密码、Token、完整手机号、完整身份证号
 - 响应体中密码字段不输出（Pydantic `model_config` 排除或 response schema 中忽略）
 - 禁止 `print()` — 必须使用 `logging` 模块

package/dist/skills/reef-style-backend/fragments/python/sqlalchemy-orm/quick-reference.md

@@ -27,6 +27,7 @@ class UserService:
 ```
 
 **规范：**
+
 - **强制**使用 `AsyncSession` + `async_sessionmaker`
 - 禁止同步 `Session` 或 `scoped_session`
 - `expire_on_commit=False` 避免 commit 后属性不可访问
@@ -52,6 +53,7 @@ class User(Base):
 ```
 
 **规范：**
+
 - **强制**使用 `Mapped` + `mapped_column`（v2.0 style）
 - 禁止旧版 `Column`(name, Type) 写法
 - 所有模型继承共享 `Base`
@@ -71,6 +73,7 @@ stmt = select(Post).options(joinedload(Post.author)).where(Post.id == post_id)
 ```
 
 **规范：**
+
 - 批量列表查询用 `selectinload()`（发出额外 IN 查询，对列表友好）
 - 单条查询用 `joinedload()`（JOIN 一次）
 - **禁止**在循环中逐条访问关联属性

package/dist/skills/reef-style-backend/variants/java/examples/code-wrapping.md

@@ -185,7 +185,7 @@ Java 15+ 的 Text Block 用于嵌入 JSON / SQL / XML / 模板等 DSL。缩进
 ```java
 // ✅ opening """ 后直接换行，内容相对 opening 行缩进 4 格
 // ✅ closing """ 决定 stripIndent() 的公共缩进基线
-var json = 
+var json =
     """
     {
       "name": "example",
@@ -195,7 +195,7 @@ var json =
     """;
 
 // ✅ 嵌入 SQL：closing """ 与 SQL 内容的公共缩进最左列对齐
-var sql = 
+var sql =
     """
     SELECT u.id, u.name, r.role_name
     FROM users u
@@ -211,7 +211,7 @@ var message = """
     """.formatted(userName, orderId);
 
 // ✅ 空行可用 \s 占位避免 stripIndent 清空：
-var json = 
+var json =
     """
     {
       "title": "test",
@@ -228,4 +228,3 @@ var json =
 - 禁止 text block 与 `+` 拼接混用；需要变量替换统一用 `formatted()`
 - 短字符串（≤ 100 列单行）不使用 text block，直接使用普通字符串
 - `\s` 用于显式保留 text block 中的空行（避免 `stripIndent()` 把空行清空）
-