| name | bootstrap-sdk-environment |
| description | 拉取并接入 SDK,安装应用层认知环境并完成双重验证。 |
| disable-model-invocation | true |
Bootstrap SDK 环境
把本 Skill 作为手动调用的脚手架入口。按顺序执行两个外部事实来源:先完成 SDK 接入,再安装应用层认知环境。只编排顺序和验收,不复制下游规则。
1. 锁定本次 Bootstrap
- 确定宿主工程绝对路径;默认使用包含当前任务
Podfile 与 Xcode 工程的工作区根目录。
- 确定用户要求的 SDK 名称、版本与可解析的交付来源。缺失值交给 SDK 接入阶段按其规则发现。
- 确认以下两个上下文指针可读:
- 记录宿主工程的
git status --short,把已有改动作为保护基线。
完成标准:宿主根、SDK 请求、两个事实来源和改动基线均已锁定;任何无法安全推断的必需输入以 needs_input 返回。
2. 接入 SDK
完整读取并执行 sdk-integration/SKILL.md,以其中的 Pod Maker、下载、Podfile、依赖安装和真实 Target 构建规则为准。把用户本次指定的 SDK 清单传入该流程。
仅当该流程返回 integrated 时进入应用层安装;返回 needs_input 时原样保留其首个根因和所需输入,并结束本次 Bootstrap。
完成标准:每个请求的 SDK 均出现在锁文件的预期本地来源中,且真实应用 Target 构建成功,SDK 接入状态为 integrated。
3. 安装应用层环境
完整读取 sdk-cognition/HOST-INSTALL.md,从该文件所属 release 根目录执行其安装命令,并将同一个宿主工程绝对路径作为参数。
接受安装器的 installed 或 existing 状态。遇到冲突时保留宿主现有内容,以安装器错误码返回 needs_input。安装后逐项验证 HOST-INSTALL.md“安装结果”列出的入口 Skill、运维 Skill、当前绑定与不可变快照均存在,并确认 current.json 指向安装器报告的 release。
完成标准:安装器返回 installed 或 existing,全部安装产物存在且当前绑定与 release 报告一致。
4. 交付
复查 git status --short,区分本次生成内容与宿主原有改动。报告宿主工程、SDK 名称与锁定版本、SDK 接入状态、应用层安装状态、release ID、入口 Skill 路径、构建结果和保留的用户改动。
仅在 SDK 接入与应用层安装的完成标准全部满足时返回 bootstrapped;其余返回 needs_input,并给出失败阶段、首个根因和继续执行所需的最小输入。