# Bootstrap Sdk Environment

> 拉取并接入 SDK，安装应用层认知环境并完成双重验证。

- Skill: `didi/bootstrap-sdk-environment` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add didi/bootstrap-sdk-environment`
- Raw SKILL.md: https://api.skillmd.com/api/skills/didi/bootstrap-sdk-environment/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: didi (https://skillmd.com/u/didi)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/didi/bootstrap-sdk-environment

---


# Bootstrap SDK 环境

把本 Skill 作为手动调用的脚手架入口。按顺序执行两个外部事实来源：先完成 SDK 接入，再安装应用层认知环境。只编排顺序和验收，不复制下游规则。

## 1. 锁定本次 Bootstrap

1. 确定宿主工程绝对路径；默认使用包含当前任务 `Podfile` 与 Xcode 工程的工作区根目录。
2. 确定用户要求的 SDK 名称、版本与可解析的交付来源。缺失值交给 SDK 接入阶段按其规则发现。
3. 确认以下两个上下文指针可读：
   - SDK 接入：[sdk-integration/SKILL.md](../sdk-integration/SKILL.md)
   - 应用层安装：[sdk-cognition/HOST-INSTALL.md](../sdk-cognition/HOST-INSTALL.md)
4. 记录宿主工程的 `git status --short`，把已有改动作为保护基线。

完成标准：宿主根、SDK 请求、两个事实来源和改动基线均已锁定；任何无法安全推断的必需输入以 `needs_input` 返回。

## 2. 接入 SDK

完整读取并执行 [sdk-integration/SKILL.md](../sdk-integration/SKILL.md)，以其中的 Pod Maker、下载、Podfile、依赖安装和真实 Target 构建规则为准。把用户本次指定的 SDK 清单传入该流程。

仅当该流程返回 `integrated` 时进入应用层安装；返回 `needs_input` 时原样保留其首个根因和所需输入，并结束本次 Bootstrap。

完成标准：每个请求的 SDK 均出现在锁文件的预期本地来源中，且真实应用 Target 构建成功，SDK 接入状态为 `integrated`。

## 3. 安装应用层环境

完整读取 [sdk-cognition/HOST-INSTALL.md](../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`，并给出失败阶段、首个根因和继续执行所需的最小输入。