AgentSkillsCN

profile-validation

为更改运行正确的测试，并保持覆盖率预期。当修改代码或测试，或调试失败时使用。

SKILL.md
--- frontmatter
name: profile-validation
description: Validate profile files against the schema and OpenAPI operations. Use when creating or changing profiles or when validation errors appear.

Profile validation

When to use

  • •Creating or updating profile JSON files
  • •Investigating validation errors
  • •Ensuring OpenAPI operations exist for tools

Steps

  1. •Validate structure only:
    • •npm run validate -- profiles/my-profile.json
  2. •Validate structure plus OpenAPI operations:
    • •npm run validate -- profiles/my-profile.json openapi.yaml
  3. •Ensure parameter aliases are defined for generic path params.
  4. •Ensure metadata parameters are marked and not sent to the API.

Checks and tests

  • •Run npm run typecheck before finishing.
  • •Run npm test after fixing validation errors.

Notes

  • •Operation lookup is strict. If an operation is missing, update the spec or profile.