用途:审查 XcodeBuildMCP 工具契约变更,确保实现、清单与工作流暴露保持一致。默认仅审查,除非用户明确要求实现改动,否则不修改产品代码。
需检查的文件:src/mcp/tools/**、manifests/tools/.yaml、manifests/workflows/.yaml、src/core/manifest/schema.ts、src/runtime/tool-catalog.ts、src/runtime/types.ts,以及 xcodebuildmcp.com/app/docs/_content/tool-authoring.mdx 与 architecture-manifest-visibility.mdx。
审查要点:清单 id 与文件名一致;清单 module 指向无扩展名的实现路径;工具模块导出具名 schema 与 handler;names.mcp 全局唯一;names.cli 保持工作流局部并与 CLI 文档/夹具一致;工具至少出现在一个工作流中,除非因 availability 有意隐藏;设置 ctx.structuredOutput 的工具必须提供 outputSchema;nextSteps.toolId 引用已存在的清单工具 ID;避免并行遗留路径或重复实现路径。
验证命令:npm run typecheck;npm test -- src/core/manifest/tests/schema.test.ts;npm test -- src/runtime/tests/tool-invoker.test.ts;npx skill-check .agents/skills/xcodebuildmcp-tool-contract-review。
适用场景:XcodeBuildMCP 工具契约相关变更的代码审查。限制:默认只审查,不编辑产品代码;其他细节暂未提供。