skills

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

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

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

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

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

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

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

Must follow when 为 Skill 或项目模块编写检查清单（checklist.md），确保每一项可判断、有示例、结构清晰、支持自动化验证。

Must follow when 设计或审查 React 组件，确保组件符合 shadcn/ui 设计哲学：单一职责、可组合、可访问、可复制粘贴。定义何时应该拆分组件、组件边界、命名规范。

Must follow when 创建或审查 React 组件文件夹单元，强制每个组件以独立文件夹形式存在，包含组件本身、单元测试（*.test.tsx）和 Storybook 故事文件（*.stories.tsx）。

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

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

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

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

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

Use when 需要实际编写检查脚本代码，基于 assess-automation-checklist 的设计方案实现自动化检查器；输出可运行的脚本文件和集成指南。触发词：编写检查脚本、实现自动检查、code checker、写检查器代码。

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

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

Use when 需要深度反思已定义的 best-practice，挖掘潜在盲区、过度设计、隐藏假设和未覆盖场景；通过自我审视挑战既有规范，发现规范本身的局限性。触发词：反思最佳实践、深挖规范盲区、自检 skill、挑战既有规范。

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

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

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

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

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

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

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

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

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

Use when 需要把已批准的实现计划拆成独立任务并分派给子代理执行，通过规格一致性审查与代码质量审查双阶段把关，确保并行实现结果与设计、计划和验收标准保持一致。触发词：子代理开发、分派任务、并行实现、subagent。

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

Use when 需要以测试先行方式实现功能、修复 bug 或重构行为，严格执行 Red-Green-Refactor 循环，先写失败测试再写最小生产代码并完成重构验证。触发词：TDD、测试先行、红绿重构、先写测试。

Must follow when 创建或审查 UI 组件代码，确保在标准场景下使用项目组件库组件（如 shadcn/ui），禁止直接使用原生 HTML 元素。

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

Use when 需要将已批准的设计规格拆解为可执行实现计划，按最小任务粒度给出文件路径、完整代码、验证命令、依赖上下文和完成标准，便于低上下文执行者稳定落地实现。触发词：写计划、实现计划、任务拆解、plan。

Must follow when 项目中存在 Zod schema 定义时，禁止另建 type.ts 文件重复声明类型；所有类型须直接用 z.infer 从 schema 派生，杜绝类型与 schema 不同步。

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

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

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

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

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