---
name: yida-solution-template
description: 查询和启用宜搭方案中心模板，提供 AI 搭建入口、启用摘要和状态恢复。适用于明确的方案中心、方案模板、模板启用、模板 AI 搭请求，以及已有模板任务。
---

# 宜搭方案模板

## 选择技能

| 用户需求 | 使用技能 |
| --- | --- |
| 查询、AI 定制或启用宜搭方案中心模板，或继续已有模板任务 | 本技能 |
| 未指定方案中心或模板的完整应用搭建 | `yida-app` |

## 查询并选择模板

先检查登录环境，再搜索模板、读取详情。将 `TPL_XXX` 替换为查询得到的模板 ID：

```bash
openyida login --check-only --json
openyida solution-template search --query '合同' --json
openyida solution-template detail TPL_XXX --json
```

根据用户需求选择一种方式：

| 使用方式 | 下一步 |
| --- | --- |
| 调整业务范围、字段、页面或流程 | 执行 `ai-build`，交付原生搭建链接，引导用户在该页补充定制需求并提交 |
| 原样使用模板 | 按下节展示摘要并直接启用 |

```bash
openyida solution-template ai-build TPL_XXX --json
```

`ai-build` 返回 `submissionAccepted=false`、`applicationVerified=false`，交付时说明“模板 AI 搭建入口已准备好”。

## 展示摘要并启用

用户允许创建应用且名称已明确时，先用 `prepare` 读取摘要，说明目标组织/环境、模板版本、名称、数据选择、当前账号创建的同名应用和已有请求。授权和参数齐全时直接继续执行。

```bash
openyida solution-template prepare TPL_XXX --name '合同管理' --with-data n --json
openyida solution-template enable TPL_XXX --name '合同管理' --with-data n --json
```

`--with-data n` 跳过示例数据，`y` 保留示例数据；按用户需求选择，同一次操作保持名称和数据选择一致。`prepare` 只读信息；`enable` 先保存本地请求记录，再提交一次复制请求。

摘要中的 `directEnableSupported` 表示模板有复制源；`enableEligibility=platform-decides-on-submit` 表示启用资格由平台在提交时判断。

`enable` 默认等待 10 秒，`status` 默认查询一次。用 `--wait 0-60` 设置只读等待预算，`--wait 0` 查询一次；等待期间按递增间隔查应用列表，超时或响应不完整也先尝试查询恢复。进度只描述已受理、待确认和已查到应用等事实；命令结束后停止查询。

## 根据结果继续操作

`submissionAccepted` 表示平台已受理；`applicationVerified` 表示本次查询已确认应用存在。`previouslyVerified` 和 `lastVerifiedAt` 保存历史创建证据。

| 返回结果 | 下一步 |
| --- | --- |
| `applicationVerified=true` | 返回原应用入口，按用户要求打开并验收 |
| `accepted`，应用尚未出现 | 保留已受理状态，使用原请求号继续查询 |
| `uncertain`，提交结果未知 | 保留原请求，使用 `status` 查询；`--retry` 对此状态也只查询 |
| `ambiguous`，出现多个候选应用 | 保留原请求，列出候选并核对应用身份 |
| `failed-before-submit`，平台明确拒绝 | 展示平台原因并结束本次尝试；`status` 和普通重复 `enable` 仅返回原拒绝原因，不认领后来出现的同名应用 |
| 应用查询失败 | 保留已受理状态与平台原因，按 `nextAction` 继续查询 |
| 历史 `completed`，本次 `applicationVerified=false` | 说明曾确认创建、本次可见性待确认，保留历史证据并继续查询 |

将以下命令的 `st-xxxxxxxx` 替换为启用结果中的 `requestId`：

```bash
openyida solution-template status st-xxxxxxxx --wait 10 --json
```

平台明确拒绝后，用户再次明确要求提交时，使用原模板、名称、数据选择和请求号，加 `--retry` 发起一次新尝试：

```bash
openyida solution-template enable TPL_XXX --name '合同管理' --with-data n --request-id st-xxxxxxxx --retry --json
```

已完成请求重复执行会返回原应用。用户明确要求另建一份时，使用新的 `--request-id`。

## 执行边界与完成标准

- 使用当前登录组织提交。登录、组织权限、版本权益、AI 额度和模板可用性由平台判断；本技能展示平台结果，保持当前组织及权限、权益设置。
- 未知或歧义结果仅通过原请求继续查询或核对应用身份，保留该次请求号。
- 应用列表确认资源身份；页面效果、业务数据和运行时权限通过实际打开应用验收。只有本次 `applicationVerified=true` 才报告“已查到应用”；AI 入口或历史记录分别按其实际状态交付。

## 相关技能

- `yida-app`：完整应用的需求分析与搭建，通过 `use_skill` 加载。