用途：编排 Stitch SDK 的完整生成流水线，从捕获 MCP 工具 schema 到发布经过测试与验证的包。适用于 Stitch MCP 服务器新增或变更工具、需要从零重新生成 SDK、或想验证流水线是否健康。
前置条件：设置 STITCH_API_KEY 环境变量；安装 bun；工作目录为项目根目录（stitch-sdk/）。
流水线阶段：Stage 1 捕获工具 schema（npm run capture），连接 MCP 服务器调用 tools/list，写出 packages/sdk/generated/tools-manifest.json 并更新 stitch-sdk.lock；若清单已最新可跳过。Stage 2 领域设计（唯需智能体的阶段，使用 stitch-sdk-domain-design 技能）编辑 domain-map.json，决定类别归属、参数路由、响应投影与缓存；若绑定正确且只改 ir-schema.ts 或 generate-sdk.ts 可跳过。Stage 3 生成 TypeScript（npm run generate），校验 IR 与投影并输出到 packages/sdk/generated/src/；出现投影错误需回退 Stage 2。Stage 4 构建（npm run build）；Stage 5 单元测试（npm run test）；Stage 6 脚本测试（npm run test:scripts）；Stage 7 端到端测试（npm run test:e2e），需 STITCH_API_KEY，AI SDK 测试另需 GEMINI_API_KEY，包含 live.test.ts 与 ai-sdk-e2e.test.ts；Stage 8 锁校验（npm run validate:generated），务必在 Stage 3 后运行，否则哈希会不匹配。Stage 9 技能审计（智能体），依据公共接口、生成类、错误码与配置 schema，按优先级检查 stitch-sdk-usage、readme、development、domain-design 中的方法名、导入、构造签名、配置字段与错误码。
快捷方式：npm run pipeline 依次运行 Stage 1→3→4→5，不含 Stage 2、7、9。可根据改动类型从特定阶段开始。
限制：Stage 2 与 Stage 9 需要智能体；端到端测试需真实 API 密钥并调用线上服务；其他阶段为确定性脚本。