11comm

使用 Nitro v3 框架和 H3 编写服务端 API 的技能。适用于后端接口开发、Mock 数据迁移到 Neon 数据库、以及编写符合 Drizzle ORM 标准的查询逻辑。当需要开发新的 CRUD 接口或修复现有后端逻辑时使用此技能。

规范类型项目（apps/type）的代码组织方式、导出语法和文件结构。用于解决类型导出冲突、创建统一导出入口、处理重复导出等问题。适用于类型项目开发、类型错误修复、代码规范实施场景。在处理类型项目的代码写法时，请使用本技能。

当你修改数据库结构或种子生成脚本时，请务必阅读并遵循此指南，以防止性能问题、数据一致性崩溃和部署失败。新 Schema 应在 apps/type 中创建。

数据库 Schema 变更时的全项目同步检查清单。当修改 apps/type 中 schema.ts 的表字段、新增数据库表、或删除表时，使用此技能确保类型项目、数据库迁移、后端接口、前端页面、种子数据和技能文档全部同步更新，避免遗漏。

当用户要求在 bug 已经定位并修复后，记录排错经验、事故结论、AI 记忆更新、复盘摘要或本地 MCP 记忆时使用。这个技能只负责沉淀"发生了什么、为什么会发生、如何修好、以后要记住什么"，不要把它用于实际修复 bug。

新建公共组件规范专家 - 指导在 src/components/common 目录下创建符合项目规范的公共组件，包括文件结构、TypeScript 类型、Vue 组件、文档和测试页面。 触发条件（满足任意一项即触发）： - 任务包含"新建组件"、"公共组件"、"common 组件"、"创建组件"等关键词 - 需要在 src/components/common 目录下创建新组件 - 需要创建可复用的业务组件（如表单分区标题、操作按钮组、信息展示卡片） - 需要编写组件的 TypeScript 类型定义 - 需要编写组件使用文档（index.md） - 需要创建组件测试页面（src/pages/test-use/） - 用户提及"组件规范"、"组件文档"、"组件测试"等关键词 必须协同的技能： - beautiful-component-design（组件美化时）- 图标、响应式设计、表单分区标题 - component-migration（从旧组件迁移时）- ColorUI → wot-design-uni - use-wd-form（组件内包含表单时）- 表单结构、wd-picker、校验规则 禁止事项： - 禁止在 components 目录外创建公共组件 - 禁止不编写组件文档（index.md） - 禁止不提供使用示例和测试页面 - 禁止组件命名不规范（必须使用短横线命名法） - 禁止不定义 TypeScript 类型（types.ts） - 禁止在组件文件顶部不添加说明注释 - 禁止不使用 withDefaults 设置 props 默认值 覆盖场景：所有需要跨页面复用的业务组件，包括表单分区标题（FormSectionTitle）、操作按钮组（ActivityActions）、信息展示卡片（ActivityInfo）、加载状态组件（ZPagingLoading）等。

接口错误提示能力 - 提供统一的接口错误提示标准和实施方案，基于 wot-design-uni 和 Alova useRequest 回调模式。 触发条件（满足任意一项即触发）： - 编写任何 API 接口调用代码（使用 useRequest） - 处理 useRequest 的 onError 回调 - 实现全局错误拦截逻辑 - 用户提及"接口错误提示"、"错误处理"、"Toast 提示"等关键词 - 从 Vue2 迁移 API 调用（需要添加错误处理） - 实现表单提交、列表加载等涉及 API 的功能 必须协同的技能： - api-migration（API 接口迁移时） - z-paging-integration（分页列表时） - use-wd-form（表单提交时） 禁止项： - 禁止使用 try/catch 包装 send() 函数 - 禁止在组件内手动显示错误 Toast（全局拦截器已处理） - 禁止使用 immediate: true（必须手动触发请求） - 禁止在 onError 中重复显示错误提示 覆盖场景：几乎所有 API 调用都需要此技能，包括列表查询、详情查询、表单提交、数据删除、状态更新等。

专业的接口迁移与编写专家。从 Java110Context + uni.request 迁移到 Alova + TypeScript，并同时适配当前仓库的 Nitro / Vite mock 双运行时架构。 触发条件（满足任意一项即触发）： - 需要新增或修改 `src/api/*.ts` 接口定义 - 需要新增或修改 `server/modules/*/{endpoints,repository}.ts` - 需要为 H5 mock / Nitro 双运行时补齐同一份接口实现 - 需要从旧项目 `examples/gitee-exampl-app/constant/url.js` 迁移接口地址 - 需要维护 `src/api/mock/*.mock.ts` 本地 mock 包装层 - 用户提及“API 迁移”“接口定义”“Nitro 接口”“本地 mock”“useRequest”等关键词 必须协同的技能： - api-error-handling（几乎所有接口调用都需要） - z-paging-integration（分页列表时） - use-wd-form（表单提交时） - code-migration（从 Vue2 页面迁移时） 禁止项： - 禁止为已共享化模块把业务数据和 CRUD 逻辑继续堆回 `src/api/mock/*.mock.ts` - 禁止把迁移后的前端接口统一改成 `/api/**`，应继续兼容旧业务路径 - 禁止在 API 泛型里包裹 `ApiResponse` - 禁止使用 `try/catch` 包装 `send()` - 禁止在 `server/**` 运行时代码中使用 `@/` alias 或省略相对导入 `.ts` 扩展名 - 禁止为了写 H5 mock 再维护一套与 Nitro 分叉的业务实现 覆盖场景：列表、详情、创建、更新、状态流转、字典查询、分页接口，以及双运行时下的接口复用。

Nitro v3 + Neon + Drizzle 后端开发技能。指导如何使用 Nitro v3 构建独立后端服务，配合 Neon Postgres 和 Drizzle ORM 实现类型安全的数据库操作。适用于智慧社区物业管理系统后端开发。

移动端 uni-app + wot-design-uni 组件美化规范 - 提供图标、文本对齐、响应式设计、表单分区标题、选择器美化、弹框交互的完整规范。 触发条件（满足任意一项即触发）： - 需要添加 FormSectionTitle 组件（表单分区标题） - 需要使用 Carbon Icons 图标 - 需要实现响应式设计（rpx 单位、图片网格） - 需要美化选择器组件（wd-picker） - 需要实现弹框交互（wd-message-box、wd-popup） - 需要美化详情页卡片（通栏标题 + 色彩编码） - 用户提及"美化"、"图标"、"对齐"、"响应式"、"FormSectionTitle"等关键词 - 修复组件嵌套顺序错误（wd-picker 和 wd-cell） - 修复插槽使用错误（#value 插槽不存在） 必须协同的技能： - use-wd-form（表单页面必须协同） - api-migration（如果有接口调用） - api-error-handling（如果有接口调用） - z-paging-integration（列表页面美化） 禁止项： - 禁止使用 <view class="section-title"> 代替 FormSectionTitle - 禁止 wd-cell 包裹 wd-picker（正确：wd-picker 包裹 wd-cell） - 禁止使用不存在的 #value 插槽（wd-cell 没有此插槽） - 禁止使用 wd-popup 实现标准交互（应使用 wd-message-box） - 禁止在详情页卡片容器保留 padding（应移除以实现通栏标题） 覆盖场景：表单页面、详情页面、列表页面、选择器页面、弹框交互、图标使用、响应式布局等所有需要美化的场景。

专注于 Vue2 Options API 到 Vue3 Composition API + TypeScript 的迁移。 触发条件（满足任意一项即触发）： - 任务包含"Vue2 到 Vue3"、"Options API"、"Composition API"、"代码迁移"等关键词 - 需要将 Options API（data、methods、computed）转换为 Composition API（ref、reactive、computed） - 需要添加 TypeScript 类型定义 - 需要迁移生命周期钩子（mounted → onMounted） - 需要将 Vuex 迁移到 Pinia - 需要编写组合式函数（Composables） - 需要添加 definePage 页面配置 - 需要处理静态资源导入（@/ 别名 → import） - 从 Vue2 项目迁移页面代码 必须协同的技能： - component-migration（组件迁移）- ColorUI → wot-design-uni - style-migration（样式迁移）- ColorUI 类名 → UnoCSS 原子类 - api-migration（如果有接口）- API 调用 - api-error-handling（如果有接口）- 错误提示 - route-migration（路由迁移）- pages.json → 约定式路由 禁止事项： - 禁止使用 export default {}（必须使用 <script setup lang="ts">） - 禁止使用 this（Composition API 中不存在 this） - 禁止使用 any 类型（必须明确类型） - 禁止在 definePage 中添加 name 或 meta 字段（只使用 style） - 禁止在微信小程序样式中使用 * 通配符选择器 - 禁止在模板中直接使用 @/ 别名字符串（静态资源必须 import） 覆盖场景：几乎所有从 Vue2 迁移到 Vue3 的页面都需要此技能，包括代码结构、响应式数据、生命周期、状态管理等。

专业的 uni-app 组件迁移专家，从 ColorUI + uni-app 内置组件到 wot-design-uni 组件库的迁移。 触发条件（满足任意一项即触发）： - 任务包含"组件迁移"、"ColorUI"、"wot-design-uni"等关键词 - 需要将 ColorUI 组件（cu-btn、cu-list、cu-card）迁移到 wot-design-uni - 需要修复 wot-design-uni 组件使用错误（类型错误、插槽错误、嵌套顺序错误） - 需要迁移 Icon 图标（cuIcon-* → i-carbon-*） - 需要迁移表单组件（cu-form → wd-form） - 需要迁移空状态组件（no-data-page → wd-status-tip） - 需要迁移图片组件（image → wd-img） - 从 Vue2 项目迁移页面组件 必须协同的技能： - use-wd-form（表单页面迁移时，必须）- 表单结构、wd-picker、校验规则 - beautiful-component-design（表单页面迁移时，必须）- FormSectionTitle、图标、美化 - api-migration（如果有接口）- API 调用 - api-error-handling（如果有接口）- 错误提示 - style-migration（样式迁移）- ColorUI 类名 → UnoCSS 原子类 - code-migration（Vue2 迁移）- Options API → Composition API 禁止事项： - 禁止使用 wd-empty 组件（不存在，必须使用 wd-status-tip） - 禁止使用 wd-cell 的 #value 插槽（不存在） - 禁止使用 wd-radio-group 替代 wd-picker（除非动态场景） - 禁止在子组件内直接使用 <wd-toast />、<wd-message-box />（必须使用全局组合式函数） - 禁止跳过 beautiful-component-design 技能（表单页面必须使用） 覆盖场景：几乎所有从 Vue2 迁移到 Vue3 的组件都需要此技能，包括按钮、列表、卡片、表单、图标、空状态等。

当用户要求在 bug 已经定位并修复后，记录排错经验、事故结论、AI 记忆更新、复盘摘要或本地 MCP 记忆时使用。这个技能只负责沉淀"发生了什么、为什么会发生、如何修好、以后要记住什么"，不要把它用于实际修复 bug。

专注于 Vue2 传统路由配置到 Vue3 约定式路由的迁移。 触发条件（满足任意一项即触发）： - 任务包含"路由迁移"、"pages.json"、"约定式路由"、"路由配置"等关键词 - 需要从 pages.json 迁移到文件系统路由 - 需要添加 definePage 页面配置 - 需要配置强类型路由系统（TypedRouter） - 需要更新路由跳转代码（uni.navigateTo → TypedRouter） - 需要处理多平台路由适配 - 需要查阅路由迁移映射表（docs/prompts/route-migration-map.yml） - 从 Vue2 项目迁移页面路由 必须协同的技能： - code-migration（代码迁移）- Vue2 → Vue3 代码写法 - component-migration（组件迁移）- ColorUI → wot-design-uni - style-migration（样式迁移）- ColorUI 类名 → UnoCSS 原子类 禁止事项： - 禁止自行决定路由路径（必须查阅映射表） - 禁止使用 uni.navigateTo 字符串拼接（必须使用 TypedRouter） - 禁止在 definePage 中添加 name 字段（只使用 style） - 禁止跳过 definePage 配置（会导致标题显示为 "unibest"） - 禁止不更新映射表状态（完成后必须添加 ✅ 标记） 覆盖场景：几乎所有从 Vue2 迁移到 Vue3 的页面都需要此技能，包括路由配置、页面跳转、参数传递等。

专注于 ColorUI 到 UnoCSS + wot-design-uni 的样式系统迁移，从传统 CSS 框架到现代化原子 CSS。 触发条件（满足任意一项即触发）： - 任务包含"样式迁移"、"ColorUI"、"UnoCSS"、"原子 CSS"等关键词 - 需要将 ColorUI 类名（cu-btn、cu-list、cu-card）迁移到 UnoCSS 原子类 - 需要将 SCSS 变量迁移到 UnoCSS 主题配置 - 需要将固定像素（20px）转换为响应式单位（20rpx） - 需要迁移渐变背景（bg-gradual-* → bg-gradient-to-*） - 需要迁移间距样式（margin-xs → m-10rpx） - 需要迁移圆角样式（radius-sm → rounded-8rpx） - 从 Vue2 项目迁移页面样式 必须协同的技能： - component-migration（组件迁移）- ColorUI → wot-design-uni - code-migration（代码迁移）- Vue2 → Vue3 代码写法 - beautiful-component-design（可选）- 样式美化 禁止事项： - 禁止滥用 UnoCSS shortcuts 功能（不要将业务样式写入 uno.config.ts） - 禁止将 ColorUI 类名直接转为 shortcuts（应展开为原子类） - 禁止在微信小程序样式中使用 * 通配符选择器 - 禁止使用 UnoCSS 的 space-y-* / space-x-* 类（微信小程序不支持） - 禁止使用 UnoCSS 的 divide-y-* / divide-x-* 类（微信小程序不支持） - 禁止使用复杂的 :nth-child() 选择器（如 n+2, 3n+1） - 禁止使用 :not() 伪类选择器（特别是 :not([hidden])） 覆盖场景：几乎所有从 Vue2 迁移到 Vue3 的页面都需要此技能，包括布局、颜色、间距、形状、渐变等样式。

uni-app 动态页面标题设置专家 - 根据路由参数或业务状态动态设置页面标题，使用 uni.setNavigationBarTitle API。 触发条件（满足任意一项即触发）： - 任务包含"动态标题"、"页面标题"、"navigationBarTitleText"、"setNavigationBarTitle"等关键词 - 需要根据路由参数动态设置页面标题（如显示工单编号、房屋地址） - 需要根据业务状态动态更新标题（如派单/转单显示不同标题） - 从 Vue2 迁移需要动态标题的页面 - 实现详情页、编辑页、审核页等需要显示动态信息的标题 - 页面标题需要根据数据加载后的内容变化 - 需要在不同操作模式下显示不同标题（查看/编辑/审核） 必须协同的技能： - route-migration（路由迁移时）- 确保路由参数正确传递 - code-migration（Vue2 迁移时）- Options API → Composition API - api-migration（需要从接口获取标题数据时）- API 调用规范 禁止事项： - 禁止在 pages.json 中硬编码动态标题 - 禁止使用 uni.setNavigationBarTitle 的回调形式（应使用 Promise 或直接调用） - 禁止在 onLoad 之外的生命周期钩子中设置初始标题 - 禁止不处理标题设置失败的情况 - 禁止标题过长不做截断处理 覆盖场景：几乎所有需要根据数据动态显示标题的页面，包括详情页（显示编号/名称）、编辑页（显示操作类型）、审核页（显示审核状态）、表单页（显示创建/修改模式）等。

使用 wot-design-uni 的 wd-form 组件编写表单页的标准规范 - 提供表单结构、wd-picker 选择器、校验规则、提交处理的完整规范。 触发条件（满足任意一项即触发）： - 页面包含 <wd-form> 组件 - 需要实现表单页面（创建、编辑、提交等） - 需要添加选择功能（必须使用 wd-picker 而非 wd-radio-group） - 需要添加表单分区标题（必须使用 FormSectionTitle） - 用户提及"表单"、"wd-form"、"表单校验"、"表单提交"等关键词 - 从 Vue2 迁移表单页面 - 需要实现单选/多选功能（单选用 wd-picker，多选用 wd-checkbox-group） 必须协同的技能： - beautiful-component-design（FormSectionTitle、图标、美化） - api-migration（如果有接口调用） - api-error-handling（如果有接口调用） - code-migration + component-migration（从 Vue2 迁移时） 禁止项： - 禁止使用 wd-radio-group 实现单选（应使用 wd-picker） - 禁止使用 <view class="section-title"> 代替 FormSectionTitle - 禁止 wd-cell 包裹 wd-picker（正确：wd-picker 包裹 wd-cell） - 禁止使用不存在的 #value 插槽 - 禁止单选初始化为数组（应为空字符串） - 禁止多选初始化为字符串（应为空数组） 覆盖场景：维修工单创建、房屋申请、投诉录单、活动报名、用户信息编辑等所有表单页面。

z-paging 分页组件与 api-migration 适配方案 - 提供 z-paging 与 useRequest 回调钩子模式的正确集成方式。 触发条件（满足任意一项即触发）： - 页面包含 <z-paging> 组件 - 需要实现列表分页功能（工单列表、房屋列表、活动列表等） - 用户提及"分页"、"列表加载"、"上拉加载"、"下拉刷新"等关键词 - 从 Vue2 迁移分页列表页面 - 需要实现筛选条件 + 分页的组合功能 - 修复 z-paging 相关错误（无限循环、无法加载等） 必须协同的技能（强制组合）： - api-migration（API 接口调用） - api-error-handling（错误提示处理） - beautiful-component-design（可选，列表项美化） 禁止项： - 禁止在 @query 回调中使用 try/catch - 禁止在 @query 回调中调用 refresh()/reload()（会导致无限循环） - 禁止同时使用 :query 属性和 @query 事件 - 禁止使用 @query 时设置 :auto="false" - 禁止重复配置全局已配置的 props（default-page-size、refresher-enabled 等） - 禁止忘记调用 complete() 方法 覆盖场景：维修工单列表、房屋申请列表、活动列表、投诉列表、选择器列表等所有需要分页的列表页面。

项目数据库表清单与批量查询工具。提供项目中所有数据库表的完整列表，并支持使用 Neon MCP 批量查询表结构信息（字段、索引、外键），用于数据库结构查询和开发参考。当你需要验证表名、理解数据库结构、检查数据库 Schema 定义、批量查询全部表数据、或为开发和调试获取表结构参考时，必须使用此技能。

前端开发指南与模式，涵盖 `apps/admin`（Vue 3 + TypeScript）的页面结构、列表页、表单页、弹窗和 i18n 的最新标准写法。

修复 TypeScript 类型错误，优化类型写法的通用子代理。

提供项目代码风格指南，或根据代码风格审查/重构代码。每当需要把控【代码风格】时，请主动使用该技能。

项目范围迁移的策略和协议，特别关注数据库 schema 和类型系统的影子迁移（Shadow Migration）策略。

项目数据库schema架构综合指南，包含架构原则、编写标准（Trinity Pattern）和详细的领域参考。用于定义新表、修改schema或理解数据模型时使用。

Guides and best practices for working with Neon Serverless Postgres. Covers getting started, local development with Neon, choosing a connection method, Neon features, authentication (@neondatabase/auth), PostgREST-style data API (@neondatabase/neon-js), Neon CLI, and Neon's Platform API/SDKs. Use for any Neon-related questions.

使用 Neon Serverless Postgres 的指南和最佳实践。涵盖入门、使用 Neon 进行本地开发、选择连接方式、Neon 功能、身份验证 (@neondatabase/auth)、PostgREST 风格的数据 API (@neondatabase/neon-js)、Neon CLI 以及 Neon 的平台 API/SDK。用于任何与 Neon 相关的问题。

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.