5 分钟创建你的第一个智能体

QBuilder Desktop 与 yao-meta-skill 均依赖本地网关。若网关未启动,后续所有 Desktop 交互均会出现调用失败或持续 loading。

启动方式

从桌面快捷方式或开始菜单启动 QBuilder。桌面快捷方式图标为橙红色方块,QBuilder logo 居中。

未显示登录界面时的排查

• 查看任务栏或系统托盘是否有 QBuilder 图标闪烁 — 表示正在启动。
• 首次启动耗时较长,通常 10–15 秒。
• 若仍未显示,右键托盘图标 → 选择「退出」 → 重新启动。

1.1 启动 QBuilder Desktop

启动 QBuilder Desktop → 在登录页填写邮箱密码(亦可使用第三方登录) → 进入 Dashboard。

1.2 定位「从向导构建技能」卡片

Dashboard 上半区为工作流卡片网格,其中第一张卡片即 从向导构建技能(workflow id: workflow-1-1)。

wizard-01-before-click.png · Dashboard 工作流卡片网格

1.3 点击卡片,进入 AI 创建技能

系统将自动跳转至 Skill Studio 面板,左侧导航栏中 AI 创建 项处于高亮选中状态。

wizard-02-after-click.png · 自动切换到 Skill Studio 的 AI 创建技能面板

2.1 AI 的首轮提问

进入 AI 创建后,系统立即开启多轮对话,首轮提问如下:

请从定位、场景、操作流程、运行环境、验收标准五个维度描述你的问题,我来帮你编译成专业技能。首先,你希望解决什么问题?

wizard-03-first-question.png · AI 抛出 5 维度首问

2.2 一次性填写 5 维度(降低轮次)

无需等待 AI 逐个提问。一次性填写下列 5 个维度,可显著减少后续追问轮次。

2.3 提交回答,等待 AI 流式响应

完成填写后,点击文本框右下角的 发送 按钮(或按回车)。AI 将先复述需求、确认理解,随后右侧覆盖率面板开始更新。

wizard-06-ai-response.png · AI 完成 5 维度评估,出现首个 followup

覆盖率到达 100% 后,AI 会提出若干 followup 用于消除歧义。本教程实测共 4 个:

1. 列类型推断是仅用于格式化(对齐、日期显示),还是需要将数值列实际存储为 number 类型?
2. SheetJS 是经 CDN 加载,还是经 npm 本地打包?
3. 目标产物是独立 index.html(双击即用),还是嵌入到 Hermes Desktop 拖拽区?
4. 上述 5 维度总结是否有需要调整之处?(若无偏差,即作为技能创建的需求输入)

wizard-07-followup-typed.png · 首个 followup 准备回答

每个追问的两种处理方式

• 点击「发送」:提供具体回答(2–4 句为佳)。AI 将更新覆盖率摘要。
• 点击「跳过」:不提供回答,默认按 AI 当前理解继续。

若对追问无明确倾向,通常「3 答 + 1 跳」节奏最节省时间,其中「1 跳」对应最终的确认问。

wizard-15-after-followup3.png · 第 3 个追问已答,出现最终确认

wizard-18-after-skip.png · 跳过最终确认,准备进入编译

所有追问均已回答(或跳过)后,右上角的 编译 Skill 按钮将由 disabled 转为 enabled。点击后,AI 将执行以下两步:

1. 将本轮所有问答与追问整理为 markdown 格式的需求文档。
2. 将该文档注入 yao-meta-skill 的输入,并跳转至新 session 由 yao-meta-skill 接手。

wizard-19-compile-pre.png · 准备点击「编译 Skill」

wizard-20-compile-after.png · handoff 完成,yao-meta-skill 开始工作

handoff session 启动后,yao-meta-skill 将在 workspace 中创建技能。UI 是否仍显示「agent not responding」banner 不构成判断依据 — 此为 Desktop UI 心跳机制的误报,后端大概率仍在运行。

通过文件系统判断

在 workspace 根目录(例如 D:\Workspace\quseit-website\)刷新文件管理器:

D:\Workspace\quseit-website> dir
...
<新建目录>  csv-to-xlsx-browser\
...

若 csv-to-xlsx-browser\(或自定义命名目录)出现,则可确认 yao-meta-skill 正在落盘。

yao-meta-skill 的标准产出结构

csv-to-xlsx-browser/
├── SKILL.md            触发词 + 红线 + 诚实边界
├── manifest.json       结构化元数据
├── README.md           quick start + 排除项
├── agents/
│   └── interface.yaml  agent 接口
├── assets/             用户最终消费的产物(独立 index.html 等)
├── fixtures/           测试 CSV / 测试样本
├── reports/            意图置信度报告
└── scripts/            工具脚本 + node_modules(真实依赖)
    ├── headless_convert.js
    └── verify_xlsx.py

wizard-21-final.png · handoff session 持续在跑(banner 可能误报)

yao-meta-skill 通常会同时产出可执行的验证脚本。在 scripts/ 目录下找到 headless_convert.js(或类似名)与 verify_xlsx.py(或类似名),依次执行:

cd csv-to-xlsx-browser\scripts
npm install                # 装 SheetJS 等依赖
node headless_convert.js ..\fixtures\sample.csv ..\_verify_out\sample.xlsx
python verify_xlsx.py ..\_verify_out\sample.xlsx

# 预期输出:
{
  "ok": true,
  "checks": [
    { "name": "number_types", "ok": true, "detail": "5 cells in number columns have correct Python type" },
    { "name": "date_types",   "ok": true, "detail": "5 cells in date columns have correct Python type" },
    { "name": "column_widths","ok": true, "detail": "5 column widths all in (0, 100]" }
  ]
}

全部 "ok": true 即代表产物合格。

wizard-25-verify-output.png · verify_xlsx.py 终端输出,3 项检查全 ok:true