适用用途 omp-setup 用于把 Oh-My-Pi（omp）配置成适合多智能体工作的状态。当用户要求为多智能体编排、嵌套子智能体、智能体团队或递归深度做准备或调整 omp 时，可使用本技能，即使用户没有明确点名该技能。
主要能力 本技能会读取已有的命名配置文件，并在这些配置文件中配置 task.maxRecursionDepth。它不会写入无关设置，不修改项目文件或凭据文件，也不依赖 PI_CODING_AGENT_DIR 发现配置文件。递归深度只接受非负整数（0、1、2……），负数与无限制值会被拒绝。
使用方式 工作流分为以下步骤：
- 预检：要求 PATH 中存在 omp 可执行文件，并运行 omp --profile default config get task.maxRecursionDepth --json。OMP_PROFILE 与 PI_PROFILE 视为 shell 选择的默认配置，显式 --profile <name> 会覆盖二者；每次读写都保留显式参数，不编辑 .envrc，也不修改这些变量。若 omp 或该键不可用，报告前置条件失败并停止。
- 枚举已有命名配置：根据 HOME、PI_CONFIG_DIR（默认 .omp）解析配置根，读取 profiles 目录下的直接子目录作为命名配置；目录不存在表示没有命名配置，不创建缺失的配置。
- 收集配置选择：默认配置为必选项；询问要加入的命名配置，默认不预选，空选择表示仅默认配置。仅一个已发现配置时使用包含/跳过二选一，两个及以上时使用多选，每题最多五个选项。若调用时已给出有效选择则直接采用；未知名称会被拒绝而非创建。
- 收集并校验深度：询问 task.maxRecursionDepth，推荐默认 4，另提供 2 和 6 作为选项，也允许自定义。只接受十进制非负整数；该值限制任务子智能体的嵌套层数，0 表示主智能体不能生成任务子智能体。
- 预览与确认：对每个选中配置读取当前值，展示配置、当前值、请求值的表格，适用时给出 0 深度警告，并在首次写入前询问应用或取消；若所有选中配置已是目标值，则报告无需写入并跳过确认。
- 只写目标键：按确定顺序应用，先默认配置，再按名称排序的命名配置；对当前值不同的配置运行 omp --profile <name> config set task.maxRecursionDepth <depth> --json。每个配置名作为单个字面 CLI 参数传递，不当作 shell 语法求值；使用 CLI 而非编辑 YAML 或会话级设置写入，以保留既有配置文件的持久化语义。
- 立即校验：每次写入后运行对应的 config get ... --json，要求返回值等于请求的整数；保存成功但有效值仍不同不算成功，此时报告 CLI 指出的覆盖来源，不通过修改项目文件、覆盖层、环境变量或运行时状态来强制生效。写入或校验失败时，在未处理配置之前停止，并分别报告成功、失败与未处理的配置。
- 报告结果：返回按配置列出的表格，含先前值、请求值、校验后的有效值及状态（未变、已更新、已配置或失败）；说明持久化值作用于后续子智能体启动，不会重启正在运行的子智能体；不打印凭据或完整配置。每个报告的配置附上手动检查命令 omp --profile <name> config get task.maxRecursionDepth --json。
适用场景 适合为多智能体编排、嵌套子智能体、智能体团队等场景统一设置递归深度，并在多个已有命名配置之间保持一致的 task.maxRecursionDepth。
限制 只处理 task.maxRecursionDepth 一个键，不读取或修改项目设置、凭据、模型设置、智能体定义或无关键；不创建不存在的配置；不接受负数或无限制深度；不回滚未请求的更改。该技能描述的 omp 具体可用性、安装方式与平台支持，资料暂未提供。