forge-town/skills

1

svg-icon-best-practice Must follow when 管理或新增 React TypeScript 项目中的 SVG 图标组件，确保命名、封装方式和导出规范遵循项目标准规范。

forge-town/skills

68

2

page-best-practice Must follow when 创建或审查前端页面结构，确保遵循 Anatomy 规范，正确分离 Wrapper、Content 和 Optional Store 模块。

forge-town/skills

43

3

create-skills Use when 需要创建新技能或更新现有技能，将领域知识、工作流程、脚本和工具集成打包为可复用 Skill；生成的新技能须使用中文编写。触发词：创建新技能、更新skill、新建技能包、扩展AI能力。

forge-town/skills

42

4

store-best-practice Must follow when 使用 Zustand 创建或重构状态管理 Store，确保遵循 slice 模式、Provider 设置和类型安全规范。

forge-town/skills

40

5

service-best-practice Must follow when 创建或重构 Service 层，基于 tRPC + Service + DAO 架构确保依赖注入、错误处理和业务逻辑分层符合规范。

forge-town/skills

39

6

zod-env-integration Must follow when 配置类型安全的环境变量管理模块，基于 .env.example 使用 Zod 生成 env schema 和标准化管理工具。触发词：zod环境变量、env类型安全配置、环境变量schema。

forge-town/skills

39

7

check-all-skills Use when 需要批量验证 Skill 是否符合最佳实践规范，自动检查命名、前言区、结构与依赖等维度，生成详细报告并输出修复建议；支持单个或批量检查。触发词：检查skill规范、批量验证技能质量、扫描全部技能、全量skill质量校…

forge-town/skills

38

8

skill-best-practice Must follow when 创建或修改 Skill 后执行质量验证，涵盖命名、目录结构、元数据完整性、临时文件清理和依赖格式共 16 项检查。

forge-town/skills

38

9

dao-best-practice Must follow when 创建或重构 DAO 文件，确保遵循 Drizzle ORM 最佳实践（文件结构、方法命名、类型安全、性能优化）。

forge-town/skills

37

10

db-table-best-practice Must follow when 创建或审查 Drizzle ORM 数据库表定义，确保表名、列名、索引和关系配置均遵循项目命名规范与表结构规范。

forge-town/skills

36

11

remove-comments Use when 需要批量删除代码文件中的注释，支持 Python、JS、TS、TSX、Java、C/C++、Rust、Go、HTML 等主流编程语言。触发词：删除注释、清除代码注释、移除注释行、批量去注释。

forge-town/skills

33

12

generate-preview Use when 需要对 React 组件文件生成结构化 .json 描述和可视化 .md 目录树预览，用于组件拆分前的详细结构分析、复杂度评估与规划。触发词：生成组件预览文档、拆分前分析、组件结构可视化。

forge-town/skills

28

13

implement-split Use when 需要将大型组件或模块按最佳实践拆分为多个独立文件，系统性地执行代码拆分与重构，确保拆分后各模块结构符合规范。触发词：拆分组件、实现文件拆分、代码模块拆分重构、component-split。

forge-town/skills

27

14

use-store-not-props-best-practice Must follow when 设计组件数据流——优先通过 Store 访问全局状态，不得通过 Props 层层传递；适用于代码审查和新功能设计阶段。

forge-town/skills

27

15

check-svg Use when 需要扫描或检查项目中 SVG 图标的使用情况，发现并报告不符合规范的写法，包括命名、路径和组件化问题；适用于代码审查阶段。触发词：检查svg规范、图标规范检查、SVG使用审查、SVG图标优化。

forge-town/skills

25

16

check-refine-trpc Use when 需要审查或重构 tRPC 路由代码，确保路由结构、类型定义、输入验证和错误处理均符合项目最佳实践；适用于代码审查和路由重构阶段。触发词：检查trpc代码、重构路由写法、优化tRPC格式。

forge-town/skills

24

17

storybook-best-practice Must follow when 创建或维护 Storybook Stories，确保组件文档命名、参数定义和装饰器配置符合项目 Storybook 编写规范。

forge-town/skills

24

18

barrel-export 自动生成、优化、修复与检查 index 文件，确保所有 index.ts / index.js 遵循桶导出规范。适用于"生成 barrel export"、"修复 index"、"检查桶导出"、"优化导出结构"等场景。

forge-town/skills

23

19

check-all-items 自动扫描并执行所有以best-practice结尾的技能，检查项目是否符合最佳实践。通过自动发现机制确保所有相关最佳实践都被检查，并强制执行标准化验证指令提升输出稳定性。

forge-town/skills

23

20

classname-refactor 自动检查并转换 React/Vue 文件中 className 的模板字符串为 cn 函数调用；支持递归扫描文件夹、详细报告所有 className 位置

forge-town/skills

23

21

skill-creator 创建有效技能的中文指南。当用户想要创建一个新技能（或更新现有技能）来扩展 AI 的能力时，应使用此技能，包括专门知识、工作流程或工具集成。生成的新技能应使用中文描述。

forge-town/skills

22

22

create-skill Use when 需要创建一个新 Skill 或更新现有 Skill，将领域知识、工作流程或工具集成打包为可复用技能包，须中文编写。触发词：创建新技能、新建技能、修改skill、更新技能。

forge-town/skills

21

23

schema-best-practice Must follow when 创建或重构数据库 Schema 定义，确保 Drizzle ORM schema 中的命名、关系和索引配置均符合规范。

forge-town/skills

19

24

form-best-practice Must follow when 创建或重构前端表单组件，确保表单结构、字段验证逻辑和状态管理遵循项目表单设计规范与组件化标准。

forge-town/skills

18

25

repository-best-practice Must follow when 创建或重构 Repository 层，确保数据访问模式、方法命名、返回类型和接口定义符合项目规范。

forge-town/skills

18

26

error-handling-best-practice Must follow when 编写错误处理代码，必须使用 neverthrow 库进行函数式错误处理，禁止使用原生 try-catch。确保错误显式传递、类型安全、调用方强制处理错误。

forge-town/skills

15

27

barrel-export-best-practice Must follow when 编写或审查 index.ts/index.js 桶导出文件，确保所有导出遵循只做 re-export、无业务逻辑、命名导出等规范。

forge-town/skills

14

28

check-all-best-practices Use when 需要对项目进行全量最佳实践检查——自动发现并依次执行所有以 best-practice 结尾的技能，输出汇总报告并强制执行标准化验证指令。触发词：检查所有技能、全量规范验证、批量最佳实践检查。

forge-town/skills

14

29

check-barrel-export Use when 需要生成、优化、修复或检查项目中所有 index 文件（桶导出），确保 index.ts/index.js 均遵循标准桶导出规范。触发词：生成barrel导出、优化index文件、检查桶导出规范。

forge-town/skills

14

30

fix-all-best-practices Use when 需要一键扫描并自动修复项目中所有最佳实践违规问题，自动发现并依次执行所有 best-practice 技能的检查与修复操作。触发词：修复所有违规、自动修复最佳实践、一键规范化项目代码。

forge-town/skills

14

31

implement-trpc-query Use when 需要实现 tRPC 按需查询（on-demand query）模式，确保查询逻辑和数据获取方式符合项目 tRPC 规范和最佳实践。触发词：tRPC按需查询、实现tRPC查询、on-demand查询模式。

forge-town/skills

14

32

one-component-per-file-best-practice Must follow when 检查或重构 React/Vue 组件文件，强制每个文件只包含一个组件，不允许多组件共存于同一文件；支持 TSX/JSX/Vue。

forge-town/skills

14

33

refactor-classname Use when 需要检查或转换 React/Vue 文件中的 className 模板字符串为 cn 函数调用，支持递归扫描文件夹、详细报告所有位置。触发词：优化className写法、重构模板字符串、检查className规范。

forge-town/skills

14

34

refine-trpc-best-practice Must follow when 在 React 组件中进行数据获取，确保通过 Refine hooks（useList/useOne 等）经由 DataProvider 访问数据，禁止直接调用 trpc 客户端。

forge-town/skills

14

35

better-auth-integration Must follow when 需要将 Better Auth 认证系统集成到项目，涵盖安装配置、数据库集成、Provider 设置和认证流程验证等完整步骤。触发词：集成better-auth、配置认证系统、接入鉴权。

forge-town/skills

11

36

check-try-catch Use when 需要扫描代码中 try-catch 的使用情况，识别不规范的错误处理模式，确保异常处理符合项目规范；适用于代码审查阶段。触发词：检查try-catch写法、错误处理规范检查、异常捕获审查。

forge-town/skills

11

37

clean-hardcode Use when 需要清理代码库中的垃圾代码，包括未使用导入、注释代码段、console.log、死代码、空函数、重复代码等。触发词：清理代码、clean code、删除dead code、清除垃圾。

forge-town/skills

10

38

i18n-best-practice Must follow when 创建或重构 i18n 国际化代码，确保遵循 react-i18next 最佳实践（初始化配置、翻译文件结构、组件用法、SSR 同步、语言切换与测试 Mock）。

forge-town/skills

10

39

no-re-export-best-practice Must follow when 审查或编写非 index 文件中的 import/export，禁止在非桶导出文件中对外部模块做 re-export（间接转发），每个消费文件应直接从来源 import。

forge-town/skills

10

40

assess-automation-checklist Use when 需要评估现有 checklist 的脚本化可能性，分析哪些检查项可通过代码自动化，哪些必须依赖 LLM 判断，输出明确的脚本化设计方案和实现指南。触发词：规划检查脚本、评估脚本化、设计自动化检查、checklist转…

forge-town/skills

9

41

brainstorming Use when 在任何创造性工作之前先精炼需求与方案，包括创建功能、构建组件、添加新功能或修改行为；通过自然对话探索用户意图、约束与成功标准，并产出可审阅设计文档。触发词：brainstorm、头脑风暴、脑暴。

forge-town/skills

9

42

check-all-components-design Use when 需要全面检查项目中所有 React 组件的设计质量，扫描并报告 God Component、配置驱动、业务耦合等反模式，确保符合设计规范。触发词：检查组件设计、扫描组件质量、组件设计审查。

forge-town/skills

9

43

check-checklist Use when 需要验证 checklist.md 文件是否符合 checklist-best-practice 规范，包括可判定性、示例完整性、分类结构和 Bad Case 节审查。触发词：检查checklist规范、checkl…

forge-town/skills

9

44

check-component-consistency Use when 需要检测多个同类型组件（如 Button、Page）的代码实现一致性，交叉对比 Props、事件、样式、hooks 等实现层面差异，确保代码模式统一。触发词：检查组件一致性、对比组件实现、组件模式审计。

forge-town/skills

9

45

check-components Use when 需要扫描并验证 React 组件文件夹是否符合 component-unit-best-practice 规范，包括文件夹结构、单元测试和 Storybook 故事文件的完整性检查。触发词：检查组件规范、组件文件夹审…

forge-town/skills

9

46

check-error-handling Use when 需要检查代码中是否违规使用原生 try-catch，确保项目使用 neverthrow 进行函数式错误处理；扫描并报告所有原生异常处理代码。触发词：检查错误处理、neverthrow检查、错误处理规范检查、Resul…

forge-town/skills

9

47

check-hardcode Use when 需要检查代码中是否存在硬编码内容，包括魔法数字、路径、URL、密钥、环境变量、响应消息等；确保所有可配置值都使用常量或配置文件管理。触发词：硬编码、hard code、magic number。

forge-town/skills

9

48

check-props-drilling Use when 需要检查代码中是否存在 Props Drilling（透传 Props）问题，识别那些本应从 Zustand Store 直接获取却通过多层组件传递的数据。触发词：检查 props 透传、props drilling…

forge-town/skills

9

49

check-ui-components Use when 需要检查代码中是否违规使用原生 HTML 元素（如 button、input、select 等），确保符合组件库规范，优先使用组件库组件而非原生元素。触发词：检查 UI 组件、检查原生元素、ui 组件规范检查。

forge-town/skills

9

50

check-zod-infer-type Use when 需要检查项目中是否存在违规的 types.ts/type.ts 文件，或检查是否有手写类型与 Zod schema 重复定义，确保所有类型都从 Zod schema 派生。触发词：检查类型文件、检查types目录、z…

forge-town/skills

9