mobilebuildmcp-structured-output-review

用途

MobileBuildMCP Structured Output Review 是一个面向 MobileBuildMCP 项目的审查型技能，用于评审结构化输出（structured output）相关的 schema 变更，保障 schema 的正确性与向后兼容性。

其关注的审查领域包括：结构化输出 schema 变更、schema 版本管理、manifest 中的 outputSchema 元数据，以及 JSON 测试夹具（fixture）的兼容性。

主要能力与审查范围

该技能默认仅执行审查（Review-only by default）。除非用户明确要求实现层面的改动，否则不修改产品代码。

需要检查的文件包括：

• schemas/structured-output/**
• src/core/structured-output-schema.ts
• src/core/__tests__/structured-output-schema.test.ts
• src/snapshot-tests/__fixtures__/json/**
• src/snapshot-tests/__tests__/json-fixture-schema.test.ts
• xcodebuildmcp.com/app/docs/_content/schema-versioning.mdx
• xcodebuildmcp.com/app/docs/_content/output-formats.mdx

审查准则（Guardrails）

• schema 使用 mobilebuildmcp.output.<name> 格式。
• schemaVersion 仅使用整数字符串。
• 破坏性（breaking）schema 变更需新建带版本号的 schema 文件。
• 已发布的 schema 版本不得被移除，也不得做不兼容的改动。
• manifest 中的 outputSchema 需与代码发出的 ctx.structuredOutput payload 一致。
• JSON 夹具需通过当前 schema 契约的校验。
• $ref 的使用需与 structured-output-schema.ts 中的打包方式保持兼容。

使用方式

该技能通过检查上述文件并依据上述准则进行审查。提供以下验证命令：

• npm run test:schema-fixtures
• npm test -- src/core/__tests__/structured-output-schema.test.ts
• npm run typecheck
• npx skill-check .agents/skills/mobilebuildmcp-structured-output-review

适用场景

适用于 MobileBuildMCP 项目中结构化输出 schema 的变更评审、schema 版本管理核查、manifest outputSchema 与输出 payload 的一致性检查，以及 JSON 测试夹具的兼容性验证。

限制

• 默认仅审查，不修改产品代码，除非用户明确要求实现变更。
• 资料未提供收费、价格、平台支持范围等信息。
• 资料未提供具体的使用步骤细节与依赖环境信息。