菜单
Keeps tools/generate-data seeders and docs in sync when main or management DB schema or ORM entities change. Use when adding or changing tables/entities in packages/orm, packages/management-orm, or infra database migrations.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
When changing API routes, auth, or env-dependent behavior, add or update the corresponding integration tests and keep the test file layout consistent.
When adding or changing files under infra/k8s/ or sync targets for k8s, know what Argo CD syncs and remind the user to push to Git so the cluster can sync.
When changing DB schema or permission dimensions, consider predefined roles and bucket_role / role-related code.
Use when adding or changing environment variables, infra/env/classification YAML, scripts/env-classification, K8s env render, or local env generation.
Common patterns for the Boilerplate HTTP API (Express)
When adding or changing preconditions, cleanup steps, or env usage for local Docker Compose or local k3d, keep both in sync where they share resources (e.g. infra/config/local/*.env).
| name | generate-data-sync |
| description | Keeps tools/generate-data seeders and docs in sync when main or management DB schema or ORM entities change. Use when adding or changing tables/entities in packages/orm, packages/management-orm, or infra database migrations. |
When the main or management database schema or ORM entities change, update the generate-data tool so seeded test data stays aligned.
infra/database/ or infra/management-database/ (migrations, combined init).packages/orm or packages/management-orm.Decide what to seed
New or changed core domain tables (e.g. user-related, admin-related) should usually get seed
logic. Skip internal/auth-only tables (e.g. refresh_token, verification_token) unless tests need
them.
Update seeders
tools/generate-data/src/main/seed.ts – add or update entities in dependency order;
respect FKs; use @faker-js/faker for appropriate fields; use bcrypt for password hashes where
applicable.tools/generate-data/src/management/seed.ts – same; never set is_super_admin: true for seeded rows.Update docs
Edit tools/generate-data/TOOLS-GENERATE-DATA.md so the “What gets seeded” section lists the
new or changed tables/entities.
Schema naming
Follow database-schema-naming: snake_case columns, singular table names; entity name
mapping where property is camelCase.
infra/k8s/base/stack/postgres-init/0003_app_schema.sqlinfra/k8s/base/stack/postgres-init/0005_management_schema.sql.fragtools/generate-data/src/main/seed.ts, tools/generate-data/src/management/seed.ts