为vercel-optimize做贡献保持改动小而聚焦、有指标依据并通过夹具测试。运行时代码位于skills/vercel-optimize测试和夹具位于packages/vercel-optimize-tests以保证已安装技能保持精简。常见改动改动编辑测试门控lib/gates/id.mjs、lib/gates/index.mjsnode --test packages/vercel-optimize-tests/test/*gate*.test.mjs扫描器lib/scanners/id.mjs、lib/scanners/index.mjspackages/vercel-optimize-tests/test/中的扫描器特定测试引用references/docs-library.jsonnode skills/vercel-optimize/scripts/check-citations.mjs支持主题references/support-topics/id.mdnode --test packages/vercel-optimize-tests/test/support-topics.test.mjs行动手册references/playbooks/profile.md及references/scoring.md中的选择矩阵node --test packages/vercel-optimize-tests/test/support-topics.test.mjs packages/vercel-optimize-tests/test/investigation-brief.test.mjs渲染器或验证器lib/render-report.mjs、lib/verify-claim.mjs或相关模块针对性测试加完整测试套件生成的文档nodeskills/vercel-optimize/scripts/build-docs.mjsnodeskills/vercel-optimize/scripts/check-docs-fresh.mjs完整测试循环node--testpackages/vercel-optimize-tests/test/*.test.mjsnodeskills/vercel-optimize/scripts/check-docs-fresh.mjsnodeskills/vercel-optimize/scripts/check-citations.mjs规则无运行时依赖。脚本仅使用 Node.js 20 内置功能与 Vercel CLI。没有 Vercel 指标信号、代码变更时的代码证据以及白名单内的引用就不给出任何建议。不编造 URL、确切的节省金额预测或版本不匹配的框架 API。夹具中不包含内部仓库路径、服务名称、客户名称或捕获的私有输出。保持生成的报告文案面向客户。将调试详情放在--debug-out后面。输出契约每个输出 JSON 的脚本必须是确定性的稳定的键顺序、稳定的排序顺序、2 空格缩进、末尾换行。如果被消费的模式发生变化请在同一个 PR 中更新模式版本和夹具测试。