AgentSkillsCN

profile-schema-sync

遵循仓库工作流程规则，避免重复逻辑。当开始任何更改时使用，以确保流程和文档的一致性。

SKILL.md
--- frontmatter
name: profile-schema-sync
description: Update profile structure and keep TypeScript types, generated Zod schemas, and JSON Schema in sync. Use when adding or changing profile fields or validation rules.

Profile schema sync

When to use

  • •Adding or changing any profile field
  • •Adjusting validation rules for profiles
  • •Updating profile-related documentation or tests

Steps

  1. •Update the profile types in src/types/profile.ts.
  2. •Run npm run generate-schemas to refresh src/generated-schemas.ts.
  3. •Manually update profile-schema.json to match the TypeScript types.
  4. •Update profile validation tests in src/profile-loader.test.ts.
  5. •Update docs/PROFILE-GUIDE.md if the change is user-facing.
  6. •Remove any completed item from TODO.md.

Checks and tests

  • •Run npm run typecheck before finishing.
  • •Run npm test.
  • •Run npm run validate for any changed profile.

Notes

  • •Missing fields in generated schemas break runtime validation.
  • •Do not duplicate validation rules that already exist in canonical docs.