ambleloft

教程与开发文档

从一个业务目标开始:小任务跟随技能大师创建,多项目工作交给带技能的专家团队。按需学习表单、扩展与远程项目。

本页内容

01推荐从技能大师开始

在本地项目中新建任务,点击「创建技能 / 扩展」,描述目标并提供业务规则或接口文档。技能大师辅助你确定字段与流程、生成源码、检查产物,再由你确认安装和试用。先完成三步差旅 Skill,随后为业务系统增加扩展操作。

开发路径适合的下一步
技能大师通过引导创建、检查、安装和试用技能或扩展。
声明式表单维护确定的业务字段、步骤和提交方式。
SDK 与业务操作手动构建扩展,管理配置、权限和业务接入。
SSH 远程项目浏览服务器代码,执行任务并核对运行结果。
开始:跟随技能大师创建

02项目在服务器上时

通过 SSH 连接远端工作目录,让文件面板、Agent 任务和终端使用同一项目。技能与扩展安装仍走本地项目流程,远端生成的产物需先取回本机。

设置 SSH 远程项目

03理解三个运行位置

插件后端运行 Node.js 业务逻辑;插件主页运行浏览器界面,通过 WebviewClient 调用操作;聊天表单由宿主根据 YAML 渲染。自定义聊天 HTML 使用独立的 MCP Apps 协议,不能与主页桥接 API 混用。

代码示例
Skill → Agent → forms_list / forms_present → Host form
                                                ↓ confirmation
Home page → WebviewClient.invoke → Operation → Your service
                                                ↑
Your service → Extension subscription → Local messages → Action

04边界与版本

当前为内部源码预览,尚未正式发行。版本号不证明能力或平台支持。模型工具通过 tools/list 和 capabilities 发现;Node 方法和权限需分别检查。持久补充输入仅为模型工具,不提供 Node/页面 inputs 或执行单元恢复。

查看版本检查与 CLI

05组织一次跨项目协作

先添加专家并准备技能,创建空间关联已有项目;向主持人描述目标,审阅任务与依赖,确认启动后按交付证据验收。当前教程对照源码界面,下载包请核对发行说明。

开始协作练习
SDK / CLI 0.1.0-alpha.9 · 接口基线 兼容性与预览说明 · 案例源码