跳到主要内容

使用 AI 构建 Dex 应用

Dex Skills 是 Dex 官方的 coding-agent 指导，以 Plugin 或三个 standalone Skills 的 bundle 形式发布。它帮助 Codex、Claude Code 和 Cursor 设计并构建 Dex 应用、直接使用 公开 Dex SDK，以及贡献官方 Connector。

该 plugin 提供开发指导，不包含 runtime code。Dex Server、Worker 和应用不会加载它。

从 Dex App Builder 开始

产品、应用或业务流程类请求应从 dex-app-builder 开始。它负责端到端工作流，并在 需要 SDK 或 Connector 工作时加载对应的专用 skill。

需要代码工作区​

Dex Skills 是 developer plugin，不是托管式 application builder。要创建或修改应用， 需要在 Codex 或其他 coding-agent host 中使用，并提供可写 repository 或 project workspace、文件编辑工具和命令执行能力。现有 repository 和新建的空 repository 都可以。

如果普通聊天没有 repository 和命令执行能力，这些 skill 仍可用于业务 discovery、 架构设计和实现交接，但不能创建项目文件、运行测试、构建 artifact 或部署应用。 开始实现前，需要把确认后的方案转到由 repository 支持的代码工作区。

选择 Skill​

Skill定位使用场景
Dex App Builder主要 skill发现、原型设计、实现并在本地验证使用 Go backend 的端到端 process product。
Dex SDK专用 sub-skill使用 Python、Go、Java、TypeScript 或 Rust 实现、调试、测试和运维 Dex 应用。
Dex Connector Contributor专用 sub-skill创建、验证并提交官方 Connector operation、Trigger 和 configuration UI unit。

只有独立 SDK 任务才直接使用 dex-sdk。只有独立修改官方 Dex Connectors Library 时才直接使用 dex-connector-contributor。

三个 Skill 如何协作​

Dex App Builder 是主要协调入口。进入 backend 设计与实现时，它加载 Dex SDK；它会 直接使用已发布 Connector，并把确认的官方 Connector gap 路由给 Dex Connector Contributor。Connector Contributor 需要共享的 Flow 和 Step 语义时也会加载 Dex SDK。

三个 Skills 必须一起安装，agent 才能在它们之间正确路由。源码和 release 位于 superdurable/dex-skills。

二选一安装​

只能选择一种安装方式，不要同时安装：

  1. Plugin（推荐）：一次安装三个 Skills，并使用 host 的 marketplace 生命周期。
  2. Standalone Skills：通过 Agent Skills CLI 直接安装全部三个 Skills。

同时安装会留下重复副本，使实际加载的版本不明确。同一个 host 中，Plugin 和 standalone 安装的调用方式也可能不同。

安装与使用 Dex Skills​

选择当前使用的 host。一个 host 只能选择 Plugin 或 standalone Skills 中的一种安装路径。

Plugin（推荐）

安装

此路径不需要单独安装 Codex CLI。

  1. 打开 plugin browser，选择添加菜单，然后点击 Add a marketplace。
  2. Source 使用下面的 repository，Git ref 使用 main，Sparse paths 保持为空。
https://github.com/superdurable/dex-skills
  1. 添加 marketplace，打开 Super Durable，选择 Dex 并安装。
  2. 打开 repository 或空 project，然后创建新 task。

使用

输入 @，从 picker 中选择 Dex，再输入请求。只输入普通 @Dex 文本不会创建 Plugin binding。

@Dex Design and build an event-registration application.
@Dex Diagnose why this Flow retries after the payment Step completes.
@Dex Add <XYZ> to Dex official connector library

更新

在 plugin browser 的 marketplace 管理页面找到 Super Durable，点击 Upgrade。完成后重启 Desktop app，并创建新 task。

Standalone Skills

如果选择该方式，请不要再安装 Plugin。三个 Skills 必须一起安装。

安装

npx skills add superdurable/dex-skills --skill '*' --agent codex --global

使用

$dex-app-builder Design and build an event-registration application.
$dex-sdk Diagnose why this Flow retries after the payment Step completes.
$dex-connector-contributor Add <XYZ> to Dex official connector library

更新

npx skills update dex-app-builder dex-sdk dex-connector-contributor --global

如果已安装的 skills CLI 不支持 update，请重新运行上面的安装命令。

信任与权限​

只从可信来源安装 agent extension。Dex 不声明 MCP server、credential 或应用 runtime code。可选 lifecycle hook 只读取已安装版本和 GitHub 公开 release metadata，并报告 较新版本，不会执行安装。创建 GitHub fork、发布 branch、打开 pull request，以及修改 运行中 Flow，仍然是需要授权的操作。

接下来阅读主要工作流 Dex App Builder。