@gong-ym/ai-spec-auto 0.2.14 → 0.2.15

package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-parallel-fetching.md

@@ -1,83 +1,83 @@
----
-title: Parallel Data Fetching with Component Composition
-impact: CRITICAL
-impactDescription: eliminates server-side waterfalls
-tags: server, rsc, parallel-fetching, composition
----
-
-## Parallel Data Fetching with Component Composition
-
-React Server Components execute sequentially within a tree. Restructure with composition to parallelize data fetching.
-
-**Incorrect (Sidebar waits for Page's fetch to complete):**
-
-```tsx
-export default async function Page() {
-  const header = await fetchHeader()
-  return (
-    <div>
-      <div>{header}</div>
-      <Sidebar />
-    </div>
-  )
-}
-
-async function Sidebar() {
-  const items = await fetchSidebarItems()
-  return <nav>{items.map(renderItem)}</nav>
-}
-```
-
-**Correct (both fetch simultaneously):**
-
-```tsx
-async function Header() {
-  const data = await fetchHeader()
-  return <div>{data}</div>
-}
-
-async function Sidebar() {
-  const items = await fetchSidebarItems()
-  return <nav>{items.map(renderItem)}</nav>
-}
-
-export default function Page() {
-  return (
-    <div>
-      <Header />
-      <Sidebar />
-    </div>
-  )
-}
-```
-
-**Alternative with children prop:**
-
-```tsx
-async function Header() {
-  const data = await fetchHeader()
-  return <div>{data}</div>
-}
-
-async function Sidebar() {
-  const items = await fetchSidebarItems()
-  return <nav>{items.map(renderItem)}</nav>
-}
-
-function Layout({ children }: { children: ReactNode }) {
-  return (
-    <div>
-      <Header />
-      {children}
-    </div>
-  )
-}
-
-export default function Page() {
-  return (
-    <Layout>
-      <Sidebar />
-    </Layout>
-  )
-}
-```
+---
+title: Parallel Data Fetching with Component Composition
+impact: CRITICAL
+impactDescription: eliminates server-side waterfalls
+tags: server, rsc, parallel-fetching, composition
+---
+
+## Parallel Data Fetching with Component Composition
+
+React Server Components execute sequentially within a tree. Restructure with composition to parallelize data fetching.
+
+**Incorrect (Sidebar waits for Page's fetch to complete):**
+
+```tsx
+export default async function Page() {
+  const header = await fetchHeader()
+  return (
+    <div>
+      <div>{header}</div>
+      <Sidebar />
+    </div>
+  )
+}
+
+async function Sidebar() {
+  const items = await fetchSidebarItems()
+  return <nav>{items.map(renderItem)}</nav>
+}
+```
+
+**Correct (both fetch simultaneously):**
+
+```tsx
+async function Header() {
+  const data = await fetchHeader()
+  return <div>{data}</div>
+}
+
+async function Sidebar() {
+  const items = await fetchSidebarItems()
+  return <nav>{items.map(renderItem)}</nav>
+}
+
+export default function Page() {
+  return (
+    <div>
+      <Header />
+      <Sidebar />
+    </div>
+  )
+}
+```
+
+**Alternative with children prop:**
+
+```tsx
+async function Header() {
+  const data = await fetchHeader()
+  return <div>{data}</div>
+}
+
+async function Sidebar() {
+  const items = await fetchSidebarItems()
+  return <nav>{items.map(renderItem)}</nav>
+}
+
+function Layout({ children }: { children: ReactNode }) {
+  return (
+    <div>
+      <Header />
+      {children}
+    </div>
+  )
+}
+
+export default function Page() {
+  return (
+    <Layout>
+      <Sidebar />
+    </Layout>
+  )
+}
+```

package/.agents/skills/profiles/react/vercel-react-best-practices/rules/server-serialization.md

@@ -1,38 +1,38 @@
----
-title: Minimize Serialization at RSC Boundaries
-impact: HIGH
-impactDescription: reduces data transfer size
-tags: server, rsc, serialization, props
----
-
-## Minimize Serialization at RSC Boundaries
-
-The React Server/Client boundary serializes all object properties into strings and embeds them in the HTML response and subsequent RSC requests. This serialized data directly impacts page weight and load time, so **size matters a lot**. Only pass fields that the client actually uses.
-
-**Incorrect (serializes all 50 fields):**
-
-```tsx
-async function Page() {
-  const user = await fetchUser()  // 50 fields
-  return <Profile user={user} />
-}
-
-'use client'
-function Profile({ user }: { user: User }) {
-  return <div>{user.name}</div>  // uses 1 field
-}
-```
-
-**Correct (serializes only 1 field):**
-
-```tsx
-async function Page() {
-  const user = await fetchUser()
-  return <Profile name={user.name} />
-}
-
-'use client'
-function Profile({ name }: { name: string }) {
-  return <div>{name}</div>
-}
-```
+---
+title: Minimize Serialization at RSC Boundaries
+impact: HIGH
+impactDescription: reduces data transfer size
+tags: server, rsc, serialization, props
+---
+
+## Minimize Serialization at RSC Boundaries
+
+The React Server/Client boundary serializes all object properties into strings and embeds them in the HTML response and subsequent RSC requests. This serialized data directly impacts page weight and load time, so **size matters a lot**. Only pass fields that the client actually uses.
+
+**Incorrect (serializes all 50 fields):**
+
+```tsx
+async function Page() {
+  const user = await fetchUser()  // 50 fields
+  return <Profile user={user} />
+}
+
+'use client'
+function Profile({ user }: { user: User }) {
+  return <div>{user.name}</div>  // uses 1 field
+}
+```
+
+**Correct (serializes only 1 field):**
+
+```tsx
+async function Page() {
+  const user = await fetchUser()
+  return <Profile name={user.name} />
+}
+
+'use client'
+function Profile({ name }: { name: string }) {
+  return <div>{name}</div>
+}
+```

package/.agents/skills/profiles/springboot/README.md

@@ -1,10 +1,10 @@
-# Spring Boot Profile Skills
-
-此目录存放 Spring Boot profile 专属技能。
-
-当前已规划（待实现）的技能：
-
-- `create-controller` — 按团队规范创建 Controller 及 DTO
-- `create-service` — 按团队规范创建 Service 与实现类
-- `create-repository` — 按团队规范创建 Repository / Mapper
-- `create-entity` — 按团队规范创建 Entity / Domain 对象
+# Spring Boot Profile Skills
+
+此目录存放 Spring Boot profile 专属技能。
+
+当前已规划（待实现）的技能：
+
+- `create-controller` — 按团队规范创建 Controller 及 DTO
+- `create-service` — 按团队规范创建 Service 与实现类
+- `create-repository` — 按团队规范创建 Repository / Mapper
+- `create-entity` — 按团队规范创建 Entity / Domain 对象

package/.agents/skills/profiles/vue/create-api/SKILL.md

@@ -1,105 +1,105 @@
----
-name: create-api
-description: 指导在 Vue 3 项目中按团队规范创建和维护 HTTP 接口，包括类型定义、请求封装、命名约定与错误处理。当前端需要新增或调整 API 时使用本技能。
-compatibility: Requires a local Vue project workspace and the repository's API/rule conventions under .agents/rules/.
----
-
-# 创建与维护 API
-
-## 目录结构
-
-```text
-src/api/<name>.ts                # 请求函数（按业务模块拆分）
-src/api/types/<name>.ts     # 请求/响应类型定义
-```
-
-所有请求函数集中在 `src/api/` 下按模块管理，禁止在组件或 store 中直接调用 `request`。
-
----
-
-## 创建步骤
-
-### 1. 定义类型
-
-```ts
-// src/api/types/banner.ts
-export interface Banner {
-  id: number;
-  title: string;
-  imageUrl: string;
-  status: number;
-}
-
-export interface GetBannerListParams {
-  page: number;
-  pageSize: number;
-  status?: number;
-}
-
-export interface GetBannerListResult {
-  list: Banner[];
-  total: number;
-}
-
-export type CreateBannerParams = Pick<Banner, 'title' | 'imageUrl'>;
-export type UpdateBannerParams = CreateBannerParams & { id: number };
-```
-
-类型严格依据接口文档（如 Apifox），禁止凭空创造字段。
-
-### 2. 创建请求函数
-
-```ts
-// src/api/banner.ts
-import { request } from '@koi-design/vix-tools';
-import type {
-  GetBannerListParams,
-  GetBannerListResult,
-  CreateBannerParams,
-  UpdateBannerParams,
-} from './types/banner';
-
-export function getBannerListApi(data: GetBannerListParams): Promise<GetBannerListResult> {
-  return request({ url: '/api/banner/page', method: 'post', data });
-}
-
-export function getBannerDetailApi(id: number): Promise<Banner> {
-  return request({ url: `/api/banner/${id}`, method: 'get' });
-}
-
-export function createBannerApi(data: CreateBannerParams): Promise<void> {
-  return request({ url: '/api/banner', method: 'post', data });
-}
-
-export function updateBannerApi(data: UpdateBannerParams): Promise<void> {
-  return request({ url: `/api/banner/${data.id}`, method: 'put', data });
-}
-
-export function deleteBannerApi(id: number): Promise<void> {
-  return request({ url: `/api/banner/${id}`, method: 'delete' });
-}
-```
-
----
-
-## 命名约定（NON-NEGOTIABLE）
-
-`getXxxListApi` / `getXxxDetailApi` / `createXxxApi` / `updateXxxApi` / `deleteXxxApi`
-
-- 统一使用 `Api` 后缀，区分接口函数与业务函数
-- **禁止** `fetchXxx` 等前缀
-
-## 错误处理（NON-NEGOTIABLE）
-
-- 接口错误由 `requestConfig` 统一处理，业务代码中**禁止重复** `message.error` 等提示
-- 业务侧只处理成功逻辑及前端自身校验错误
-
----
-
-## 快速检查清单
-
-- [ ] 类型在 `src/api/types/<name>.ts`，请求在 `src/api/<name>.ts`？
-- [ ] 命名符合 `getXxxApi` / `createXxxApi` / `updateXxxApi` / `deleteXxxApi`？
-- [ ] 使用 `import { request } from '@koi-design/vix-tools'`？
-- [ ] 未重复处理接口错误？
-- [ ] 类型与接口文档一致？
+---
+name: create-api
+description: 指导在 Vue 3 项目中按团队规范创建和维护 HTTP 接口，包括类型定义、请求封装、命名约定与错误处理。当前端需要新增或调整 API 时使用本技能。
+compatibility: Requires a local Vue project workspace and the repository's API/rule conventions under .agents/rules/.
+---
+
+# 创建与维护 API
+
+## 目录结构
+
+```text
+src/api/<name>.ts                # 请求函数（按业务模块拆分）
+src/api/types/<name>.ts     # 请求/响应类型定义
+```
+
+所有请求函数集中在 `src/api/` 下按模块管理，禁止在组件或 store 中直接调用 `request`。
+
+---
+
+## 创建步骤
+
+### 1. 定义类型
+
+```ts
+// src/api/types/banner.ts
+export interface Banner {
+  id: number;
+  title: string;
+  imageUrl: string;
+  status: number;
+}
+
+export interface GetBannerListParams {
+  page: number;
+  pageSize: number;
+  status?: number;
+}
+
+export interface GetBannerListResult {
+  list: Banner[];
+  total: number;
+}
+
+export type CreateBannerParams = Pick<Banner, 'title' | 'imageUrl'>;
+export type UpdateBannerParams = CreateBannerParams & { id: number };
+```
+
+类型严格依据接口文档（如 Apifox），禁止凭空创造字段。
+
+### 2. 创建请求函数
+
+```ts
+// src/api/banner.ts
+import { request } from '@koi-design/vix-tools';
+import type {
+  GetBannerListParams,
+  GetBannerListResult,
+  CreateBannerParams,
+  UpdateBannerParams,
+} from './types/banner';
+
+export function getBannerListApi(data: GetBannerListParams): Promise<GetBannerListResult> {
+  return request({ url: '/api/banner/page', method: 'post', data });
+}
+
+export function getBannerDetailApi(id: number): Promise<Banner> {
+  return request({ url: `/api/banner/${id}`, method: 'get' });
+}
+
+export function createBannerApi(data: CreateBannerParams): Promise<void> {
+  return request({ url: '/api/banner', method: 'post', data });
+}
+
+export function updateBannerApi(data: UpdateBannerParams): Promise<void> {
+  return request({ url: `/api/banner/${data.id}`, method: 'put', data });
+}
+
+export function deleteBannerApi(id: number): Promise<void> {
+  return request({ url: `/api/banner/${id}`, method: 'delete' });
+}
+```
+
+---
+
+## 命名约定（NON-NEGOTIABLE）
+
+`getXxxListApi` / `getXxxDetailApi` / `createXxxApi` / `updateXxxApi` / `deleteXxxApi`
+
+- 统一使用 `Api` 后缀，区分接口函数与业务函数
+- **禁止** `fetchXxx` 等前缀
+
+## 错误处理（NON-NEGOTIABLE）
+
+- 接口错误由 `requestConfig` 统一处理，业务代码中**禁止重复** `message.error` 等提示
+- 业务侧只处理成功逻辑及前端自身校验错误
+
+---
+
+## 快速检查清单
+
+- [ ] 类型在 `src/api/types/<name>.ts`，请求在 `src/api/<name>.ts`？
+- [ ] 命名符合 `getXxxApi` / `createXxxApi` / `updateXxxApi` / `deleteXxxApi`？
+- [ ] 使用 `import { request } from '@koi-design/vix-tools'`？
+- [ ] 未重复处理接口错误？
+- [ ] 类型与接口文档一致？

package/.agents/skills/profiles/vue/create-component/SKILL.md

@@ -1,76 +1,76 @@
----
-name: create-component
-description: 指导在 Vue 3 项目中按团队规范创建和拆分 SFC 组件，包括目录结构、文件命名、样式与主题变量使用。当前端需要新增或重构组件时使用本技能。
-compatibility: Requires a local Vue project workspace and the repository's component/style conventions under .agents/rules/.
----
-
-# 创建与拆分 Vue 组件
-
-## 组件放在哪里？
-
-- **通用组件**（跨页面复用）：`src/components/<component-name>/index.vue + types.ts + style.module.scss`
-- **页面级组件**（只在单页使用）：`src/views/<page>/components/<component-name>/`
-- 目录名 `kebab-case`，组件引用名 `PascalCase`
-
----
-
-## 创建步骤
-
-### 1. 定义类型（types.ts）
-
-```ts
-// src/components/user-avatar/types.ts
-export interface UserAvatarProps {
-  src: string
-  size?: number
-}
-export interface UserAvatarEmits {
-  (e: 'click', event: MouseEvent): void
-}
-```
-
-### 2. 编写 SFC（index.vue）
-
-```vue
-<!-- src/components/user-avatar/index.vue -->
-<script setup lang="ts">
-import type { UserAvatarProps, UserAvatarEmits } from './types'
-import styles from './style.module.scss'
-
-withDefaults(defineProps<UserAvatarProps>(), { size: 40 })
-defineEmits<UserAvatarEmits>()
-</script>
-
-<template>
-  <img :class="styles.avatar" :src="src" :width="size" :height="size" @click="$emit('click', $event)" />
-</template>
-```
-
-### 3. 样式（style.module.scss）
-
-```scss
-.avatar {
-  border-radius: 50%;
-  object-fit: cover;
-  border: 1px solid var(--color-border);        // 必须使用主题变量
-  background-color: var(--color-bg-container);   // 禁止硬编码颜色
-}
-```
-
----
-
-## 核心规则
-
-- 必须使用 `<script setup lang="ts">`，通过 `defineProps` / `defineEmits` / `defineSlots` 声明接口
-- 样式使用 CSS Modules（`style.module.scss`）或 `<style scoped>`，颜色必须用主题变量
-- 单个 `.vue` 文件不超过 **400 行**，超过时拆分子组件
-- 一个组件聚焦单一职责
-
----
-
-## 快速检查清单
-
-- [ ] 组件放在了正确位置（通用 vs 页面级）？
-- [ ] 使用了 `<script setup lang="ts">` + defineProps/defineEmits？
-- [ ] 样式使用 CSS Modules 或 scoped，颜色用主题变量？
-- [ ] 文件不超过 400 行？
+---
+name: create-component
+description: 指导在 Vue 3 项目中按团队规范创建和拆分 SFC 组件，包括目录结构、文件命名、样式与主题变量使用。当前端需要新增或重构组件时使用本技能。
+compatibility: Requires a local Vue project workspace and the repository's component/style conventions under .agents/rules/.
+---
+
+# 创建与拆分 Vue 组件
+
+## 组件放在哪里？
+
+- **通用组件**（跨页面复用）：`src/components/<component-name>/index.vue + types.ts + style.module.scss`
+- **页面级组件**（只在单页使用）：`src/views/<page>/components/<component-name>/`
+- 目录名 `kebab-case`，组件引用名 `PascalCase`
+
+---
+
+## 创建步骤
+
+### 1. 定义类型（types.ts）
+
+```ts
+// src/components/user-avatar/types.ts
+export interface UserAvatarProps {
+  src: string
+  size?: number
+}
+export interface UserAvatarEmits {
+  (e: 'click', event: MouseEvent): void
+}
+```
+
+### 2. 编写 SFC（index.vue）
+
+```vue
+<!-- src/components/user-avatar/index.vue -->
+<script setup lang="ts">
+import type { UserAvatarProps, UserAvatarEmits } from './types'
+import styles from './style.module.scss'
+
+withDefaults(defineProps<UserAvatarProps>(), { size: 40 })
+defineEmits<UserAvatarEmits>()
+</script>
+
+<template>
+  <img :class="styles.avatar" :src="src" :width="size" :height="size" @click="$emit('click', $event)" />
+</template>
+```
+
+### 3. 样式（style.module.scss）
+
+```scss
+.avatar {
+  border-radius: 50%;
+  object-fit: cover;
+  border: 1px solid var(--color-border);        // 必须使用主题变量
+  background-color: var(--color-bg-container);   // 禁止硬编码颜色
+}
+```
+
+---
+
+## 核心规则
+
+- 必须使用 `<script setup lang="ts">`，通过 `defineProps` / `defineEmits` / `defineSlots` 声明接口
+- 样式使用 CSS Modules（`style.module.scss`）或 `<style scoped>`，颜色必须用主题变量
+- 单个 `.vue` 文件不超过 **400 行**，超过时拆分子组件
+- 一个组件聚焦单一职责
+
+---
+
+## 快速检查清单
+
+- [ ] 组件放在了正确位置（通用 vs 页面级）？
+- [ ] 使用了 `<script setup lang="ts">` + defineProps/defineEmits？
+- [ ] 样式使用 CSS Modules 或 scoped，颜色用主题变量？
+- [ ] 文件不超过 400 行？