yida-solution-template · diff
git:20261021.b8a86fe to git:20261021.a4cdbd8
56 added, 16 removed. Audit A to A.
---
name: yida-solution-template
- description: 仅在用户明确提到宜搭方案中心、方案模板、模板启用、模板 AI 搭，或继续该上下文时使用。查询模板与详情；定制需求交给平台原生 AI 搭建入口；原样使用模板时可在明确应用名称后直接启用，并以本地请求收据和应用列表回读防止超时重建。泛称“搭应用/系统”仍走 yida-app。
+ description: 查询和启用宜搭方案中心模板，提供 AI 搭建入口、启用摘要和状态恢复。适用于明确的方案中心、方案模板、模板启用、模板 AI 搭请求，以及已有模板任务。
---
# 宜搭方案模板
- 本技能处理方案中心模板的发现、详情、原生 AI 搭建入口和直接启用。只有用户明确提到“方案中心”“方案模板”“模板启用”“模板 AI 搭”或延续已确认模板任务时加载；普通“搭应用/系统”必须继续使用 `yida-app`。
+ ## 选择技能
- ## 顺序
+ | 用户需求 | 使用技能 |
+ | --- | --- |
+ | 查询、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
- openyida solution-template prepare TPL_XXX --name '合同管理' --with-data n --json
```
- 原样启用前用 `prepare` 获取只读摘要，向用户说明目标组织/环境、模板版本、应用名称、是否带示例数据、当前账号创建的同名应用和已有请求。它不写入应用或收据。`directEnableSupported` 仅说明存在复制源；`enableEligibility=platform-decides-on-submit` 表示权限和权益尚待平台在提交时裁决，不能承诺当前账号一定能启用。用户已明确授权且参数齐全时，不额外增加确认环节。
+ 根据用户需求选择一种方式：
- - 需要修改业务范围、字段、页面或流程：执行 `ai-build` 获取平台原生搭建入口，把定制要求交给原生搭建器。返回的 `submissionAccepted=false`、`applicationVerified=false` 表示只完成入口交接，不能宣称应用已创建。
- - 希望原样使用模板：只有用户明确目标应用名称并允许创建资源时，才执行 `enable`。`--with-data y|n` 决定是否带模板数据。
+ | 使用方式 | 下一步 |
+ | --- | --- |
+ | 调整业务范围、字段、页面或流程 | 执行 `ai-build`，交付原生搭建链接，引导用户在该页补充定制需求并提交 |
+ | 原样使用模板 | 按下节展示摘要并直接启用 |
```bash
openyida solution-template ai-build TPL_XXX --json
- openyida solution-template enable TPL_XXX --name '合同管理' --with-data y --json
```
- ## 超时、回读与完成口径
+ `ai-build` 返回 `submissionAccepted=false`、`applicationVerified=false`，交付时说明“模板 AI 搭建入口已准备好”。
- 直接启用会先写本地请求收据，每次尝试只提交一次。默认最多等待 10 秒，按递增间隔只读查询应用；`--wait 0` 只查一次，`--wait 0-60` 设置等待预算。超时和不完整响应也先尝试只读恢复。没有后台轮询或百分比进度。
+ ## 展示摘要并启用
- 平台明确拒绝时，本次尝试结束，保留平台错误；`status` 和普通重复 `enable` 只返回拒绝原因，不将后来出现的同名应用归为本次结果，不自动重试、不修改权限或权益。仅当用户再次明确要求提交时，使用相同参数和 `--retry` 开始一次新尝试，继续由平台鉴权：
+ 用户允许创建应用且名称已明确时，先用 `prepare` 读取摘要，说明目标组织/环境、模板版本、名称、数据选择、当前账号创建的同名应用和已有请求。授权和参数齐全时直接继续执行。
```bash
- openyida solution-template enable TPL_XXX --name '合同管理' --with-data n --request-id st-xxxxxxxx --retry --json
+ openyida solution-template prepare TPL_XXX --name '合同管理' --with-data n --json
+ openyida solution-template enable TPL_XXX --name '合同管理' --with-data n --json
```
- 未知结果或应用尚不可见时，不得盲目重建；`--retry` 也不会重放未知请求。使用返回的请求号查询，可选择在本次命令内等待：
+ `--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
```
- 分别读取 `submissionAccepted` 与 `applicationVerified`。只有 `applicationVerified=true` 才表示本次查询确认应用存在；`previouslyVerified` 和 `lastVerifiedAt` 保留历史创建证据。即使历史 `state=completed`，本次查询失败或应用不再可见时也必须返回 `applicationVerified=false`，不能声称当前可访问。查询失败保留已受理状态和平台原因，通过 `nextAction` 继续查状态，不转成启用失败。`uncertain` 或 `ambiguous` 不得重提；多候选需核对身份。已完成请求重复执行只返回原应用；只有用户明确要求再建一份时才使用新的 `--request-id`。
+ 平台明确拒绝后，用户再次明确要求提交时，使用原模板、名称、数据选择和请求号，加 `--retry` 发起一次新尝试：
- 登录、组织权限、版本权益、AI 额度和模板可用性均由平台裁决。保留平台错误，不切换组织、不修改权益、不绕过限制。真实启用后还需按用户要求打开并验收应用；应用列表回读只证明资源身份，不证明页面效果、业务数据或运行时权限正确。
+ ```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` 加载。