ambleloft跟随技能大师创建
先完成一个三步差旅登记 Skill，再学习怎样提供接口文档，把业务表单接到已有系统。源码留在你的项目中，可以继续修改和维护。
完成后：跟随引导生成、检查并安装一个三步差旅 Skill，在聊天中试用；按需继续接入业务服务。
前置条件：包含技能大师的桌面应用、支持工具调用的模型，以及一个本地项目目录。
本页内容
01开始前准备
使用包含内置「技能大师」和创建卡的 Ambleloft 版本，配置支持工具调用的模型，并准备一个本地项目文件夹。首次创建从本地项目开始，当前安装入口需要本地产物。若看不到创建入口，请检查版本和技能启用状态；从源码更新后需要完全退出并重新启动应用。
先完成应用启动与模型配置02在项目中开始创建
新建或选择一个本地项目，再新建任务。点击输入框下的「创建技能 / 扩展」：应用选中技能大师，并将引导提示放入草稿。补上你的目标后发送。它不会在点击入口时自动发送消息。
我想做一个三步差旅费用登记工具，给同事在聊天里使用。
第一步填目的地，第二步填金额和费用说明，第三步由用户核对确认。
先把登记信息发回聊天，整理成申请草稿。暂时不接财务系统。
请用技能大师引导我完成创建、检查、安装和试用。03确认用途，再决定字段
技能大师应复用你已说明的信息，只追问会影响实现的内容，并给出可修改的名称、步骤和字段建议。这里确认金额使用人民币、必须大于零，费用说明必填；第三步允许返回前两步检查并勾选确认。固定字段的业务表单可以作为独立 Skill 交付。需求不明确时先说明业务规则，避免把模型建议直接当成公司制度。
04使用现成模板核对生成结果
让技能大师参考本页关联的三步差旅教程，或将其中的 SKILL.md 和 forms/travel.yaml 保存到项目的 reference/travel-expense 目录，再请它读取。示例是可检查的起点，你仍可修改名称、字段和说明。生成文件应放入项目中的独立目录，保留原有文件。
获取三步差旅的完整文件与配置说明05查看创建卡与检查结果
展开「方案与验证详情」，核对目标、交付形式、生成目录和仍未验证的部分。技能大师生成文件后，会请求宿主检查并准备安装快照。纯 Skill 至少应包含 SKILL.md 与它引用的 YAML 文件，确认提交方式为 chat。检查通过表示产物符合安装要求；本步骤不会运行生成代码，也不证明后续业务调用成功。
travel-expense/
SKILL.md
forms/
travel.yaml06安装已检查的版本
创建卡出现「安装并启用」后，核对产物并点击安装。遇到技能重名时选择替换或另存。安装使用检查时保存的快照；项目中的源文件仍可编辑。之后修改源文件，需要重新检查和安装，已安装版本才会更新。
07理解版本与验证记录
创建卡的「方案与验证详情」保留用途、所需环境、安装设置、权限和未验证项。宿主文件检查只说明安装快照通过静态校验；用户试用确认单独记录。每条记录绑定产物摘要。更新安装版本、设置、凭据或授权后，旧试用确认会成为历史记录，请重新试用。仅保存配置不会显示连接成功；没有连接检查协议时，外部连接仍标记未验证。普通 Skill 不需要额外的 Node 服务或业务服务器。
08在聊天中完成一次真实试用
点击「准备试用」，检查填入的提示词后发送。独立 Skill 会被选中，Agent 应展示三步业务表单。先留空必填项确认无法进入下一步，再填写目的地、金额和费用说明；返回上一步检查后勾选确认并提交。预期结果是聊天收到确认信息，Agent 据此整理申请草稿。只有你实际完成并核对后，才点击「我已试用，通过」。
| 检查点 | 预期结果 |
|---|---|
| 字段与导航 | 步骤和规则符合已确认需求，返回修改可用。 |
| 提交时机 | 前两步只收集信息，最终确认后才发送到聊天。 |
| 结果含义 | 申请草稿包含确认数据；没有宣称企业财务系统已受理。 |
09把 Skill 接入已有系统
在同一个创建任务中说明新增的业务动作，例如把已确认的差旅信息提交到公司的费用系统。提供该系统的接口文档后，技能大师可建议把 Skill 随扩展交付，并生成 Operation 对接代码。扩展也可接入 CLI、设备桥或厂商 SDK；选择方式取决于执行位置、依赖和操作范围。具体适配需要相应资料和环境验证。
10将接口资料放入项目
把经过脱敏的 Markdown 或 JSON 文档保存到 docs/expense-api.md 等项目路径，再在聊天中明确要求读取。至少说明接口用途、认证方式、字段规则、请求与成功/错误响应。写入操作还要说明幂等键和结果查询方式。文档缺失时请模型列出待确认项，不要让它猜出服务地址或业务规则。文档内容可能进入所选模型服务的上下文，分享前核对数据范围。
请读取项目中的 docs/expense-api.md，继续完善现有差旅工具。
先列出文档支持的提交和结果查询流程，以及仍缺少的约定。
保留已确认的三步表单，生成所需扩展代码。
服务地址放入扩展设置，凭据通过宿主支持的凭据入口配置。
先检查代码，并用明确标注的模拟服务验证；真实系统接入另行确认。11接口资料应回答哪些问题
以下是资料清单，不是已部署的演示接口。由你的业务系统负责人提供实际约定。已有 expense-workflow 案例可用于理解表单与 Operation 的映射、提交身份和失败恢复；它的演示行为不能代替你公司的接口契约。
| 资料 | 建议内容 |
|---|---|
| 业务规则 | 谁能提交、金额与币种、哪些字段必填、是否有审批。 |
| 接口与认证 | 方法、路径、认证机制与权限范围；用占位符表示凭据。 |
| 字段与响应 | 请求示例、业务编号、状态、校验错误与权限错误。 |
| 幂等与查询 | 服务怎样使用提交标识去重，以及怎样查询先前请求的结果。 |
12用已有演示服务练习接口接入
下载下面的资料包到项目，并将文件路径告诉技能大师。资料包提供 expense-workflow 的真实本机接口、请求响应、业务规则和起始提示。按其中的命令准备 Node.js ≥22.13 的演示服务；保持 npm run service 运行，扩展的 serviceUrl 设置为 http://127.0.0.1:47832。核对 health 的 local-demo 状态，提交后查询同一个 expenseId。当前参考适配器仅允许回环 HTTP，接入企业系统还需修改适配代码和验证认证；不能仅替换任意远端 URL。
下载中英文接口资料与完整试跑步骤13配置扩展并验证实际接入
扩展检查通过后，在创建卡确认安装及代码信任，再打开「设置与权限」。连接地址、工具路径等放在扩展设置；凭据通过支持的安全入口填写，避免放进聊天或源码。按需授权项目和操作权限。缺少配置时应有明确的配置提示。先运行模拟或只读测试，再授权一次测试业务写入，并通过业务编号或查询接口核对结果。记录生成、检查、安装、配置、模拟测试和真实调用各自的结果。
14暂停、失败与继续修改
停止任务后，创建记录和已确认需求会保留。回到同一任务，发送新的补充内容或使用「继续创建」准备提示；未回答的问题仍需要实际回答。检查失败时让技能大师修正具体文件后重新检查。试用未出现表单时，检查技能启用、模型工具调用和 YAML 引用。业务提交超时且结果未知时，先查询结果，确认前不要重新提交。修复后重新检查、安装并试用。
15继续学习或手动开发
了解表单结构后，可以自己维护 YAML；需要控制构建、SDK 和打包流程时，使用手动扩展教程。SSH 远程项目适合服务器上的开发任务；当前远端产物需要取回本机，才能继续本地安装流程。
进阶：手动开发第一个扩展检查结果与排错
跟随引导生成、检查并安装一个三步差旅 Skill，在聊天中试用；按需继续接入业务服务。
按本页的验证步骤核对实际结果。涉及业务服务时，分别检查界面提交、工具回执与服务端记录。
打开错误代码与排错 →