@deepstorm/cli 0.10.2 → 0.11.1

package/dist/skills/reef-style-frontend/variants/vue/examples/service-routing.md

@@ -4,82 +4,86 @@
 
 ```typescript
 // composables/useUsers.ts
-import { ref, computed, watch } from 'vue'
-import type { User, PageResponse } from '@/shared/types/user'
+import { ref, computed, watch } from 'vue';
+import type { User, PageResponse } from '@/shared/types/user';
 
 interface UseUsersOptions {
-  page?: number
-  size?: number
-  search?: string
-  role?: string
+  page?: number;
+  size?: number;
+  search?: string;
+  role?: string;
 }
 
 // 使用 URLSearchParams 构建查询参数
 function buildQuery(params: UseUsersOptions): string {
-  const searchParams = new URLSearchParams()
-  if (params.page !== undefined) searchParams.set('page', String(params.page))
-  if (params.size !== undefined) searchParams.set('size', String(params.size))
-  if (params.search) searchParams.set('search', params.search)
-  if (params.role) searchParams.set('role', params.role)
-  const qs = searchParams.toString()
-  return qs ? `?${qs}` : ''
+  const searchParams = new URLSearchParams();
+  if (params.page !== undefined) searchParams.set('page', String(params.page));
+  if (params.size !== undefined) searchParams.set('size', String(params.size));
+  if (params.search) searchParams.set('search', params.search);
+  if (params.role) searchParams.set('role', params.role);
+  const qs = searchParams.toString();
+  return qs ? `?${qs}` : '';
 }
 
 export function useUsers(options: UseUsersOptions = {}) {
-  const users = ref<User[]>([])
-  const total = ref(0)
-  const loading = ref(true)
-  const error = ref<Error | null>(null)
-  const refreshKey = ref(0)
+  const users = ref<User[]>([]);
+  const total = ref(0);
+  const loading = ref(true);
+  const error = ref<Error | null>(null);
+  const refreshKey = ref(0);
 
   async function fetchUsers() {
-    loading.value = true
-    error.value = null
+    loading.value = true;
+    error.value = null;
 
     try {
-      const res = await fetch(`/api/v1/users${buildQuery(options)}`)
-      if (!res.ok) throw new Error(`HTTP ${res.status}`)
-      const data: PageResponse<User> = await res.json()
-      users.value = data.content
-      total.value = data.totalElements
+      const res = await fetch(`/api/v1/users${buildQuery(options)}`);
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      const data: PageResponse<User> = await res.json();
+      users.value = data.content;
+      total.value = data.totalElements;
     } catch (e) {
-      error.value = e as Error
+      error.value = e as Error;
     } finally {
-      loading.value = false
+      loading.value = false;
     }
   }
 
-  watch([() => options.page, () => options.size, () => options.search, () => options.role, refreshKey], () => {
-    fetchUsers()
-  }, { immediate: true })
+  watch(
+    [() => options.page, () => options.size, () => options.search, () => options.role, refreshKey],
+    () => {
+      fetchUsers();
+    },
+    { immediate: true },
+  );
 
   function refresh() {
-    refreshKey.value++
+    refreshKey.value++;
   }
 
-  return { users, total, loading, error, refresh }
+  return { users, total, loading, error, refresh };
 }
 
 // 写操作组合式函数
 export function useCreateUser() {
-  const loading = ref(false)
+  const loading = ref(false);
 
   async function create(data: CreateUserRequest): Promise<User> {
-    loading.value = true
+    loading.value = true;
     try {
       const res = await fetch('/api/v1/users', {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify(data),
-      })
-      if (!res.ok) throw new Error(`HTTP ${res.status}`)
-      return await res.json()
+      });
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      return await res.json();
     } finally {
-      loading.value = false
+      loading.value = false;
     }
   }
 
-  return { create, loading }
+  return { create, loading };
 }
 ```
 
@@ -87,54 +91,54 @@ export function useCreateUser() {
 
 ```typescript
 // stores/auth.ts
-import { defineStore } from 'pinia'
-import { ref, computed } from 'vue'
-import type { User } from '@/shared/types/user'
+import { defineStore } from 'pinia';
+import { ref, computed } from 'vue';
+import type { User } from '@/shared/types/user';
 
 export const useAuthStore = defineStore('auth', () => {
   // state
-  const user = ref<User | null>(null)
-  const token = ref<string | null>(localStorage.getItem('auth_token'))
-  const loading = ref(false)
+  const user = ref<User | null>(null);
+  const token = ref<string | null>(localStorage.getItem('auth_token'));
+  const loading = ref(false);
 
   // getters
-  const isAuthenticated = computed(() => !!token.value)
-  const isAdmin = computed(() => user.value?.role === 'ADMIN')
+  const isAuthenticated = computed(() => !!token.value);
+  const isAdmin = computed(() => user.value?.role === 'ADMIN');
 
   // actions
   async function login(username: string, password: string) {
-    loading.value = true
+    loading.value = true;
     try {
       const res = await fetch('/api/v1/auth/login', {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify({ username, password }),
-      })
-      const data = await res.json()
-      token.value = data.token
-      user.value = data.user
-      localStorage.setItem('auth_token', data.token)
+      });
+      const data = await res.json();
+      token.value = data.token;
+      user.value = data.user;
+      localStorage.setItem('auth_token', data.token);
     } finally {
-      loading.value = false
+      loading.value = false;
     }
   }
 
   function logout() {
-    user.value = null
-    token.value = null
-    localStorage.removeItem('auth_token')
+    user.value = null;
+    token.value = null;
+    localStorage.removeItem('auth_token');
   }
 
-  return { user, token, loading, isAuthenticated, isAdmin, login, logout }
-})
+  return { user, token, loading, isAuthenticated, isAdmin, login, logout };
+});
 ```
 
 ## 路由配置
 
 ```typescript
 // router/index.ts
-import { createRouter, createWebHistory } from 'vue-router'
-import { useAuthStore } from '@/stores/auth'
+import { createRouter, createWebHistory } from 'vue-router';
+import { useAuthStore } from '@/stores/auth';
 
 const router = createRouter({
   history: createWebHistory(import.meta.env.BASE_URL),
@@ -174,17 +178,17 @@ const router = createRouter({
       component: () => import('@/views/NotFound.vue'),
     },
   ],
-})
+});
 
 // 导航守卫
 router.beforeEach((to, from) => {
-  const auth = useAuthStore()
+  const auth = useAuthStore();
   if (to.meta.requiresAuth && !auth.isAuthenticated) {
-    return { name: 'login', query: { redirect: to.fullPath } }
+    return { name: 'login', query: { redirect: to.fullPath } };
   }
-})
+});
 
-export default router
+export default router;
 ```
 
 ## 主应用入口
@@ -192,19 +196,16 @@ export default router
 ```vue
 <!-- App.vue -->
 <script setup lang="ts">
-import { ConfigProvider } from 'ant-design-vue'
-import zhCN from 'ant-design-vue/es/locale/zh_CN'
-import dayjs from 'dayjs'
-import 'dayjs/locale/zh-cn'
+import { ConfigProvider } from 'ant-design-vue';
+import zhCN from 'ant-design-vue/es/locale/zh_CN';
+import dayjs from 'dayjs';
+import 'dayjs/locale/zh-cn';
 
-dayjs.locale('zh-cn')
+dayjs.locale('zh-cn');
 </script>
 
 <template>
-  <ConfigProvider
-    :locale="zhCN"
-    :theme="{ token: { colorPrimary: '#1677ff', borderRadius: 6 } }"
-  >
+  <ConfigProvider :locale="zhCN" :theme="{ token: { colorPrimary: '#1677ff', borderRadius: 6 } }">
     <RouterView />
   </ConfigProvider>
 </template>
@@ -212,13 +213,13 @@ dayjs.locale('zh-cn')
 
 ```typescript
 // main.ts
-import { createApp } from 'vue'
-import { createPinia } from 'pinia'
-import App from './App.vue'
-import router from './router'
-
-const app = createApp(App)
-app.use(createPinia())
-app.use(router)
-app.mount('#app')
+import { createApp } from 'vue';
+import { createPinia } from 'pinia';
+import App from './App.vue';
+import router from './router';
+
+const app = createApp(App);
+app.use(createPinia());
+app.use(router);
+app.mount('#app');
 ```

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

@@ -6,51 +6,46 @@
 
 ## 速查
 
-| 场景 | 决策 |
-| --- | --- |
-| 新建组件 | `<script setup lang="ts">` + `defineProps<Props>()` + 组合式 API |
-| 新建表单 | Ant Design Vue `<a-form>` + `v-model` + `:rules` 校验 |
-| 读数据 | 组合式函数（`useUsers`）封装 fetch/axios |
-| 写数据 | 组合式函数 + `ref()` loading/error/data 三态 |
-| 组合式函数职责 | 只负责业务逻辑和数据获取，不管理 UI 渲染 |
-| 路由 | 动态 `import()` + `createRouter` 懒加载 |
+| 场景           | 决策                                                             |
+| -------------- | ---------------------------------------------------------------- |
+| 新建组件       | `<script setup lang="ts">` + `defineProps<Props>()` + 组合式 API |
+| 新建表单       | Ant Design Vue `<a-form>` + `v-model` + `:rules` 校验            |
+| 读数据         | 组合式函数（`useUsers`）封装 fetch/axios                         |
+| 写数据         | 组合式函数 + `ref()` loading/error/data 三态                     |
+| 组合式函数职责 | 只负责业务逻辑和数据获取，不管理 UI 渲染                         |
+| 路由           | 动态 `import()` + `createRouter` 懒加载                          |
 
 ## 新建组件
 
 ```vue
 <script setup lang="ts">
 interface UserTableProps {
-  users: User[]
-  loading?: boolean
-  onSelect?: (user: User) => void
+  users: User[];
+  loading?: boolean;
+  onSelect?: (user: User) => void;
 }
 
-const props = defineProps<UserTableProps>()
+const props = defineProps<UserTableProps>();
 const emit = defineEmits<{
-  select: [user: User]
-}>()
+  select: [user: User];
+}>();
 
 function handleClick(user: User) {
-  emit('select', user)
+  emit('select', user);
 }
 </script>
 
 <template>
-  <a-table
-    :data-source="props.users"
-    :loading="props.loading"
-    row-key="id"
-    @click="handleClick"
-  />
+  <a-table :data-source="props.users" :loading="props.loading" row-key="id" @click="handleClick" />
 </template>
 ```
 
-| 规则 | 要求 |
-| --- | --- |
-| `<script setup lang="ts">` | 禁止 Options API，使用组合式 API |
-| `defineProps<Type>()` | 使用泛型语法定义 Props，`type` 定义联合类型 |
-| 状态提升 | 组件间共享状态提升到最近公共父组件，或使用 Pinia |
-| 默认导出 | 页面级组件使用 `export default`（路由组件），通用组件使用具名导出 |
+| 规则                       | 要求                                                              |
+| -------------------------- | ----------------------------------------------------------------- |
+| `<script setup lang="ts">` | 禁止 Options API，使用组合式 API                                  |
+| `defineProps<Type>()`      | 使用泛型语法定义 Props，`type` 定义联合类型                       |
+| 状态提升                   | 组件间共享状态提升到最近公共父组件，或使用 Pinia                  |
+| 默认导出                   | 页面级组件使用 `export default`（路由组件），通用组件使用具名导出 |
 
 ## 组合式 API 规则
 
@@ -61,22 +56,22 @@ function handleClick(user: User) {
 
 ```vue
 <script setup lang="ts">
-import { ref, onMounted, onUnmounted } from 'vue'
+import { ref, onMounted, onUnmounted } from 'vue';
 
-const users = ref<User[]>([])
-const loading = ref(true)
-const error = ref<Error | null>(null)
+const users = ref<User[]>([]);
+const loading = ref(true);
+const error = ref<Error | null>(null);
 
 onMounted(async () => {
   try {
-    const res = await fetch('/api/v1/users')
-    users.value = await res.json()
+    const res = await fetch('/api/v1/users');
+    users.value = await res.json();
   } catch (e) {
-    error.value = e as Error
+    error.value = e as Error;
   } finally {
-    loading.value = false
+    loading.value = false;
   }
-})
+});
 </script>
 ```
 
@@ -105,7 +100,7 @@ onMounted(async () => {
 
 ```vue
 <script setup lang="ts">
-import { createRouter, createWebHistory } from 'vue-router'
+import { createRouter, createWebHistory } from 'vue-router';
 
 const router = createRouter({
   history: createWebHistory(import.meta.env.BASE_URL),
@@ -121,7 +116,7 @@ const router = createRouter({
       component: () => import('@/views/UserDetail.vue'),
     },
   ],
-})
+});
 </script>
 ```
 
@@ -135,19 +130,19 @@ const router = createRouter({
 
 ## 注释规则
 
-| 文件类型 | 注释要求 |
-|---------|---------|
-| **类型定义** | 复杂类型加行内注释说明字段含义 |
-| **组合式函数** | 简要说明该函数的功能和返回值 |
-| **组件** | 关键组件加注释说明用途；复杂逻辑行内注释 |
+| 文件类型       | 注释要求                                 |
+| -------------- | ---------------------------------------- |
+| **类型定义**   | 复杂类型加行内注释说明字段含义           |
+| **组合式函数** | 简要说明该函数的功能和返回值             |
+| **组件**       | 关键组件加注释说明用途；复杂逻辑行内注释 |
 
 ## 常见坑
 
-| 场景 | 问题 | 正确做法 |
-|------|------|---------|
-| `reactive` 整体赋值 | 直接 `state = newVal` 破坏响应式 | 使用 `Object.assign()` 或改用 `ref()` |
-| `v-for` 缺少 `:key` | 列表渲染异常/性能下降 | 绑定唯一 `:key="item.id"` |
-| 响应式解构丢失 | `const { name } = reactive(obj)` 解构后 `name` 失去响应性 | 使用 `toRefs()` 或保持 `obj.name` 访问 |
-| 生命周期清理遗漏 | 事件监听/定时器在组件卸载后仍然运行 | `onUnmounted` 中清理 |
-| `watch` 旧值误用 | 以为 `watch` 第一个回调参数是新值 | 签名是 `watch(source, (newVal, oldVal) => ...)` |
-| Ant Design Vue 手动导入遗漏 | `message` / `Modal` 等程序化 API 未导入 | 从 `ant-design-vue` 包手动导入 |
+| 场景                        | 问题                                                      | 正确做法                                        |
+| --------------------------- | --------------------------------------------------------- | ----------------------------------------------- |
+| `reactive` 整体赋值         | 直接 `state = newVal` 破坏响应式                          | 使用 `Object.assign()` 或改用 `ref()`           |
+| `v-for` 缺少 `:key`         | 列表渲染异常/性能下降                                     | 绑定唯一 `:key="item.id"`                       |
+| 响应式解构丢失              | `const { name } = reactive(obj)` 解构后 `name` 失去响应性 | 使用 `toRefs()` 或保持 `obj.name` 访问          |
+| 生命周期清理遗漏            | 事件监听/定时器在组件卸载后仍然运行                       | `onUnmounted` 中清理                            |
+| `watch` 旧值误用            | 以为 `watch` 第一个回调参数是新值                         | 签名是 `watch(source, (newVal, oldVal) => ...)` |
+| Ant Design Vue 手动导入遗漏 | `message` / `Modal` 等程序化 API 未导入                   | 从 `ant-design-vue` 包手动导入                  |

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

@@ -29,11 +29,11 @@ flowchart LR
 
 ## 使用方式
 
-| 方式 | 说明 | 示例 |
-|------|------|------|
-| **提供功能描述**（推荐） | 直接描述功能，自动解析生成 | "帮我生成注册功能的测试用例：邮箱+密码+验证码注册" |
-| **Jira + PRD** | 附上 PRD 链接获取更全面覆盖 | "Jira LC-1234：用户注册。PRD 说支持国际手机号，验证码 5 分钟有效" |
-| **Jira ID 参考** | 仅提 ID，引导补充描述 | "为 LC-1234 生成测试用例"（需用户补充描述） |
+| 方式                     | 说明                        | 示例                                                              |
+| ------------------------ | --------------------------- | ----------------------------------------------------------------- |
+| **提供功能描述**（推荐） | 直接描述功能，自动解析生成  | "帮我生成注册功能的测试用例：邮箱+密码+验证码注册"                |
+| **Jira + PRD**           | 附上 PRD 链接获取更全面覆盖 | "Jira LC-1234：用户注册。PRD 说支持国际手机号，验证码 5 分钟有效" |
+| **Jira ID 参考**         | 仅提 ID，引导补充描述       | "为 LC-1234 生成测试用例"（需用户补充描述）                       |
 
 ---
 
@@ -59,12 +59,12 @@ flowchart LR
 
 基于收集到的输入，按以下四个维度分析测试覆盖：
 
-| 维度 | 分析目标 | 来源 |
-|------|---------|------|
-| **正常流程** | 用户按预期操作的完整成功路径 | Jira 功能描述中的主要用户场景 |
-| **边界条件** | 输入值、状态或数据的极限条件 | 规格中的限制、约束、最大/最小值 |
-| **异常场景** | 出错的路径、故障、非预期操作 | 错误处理、网络超时、权限不足、数据不存在 |
-| **验收标准验证** | 逐条验证定义的验收条件 | PRD/Jira 中的 AC 列表 |
+| 维度             | 分析目标                     | 来源                                     |
+| ---------------- | ---------------------------- | ---------------------------------------- |
+| **正常流程**     | 用户按预期操作的完整成功路径 | Jira 功能描述中的主要用户场景            |
+| **边界条件**     | 输入值、状态或数据的极限条件 | 规格中的限制、约束、最大/最小值          |
+| **异常场景**     | 出错的路径、故障、非预期操作 | 错误处理、网络超时、权限不足、数据不存在 |
+| **验收标准验证** | 逐条验证定义的验收条件       | PRD/Jira 中的 AC 列表                    |
 
 **覆盖度要求：** 至少覆盖三个维度（必须包含"正常流程"和"验收标准"）。
 
@@ -76,14 +76,14 @@ flowchart LR
 
 每个测试用例包含以下字段：
 
-| 字段 | 必填 | 说明 |
-|------|------|------|
-| `ID` | 是 | 唯一标识，格式 `TC-{feature}-{seq}` |
-| `类型` | 是 | 正常流程 / 边界条件 / 异常场景 / 验收标准 |
-| `前置条件` | 是 | 测试所需的前置状态或数据 |
-| `测试步骤` | 是 | 清晰的操作步骤描述 |
-| `预期结果` | 是 | 期望的行为或输出 |
-| `关联验收标准` | 否 | 对应 PRD 或 Jira 中的验收标准编号 |
+| 字段           | 必填 | 说明                                      |
+| -------------- | ---- | ----------------------------------------- |
+| `ID`           | 是   | 唯一标识，格式 `TC-{feature}-{seq}`       |
+| `类型`         | 是   | 正常流程 / 边界条件 / 异常场景 / 验收标准 |
+| `前置条件`     | 是   | 测试所需的前置状态或数据                  |
+| `测试步骤`     | 是   | 清晰的操作步骤描述                        |
+| `预期结果`     | 是   | 期望的行为或输出                          |
+| `关联验收标准` | 否   | 对应 PRD 或 Jira 中的验收标准编号         |
 
 #### 3.2 输出结构
 

package/dist/skills/reef-testcase/references/coverage-dimensions.md

@@ -11,11 +11,13 @@
 覆盖功能的预期使用路径，即 "Happy Path"。
 
 **关键问题：**
+
 - 用户按预期操作时会发生什么？
 - 最常见的成功路径是什么？
 - 输入有效数据时系统如何响应？
 
 **示例：**
+
 ```
 ID: TC-login-001 | 类型: 正常流程
 前置条件: 用户已注册且账号正常
@@ -30,6 +32,7 @@ ID: TC-login-001 | 类型: 正常流程
 覆盖输入值、状态或数据在极限条件下的行为。
 
 **关键问题：**
+
 - 输入允许的最大值/最小值？
 - 字符串为空或达到最大长度？
 - 列表为空的边界？
@@ -37,6 +40,7 @@ ID: TC-login-001 | 类型: 正常流程
 - 时间边界（过去/未来/并发）？
 
 **示例：**
+
 ```
 ID: TC-login-002 | 类型: 边界条件
 前置条件: 用户已注册
@@ -51,6 +55,7 @@ ID: TC-login-002 | 类型: 边界条件
 覆盖可能出错的路径、系统故障或非预期操作。
 
 **关键问题：**
+
 - 网络中断或超时？
 - 数据不存在或已被删除？
 - 权限不足？
@@ -59,6 +64,7 @@ ID: TC-login-002 | 类型: 边界条件
 - 第三方服务不可用？
 
 **示例：**
+
 ```
 ID: TC-login-003 | 类型: 异常场景
 前置条件: 用户已注册但账号被锁定
@@ -73,11 +79,13 @@ ID: TC-login-003 | 类型: 异常场景
 逐条验证 PRD 或 Jira 中定义的验收标准（Acceptance Criteria）是否满足。
 
 **关键问题：**
+
 - Jira Issue 中列出了哪些 AC？
 - PRD 中有哪些功能验收点？
 - 每条 AC 是否有对应的测试用例验证？
 
 **示例：**
+
 ```
 ID: TC-login-004 | 类型: 验收标准
 前置条件: 用户已注册

package/dist/skills/reef-testcase/references/test-case-template.md

@@ -4,28 +4,28 @@
 
 每个测试用例包含以下字段：
 
-| 字段 | 必填 | 说明 |
-|------|------|------|
-| `ID` | 是 | 唯一标识，格式 `TC-{feature}-{seq}` |
-| `类型` | 是 | 正常流程 / 边界条件 / 异常场景 / 验收标准 |
-| `前置条件` | 是 | 测试所需的前置状态或数据 |
-| `测试步骤` | 是 | 清晰的操作步骤描述 |
-| `预期结果` | 是 | 期望的行为或输出 |
-| `关联验收标准` | 否 | 对应 PRD 或 Jira 中的验收标准编号 |
+| 字段           | 必填 | 说明                                      |
+| -------------- | ---- | ----------------------------------------- |
+| `ID`           | 是   | 唯一标识，格式 `TC-{feature}-{seq}`       |
+| `类型`         | 是   | 正常流程 / 边界条件 / 异常场景 / 验收标准 |
+| `前置条件`     | 是   | 测试所需的前置状态或数据                  |
+| `测试步骤`     | 是   | 清晰的操作步骤描述                        |
+| `预期结果`     | 是   | 期望的行为或输出                          |
+| `关联验收标准` | 否   | 对应 PRD 或 Jira 中的验收标准编号         |
 
 ## 模板示例
 
 ```markdown
 ### TC-{feature}-001
 
-| 字段 | 内容 |
-|------|------|
-| **ID** | TC-{feature}-001 |
-| **类型** | 正常流程 |
-| **前置条件** | {测试所需的前置状态或数据} |
-| **测试步骤** | 1. {步骤一}<br>2. {步骤二}<br>3. {步骤三} |
-| **预期结果** | {期望的行为或输出} |
-| **关联验收标准** | AC-{id}（可选） |
+| 字段             | 内容                                      |
+| ---------------- | ----------------------------------------- |
+| **ID**           | TC-{feature}-001                          |
+| **类型**         | 正常流程                                  |
+| **前置条件**     | {测试所需的前置状态或数据}                |
+| **测试步骤**     | 1. {步骤一}<br>2. {步骤二}<br>3. {步骤三} |
+| **预期结果**     | {期望的行为或输出}                        |
+| **关联验收标准** | AC-{id}（可选）                           |
 ```
 
 ## 输出结构