barrel-export-best-practice
Must follow when 编写或审查 index.ts/index.js 桶导出文件,确保所有导出遵循只做 re-export、无业务逻辑、命名导出等规范。触发词:桶导出规范、index文件规范、barrel export审查、检查桶导出。
better-auth-integration
Must follow when 需要将 Better Auth 认证系统集成到项目,涵盖安装配置、数据库集成、Provider 设置和认证流程验证等完整步骤。触发词:集成better-auth、配置认证系统、接入鉴权。
check-all-best-practices
Use when 需要对项目进行全量最佳实践检查——自动发现并依次执行所有以 best-practice 结尾的技能,输出汇总报告并强制执行标准化验证指令。触发词:检查所有技能、全量规范验证、批量最佳实践检查。
check-all-skills
Use when 需要批量验证 Skill 是否符合最佳实践规范,自动检查命名、前言区、结构与依赖等维度,生成详细报告并输出修复建议;支持单个或批量检查。触发词:检查skill规范、批量验证技能质量。
check-barrel-export
Use when 需要生成、优化、修复或检查项目中所有 index 文件(桶导出),确保 index.ts/index.js 均遵循标准桶导出规范。触发词:生成barrel导出、优化index文件、检查桶导出规范。
check-refine-trpc
Use when 需要审查或重构 tRPC 路由代码,确保路由结构、类型定义、输入验证和错误处理均符合项目最佳实践;适用于代码审查和路由重构阶段。触发词:检查trpc代码、重构路由写法、优化tRPC格式。
check-svg
Use when 需要扫描或检查项目中 SVG 图标的使用情况,发现并报告不符合规范的写法,包括命名、路径和组件化问题;适用于代码审查阶段。触发词:检查svg规范、图标规范检查、SVG使用审查、SVG图标优化。
check-try-catch
Use when 需要扫描代码中 try-catch 的使用情况,识别不规范的错误处理模式,确保异常处理符合项目规范;适用于代码审查阶段。触发词:检查try-catch写法、错误处理规范检查、异常捕获审查。
create-skills
Use when 需要创建新技能或更新现有技能,将领域知识、工作流程、脚本和工具集成打包为可复用 Skill;生成的新技能须使用中文编写。触发词:创建新技能、更新skill、新建技能包、扩展AI能力。
dao-best-practice
Must follow when 创建或重构 DAO 文件,确保遵循 Drizzle ORM 最佳实践(文件结构、方法命名、类型安全、性能优化)。触发词:dao规范、DAO最佳实践、创建DAO文件、审查DAO代码。
db-table-best-practice
Must follow when 创建或审查 Drizzle ORM 数据库表定义,确保表名、列名、索引和关系配置均遵循项目命名规范与表结构规范。触发词:数据库表名规范、检查表结构定义、数据库命名审查、schema命名。
error-handling-best-practice
Must follow when 编写包含 try-catch 的错误处理代码,确保 catch 块有实质处理逻辑,不为空、不仅记录日志、必须处理或重新抛出异常。触发词:try-catch规范、错误处理最佳实践、异常处理审查。
fix-all-best-practices
Use when 需要一键扫描并自动修复项目中所有最佳实践违规问题,自动发现并依次执行所有 best-practice 技能的检查与修复操作。触发词:修复所有违规、自动修复最佳实践、一键规范化项目代码。
form-best-practice
Must follow when 创建或重构前端表单组件,确保表单结构、字段验证逻辑和状态管理遵循项目表单设计规范与组件化标准。触发词:表单规范、创建表单组件、表单最佳实践审查、form-best-practice。
generate-preview
Use when 需要对 React 组件文件生成结构化 .json 描述和可视化 .md 目录树预览,用于组件拆分前的详细结构分析、复杂度评估与规划。触发词:生成组件预览文档、拆分前分析、组件结构可视化。
implement-split
Use when 需要将大型组件或模块按最佳实践拆分为多个独立文件,系统性地执行代码拆分与重构,确保拆分后各模块结构符合规范。触发词:拆分组件、实现文件拆分、代码模块拆分重构、component-split。
implement-trpc-query
Use when 需要实现 tRPC 按需查询(on-demand query)模式,确保查询逻辑和数据获取方式符合项目 tRPC 规范和最佳实践。触发词:tRPC按需查询、实现tRPC查询、on-demand查询模式。
no-re-export-best-practice
Must follow when 审查或编写非 index 文件中的 import/export,禁止在非桶导出文件中对外部模块做 re-export(间接转发),每个消费文件应直接从来源 import。触发词:禁止重导出、re-export规范、非index文件导出、转发导出审查。
one-component-per-file-best-practice
Must follow when 检查或重构 React/Vue 组件文件,强制每个文件只包含一个组件,不允许多组件共存于同一文件;支持 TSX/JSX/Vue。触发词:一文件一组件、组件文件规范检查、单组件规范。
page-best-practice
Must follow when 创建或审查前端页面结构,确保遵循 Anatomy 规范,正确分离 Wrapper、Content 和 Optional Store 模块。触发词:创建页面、页面结构规范、前端页面解剖规范。
refactor-classname
Use when 需要检查或转换 React/Vue 文件中的 className 模板字符串为 cn 函数调用,支持递归扫描文件夹、详细报告所有位置。触发词:优化className写法、重构模板字符串、检查className规范。
refine-trpc-best-practice
Must follow when 在 React 组件中进行数据获取,确保通过 Refine hooks(useList/useOne 等)经由 DataProvider 访问数据,禁止直接调用 trpc 客户端。触发词:refine数据规范、禁止直接使用tRPC、DataProvider最佳实践。
remove-comments
Use when 需要批量删除代码文件中的注释,支持 Python、JS、TS、TSX、Java、C/C++、Rust、Go、HTML 等主流编程语言。触发词:删除注释、清除代码注释、移除注释行、批量去注释。
repository-best-practice
Must follow when 创建或重构 Repository 层,确保数据访问模式、方法命名、返回类型和接口定义符合项目规范。触发词:repository规范、创建repository层、数据访问层审查。
schema-best-practice
Must follow when 创建或重构数据库 Schema 定义,确保 Drizzle ORM schema 中的命名、关系和索引配置均符合规范。触发词:schema规范、创建数据库schema、schema结构审查。
service-best-practice
Must follow when 创建或重构 Service 层,基于 tRPC + Service + DAO 架构确保依赖注入、错误处理和业务逻辑分层符合规范。触发词:service规范、创建service层、服务层重构。
skill-best-practice
Must follow when 创建或修改 Skill 后执行质量验证,涵盖命名、目录结构、元数据完整性、临时文件清理和依赖格式共 16 项检查。触发词:检查skill规范、skill质量验证、技能合规性检查。
store-best-practice
Must follow when 使用 Zustand 创建或重构状态管理 Store,确保遵循 slice 模式、Provider 设置和类型安全规范。触发词:创建store、zustand规范、状态管理最佳实践、store设计审查。
storybook-best-practice
Must follow when 创建或维护 Storybook Stories,确保组件文档命名、参数定义和装饰器配置符合项目 Storybook 编写规范。触发词:创建storybook、story规范、组件故事文档审查。
svg-icon-best-practice
Must follow when 管理或新增 React TypeScript 项目中的 SVG 图标组件,确保命名、封装方式和导出规范遵循项目标准规范。触发词:svg图标规范、图标组件管理、SVG图标规范审查。
use-store-not-props-best-practice
Must follow when 设计组件数据流——优先通过 Store 访问全局状态,不得通过 Props 层层传递;适用于代码审查和新功能设计阶段。触发词:用store替代props、组件传参规范。
zod-env-integration
Must follow when 配置类型安全的环境变量管理模块,基于 .env.example 使用 Zod 生成 env schema 和标准化管理工具。触发词:zod环境变量、env类型安全配置、环境变量schema。