メニュー
使用本仓库开发的最佳实践汇总，前后端都包含，在开发任何任务（代码开发）之前都需要参考该文档，做产品设计不需要参考该文档。
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/blesstosam/trpc-fastify-starter --skill best-practicesコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
Master end-to-end testing with Playwright and Cypress to build reliable test suites that catch bugs, improve confidence, and enable fast deployment. Use when implementing E2E tests, debugging flaky tests, or establishing testing standards.
Anthony Fu's opinionated tooling and conventions for JavaScript/TypeScript projects. Use when setting up new projects, configuring ESLint/Prettier alternatives, monorepos, library publishing, or when the user mentions Anthony Fu's preferences.
Systematic workflow for verifying bug fixes to ensure quality and prevent regres...
SKILL.md を表示中
SOC 職業分類に基づく
| name | best-practices |
| description | 使用本仓库开发的最佳实践汇总，前后端都包含，在开发任何任务（代码开发）之前都需要参考该文档，做产品设计不需要参考该文档。 |
| metadata | {"author":"blesstosam","version":"2026.04.06"} |
dayjs@sapphire/snowflakenanoidarchiverdocxexceljscsv-parseant-design-vuemotion-v，文档地址在https://motion.dev/docs/vue<style scoped>（详见 references/tailwind-first.md）ant-design-vue里的组件，需要显示的引入，如import { Avatar } from 'ant-design-vue'critique skill 对刚实现的页面进行一次评估，如果有优化的地方根据优化点修复一版（只做一轮修复）YYYY-MM-DD HH:mm:ss格式，禁止直接渲染toISOString()这类包含T/Z的UTC原始串fastify-best-practices skillreferences/backend-schema-dto.mdreferences/backend-service-data-shape.mdcreated_time，映射到orm的字段要使用驼峰法，如createdTimeschema.prisma 里已定义的枚举，TypeScript 代码必须直接复用 Prisma 生成导出的 const/type（如 server/src/generated/prisma/client 或 enums），禁止在 TS 里重复定义同值常量或类型status、type、scene、mode、algorithmKey），若当前 Prisma schema 还没有对应 enum，必须先收回到所属模块内的共享常量、共享类型和共享 schema helper，禁止在 router、service、DTO、SQL 片段里散落重复字面量shared/constants、dto helper 或同目录共享文件中；禁止建立跨模块、无业务语义的大杂烩枚举文件，也不要因为字符串值偶然相同就复用不属于该字段的 Prisma enummeta/openapi、input/output schemaupdateMany / deleteMany 的 WHERE 条件已经内聚了所有业务约束（状态、类型、权限范围等）时，不要再额外执行 findMany + JS 侧逐条校验来”预先筛出不合规记录”。数据库 WHERE 本身就是最准确的过滤器，重复校验徒增查询次数、拉低批量操作吞吐，且无法消除并发竞争（WHERE 才是原子保证）。仅在需要向调用方逐条报告差异化失败原因时才考虑查询校验，否则直接用 updateMany 的 count 作为成功数即可toString() + BigInt() 往返转换来给 Set 去重。Set<bigint> 原生支持 bigint 相等性比较（1n === 1n 为 true），Array.from(new Set(ids)) 即可去重，无需 Array.from(new Set(ids.map(id => id.toString()))).map(id => BigInt(id))| Topic | Description | Reference |
|---|---|---|
| 安装依赖 | 安装依赖遵循的规范 | install-dep |
| 图标选择 | 当前端仓库需要使用图标，包含图标库的选择、图标的选择、搜索 | icon-suggest |
| ant-design-vue 组件库使用 | ant-design-vue 组件库使用规范与决策指引 | ant-design-vue |
| 使用 Tailwind-first 原则 | 前端页面样式 Tailwind-first 约束与例外边界 | tailwind-first |
| 前端组件和逻辑拆分原则 | Vue3 SFC(Single File Component)拆分最佳实践 | vue-sfc-split |
| 后端事务与批量写入、性能优化 | 事务内避免耗时操作、批处理导入与连接池保护规范 | backend-transaction-batch-write |
| 后端 Schema / DTO 约定 | 业务模块间 schema 复用、list schema、create schema、update schema 约定 | backend-schema-dto |
| 后端 service Prisma 数据形状 | 用 Prisma args/GetPayload 推导 serializer 类型、rest spread 写 create/update data、消除字段清单重复 | backend-service-data-shape |