使用 AI 创建解决方案设计

使用 Cobre 的 Agent Skill，由您自己的技术团队为集成生成一份 Solution Design Document — 涵盖 Local Payments、Cross Border、FX、稳定币、余额与运营功能。

该 skill 会读取 Cobre 的实时 API 文档和 OpenAPI 规范，然后写出一份可交给工程团队的 Markdown 设计。

您安装的文件是一个 wrapper（包装器）。每次运行时，它会从 Cobre 托管的 skill 内容拉取当前工作流、产品规则、模板与校验本体。Cobre 更新这些规则时，您无需更换 zip — 只有当您的 KAM（关键客户经理）发送新的 wrapper 时才需要更换。

同一个 .skill 文件可用于 Claude Code、Cursor、Codex、Copilot、Gemini CLI，以及其他兼容 Agent Skills 的编码智能体。它无法在不能执行脚本或拉取文档的聊天界面中运行。

请使用当前 wrapper，并让它自行刷新。 KAM 发给您的 zip 并不是完整规则集。每次运行都会通过 HTTPS 拉取最新 skill 内容，再通过 Cobre Docs MCP 读取实时 OpenAPI 规范。

开始撰写 Solution Design 之前：

向您的 Key Account Manager（KAM） 索取 cobre-create-solution-design.skill。

连接 Cobre Docs MCP，并在同一对话中刷新。仅凭已发布页面，skill 不会生成设计。

请勿保留该 skill 的私有分支。若输出与 docs.cobre.com 不一致，请以已发布文档为准，并向您的 KAM 确认是否需要新的 wrapper。

skill 会产出什么

一份覆盖您所描述产品的 Markdown Solution Design：架构、余额、Counterparty（交易对手）、按轨道的 API 映射、webhook、对账，以及未决决策。

请求、响应与 webhook 示例取自实时 OpenAPI 规范 — 而非凭记忆改写。

该文档面向您的工程启动会。商务条款、定价、FX 点差、KYC 要求以及按账户限额并不来自公开文档；设计会如实说明，而不是编造数字。

对话、intake 与文档可以使用英语、西班牙语或简体中文。skill 会先询问使用哪种语言。

参见示例

前提条件

要求	原因
具备 Shell 访问权限的编码智能体（Claude Code、Cursor、Codex、Copilot、Gemini CLI 或同类工具）	skill 必须拉取托管内容、刷新 OpenAPI 规范，并运行 `validate_spec.py`。
Cobre Docs MCP	必需。接口、Schema、示例与枚举均来自刷新后的 OpenAPI 规范。参见借助 AI 进行开发。
由您的 KAM 提供的 `cobre-create-solution-design.skill`	本地脚本与校验器。
Python 3、curl、HTTPS	拉取托管页面并校验设计。

1. 向您的 KAM 索取 skill

向您的 Key Account Manager 索取 cobre-create-solution-design.skill。

Cobre 不会公开发布该 zip 供自助下载。若您仍持有 create-solution-design-self-service.skill，请删除它，并改用当前 wrapper。

2. 在您的智能体中安装

zip 内的文件夹必须命名为 cobre-create-solution-design/，且根目录恰好包含一份 SKILL.md。请先删除任何旧副本。

智能体	安装
Claude Code	在 Settings → Skills 中导入 `.skill`，或解压到 `~/.claude/skills/`
Cursor	在 Skills 设置中导入 `.skill`，或解压到 `~/.cursor/skills/` 或 `.cursor/skills/`
Codex	解压到 `~/.agents/skills/` 或 `.agents/skills/`
Copilot / VS Code / Gemini CLI	解压到该产品的 skills 文件夹，使 `SKILL.md` 位于 skill 根目录

替换任何旧副本

说明： 从您将使用的 skills 文件夹中移除 cobre-create-solution-design 和 create-solution-design-self-service，然后导入或解压 KAM 发给您的文件。

行动后的预期结果： 磁盘上只有一份该 skill 的副本。

确认 skill 已加载

说明： 开始一段新的智能体对话，并请求一份 Cobre Solution Design（参见如何使用）。

行动后的预期结果： 助手会拉取托管 skill 内容，然后进入 intake，而不是凭记忆编造集成方案。

若您此前安装过该 skill，请在安装新版本之前删除旧副本。

3. 连接实时 Cobre 文档

skill 不会仅凭记忆或仅凭 llms.txt 撰写 Solution Design。

请遵循借助 AI 进行开发，并添加 Cobre 的公开文档 MCP（site-id=760877）。无需 Token。然后在同一对话中请求：

刷新 MCP 并重新加载最新的 API 规范。

MCP 会在本地缓存 OpenAPI 规范。本次运行中必须刷新。若刷新失败或未连接 MCP，skill 将停止。

托管 skill 内容（工作流与产品规则）与产品 OpenAPI 规范是分开的。wrapper 拉取前者；MCP 提供后者。

如何使用

请在 agent 模式下工作，以便助手可以运行脚本并调用 MCP。

开始新对话

说明： 请求一份 Solution Design。您不必使用 Cobre 的产品名称 — 描述您的业务如何移动资金即可。

示例提示词：

为我们的 Cobre 集成创建一份 Solution Design。

我们是墨西哥和哥伦比亚的 PSP。需要 SPEI 出金、收款、FX 和 USDC on-ramp。请生成一份 Solution Design。

行动后的预期结果： 助手会询问语言（英语、西班牙语或简体中文）。

让 skill 自行刷新

说明： 当智能体请求时，批准拉取托管 skill 内容以及 MCP 的 OpenAPI 刷新。

行动后的预期结果： intake 与校验使用当前规则集和当前规范 — 而不是上个月 zip 里的内容。

回答 intake

说明： skill 会先进行简短的范围筛查，然后最多进行两轮 intake。请用您自己的话回答。「我不知道」是有效回答 — 设计会列出选项、每个选项的代价，以及其间暂采的假设。

行动后的预期结果： 助手已具备撰写 Markdown 的足够信息。您不需要沙箱凭证；账户开通会作为设计中的决策出现。

审阅 Markdown

说明： skill 会写出一份 Markdown 文件。该文件即交付物。请持续要求修改，直到内容正确。

行动后的预期结果： 一份面向客户的文档。聊天中可能出现运行报告（所用来源、缺口）。请将该报告留作内部使用 — 不要把 MCP 或缓存警告粘贴进您对外分享的文件。

典型 Markdown 内容：

目标与范围

架构与设计原则

运营模型（Cobre Balance、Counterparty、资金流）

按流程的 API 映射 — 先出金，再入金，范围内再含 Cross Border / 稳定币

事件、webhook 与状态同步

对账与报表

您所在地区所需的代码与目录

决策与取舍（包括余额模型等不可逆选择）

保持 skill 最新

两层内容以不同方式保持最新：

层级	如何更新
托管 skill 内容（intake、产品规则、模板、本体）	每次运行时拉取。您无需更换 zip。
OpenAPI 规范	在本次运行中刷新 MCP。参见管理 API 与产品变更。
Wrapper（拉取脚本、校验器）	仅在 KAM 发送新文件时，或 Cobre 发出通知后拉取失败时，向 KAM 索取新的 `cobre-create-solution-design.skill`。

若 skill 输出与 docs.cobre.com 不一致，请以已发布文档为准。

示例

Solution Design — NorteLedger MX 与 Cobre 的集成

使用 AI 创建解决方案设计

skill 会产出什么#

前提条件#

1. 向您的 KAM 索取 skill#

2. 在您的智能体中安装#

3. 连接实时 Cobre 文档#

如何使用#

保持 skill 最新#

相关指南#

示例#

skill 会产出什么

前提条件

1. 向您的 KAM 索取 skill

2. 在您的智能体中安装

3. 连接实时 Cobre 文档

如何使用

保持 skill 最新

相关指南

示例