AgentSkillsCN

vkc-perf-budget

为 VKC 设计性能与包体积预算工作流(perf:collect、perf:compare、perf:gate、包体积、首次加载共享 JS)。在变更可能影响构建输出大小或性能时使用此技能。

SKILL.md
--- frontmatter
name: vkc-perf-budget
description: Performance and bundle-size budget workflow for VKC (perf:collect, perf:compare, perf:gate, bundle size, shared first load js). Use when changes may affect build output size or performance.
metadata:
  short-description: Perf budget + gate

VKC Performance Budget

When to use

  • You add a new dependency or a large UI surface.
  • You touch layout/shell components used on many routes.
  • You suspect "shared first load js" or route entry sizes may change.

Commands (this repo)

  • Collect: npm run perf:collect
    • Writes: docs/perf/latest-bundle-report.json
  • Compare: npm run perf:compare
    • Writes: docs/perf/latest-bundle-diff.json
  • Gate (collect + compare w/ fail): npm run perf:gate

Canonical references

  • Collector: scripts/perf/collect-build-metrics.mjs
  • Comparator: scripts/perf/compare-build-metrics.mjs
  • Scripts: package.json (perf:*)

References

  • Budget runbook: .codex/skills/vkc-perf-budget/references/perf-budget.md