SuperAPI AI 工具集

xcodebuildmcp-snapshot-fixture-review

测试与质量

查看项目

更新于 10-15 21:51

技能介绍

用途:在审查 XcodeBuildMCP 快照夹具(snapshot fixture)变更时,检查 MCP、CLI 与 JSON 输出契约是否保持一致与完整。默认仅做审查,除非用户明确要求实现改动,否则不要编辑产品代码。

需检查的文件:src/snapshot-tests/fixtures/**、src/snapshot-tests/contracts.ts、src/snapshot-tests/fixture-io.ts、src/snapshot-tests/tests/fixture-io.test.ts、src/snapshot-tests/tests/json-normalize.test.ts、src/snapshot-tests/tests/json-fixture-schema.test.ts、xcodebuildmcp.com/app/docs/_content/testing.mdx。

主要规则:夹具更新应对应有意为之的行为变更,不得仅为让测试通过而更新夹具;MCP、CLI 与 JSON 夹具更新需保持对齐;JSON 夹具应保留稳定的结构化输出信封;易变值应在代码中归一化,而非在夹具中临时修补;缺失夹具应通过快照更新流程生成。报告前需在归一化代码与测试中核实项目定义的归一化哨兵值,例如 99999 是易变 UI 捕获计数的有意哨兵值。同一根因的每次出现应合并为一条发现并列出受影响的夹具,不要为等价的 CLI、MCP、文本或 JSON 漂移分别输出发现;已被当前 diff 解决的发现不要重复报告。

审查限制:只审查变更的夹具及直接相关的归一化或契约代码;不要在自动化 PR 审查中运行快照或冒烟测试套件;优先给出一条高置信度的跨夹具发现,而非多条推测性差异。